注册
达梦数据库JDBC与ODBC连接配置指南
培训园地/ 文章详情 /

达梦数据库JDBC与ODBC连接配置指南

JYX. 2026/08/27 172 0 0

一、前言
达梦数据库(DM Database)作为国产数据库的代表,提供了全面的应用程序接口(API),使得开发者可以使用多种编程语言与其交互。其中,ODBC和JDBC是两种最重要、应用最广泛的接口标准。

 ODBC(Open Database Connectivity) 是微软主导的数据库访问标准,提供了一个抽象的接口,允许应用程序使用相同的代码访问不同的数据库。适用于C/C++、.NET、Python、PHP,以及Excel、Tableau、Power BI等桌面应用。

 JDBC(Java Database Connectivity) 是Java应用程序与数据库的接口规范。达梦提供了完全遵循JDBC标准的Type 4纯Java驱动程序,适用于Java技术栈。

掌握这两种接口的配置,是进行达梦数据库应用开发的基础技能。本文将从零开始,详细讲解如何在Windows和Linux环境下配置ODBC及JDBC连接达梦数据库。由于ODBC涉及跨语言、跨工具的场景更为广泛,本文将重点介绍ODBC的配置,JDBC部分作为补充简述。

二、ODBC配置指南
ODBC配置的核心是创建一个DSN(数据源名称),它就像一个“快捷方式”,把数据库的地址、端口、账号、密码等信息打包在一起。应用程序只要引用这个DSN名字,就能连接到数据库,而无需在代码里重复填写连接信息。
ODBC的配置方式取决于操作系统,以下分别介绍Windows和Linux(含麒麟系统)环境下的配置方法。
2.1 Windows环境配置
步骤1:确认ODBC驱动已安装
达梦ODBC驱动文件位于达梦安装目录的 \drivers\odbc 下。安装达梦数据库时,ODBC驱动通常会自动注册到系统中。如果后续配置时在驱动列表中找不到“DM ODBC DRIVER”,可以检查达梦安装目录下的 bin 文件夹中是否有 dodbc.dll 文件,确认驱动是否存在。
image.png
步骤2:打开ODBC数据源管理程序
ODBC数据源管理程序是Windows系统自带的工具,用于管理所有的ODBC数据源。打开方式如下:
方法一(推荐):按 Win + R,输入 odbcad32,回车
方法二:控制面板 → 管理工具 → ODBC数据源(64位)
注意:odbcad32 打开的是与操作系统位数匹配的版本(64位系统默认打开64位管理器)。如需32位管理器,使用 C:\Windows\SysWOW64\odbcad32.exe。如果后续测试连接时提示驱动不匹配,可以尝试切换32位和64位版本。
image.png
步骤3:添加DSN

  1. 在ODBC数据源管理程序中,切换到 “系统DSN”选项卡
  2. 点击 “添加” 按钮
  3. 在驱动程序列表中,选择 “DM8 ODBC DRIVER”,点击“完成”
    image.png
  4. 在弹出的配置窗口中,填写以下信息:
    | 配置项 | 说明 | 示例值 |
    |--------|------|--------|
    | 数据源名称(DSN) | 连接的别名,后续代码中引用此名称 | DM8 |
    | 描述 | 备注说明,便于识别 | 我的达梦数据库 |
    | 服务器 | 数据库所在主机的IP地址或主机名 | localhost(本机)|
    | 端口 | 达梦数据库的服务端口| 5234 |
    | 用户名 | 数据库登录用户名 | SYSDBA |
    | 密码 | 对应用户的密码 | ****** |(安装达梦时设置的密码)
    image.png
  5. 点击 “测试连接” 按钮,验证配置是否正确。
    image.png
    如果弹出“连接成功”的提示,说明DSN配置完成。
    关键提示:配置完成后,后续在代码中只需要使用 DSN=DM8 即可建立连接,无需再重复填写服务器地址、端口、账号密码等信息。
    2.2 Linux/麒麟环境配置
    在Linux(含麒麟系统)上配置ODBC,依赖 unixODBC 库作为ODBC的管理框架,再通过配置文件指定达梦的ODBC驱动和连接信息。
    步骤1:安装unixODBC
    在银河麒麟等使用 yum 的系统中:
    yum install unixODBC unixODBC-devel -y
    如果是使用 apt 的系统(如Ubuntu、优麒麟):
    apt-get install unixodbc unixodbc-dev -y
    image.png
    image.png
    安装完成后,再次执行 odbcinst -j,会显示各项配置文件的路径,例如:
    -系统级驱动配置:/etc/odbcinst.ini
    -系统级数据源配置:/etc/odbc.ini
    -用户级数据源配置:~/.odbc.ini
    说明:以上路径是unixODBC的默认配置路径,具体路径可能因安装方式略有不同。后续配置时,文件路径需根据实际环境调整。
    image.png
    步骤2:获取达梦ODBC驱动
    达梦ODBC驱动位于达梦安装目录下。本文环境达梦安装目录为/dm8,驱动路径为:
    /dm8/bin/libdodbc.so
    确认文件存在:
    ls -l /dm8/bin/libdodbc.so
    如果找不到,可以在达梦安装目录下搜索:
    find /dm8 -name "odbc.so" 2>/dev/null
    步骤3:配置驱动信息(odbcinst.ini)
    编辑/etc/odbcinst.ini文件:
    vi /etc/odbcinst.ini
    在文件末尾添加以下内容:
    Driver for Dameng Database
    [DM8 ODBC DRIVER]
    Description = DM8 ODBC Driver
    Driver = /dm8/bin/libdodbc.so
    说明:[DM8 ODBC DRIVER] 是驱动名称,后续在odbc.ini中引用。Driver的路径必须指向实际的libdodbc.so 文件。
    步骤4:配置DSN(odbc.ini)
    编辑 /etc/odbc.ini 文件:
    vi /etc/odbc.ini
    添加以下内容:
    [dm8]
    Description = DM8 ODBC DSN
    Driver = DM8 ODBC DRIVER
    SERVER = localhost
    UID = SYSDBA
    PWD = Dameng_123
    TCP_PORT = 5236
    说明:
    [dm8] 是DSN名称,后续使用 isql dm8 或代码中 DSN=dm8 引用
    Driver 的值必须与 odbcinst.ini 中的驱动名称完全一致
    SERVER 为本机填 localhost,远程填IP地址
    TCP_PORT 为达梦数据库端口,默认5236
    步骤5:测试连接
    使用isql工具测试ODBC连接:
    isql dm8 -v
    执行后显示 Connected!,说明ODBC数据源配置成功。
    image.png
    如果连接失败,请检查:
    odbcinst.ini 中 Driver 路径是否正确
    odbc.ini 中用户名、密码、端口是否正确
    达梦数据库服务是否正常运行
    2.3 ODBC配置常见问题
    image.png

三、JDBC配置指南
JDBC是Java应用程序连接达梦数据库的标准方式,配置相对简单。其本质就是将达梦提供的JDBC驱动JAR包添加到Java项目的类路径中,然后使用标准的URL格式建立连接。
3.1 获取JDBC驱动
达梦JDBC驱动位于数据库安装目录的 /drivers/jdbc 目录下。根据Java版本选择对应的JAR包:
驱动文件 对应JDK版本
DmJdbcDriver6.jar JDK 1.6
DmJdbcDriver7.jar JDK 1.7
DmJdbcDriver8.jar JDK 1.8
DmJdbcDriver11.jar JDK 11
建议:使用与达梦数据库版本相近的驱动,避免功能不适配。
image.png
3.2 在项目中添加驱动
普通Java项目:将JAR文件复制到项目的lib目录下,在IDE中右键添加到构建路径。
Maven项目:在pom.xml中添加达梦JDBC驱动的依赖坐标。
3.3 测试代码
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
public class TestJDBC {
public static void main(String[] args) {
String url = "jdbc:dm://localhost:5236"; // 连接URL
String user = "SYSDBA"; // 用户名
String password = "Dameng_123"; // 密码

try {
Class.forName("dm.jdbc.driver.DmDriver");
Connection conn = DriverManager.getConnection(url, user, password);
System.out.println("JDBC连接成功!");
conn.close();
} catch (ClassNotFoundException e) {
System.out.println("驱动加载失败:" + e.getMessage());
} catch (SQLException e) {
System.out.println("连接失败:" + e.getMessage());
}
}
}
场景 URL示例
本机连接 jdbc:dm://localhost:5236
远程连接 jdbc:dm://192.168.1.100:5236
指定数据库 jdbc:dm://localhost:5236?database=库名
指定默认模式 jdbc:dm://localhost:5236?schema=模式名
省略 database 参数则连接达梦数据库的默认库。
3.4 常见问题
image.png
四、ODBC与JDBC对比总结
image.png

五、结语
通过本文的实践,我们完成了达梦数据库的ODBC和JDBC连接配置。掌握了这两种接口,就打通了达梦数据库与各类开发工具之间的桥梁,无论是使用Java开发企业应用,还是使用Python进行数据分析,亦或是通过Excel快速查看数据,都能得心应手。在实际工作中,建议根据项目技术栈选择合适的接口:Java项目用JDBC,非Java项目或多工具协作场景用ODBC。

评论
后发表回复

作者

文章

阅读量

获赞

扫一扫
联系客服