

 从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# ODBC 驱动程序选项
<a name="odbc20-configuration-options"></a>

可以使用驱动程序配置选项来控制 Amazon Redshift ODBC 驱动程序的行为。驱动程序选项不区分大小写。

在 Microsoft Windows 中，您通常可以在配置数据来源名称 (DSN) 时设置驱动程序选项。您还能在以编程方式连接时，或者通过在 `HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\your_DSN` 中添加或更改注册表项来设置驱动程序选项。

在 Linux 中，可以在 `odbc.ini` 和 `amazon.redshiftodbc.ini` 文件中设置驱动程序配置选项。在 `amazon.redshiftodbc.ini` 文件中设置的配置选项适用于所有连接。相反，`odbc.ini` 文件中的设置配置选项特定于一个连接。在 `odbc.ini` 中设置的配置选项优先于在 `amazon.redshiftodbc.ini` 中设置的配置选项。

以下是您可以为 Amazon Redshift ODBC 版本 2.x 驱动程序指定的选项的说明：

## AccessKeyID
<a name="odbc20-accesskeyid-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 用户或角色的 IAM 访问密钥。如果您设置此参数，则还必须指定 **SecretAccessKey**。

此参数为可选的。

## app\$1id
<a name="odbc20-app-id-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

Okta 提供的与您的 Amazon Redshift 应用程序关联的唯一 ID。

此参数为可选的。

## ApplicationName
<a name="odbc20-application_name-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

传递给 Amazon Redshift 以供审计的客户端应用程序的名称。您提供的应用程序名称显示在 [SYS\$1CONNECTION\$1LOG](https://docs.aws.amazon.com/redshift/latest/dg/SYS_CONNECTION_LOG.html) 表的“application\$1name”列中。这有助于在调试问题时跟踪连接源并对其进行故障排除。

此参数为可选的。

## app\$1name
<a name="odbc20-app-name-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您用于验证与 Amazon Redshift 的连接的 Okta 应用程序的名称。

此参数为可选的。

## AuthProfile
<a name="odbc20-authprofile-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于管理连接设置的身份验证配置文件。如果您设置此参数，则还必须设置 **AccessKeyID** 和 **SecretAccessKey**。

此参数为可选的。

## AuthType
<a name="odbc20-authtype-option"></a>
+ **默认值**：标准
+ **数据类型** – 字符串

此选项指定在您使用“Amazon Redshift ODBC 驱动程序 DSN 设置”对话框配置 DSN 时驱动程序使用的身份验证模式：
+  标准：使用您的 Amazon Redshift 用户名和密码的标准身份验证。
+  AWS 配置文件：使用配置文件的 IAM 身份验证。
+  AWS IAM 凭证：使用 IAM 凭证的 IAM 身份验证。
+  身份提供者：AD FS：使用 Active Directory 联合身份验证服务（AD FS）的 IAM 身份验证。
+  身份提供者：身份验证插件：一种授权插件，可接受 AWS IAM Identity Center 令牌，或基于 OpenID Connect（OIDC）JSON 的身份令牌（JWT），该令牌由与 AWS IAM Identity Center 关联的任意 Web 身份提供者提供。
+  身份提供者：Azure AD：使用 Azure AD 门户的 IAM 身份验证。
+  身份提供者：JWT：使用 JSON Web 令牌（JWT）的 IAM 身份验证。
+  身份提供者：Okta：使用 Okta 的 IAM 身份验证。
+  身份提供者：PingFederate：使用 PingFederate 的 IAM 身份验证。

仅当您使用 Windows 驱动程序中的“Amazon Redshift ODBC 驱动程序 DSN 设置”对话框配置 DSN 时，此选项才可用。当您使用连接字符串或非 Windows 计算机配置连接时，驱动程序将根据您指定的凭证，自动确定是使用“标准”、“AWS 配置文件”还是“AWS IAM 凭证”身份验证。要使用身份提供者，您必须设置 **plugin\$1name** 属性。

此参数为必需参数。

## AutoCreate
<a name="odbc20-autocreate-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定当指定的用户不存在时驱动程序是否创建新用户。
+  1 \$1 TRUE：如果通过 **UID** 指定的用户不存在，则驱动程序将创建新用户。
+  0 \$1 FALSE：驱动程序不会创建新用户。如果指定的用户不存在，则身份验证将失败。

此参数为可选的。

## CaFile
<a name="odbc20-cafile-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于某些形式的 IAM 身份验证的 CA 证书文件的文件路径。

 此参数仅在 Linux 上可用。

此参数为可选的。

## client\$1id
<a name="odbc20-client-id-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

与 Azure AD 中的 Amazon Redshift 应用程序关联的客户端 ID。

如果通过 Azure AD 服务进行身份验证，则此参数是必需的。

## client\$1 secret
<a name="odbc20-client-secret-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 与 Azure AD 中的 Amazon Redshift 应用程序关联的秘密密钥。

如果通过 Azure AD 服务进行身份验证，则此参数是必需的。

## ClusterId
<a name="odbc20-clusterid-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您要连接到的 Amazon Redshift 集群的名称。它将在 IAM 身份验证中使用。集群 ID 不会在**服务器**参数中指定。

此参数为可选的。

## 压缩
<a name="odbc20-compression-option"></a>
+ **默认值** – 关闭
+ **数据类型** – 字符串

用于 Amazon Redshift 服务器与客户端或驱动程序之间线路协议通信的压缩方法。

可以指定以下值：
+ lz4：将用于与 Amazon Redshift 进行线路协议通信的压缩方法设置为 `lz4`。
+ zstd：将用于与 Amazon Redshift 进行线路协议通信的压缩方法设置为 `zstd`。
+  off：与 Amazon Redshift 进行线路协议通信时不使用压缩方法。

此参数为可选的。

## 数据库
<a name="odbc20-database-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您要访问的 Amazon Redshift 数据库的名称。

此参数为必需参数。

## DatabaseMetadataCurrentDbOnly
<a name="odbc20-database-metadata-option"></a>
+ **默认值**：1
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否从多个数据库和集群返回元数据。
+ 1 \$1 TRUE：驱动程序仅从当前数据库返回元数据。
+  0 \$1 FALSE。驱动程序将跨多个 Amazon Redshift 数据库和集群返回元数据。

此参数为可选的。

## dbgroups\$1filter
<a name="odbc20-dbgroups-filter-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

在使用 Azure、浏览器 Azure 和浏览器 SAML 身份验证类型时，您可以指定的正则表达式，用于筛选出从 Amazon Redshift 的 SAML 响应中收到的数据库组 (DbGroup)。

此参数为可选的。

## 驱动程序
<a name="odbc20-driver-option"></a>
+ **默认值**：Amazon Redshift ODBC 驱动程序 (x64)
+ **数据类型** – 字符串

驱动程序的名称。唯一受支持的值是 **Amazon Redshift ODBC 驱动程序(x64)**。

如果您未设置 **DSN**，则此参数是必需的。

## DSN
<a name="odbc20-dsn-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

驱动程序数据来源名称的名称。应用程序将在 SQLDriverConnect API 中指定 DSN。

如果您未设置**驱动程序**，则此参数是必需的。

## EndpointUrl
<a name="odbc20-endpointurl-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于与 Amazon Redshift Coral 服务通信以进行 IAM 身份验证的覆盖端点。

此参数为可选的。

## ForceLowercase
<a name="odbc20-forcelowercase-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定在使用单点登录身份验证时，驱动程序是否会将从身份提供者发送到 Amazon Redshift 的所有数据库组 (DbGroup) 小写。
+  1 \$1 TRUE：驱动程序会将从身份提供者发送的所有 DbGroup 转换为小写。
+  0 \$1 FALSE：驱动程序不会更改 DbGroup。

此参数为可选的。

## group\$1federation
<a name="odbc20-group-federation-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，指定 `getClusterCredentialsWithIAM` API 是否用于在预调配集群中获取临时集群凭证。此选项允许 IAM 用户在预调配集群中与 Redshift 数据库角色进行集成。请注意，此选项不适用于 Redshift Serverless 命名空间。
+  1 \$1 TRUE：驱动程序使用 `getClusterCredentialsWithIAM` API 来获取预调配集群中的临时集群凭证。
+  0 \$1 FALSE：驱动程序使用默认 `getClusterCredentials` API 来获取预调配集群中的临时集群凭证。

此参数为可选的。

## https\$1proxy\$1host
<a name="odbc20-https-proxy-host-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您要通过其来传递 IAM 身份验证过程的代理服务器的主机名或 IP 地址。

此参数为可选的。

## https\$1proxy\$1password
<a name="odbc20-https-proxy-password-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于访问代理服务器的密码。它将用于 IAM 身份验证。

此参数为可选的。

## https\$1proxy\$1port
<a name="odbc20-https-proxy-port-option"></a>
+ **默认值** – 无
+ **数据类型** – 整数

代理服务器用于侦听客户端连接的端口号。它将用于 IAM 身份验证。

此参数为可选的。

## https\$1proxy\$1username
<a name="odbc20-https-proxy-username-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于访问代理服务器的用户名。它用于 IAM 身份验证。

此参数为可选的。

## IAM
<a name="odbc20-iam-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否使用 IAM 身份验证方法对连接进行身份验证。
+  1 \$1 TRUE：驱动程序将使用某种 IAM 身份验证方法（使用访问密钥和秘密密钥对、配置文件或凭证服务）。
+  0 \$1 FALSE。驱动程序将使用标准身份验证（使用您的数据库用户名和密码）。

此参数为可选的。

## idc\$1client\$1display\$1name
<a name="odbc20-idc_client_display_name-option"></a>
+ **默认值** – Amazon Redshift ODBC 驱动程序
+ **数据类型** – 字符串

要用于使用 BrowserIdcAuthPlugin 的客户端的显示名称。

此参数为可选的。

## idc\$1region
<a name="odbc20-idc_region"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

AWS IAM Identity Center 实例所在的 AWS 区域。

只有在 plugin\$1name 配置选项中使用 `BrowserIdcAuthPlugin` 进行身份验证时，才需要此参数。

## idp\$1host
<a name="odbc20-idp-host-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您用于对 Amazon Redshift 进行身份验证的 IdP（身份提供者）主机。

此参数为可选的。

## idp\$1port
<a name="odbc20-idp-port-option"></a>
+ **默认值** – 无
+ **数据类型** – 整数

您用于对 Amazon Redshift 进行身份验证的 IdP（身份提供者）的端口。根据您在创建、修改或迁移集群时选择的端口，允许访问所选端口。

此参数为可选的。

## idp\$1response\$1timeout
<a name="odbc20-idp-response-timeout-option"></a>
+ **默认值** – 120
+ **数据类型** – 整数

当通过浏览器插件使用 SAML 或 Azure AD 服务时，驱动程序等待身份提供者发出 SAML 响应的秒数。

此参数为可选的。

## idp\$1tenant
<a name="odbc20-idp-tenant-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 与您的 Amazon Redshift 应用程序关联的 Azure AD 租户 ID。

如果通过 Azure AD 服务进行身份验证，则此参数是必需的。

## idp\$1partition
<a name="odbc20-idp-partition-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

指定在其中配置身份提供者（IdP）的云分区。这决定了驱动程序连接到哪个 IdP 身份验证端点。

如果将此参数留空，则驱动程序默认为商业分区。可能的值有：
+ `us-gov`：如果在 Azure Government 中配置了 IdP，请使用此值。例如，Azure AD Government 使用端点 `login.microsoftonline.us`。
+ `cn`：如果在中国云分区中配置了 IdP，请使用此值。例如，Azure AD China 使用 `login.chinacloudapi.cn` 端点。

此参数为可选的。

## idp\$1use\$1https\$1proxy
<a name="odbc20-idp-use-https-proxy-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否通过代理服务器传递身份提供者（IdP）的身份验证过程。
+  1 \$1 TRUE：驱动程序将通过代理服务器传递 IdP 身份验证过程。
+  0 \$1 FALSE。驱动程序不会通过代理服务器传递 IdP 身份验证过程。

此参数为可选的。

## InstanceProfile
<a name="odbc20-instanceprofile-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序在配置为使用配置文件进行身份验证时是否使用 Amazon EC2 实例配置文件。
+  1 \$1 TRUE：驱动程序将使用 Amazon EC2 实例配置文件。
+  0 \$1 FALSE。驱动程序将改用通过“配置文件名称”选项（**配置文件**）指定的串联角色配置文件。

此参数为可选的。

## issuer\$1url
<a name="odbc20-issuer_url"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 指向 AWS IAM Identity Center 服务器的实例端点。

只有在 plugin\$1name 配置选项中使用 `BrowserIdcAuthPlugin` 进行身份验证时，才需要此参数。

## KeepAlive
<a name="odbc20-keepalive-option"></a>
+ **默认值**：1
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否使用 TCP keepalive 来防止连接超时。
+  1 \$1 TRUE：驱动程序将使用 TCP keepalive 来防止连接超时。
+  0 \$1 FALSE。驱动程序不会使用 TCP keepalive。

此参数为可选的。

## KeepAliveCount
<a name="odbc20-keepalivecount-option"></a>
+ **默认值** - 0
+ **数据类型** – 整数

连接被视为断开前可能丢失的 TCP keepalive 包的数量。当此参数设置为 0 时，驱动程序将使用此设置的系统默认值。

此参数为可选的。

## KeepAliveInterval
<a name="odbc20-keepaliveinterval-option"></a>
+ **默认值** - 0
+ **数据类型** – 整数

两次传输 TCP keepalive 间隔的秒数。当此参数设置为 0 时，驱动程序将使用此设置的系统默认值。

此参数为可选的。

## KeepAliveTime
<a name="odbc20-keepalivetime-option"></a>
+ **默认值** - 0
+ **数据类型** – 整数

驱动程序发送 TCP Keepalive 包前处于不活动状态的秒数。当此参数设置为 0 时，驱动程序将使用此设置的系统默认值。

此参数为可选的。

## listen\$1port
<a name="odbc20-listen-port-option"></a>
+ **默认值**：7890
+ **数据类型** – 整数

通过浏览器插件使用 SAML、Azure AD 或 AWS IAM Identity Center 服务时，驱动程序用于接收来自身份提供者的 SAML 响应的端口。

此参数为可选的。

## login\$1url
<a name="odbc20-login-url-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

在使用通用浏览器 SAML 插件时，身份提供者网站上的资源的 URL。

如果通过浏览器插件使用 SAML 或 Azure AD 服务进行身份验证，则此参数是必需的。

## loginToRp
<a name="odbc20-logintorp-option"></a>
+ **默认值**：urn:amazon:webservices
+ **数据类型** – 字符串

要用于 AD FS 身份验证类型的信赖方信任。

此字符串为可选项。

## LogLevel
<a name="odbc20-loglevel-option"></a>
+ **默认值** - 0
+ **数据类型** – 整数

使用此属性可以启用或禁用驱动程序中的日志记录，并指定包含在日志中的详细信息量。我们建议您启用日志记录的时长仅足以捕获问题即可，因为日志记录会降低性能，并会占用大量磁盘空间。

 将该属性设置为以下值之一：
+  0：关闭。禁用所有日志记录。
+  1：错误。记录也许不会导致驱动程序中止运行但会生成错误的错误事件。
+  2：API\$1CALL。记录带有函数参数值的 ODBC API 函数调用。
+  3：信息。记录描述驱动程序进度的一般信息。
+  4：MSG\$1PROTOCOL。记录驱动程序消息协议的详细信息。
+  5：调试。记录所有驱动程序活动 
+  6：DEBUG\$1APPEND。保留所有驱动程序活动的附加日志。

启用日志记录后，驱动程序将在您在 **LogPath** 属性中指定的位置生成以下日志文件：
+  一个 `redshift_odbc.log.1` 文件，它将记录连接握手期间发生的驱动程序活动。
+  一个 `redshift_odbc.log` 文件，用于与数据库建立连接后的所有驱动程序活动。

此参数为可选的。

## LogPath
<a name="odbc20-logpath-option"></a>
+ **默认值**：特定于操作系统的 TEMP 目录
+ **数据类型** – 字符串

当 **LogLevel** 大于 0 时，驱动程序保存日志文件的文件夹的完整路径。

此参数为可选的。

## Min\$1TLS
<a name="odbc20-min-tls-option"></a>
+ **默认值** – 1.2
+ **数据类型** – 字符串

 驱动程序允许数据存储以用于对连接进行加密的 TLS/SSL 的最低版本。例如，如果指定了 TLS 1.2，则无法使用 TLS 1.1 对连接进行加密。

Min\$1TLS 接受以下值：
+  1.0：连接必须至少使用 TLS 1.0。
+  1.1：连接必须至少使用 TLS 1.1。
+  1.2：连接必须至少使用 TLS 1.2。

此参数为可选的。

## partner\$1spid
<a name="odbc20-partner-spid-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

在使用 PingFederate 服务验证连接时使用的合作伙伴 SPID（服务提供商 ID）值。

此参数为可选的。

## 密码\$1 PWS
<a name="odbc20-password-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

与您在“用户”字段（**UID** \$1 **用户**\$1 **LogonID**）中提供的数据库用户名相对应的密码。

此参数为可选的。

## plugin\$1name
<a name="odbc20-plugin-name-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

要用于身份验证的凭证提供程序插件名称。

 支持下列值：
+  `ADFS`：使用 Active Directory 联合身份验证服务进行身份验证。
+  `AzureAD`：使用 Microsoft Azure Active Directory (AD) 服务进行身份验证。
+  `BrowserAzureAD`：使用适用于 Microsoft Azure Active Directory (AD) 服务的浏览器插件进行身份验证。
+  `BrowserIdcAuthPlugin `：使用 AWS IAM Identity Center 的授权插件。
+  `BrowserSAML`：使用适用于 SAML 服务（如 Okta 或 Ping）的浏览器插件进行身份验证。
+  `IdpTokenAuthPlugin`：一种授权插件，可接受 AWS IAM Identity Center 令牌，或者基于 OpenID Connect（OIDC）JSON 的身份令牌（JWT），该令牌由与 AWS IAM Identity Center 关联的任意 Web 身份提供者提供。
+  `JWT`：使用 JSON Web 令牌 (JWT) 进行身份验证。
+  `Ping`：使用 PingFederate 服务进行身份验证。
+  `Okta`：使用 Okta 服务进行身份验证。

此参数为可选的。

## 端口 \$1 PortNumber
<a name="odbc20-port-option"></a>
+ **默认值**：5439
+ **数据类型** – 整数

Amazon Redshift 服务器用于侦听客户端连接的 TCP 端口号。

此参数为可选的。

## preferred\$1role
<a name="odbc20-preferred-role-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您希望在 Amazon Redshift 连接期间担任的角色。它将用于 IAM 身份验证。

此参数为可选的。

## 配置文件
<a name="odbc20-profile-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于在 Amazon Redshift 中进行身份验证的用户 AWS 配置文件的名称。
+  如果“使用实例配置文件”参数（**InstanceProfile** 属性）设置为 1 \$1 TRUE，则该设置将优先，驱动程序将改用 Amazon EC2 实例配置文件。
+  包含配置文件的凭证文件的默认位置为 `~/.aws/Credentials`。`AWS_SHARED_CREDENTIALS_FILE` 环境变量可用于指向其他凭证文件。

此参数为可选的。

## provider\$1name
<a name="odbc20-provider-name-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用户使用 CREATE IDENTITY PROVIDER 查询创建的身份验证提供程序。它将用于本机 Amazon Redshift 身份验证。

此参数为可选的。

## ProxyHost
<a name="odbc20-proxyhost-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

要通过其连接的代理服务器的主机名或 IP 地址。

此参数为可选的。

## ProxyPort
<a name="odbc20-proxyport-option"></a>
+ **默认值** – 无
+ **数据类型** – 整数

代理服务器用于侦听客户端连接的端口号。

此参数为可选的。

## ProxyPwd
<a name="odbc20-proxypwd-option"></a>
+ **默认 ValPrevious ODBC 驱动程序版本**：无
+ **数据类型** – 字符串

用于访问代理服务器的密码。

此参数为可选的。

## ProxyUid
<a name="odbc20-proxyuid-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于访问代理服务器的用户名。

此参数为可选的。

## ReadOnly
<a name="odbc20-readonly-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否处于只读模式。
+  1 \$1 TRUE：连接处于只读模式，无法写入数据存储。
+  0 \$1 FALSE：连接不处于只读模式，可以写入数据存储。

此参数为可选的。

## region
<a name="odbc20-region-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

您的集群所在的 AWS 区域。

此参数为可选的。

## SecretAccessKey
<a name="odbc20-secretaccesskey-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 用户或角色的 IAM 秘密密钥。如果您设置此参数，则还必须设置 **AccessKeyID**。

此参数为可选的。

## SessionToken
<a name="odbc20-sessiontoken-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

 与您用于身份验证的 IAM 角色关联的临时 IAM 会话令牌。

此参数为可选的。

## 服务器 \$1 HostName \$1 主机
<a name="odbc20-server-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

要连接到的端点服务器。

此参数为必需参数。

## ssl\$1insecure
<a name="odbc20-ssl-insecure-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是否检查 IdP 服务器证书的真实性。
+  1 \$1 TRUE：驱动程序不检查 IdP 服务器证书的真实性。
+  0 \$1 FALSE：驱动程序检查 IdP 服务器证书的真实性 

此参数为可选的。

## SSLMode
<a name="odbc20-sslmode-option"></a>
+ **默认值** – `verify-ca`
+ **数据类型** – 字符串

在连接到 Amazon Redshift 时要使用的 SSL 证书验证模式。以下是可能的值：
+  `verify-full`：仅使用 SSL、受信任的证书颁发机构和与证书匹配的服务器名称进行连接。
+  `verify-ca`：仅使用 SSL 和受信任的证书颁发机构进行连接。
+  `require`：仅使用 SSL 进行连接。
+  `prefer`：使用 SSL 进行连接（如果可用）。否则，将在不使用 SSL 的情况下进行连接。
+  `allow`：默认情况下，不使用 SSL 进行连接。如果服务器需要 SSL 连接，则使用 SSL。
+  `disable`：不使用 SSL 进行连接。

此参数为可选的。

## StsConnectionTimeout
<a name="odbc20-stsconnectiontimeout-option"></a>
+ **默认值** - 0
+ **数据类型** – 整数

IAM 连接的最长等待时间（以秒为单位）。如果设置为 0 或未指定，驱动程序将为每次 AWS STS 调用等待 60 秒。

此参数为可选的。

## StsEndpointUrl
<a name="odbc20-stsendpointurl-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

此选项指定用于与 AWS Security Token Service (AWS STS) 通信的覆盖端点。

此参数为可选的。

## 令牌
<a name="jdbc20-token-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

AWS IAM Identity Center 提供的访问令牌，或 OpenID Connect（OIDC）JSON Web 令牌（JWT，JSON Web Token），该令牌由与 AWS IAM Identity Center 关联的 Web 身份提供者提供。您的应用程序必须通过 AWS IAM Identity Center 或与 AWS IAM Identity Center 关联的身份提供者，对您的应用程序用户进行身份验证，从而生成此令牌。

此参数可用于 `IdpTokenAuthPlugin`。

## token\$1type
<a name="jdbc20-token-type-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

`IdpTokenAuthPlugin` 中使用的令牌类型。

可以指定以下值：

**ACCESS\$1TOKEN**  
如果您使用 AWS IAM Identity Center 提供的访问令牌，请输入此项。

**EXT\$1JWT**  
如果您使用 OpenID Connect（OIDC）JSON Web 令牌（JWT）（该令牌由与 AWS IAM Identity Center 集成的基于 Web 的身份提供者提供），请输入此项。

此参数可用于 `IdpTokenAuthPlugin`。

## UID \$1 用户 \$1 LogonID
<a name="odbc20-uid-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

用于访问 Amazon Redshift 服务器的用户名。

如果使用数据库身份验证，则此参数是必需项。

## UseUnicode
<a name="odbc20-useunicode-option"></a>
+ **默认值** - 0
+ **数据类型** – Boolean

一个布尔值，用于指定驱动程序是以 Unicode 还是常规 SQL 类型返回 Redshift 数据。
+  1 \$1 TRUE：驱动程序返回字符数据类型的宽 SQL 类型。
  + 返回 SQL\$1WCHAR 而不是 SQL\$1CHAR。
  + 返回 SQL\$1WVARCHAR 而不是 SQL\$1VARCHAR。
  + 返回 SQL\$1WLONGVARCHAR 而不是 SQL\$1LONGVARCHAR。
+  0 \$1 FALSE：驱动程序返回字符数据类型的正常 SQL 类型。
  + 返回 SQL\$1CHAR 而不是 SQL\$1WCHAR。
  + 返回 SQL\$1VARCHAR 而不是 SQL\$1WVARCHAR。
  + 返回 SQL\$1LONGVARCHAR 而不是 SQL\$1WLONGVARCHAR。

此参数为可选的。它在驱动程序版本 2.1.15 和更高版本中可用。

## web\$1identity\$1token
<a name="odbc20-web-identity-token-option"></a>
+ **默认值** – 无
+ **数据类型** – 字符串

身份提供者提供的 OAUTH 令牌。它将在 JWT 插件中使用。

如果您将 **plugin\$1name** 参数设置为 BasicJwtCredentialsProvider，则此参数是必需项。