ODBC 驱动程序的连接字符串语法和选项

为 ODBC 驱动程序指定连接字符串选项的语法如下：


Driver={Amazon IoT SiteWise ODBC Driver};(option)=(value);

可用选项如下：

Driver（必填）-与 ODBC 一起使用的驱动程序。

默认值为 Amazon IoT SiteWise。
DSN— 用于配置连接的数据源名称 (DSN)。

默认值为 NONE。
Auth— 身份验证模式。其必须是以下内容之一：
- Amazon_PROFILE— 使用默认凭证链。
- IAM— 使用 Amazon IAM 证书。
- AAD— 使用 Azure 活动目录 (AD) 身份提供商。
- OKTA— 使用 Okta 身份提供商。
默认值为 Amazon_PROFILE。

EndpointOverride— Amazon IoT SiteWise 服务的终端节点覆盖。这是一个高级选项，可以覆盖该区域。例如：
```
iotsitewise.us-east-1.amazonaws.com
```
Region— Amazon IoT SiteWise 服务终端节点的签名区域。

默认值为 us-east-1。

UID或 AccessKeyId- Amazon 用户访问密钥 ID。如果连接字符串中同时提供UID和，AccessKeyId则除非该UID值为空，否则将使用该值。

默认值为 NONE。
PWD或 SecretKey— AWS 用户私有访问密钥。如果连接字符串中同时提供PWD和，SecretKey则除非PWD值为空，否则将使用带的值。

默认值为 NONE。
SessionToken— 访问启用了多重身份验证 (MFA) 的数据库所需的临时会话令牌。请勿在输入 = 中包含尾随字符。

默认值为 NONE。

IdPHost— 指定 IdP 的主机名。

默认值为 NONE。
UID或 IdPUserName— 指定 IdP 账户的用户名。如果连接字符串中同时提供UID和，IdPUserName则除非该UID值为空，否则将使用该值。

默认值为 NONE。
PWD或 IdPPassword— 指定 IdP 帐户的密码。如果连接字符串中同时提供PWD和，IdPPassword则除非该PWD值为空，否则将使用该值。

默认值为 NONE。
OktaApplicationID— Okta 提供的与应用程序关联的唯一 ID。 Amazon IoT SiteWise 在应用程序元数据中提供的entityID字段中可以找到应用程序 ID (AppId)。一个例子是：
```
entityID="http://www.okta.com//(IdPAppID)
```
默认值为 NONE。
RoleARN— 调用者担任的角色的 Amazon 资源名称 (ARN)。

默认值为 NONE。
IdPARN— IAM 中描述 IdP 的 SAML 提供商的亚马逊资源名称 (ARN)。

默认值为 NONE。

RequestTimeout— Amazon SDK 在超时之前等待查询请求的时间（以毫秒为单位）。任何非正值都将禁用请求超时。

默认值为 3000。
ConnectionTimeout— Amazon SDK 在超时之前等待通过打开的连接传输数据的时间（以毫秒为单位）。值为 0 则禁用连接超时。此值不能为负数。

默认值为 1000。
MaxRetryCountClient— SDK 中错误代码为 5xx 的可重试错误的最大重试次数。该值不能为负数。

默认值为 0。
MaxConnections— 允许与该 Amazon IoT SiteWise 服务同时打开的 HTTP 连接的最大数量。该值必须为正数。

默认值为 25。

LogLevel— 驱动程序日志记录的日志级别。必须为以下值之一：
- 0（关闭）。
- 1（错误）。
- 2（警告）。
- 3（信息）。
- 4（调试）。
默认值为1（错误）。

警告：使用 DEBUG 日志模式时，驱动程序可能会记录个人信息。
LogOutput— 用于存储日志文件的文件夹。

默认值为：
- Windows:%USERPROFILE%，或者如果不可用，则为%HOMEDRIVE%%HOMEPATH%。
- macOS 和 Linux：$HOME如果不可用，则为函数getpwuid(getuid())返回pw_dir值中的字段。

SDK 日志记录选项

S Amazon DK 日志级别与 Amazon IoT SiteWise ODBC 驱动程序日志级别是分开的。设置其中一个不会影响另一个。

SDK 日志级别是使用环境变量设置的SW_AWS_LOG_LEVEL。有效值为：

如果未设置，SW_AWS_LOG_LEVEL则将 SDK 日志级别设置为默认值，即WARN。

通过代理连接

ODBC 驱动程序支持 Amazon IoT SiteWise 通过代理进行连接。要使用此功能，请根据您的代理设置配置以下环境变量：

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

ODBC

连接字符串示例