ODBC连接串
1.连接字符串格式
ODBC 驱动支持标准的连接字符串格式,下面是语法:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= identifier
attribute-value ::= character-string简单来说,ODBC 连接 URL 是一个字符串,其中包含逗号分割的参数。
2.支持的参数
ODBC 驱动支持多个连接字符串/DSN 参数,所有参数名都不区分大小写,即ADDRESS、Address和address都是有效的参数名,并且引用相同的参数。如果某个参数未指定,则会使用默认值。此规则的例外是ADDRESS属性,如果未指定,则改用SERVER和PORT属性。
| 属性关键字 | 描述 | 默认值 |
|---|---|---|
ADDRESS | 要连接的远端节点的地址,格式为<host>[:<port>],例如localhost、example.com:12345、127.0.0.1、192.168.3.80:5893。如果指定了此属性,则忽略SERVER和PORT参数。 | 无。 |
SERVER | 要连接的节点的地址,如果指定了 ADDRESS 参数,则忽略此参数。 | 无。 |
PORT | 节点的OdbcProcessor正在监听的端口,如果指定了ADDRESS参数,则忽略此参数。 | 10800 |
IDENTITY | 用于身份验证的标识符,根据服务端端使用的身份验证器,它可以是用户名或其他唯一标识符,具体请参见身份验证章节的内容。 | 无。 |
SECRET | 用于身份验证的密钥,根据服务端使用的身份验证器,它可以是用户密码或其他类型的用户特定密钥,具体请参见身份验证章节的内容。 | 无。 |
SCHEMA | 模式名。 | PUBLIC |
PAGE_SIZE | 对数据源的数据查询请求返回的行数,多数场景中默认值即可。设置较低值可能会导致数据获取缓慢,而设置高值则可能导致驱动占用更多的内存,并在检索下一页时产生额外的延迟。 | 1024 |
SSL_MODE | 确定是否应与服务器建立 SSL 连接。根据需要使用required或disable模式。 | disable |
SSL_KEY_FILE | 指定包含 SSL 服务端私钥的文件的路径。 | 无。 |
SSL_CERT_FILE | 指定包含 SSL 服务端证书的文件的路径。 | 无。 |
SSL_CA_FILE | 指定包含 SSL 服务端证书颁发机构(CA)的文件的路径。 | 无。 |
3.连接字符串示例
下面是连接字符串的示例,这些字符串可以与 ODBC SQLDriverConnect调用一起使用,以建立与节点的连接:
DRIVER={Apache Ignite 3};ADDRESS=localhost:10800;SCHEMA=yourSchemaNameDRIVER={Apache Ignite 3};ADDRESS=localhost:10800DRIVER={Apache Ignite 3};ADDRESS=localhost:10800;IDENTITY=yourid;SECRET=yoursecretDRIVER={Apache Ignite 3};ADDRESS=localhost:10800;SCHEMA=yourSchemaName;PAGE_SIZE=409618624049226
