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

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


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

可用选项如下：

Driver （必填）：与 ODBC 结合使用的驱动程序。

默认值为 AWS IoT SiteWise。
DSN：用于配置连接的数据来源名称（DSN）。

默认值为 NONE。
Auth：身份验证模式。其必须是以下内容之一：
- AWS_PROFILE：使用默认凭证链。
- IAM— 使用 AWS IAM 证书。
- AAD：使用 Azure Active Directory（AD）身份提供商。
- OKTA：使用 Okta 身份提供商。
默认值为 AWS_PROFILE。

EndpointOverride— AWS IoT SiteWise 服务的终端节点覆盖。这是用于覆盖区域的高级选项。例如：
```
iotsitewise.us-east-1.amazonaws.com
```
Region— AWS IoT SiteWise 服务终端节点的签名区域。

默认值为 us-east-1。

UID或 AccessKeyId- AWS 用户访问密钥 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。 AWS IoT SiteWise 在应用程序元数据中提供的entityID字段中可以找到应用程序 ID (AppId)。例如：
```
entityID="http://www.okta.com//(IdPAppID)
```
默认值为 NONE。
RoleARN：调用方所代入角色的 Amazon 资源名称（ARN）。

默认值为 NONE。
IdPARN：描述 IdP 的 IAM 中 SAML 提供商的 Amazon 资源名称（ARN）。

默认值为 NONE。

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

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

默认值为 1000。
MaxRetryCountClient：SDK 中可重试错误（错误代码为 5xx）的最大重试次数。值不得为负。

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

默认值为 25。

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

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

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

SDK 日志记录选项

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

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

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

通过代理进行连接

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

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

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

ODBC

连接字符串示例