SuperAPI AI 工具集

cdata-cli-java

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能是 cdata-cli 的构建阶段补充。cdata-cli 负责用 JDBC 驱动做发现(连接、探索模式、验证 SQL),本技能在开始编写 JVM 应用代码时接手,复用同一个 CData JDBC 驱动。已验证的表、列和 SQL 可通过 JDBC 原样运行。

主要能力:驱动类为 cdata.jdbc.<source>.<Source>Driver,URL 前缀为 jdbc:<source>:,<source> 为小写驱动名,<Source> 为对应大小写形式。若发现阶段已激活 jar,应用无需再次激活。若创建了 OAuth 连接,应用的 JDBC URL 可指向同一缓存的 OAuthSettingsLocation 令牌文件,跳过重新认证。

必要用法:先决条件是本会话已用 cdata-cli 完成连接、模式发现与 SQL 验证,否则应先调用它。获取 jar 有三种方式:复用 CLI 已下载的 ./lib/cdata.jdbc.<source>.jar;使用已安装产品路径下 lib 中的 jar;或从 https://maven.cdata.com/p/jdbc/ 仓库以 Maven 坐标 groupId cdata、artifactId <source>-jdbc 引入,坐标需用 cdatacli drivers search --driver <source> 确认。授权可执行 cdatacli drivers activate <Driver> --name "First Last" --email you@example.com --trial 或加 --key XXXXX,授权文件需位于 jar 旁或 ~/.CData/ 目录。classpath 分隔符 Windows 为 ;,macOS/Linux 为 :。现代 JDBC 通过 ServiceLoader 自动注册驱动,通常无需 Class.forName。JDBC 对象可自动关闭,建议用 try-with-resources;SQL 可用 ? 位置参数,INSERT/UPDATE/DELETE 用 executeUpdate()。连接串应从配置而非硬编码读取,OAuth 客户端密钥从环境变量读取且不得提交。

适用场景:编写 Java、Kotlin、Scala 及其他 JVM 语言应用,通过 CData 驱动连接数据源。

限制:JDBC 驱动按机器授权,与 ADO.NET、ODBC、Python 版本分开。无内置 OAuth 应用的数据源需用户自备 OAuthClientId/OAuthClientSecret。常见问题包括找不到驱动(jar 未在 classpath 或 URL 前缀错误)、缺少有效许可证、类名拼写错误、需要 OAuth 客户端凭据等。购买密钥属于机密,应在 AI 会话之外运行。其他未在资料中说明的事项暂未提供。