如何使用Rust代码查询Impala数据库？

针对SQLx不支持目标方言的说明 #

• SQLx仅支持主流数据库方言（如PostgreSQL、MySQL、SQLite、SQL Server），如果你的目标数据库不在支持列表中，只能转向ODBC这类通用数据库访问方案，暂时没有其他替代路径。

odbc-api连接问题的解决步骤 #

1. 安装对应数据库的ODBC驱动 #

• 从目标数据库官方渠道下载匹配系统架构（x86/64位）的ODBC驱动并完成安装：
  • Windows系统安装后，可通过odbcad32.exe（32位）或odbcad64.exe（64位）打开ODBC数据源管理器，确认驱动已成功注册。
  • Linux/macOS系统安装后，执行odbcinst -j查看驱动配置目录，再用odbcinst -q -d命令确认驱动已被系统识别。

2. 配置连接方式（二选一） #

方式一：使用DSN（数据源名称）连接

• Windows：在ODBC数据源管理器中添加对应驱动的DSN，填写数据库地址、端口、用户名、密码等信息，保存后在代码中直接调用DSN名称：

  use odbc_api::{Environment, Connection};
  
  fn main() -> Result<(), odbc_api::Error> {
      let env = Environment::new()?;
      let _conn = env.connect("你的DSN名称", "用户名", "密码")?;
      Ok(())
  }
  

• Linux/macOS：编辑~/.odbcinst.ini（用户级）添加驱动配置，再编辑~/.odbc.ini添加DSN配置，示例：

  # ~/.odbcinst.ini
  [ODBC Driver 18 for SQL Server]
  Description=Microsoft ODBC Driver 18 for SQL Server
  Driver=/opt/microsoft/msodbcsql18/lib64/libmsodbcsql-18.3.so.2.1
  UsageCount=1
  
  # ~/.odbc.ini
  [MyTestDSN]
  Driver=ODBC Driver 18 for SQL Server
  Server=localhost,1433
  Database=testdb
  UID=sa
  PWD=your_password
  

方式二：直接使用连接字符串

无需配置DSN，构造包含驱动名称、数据库信息的连接字符串，注意驱动名称必须与系统中注册的完全一致：

use odbc_api::{Environment, Connection};

fn main() -> Result<(), odbc_api::Error> {
    let env = Environment::new()?;
    // 示例：SQL Server连接字符串，驱动名称需匹配实际安装版本
    let conn_str = "DRIVER={ODBC Driver 18 for SQL Server};SERVER=localhost;DATABASE=testdb;UID=sa;PWD=your_password;Encrypt=yes";
    let _conn = env.connect_with_connection_string(conn_str)?;
    Ok(())
}

3. 排查连接失败原因 #

• 若仍无法连接，在代码中打印详细错误信息，odbc-api返回的错误会包含ODBC状态码和具体描述，可据此定位问题：

  match env.connect_with_connection_string(conn_str) {
      Ok(_) => println!("连接成功"),
      Err(e) => eprintln!("连接失败: {}", e),
  }
  

• 常见问题：驱动名称拼写错误、驱动与系统架构不匹配、数据库地址/端口错误、认证信息不正确。

内容的提问来源于stack exchange，提问作者Matthias Q