从补丁 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/)。 # JDBC 驱动程序版本 2.x 配置的选项 下面，您可以找到您可以为 Amazon Redshift JDBC 驱动程序 2.2 版本指定的选项的说明。配置选项不区分大小写。 您可以使用连接 URL 设置配置属性。有关更多信息，请参阅 [构建连接 URL](jdbc20-build-connection-url.md)。 **Topics** + [AccessKeyID](#jdbc20-accesskeyid-option) + [AllowDBUserOverride](#jdbc20-allowdbuseroverride-option) + [App\$1ID](#jdbc20-app-id-option) + [App\$1Name](#jdbc20-app-name-option) + [ApplicationName](#jdbc20-applicationname-option) + [AuthProfile](#jdbc20-authprofile-option) + [AutoCreate](#jdbc20-autocreate-option) + [Client\$1ID](#jdbc20-client_id-option) + [Client\$1Secret](#jdbc20-client_secret-option) + [ClusterID](#jdbc20-clusterid-option) + [压缩](#jdbc20-compression-option) + [connectTimeout](#jdbc20-connecttimeout-option) + [connectionTimezone](#jdbc20-connecttimezone-option) + [databaseMetadataCurrentDbOnly](#jdbc20-databasemetadatacurrentdbonly-option) + [DbUser](#jdbc20-dbuser-option) + [DbGroups](#jdbc20-dbgroups-option) + [DBNAME](#jdbc20-dbname-option) + [defaultRowFetchSize](#jdbc20-defaultrowfetchsize-option) + [DisableIsValidQuery](#jdbc20-disableisvalidquery-option) + [enableFetchRingBuffer](#jdbc20-enablefetchringbuffer-option) + [enableMultiSqlSupport](#jdbc20-enablemultisqlsupport-option) + [fetchRingBufferSize](#jdbc20-fetchringbuffersize-option) + [ForceLlowcase](#jdbc20-forcelowercase-option) + [groupFederation](#jdbc20-groupFederation-option) + [HOST](#jdbc20-host-option) + [IAMDisableCache](#jdbc20-iamdisablecache-option) + [IAMDuration](#jdbc20-iamduration-option) + [Idc\$1Client\$1Display\$1Name](#jdbc20-idc_client_display_name) + [Idc\$1Region](#jdbc20-idc_region) + [IdP\$1Host](#jdbc20-idp_host-option) + [IdP\$1Partition](#jdbc20-idp_partition-option) + [IdP\$1Port](#jdbc20-idp_port-option) + [IdP\$1Tenant](#jdbc20-idp_tenant-option) + [IdP\$1Response\$1Timeout](#jdbc20-idp_response_timeout-option) + [IniFile](#jdbc20-inifile-option) + [IniSection](#jdbc20-inisection-option) + [isServerless](#jdbc20-isserverless-option) + [Issuer\$1Url](#jdbc20-issuer-url) + [Listen\$1Port](#jdbc20-listen-port) + [Login\$1URL](#jdbc20-login_url-option) + [loginTimeout](#jdbc20-logintimeout-option) + [loginToRp](#jdbc20-logintorp-option) + [LogLevel](#jdbc20-loglevel-option) + [LogPath](#jdbc20-logpath-option) + [OverrideSchemaPatternType](#jdbc20-override-schema-pattern-type) + [Partner\$1SPID](#jdbc20-partner_spid-option) + [密码](#jdbc20-password-option) + [Plugin\$1Name](#jdbc20-plugin_name-option) + [PORT](#jdbc20-port-option) + [Preferred\$1Role](#jdbc20-preferred_role-option) + [配置文件](#jdbc20-profile-option) + [PWD](#jdbc20-pwd-option) + [queryGroup](#jdbc20-querygroup-option) + [readOnly](#jdbc20-readonly-option) + [Region](#jdbc20-region-option) + [reWriteBatchedInserts](#jdbc20-rewritebatchedinserts-option) + [reWriteBatchedInsertsSize](#jdbc20-rewritebatchedinsertssize-option) + [roleArn](#jdbc20-rolearn-option) + [roleSessionName](#jdbc20-roleaessionname-option) + [范围](#jdbc20-scope-option) + [SecretAccessKey](#jdbc20-secretaccesskey-option) + [SessionToken](#jdbc20-sessiontoken-option) + [serverlessAcctId](#jdbc20-serverlessacctid-option) + [serverlessWorkGroup](#jdbc20-serverlessworkgroup-option) + [socketFactory](#jdbc20-socketfactory-option) + [socketTimeout](#jdbc20-sockettimeout-option) + [SSL](#jdbc20-ssl-option) + [SSL\$1Insecure](#jdbc20-ssl_insecure-option) + [SSLCert](#jdbc20-sslcert-option) + [SSLFactory](#jdbc20-sslfactory-option) + [SSLKey](#jdbc20-sslkey-option) + [SSLMode](#jdbc20-sslmode-option) + [SSLPassword](#jdbc20-sslpassword-option) + [SSLRootCert](#jdbc20-sslrootcert-option) + [StsEndpointUrl](#jdbc20-stsendpointurl-option) + [tcpKeepAlive](#jdbc20-tcpkeepalive-option) + [令牌](#jdbc20-token-option) + [token\$1type](#jdbc20-token-type-option) + [UID](#jdbc20-uid-option) + [用户](#jdbc20-user-option) + [webIdentityToken](#jdbc20-webidentitytoken-option) ## AccessKeyID + **默认值** – 无 + **数据类型** – 字符串 您可以指定此参数以输入用户或角色的 IAM 访问密钥。您通常可以通过查看现有的字符串或用户配置文件来查找密钥。如果您指定此参数，还必须指定 `SecretAccessKey` 参数。如果在 JDBC URL 中传递，则 AccessKeyID 必须采用 URL 编码。 此参数为可选的。 ## AllowDBUserOverride + **默认值** - 0 + **数据类型** – 字符串 此选项指定驱动程序是使用 SAML 断言中的 `DbUser` 值，还是连接 URL 的 `DbUser` 连接属性中指定的值。 此参数为可选的。 **1** 驱动程序使用 SAML 断言中的 `DbUser` 值。 如果 SAML 断言没有为 `DBUser` 指定值，则驱动程序将使用 `DBUser` 连接属性中指定的值。如果连接属性也没有指定值，则驱动程序将使用连接配置文件中指定的值。 **0** 驱动程序使用 `DBUser` 连接属性中指定的 `DBUser` 值。 如果 `DBUser` 连接属性没有指定值，则驱动程序将使用连接配置文件中指定的值。如果连接配置文件也没有指定值，则驱动程序将使用 SAML 断言中的值。 ## App\$1ID + **默认值** – 无 + **数据类型** – 字符串 Okta 提供的与您的 Amazon Redshift 应用程序关联的唯一 ID。 如果通过 Okta 服务进行身份验证，则此参数是必需的。 ## App\$1Name + **默认值** – 无 + **数据类型** – 字符串 您用于验证与 Amazon Redshift 的连接的 Okta 应用程序的名称。 此参数为可选的。 ## ApplicationName + **默认值** – null + **数据类型** – 字符串 传递给 Amazon Redshift 以供审计的应用程序的名称。 此参数为可选的。 ## AuthProfile + **默认值** – 无 + **数据类型** – 字符串 用于连接到 Amazon Redshift 的身份验证配置文件的名称。 此参数为可选的。 ## AutoCreate + **默认值** – false + **数据类型** – Boolean 此选项指定在指定用户不存在时驱动程序是否导致新用户被创建。 此参数为可选的。 **true** 如果通过 `DBUser` 或唯一 ID (UID) 指定的用户不存在，则会创建具有该名称的新用户。 **false** 驱动程序不会导致新用户被创建。如果指定的用户不存在，则身份验证将失败。 ## Client\$1ID + **默认值** – 无 + **数据类型** – 字符串 使用 Azure AD 服务对连接进行身份验证时使用的客户端 ID。 如果通过 Azure AD 服务进行身份验证，则此参数是必需的。 ## Client\$1Secret + **默认值** – 无 + **数据类型** – 字符串 使用 Azure AD 服务对连接进行身份验证时使用的客户端密钥。 如果通过 Azure AD 服务进行身份验证，则此参数是必需的。 ## ClusterID + **默认值** – 无 + **数据类型** – 字符串 要连接到的 Amazon Redshift 集群的名称。驱动程序将尝试从给定主机中检测此参数。如果您使用的是网络负载均衡器 (NLB) 并通过 IAM 进行连接，驱动程序将无法检测到它，因此您可以使用此连接选项进行设置。 此参数为可选的。 ## 压缩 + **默认值** – 关闭 + **数据类型** – 字符串 用于 Amazon Redshift 服务器与客户端或驱动程序之间线路协议通信的压缩方法。 此参数为可选的。 可以指定以下值： + **lz4** 将用于与 Amazon Redshift 通信的线路协议通信的压缩方法设置为 lz4。 + **off** 与 Amazon Redshift 通信的线路协议通信不使用压缩。 ## connectTimeout + **默认值** – 10 + **数据类型** – 整数 用于套接字连接操作的超时值。如果建立 Amazon Redshift 连接所需的时间超过此值，则系统将该连接视为不可用。超时以秒为单位指定。值为 0 表示未指定超时。 此参数为可选的。 ## connectionTimezone + **默认值** – LOCAL + **数据类型** – 字符串 会话级别的时区。 此参数为可选的。 可以指定以下值： **LOCAL** 将会话级别的时区配置为 LOCAL JVM 时区。 **SERVER** 将会话级别的时区配置为在 Amazon Redshift 服务器上为用户设置的时区。您可以使用以下命令为用户配置会话级别的时区： ``` ALTER USER [...] SET TIMEZONE TO [...]; ``` ## databaseMetadataCurrentDbOnly + **默认值** – true + **数据类型** – Boolean 此选项指定元数据 API 是从所有可访问的数据库中检索数据，还是仅从连接的数据库检索数据。 此参数为可选的。 可以指定以下值： **true** 应用程序从单个数据库中检索元数据。 **false** 应用程序从所有可访问的数据库中检索元数据。 ## DbUser + **默认值** – 无 + **数据类型** – 字符串 用于您的 Amazon Redshift 账户的用户 ID。如果您启用了 AutoCreate 属性，则可以使用当前不存在的 ID。 此参数为可选的。 ## DbGroups + **默认值** – PUBLIC + **数据类型** – 字符串 `DBUser` 为当前会话加入的现有数据库组名称的逗号分隔列表。 此参数为可选的。 ## DBNAME + **默认值** – null + **数据类型** – 字符串 要连接的数据库的名称。您可以使用此选项在 JDBC 连接 URL 中指定数据库名称。 此参数为必需参数。您必须在连接 URL 或客户端应用程序的连接属性中指定数据库名称。 ## defaultRowFetchSize + **默认值** - 0 + **数据类型** – 整数 此选项可指定 getFetchSize 的默认值。 此参数为可选的。 可以指定以下值： **0** 在单一操作中取回所有行。 **正整数** 对于 ResultSet 的每次取回迭代，要从数据库中取回的行数。 ## DisableIsValidQuery + **默认值** – False + **数据类型** – Boolean 此选项指定驱动程序在使用 Connection.isValid() 方法来确定数据库连接是否处于活动状态时是否提交新的数据库查询。 此参数为可选的。 **true** 驱动程序在使用 Connection.isValid() 方法来确定数据库连接是否处于活动状态时不提交查询。如果数据库服务器意外关闭，这可能会导致驱动程序错误地将数据库连接标识为活动状态。 **false** 驱动程序在使用 Connection.isValid() 方法来确定数据库连接是否处于活动状态时提交查询。 ## enableFetchRingBuffer + **默认值** – true + **数据类型** – Boolean 此选项指定驱动程序使用单独线程上的环形缓冲区取回行。fetchRingBufferSize 参数指定环形缓冲区的大小。 环形缓冲区在 JDBC 中实施自动内存管理，以防止在数据检索操作期间出现内存不足（OOM）错误。环形缓冲区实时监控缓冲数据的实际大小，确保驱动程序占用的内存总量不超过定义的限制。当缓冲区达到容量上限时，驱动程序会暂停数据提取操作，无需人工干预即可防止内存溢出。这项内置保护措施可以自动消除 OOM 错误，用户无需进行任何配置。 如果事务检测到包含多个 SQL 命令（以分号分隔）的语句，则该事务的提取环形缓冲区将设置为 false。enableFetchRingBuffer 的值不变。 此参数为可选的。 **注意** 当禁用环形缓冲区且提取大小配置不当时，可能会出现内存不足（OOM）问题。有关配置提取大小的更多信息，请参阅[此处](https://docs.aws.amazon.com/redshift/latest/dg/set-the-JDBC-fetch-size-parameter.html)。 ## enableMultiSqlSupport + **默认值** – true + **数据类型** – Boolean 此选项指定是否处理语句中以分号分隔的多个 SQL 命令。 此参数为可选的。 可以指定以下值： **true** 驱动程序处理语句对象中多个用分号分隔的 SQL 命令。 **false** 驱动程序为单个语句中的多个 SQL 命令返回错误。 ## fetchRingBufferSize + **默认值** – 1G + **数据类型** – 字符串 此选项指定在取回结果集时使用的环形缓冲区的大小。您可以指定以字节为单位的大小，例如 1K 表示 1 KB，5000 代表 5000 字节，1M 表示 1 MB，1G 表示 1 GB，依此类推。您还可以指定堆内存的百分比。驱动程序在达到限制时停止取回行。当应用程序读取行并释放环形缓冲区中的空间时，取回将恢复。 此参数为可选的。 ## ForceLlowcase + **默认值** – false + **数据类型** – Boolean 此选项指定在使用单点登录身份验证时，驱动程序是否会将从身份提供者发送到 Amazon Redshift 的所有数据库组 (DbGroup) 设为小写。 此参数为可选的。 **true** 驱动程序会小写从身份提供者发送的所有数据库组。 **false** 驱动程序不会更改数据库组。 ## groupFederation + **默认值** – false + **数据类型** – Boolean 此选项指定是否使用 Amazon Redshift IDP 组。此选项由 GetClusterCredentialsV2 API 支持。 此参数为可选的。 **true** 使用 Amazon Redshift 身份提供者 (IDP) 组。 **false** 使用 STS API 和 GetClusterCredentials 进行用户联合身份验证，并明确指定用于连接的 DbGroups。 ## HOST + **默认值** – null + **数据类型** – 字符串 要连接到 Amazon Redshift 服务器的主机名。您可以使用此选项在 JDBC 连接 URL 中指定主机名。 此参数为必需参数。您必须在连接 URL 或客户端应用程序的连接属性中指定主机名。 ## IAMDisableCache + **默认值** – false + **数据类型** – Boolean 此选项指定是否缓存 IAM 凭证。 此参数为可选的。 **true** IAM 凭证不会被缓存。 **false** IAM 凭证将被缓存。例如，当对 API 网关的请求受到限制时，这会提高性能。 ## IAMDuration + **默认值** – 900 + **数据类型** – 整数 临时 IAM 凭证过期之前的时间长度（以秒为单位）。 + **最小值** – 900 + **最大值 **– 3,600 此参数为可选的。 ## Idc\$1Client\$1Display\$1Name + **默认值** – Amazon Redshift JDBC 驱动程序 + **数据类型** – 字符串 要用于使用 BrowserIdcAuthPlugin 的客户端的显示名称。 此参数为可选的。 ## Idc\$1Region + **默认值** – 无 + **数据类型** – 字符串 IAM Identity Center 实例所在的 AWS 区域。 只有在 plugin\$1name 配置选项中使用 `BrowserIdcAuthPlugin` 进行身份验证时，才需要此参数。 ## IdP\$1Host + **默认值** – 无 + **数据类型** – 字符串 您用于对 Amazon Redshift 进行身份验证的 IdP（身份提供者）主机。该选项可以在连接字符串或配置文件中指定。 此参数为可选的。 ## IdP\$1Partition + **默认值** – 无 + **数据类型** – 字符串 指定在其中配置身份提供者（IdP）的云分区。这决定了驱动程序连接到哪个 IdP 身份验证端点。 如果将此参数留空，则驱动程序默认为商业分区。可能的值有： + `us-gov`：如果在 Azure Government 中配置了 IdP，请使用此值。例如，Azure AD Government 使用端点 `login.microsoftonline.us`。 + `cn`：如果在中国云分区中配置了 IdP，请使用此值。例如，Azure AD China 使用 `login.chinacloudapi.cn` 端点。 此参数为可选的。 ## IdP\$1Port + **默认值** – 无 + **数据类型** – 字符串 IdP（身份提供者）使用的端口。您可以在连接字符串或配置文件中指定端口。默认端口为 5439。根据您在创建、修改或迁移集群时选择的端口，允许访问所选端口。 此参数为可选的。 ## IdP\$1Tenant + **默认值** – 无 + **数据类型** – 字符串 适用于您的 Amazon Redshift 应用程序的 Azure AD 租户 ID。 如果通过 Azure AD 服务进行身份验证，则此参数是必需的。 ## IdP\$1Response\$1Timeout + **默认值** – 120 + **数据类型** – 整数 当通过浏览器插件使用 SAML 或 Azure AD 服务时，驱动程序等待身份提供者发出 SAML 响应的时间（以秒为单位）。 此参数为可选的。 ## IniFile + **默认值** – 无 + **数据类型** – 字符串 .ini 文件的完整路径，包括文件名。例如： ``` IniFile="C:\tools\rsjdbc.ini" ``` 有关 .ini 文件的信息，请参阅[为 JDBC 驱动程序版本 2.x 创建初始化 (.ini) 文件](jdbc20-ini-file.md)。 此参数为可选的。 ## IniSection + **默认值** – 无 + **数据类型** – 字符串 .ini 文件中包含配置选项的部分的名称。有关 .ini 文件的信息，请参阅[为 JDBC 驱动程序版本 2.x 创建初始化 (.ini) 文件](jdbc20-ini-file.md)。 以下示例指定 .ini 文件的 [Prod] 部分： ``` IniSection="Prod" ``` 此参数为可选的。 ## isServerless + **默认值** – false + **数据类型** – Boolean 此选项指定 Amazon Redshift 端点主机是否为无服务器实例。驱动程序将尝试从给定主机中检测此参数。如果您使用的是网络负载均衡器 (NLB)，则驱动程序将无法检测到它，因此您可以在此处对其进行设置。 此参数为可选的。 **true** Amazon Redshift 端点主机是一个无服务器实例。 **false** Amazon Redshift 端点主机是一个预置集群。 ## Issuer\$1Url + **默认值** – 无 + **数据类型** – 字符串 指向 AWS IAM Identity Center 服务器的实例端点。 只有在 plugin\$1name 配置选项中使用 `BrowserIdcAuthPlugin` 进行身份验证时，才需要此参数。 ## Listen\$1Port + **默认值**：7890 + **数据类型** – 整数 通过浏览器插件使用 SAML、Azure AD 或 AWS Identity Center 服务时，驱动程序用于接收来自身份提供者的 SAML 响应或授权代吗的端口。 此参数为可选的。 ## Login\$1URL + **默认值** – 无 + **数据类型** – 字符串 通过浏览器插件使用 SAML 或 Azure AD 服务时，身份提供者网站上的资源 URL。 如果通过浏览器插件使用 SAML 或 Azure AD 服务进行身份验证，则此参数是必需的。 ## loginTimeout + **默认值** - 0 + **数据类型** – 整数 连接服务器并对服务器进行身份验证时发生超时前等待的秒数。如果建立连接的用时长于此阈值，则连接将被中止。 当此属性设置为 0 时，连接不会发生超时。 此参数为可选的。 ## loginToRp + **默认值** – `urn:amazon:webservices` + **数据类型** – 字符串 要用于 AD FS 身份验证类型的信赖方信任。 此参数为可选的。 ## LogLevel + **默认值** - 0 + **数据类型** – 整数 使用此属性可以打开或关闭驱动程序中的日志记录并指定包含在日志文件中的详细信息量。 只有启用足够长的日志记录才能捕获问题。日志记录会降低性能，并会占用大量磁盘空间。 此参数为可选的。 将参数设置为以下值之一： **0** 禁用所有日志记录。 **1** 启用 FATAL 级别的日志记录，该级别日志记录将记录导致驱动程序中止的非常严重错误事件。 **2** 启用 ERROR 级别的日志记录，该级别日志记录将记录可能仍然允许驱动程序继续运行的错误事件。 **3** 启用 WARNING 级别的日志记录，该级别日志记录将记录在未执行操作时可能导致错误的事件。 **4** 启用 INFO 级别的日志记录，该级别日志记录将记录描述驱动程序进程的一般信息。 **5** 启用 DEBUG 级别的日志记录，该级别日志记录将记录对调试驱动程序很有用的详细信息。 **6** 启用 TRACE 级别的日志记录，该级别日志记录将记录所有驱动程序活动。 启用日志记录后，驱动程序会在 `LogPath` 属性指定的位置生成以下日志文件： + **`redshift_jdbc.log`**：记录不特定于连接的驱动程序活动的文件。 + **`redshift_jdbc_connection_[Number].log`** – 与数据库建立的每个连接的文件，其中 `[Number]` 是区分每个日志文件和其他日志文件的数字。此文件记录特定于连接的驱动程序活动。 如果 LogPath 值无效，则驱动程序将记录的信息发送到标准输出流 `System.out`。 ## LogPath + **默认值** – 当前工作目录。 + **数据类型** – 字符串 启用 DSILogLevel 属性时驱动程序保存日志文件所在的文件夹的完整路径。 为了确保连接 URL 与所有 JDBC 应用程序兼容，我们建议您通过键入另一个反斜杠来转义文件路径中的反斜杠 (\$1)。 此参数为可选的。 ## OverrideSchemaPatternType + **默认值** – null + **数据类型** – 整数 此选项指定是否覆盖在 getTables 调用中使用的查询类型。 **0** 无模式通用查询 **1** 本地模式查询 **2** 外部模式查询 此参数为可选的。 ## Partner\$1SPID + **默认值** – 无 + **数据类型** – 字符串 在使用 PingFederate 服务验证连接时使用的合作伙伴 SPID（服务提供商 ID）值。 此参数为可选的。 ## 密码 + **默认值** – 无 + **数据类型** – 字符串 使用 IAM 身份验证通过 IDP 进行连接时，它是 IDP\$1Host 服务器的密码。使用标准身份验证时，它可用于 Amazon Redshift 数据库密码，而不是 PWD。 此参数为可选的。 ## Plugin\$1Name + **默认值** – 无 + **数据类型** – 字符串 实施特定凭证提供程序插件的完全限定类名称。 此参数为可选的。 以下提供程序选项受支持： + **`AdfsCredentialsProvider`** – Active Directory 联合身份验证服务。 + **`AzureCredentialsProvider`** – Microsoft Azure Active Directory（AD）服务。 + **`BasicJwtCredentialsProvider`** – JSON Web Token（JWT）服务。 + **`BasicSamlCredentialsProvider`** – 您可以与许多 SAML 服务提供商一起使用的安全断言标记语言（SAML）凭据。 + **`BrowserAzureCredentialsProvider`** – 浏览器 Microsoft Azure Active Directory（AD）服务。 + ** `BrowserAzureOAuth2CredentialsProvider` **–用于本机身份验证的浏览器 Microsoft Azure Active Directory（AD）服务。 + **`BrowserIdcAuthPlugin`** – 使用 AWS IAM Identity Center 的授权插件。 + **`BrowserSamlCredentialsProvider`** – 用于 SAML 服务（如 Okta、Ping 或 ADFS）的浏览器 SAML。 + **`IdpTokenAuthPlugin`** – 一种授权插件，可接受 AWS IAM Identity Center 令牌，或者基于 OpenID Connect（OIDC）JSON 的身份令牌（JWT），该令牌由与 AWS IAM Identity Center 关联的任意 Web 身份提供者提供。 + **`OktaCredentialsProvider`** – Okta 服务。 + **`PingCredentialsProvider`** – PingFederate 服务。 ## PORT + **默认值** – null + **数据类型** – 整数 要连接到 Amazon Redshift 服务器的端口。您可以使用此选项在 JDBC 连接 URL 中指定端口。 此参数为可选的。 ## Preferred\$1Role + **默认值** – 无 + **数据类型** – 字符串 您希望在 Amazon Redshift 连接期间代入的 IAM 角色。 此参数为可选的。 ## 配置文件 + **默认值** – 无 + **数据类型** – 字符串 用于 IAM 身份验证的配置文件的名称。此配置文件包含未在连接字符串中指定的任何其他连接属性。 此参数为可选的。 ## PWD + **默认值** – 无 + **数据类型** – 字符串 与您使用属性 UID 提供的 Amazon Redshift 用户名相对应的密码。 此参数为可选的。 ## queryGroup + **默认值** – null + **数据类型** – 字符串 此选项通过将查询分配到相应的查询组在运行时向队列分配查询。将为会话设置查询组。在连接上运行的所有查询都属于此查询组。 此参数为可选的。 ## readOnly + **默认值** – false + **数据类型** – Boolean 此属性指定驱动程序是否处于只读模式。 此参数为可选的。 **true** 连接处于只读模式，无法写入数据存储。 **false** 连接不处于只读模式，可以写入数据存储。 ## Region + **默认值** – null + **数据类型** – 字符串 此选项指定集群所在的 AWS 区域。如果指定 StsEndPoint 选项，则会忽略“区域”选项。Redshift `GetClusterCredentials` API 操作也使用“区域”选项。 此参数为可选的。 ## reWriteBatchedInserts + **默认值** – false + **数据类型** – Boolean 通过此选项，可以优化批处理的兼容 INSERT 语句的重写和合并。 此参数为可选的。 ## reWriteBatchedInsertsSize + **默认值** – 128 + **数据类型** – 整数 通过此选项，可以优化批处理的兼容 INSERT 语句的重写和合并。此值必须以 2 为幂呈指数增加。 此参数为可选的。 ## roleArn + **默认值** – 无 + **数据类型** – 字符串 角色的 Amazon 资源名称（ARN）。在为 Plugin\$1Name 选项指定 BasicJwtCredentialsProvider 时，请确保指定此参数。采用以下格式指定 ARN： `arn:partition:service:region:account-id:resource-id` 如果您为 Plugin\$1Name 选项指定 BasicJwtCredentialsProvider，则此参数为必需项。 ## roleSessionName + **默认值** – jwt\$1redshift\$1session + **数据类型** – 字符串 所代入角色会话的标识符。通常，您可以传递与应用程序用户关联的名称或标识符。您的应用程序使用的临时安全凭证与该用户相关联。在为 Plugin\$1Name 选项指定 BasicJwtCredentialsProvider 时，您可以指定此参数。 此参数为可选的。 ## 范围 + **默认值** – 无 + **数据类型** – 字符串 用户可以同意的范围列表，以空格分隔。您可以指定此参数，以便 Microsoft Azure 应用程序可以获得您想调用的 API 的同意。在为 Plugin\$1Name 选项指定 BrowserAzureOAuth2CredentialsProvider 时，您可以指定此参数。 此参数是 BrowserAzureOAuth2CredentialsProvider 插件必需的。 ## SecretAccessKey + **默认值** – 无 + **数据类型** – 字符串 用户或角色的 IAM 访问密钥。如果指定了此选项，则还必须指定 AccessKeyID。如果在 JDBC URL 中传递，则 SecretAccessKey 必须采用 URL 编码。 此参数为可选的。 ## SessionToken + **默认值** – 无 + **数据类型** – 字符串 与您用于身份验证的 IAM 角色关联的临时 IAM 会话令牌。如果在 JDBC URL 中传递，则临时 IAM 会话令牌必须采用 URL 编码。 此参数为可选的。 ## serverlessAcctId + **默认值** – null + **数据类型** – 字符串 Amazon Redshift Serverless 账户 ID。驱动程序将尝试从给定主机中检测此参数。如果您使用的是网络负载均衡器 (NLB)，则驱动程序将无法检测到它，因此您可以在此处对其进行设置。 此参数为可选的。 ## serverlessWorkGroup + **默认值** – null + **数据类型** – 字符串 Amazon Redshift Serverless 工作组名称。驱动程序将尝试从给定主机中检测此参数。如果您使用的是网络负载均衡器 (NLB)，则驱动程序将无法检测到它，因此您可以在此处对其进行设置。 此参数为可选的。 ## socketFactory + **默认值** – null + **数据类型** – 字符串 此选项指定了用于创建套接字的套接字产生组件。 此参数为可选的。 ## socketTimeout + **默认值** - 0 + **数据类型** – 整数 套接字读取操作发生超时前等待的秒数。如果操作用时长于此阈值，则连接将被关闭。当此属性设置为 0 时，连接不会发生超时。 此参数为可选的。 ## SSL + **默认值** – TRUE + **数据类型** – 字符串 使用此属性可以打开或关闭连接的 SSL。 此参数为可选的。 可以指定以下值： **TRUE** 驱动程序通过 SSL 连接到服务器。 **FALSE** 驱动程序在不使用 SSL 的情况下连接到服务器。IAM 身份验证不支持此选项。 或者，您也可以配置 AuthMech 属性。 ## SSL\$1Insecure + **默认值** – true + **数据类型** – 字符串 此属性指示是否应验证 IDP 主机服务器证书。 此参数为可选的。 可以指定以下值： **true** 驱动程序不检查 IDP 服务器证书的真实性。 **false** 驱动程序检查 IDP 服务器证书的真实性。 ## SSLCert + **默认值** – 无 + **数据类型** – 字符串 .pem 或 .crt 文件的完整路径，其中包含在使用 SSL 时用于验证 Amazon Redshift 服务器实例的其他受信任 CA 证书。 如果指定了 SSLKey，则此参数为必填项。 ## SSLFactory + **默认值** – 无 + **数据类型** – 字符串 在不使用服务器证书的情况下，通过 TLS/SSL 连接到服务器时使用的 SSL 出厂设置。 ## SSLKey + **默认值** – 无 + **数据类型** – 字符串 .der 文件的完整路径，包含用于验证 SSLCert 中指定的证书的 PKCS8 密钥文件。 如果指定了 SSLCert，则此参数为必填项。 ## SSLMode + **默认值** – verify-ca + **数据类型** – 字符串 使用此属性指定启用 TLS/SSL 时驱动程序如何验证证书。 此参数为可选的。 可以指定以下值： **verify-ca** 驱动程序验证证书是否来自受信任的证书颁发机构 (CA)。 **verify-full** 驱动程序验证证书来自受信任的 CA，以及证书中的主机名是否与连接 URL 中指定的主机名匹配。 ## SSLPassword + **默认值** - 0 + **数据类型** – 字符串 在 SSLKey 中指定的加密密钥文件的密码。 如果指定了 SSLKey 且对密钥文件进行了加密，则此参数为必填项。 ## SSLRootCert + **默认值** – 无 + **数据类型** – 字符串 .pem 或 .crt 文件的完整路径，其中包含在使用 SSL 时用于验证 Amazon Redshift 服务器实例的根 CA 证书。 ## StsEndpointUrl + **默认值** – null + **数据类型** – 字符串 您可以指定 AWS Security Token Service (AWS STS) 端点。如果指定此选项，则“区域”选项将被忽略。您只能为此端点指定安全协议 (HTTPS)。 ## tcpKeepAlive + **默认值** – TRUE + **数据类型** – 字符串 使用此属性可打开或关闭 TCP Keepalive。 此参数为可选的。 可以指定以下值： **TRUE** 驱动程序将使用 TCP Keepalive 来防止连接超时。 **FALSE** 驱动程序不使用 TCP Keepalive。 ## 令牌 + **默认值** – 无 + **数据类型** – 字符串 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 + **默认值** – 无 + **数据类型** – 字符串 `IdpTokenAuthPlugin` 中使用的令牌类型。 可以指定以下值： **ACCESS\$1TOKEN** 如果您使用 AWS IAM Identity Center 提供的访问令牌，请输入此项。 **EXT\$1JWT** 如果您使用 OpenID Connect（OIDC）JSON Web 令牌（JWT）（该令牌由与 AWS IAM Identity Center 集成的基于 Web 的身份提供者提供），请输入此项。 此参数可用于 `IdpTokenAuthPlugin`。 ## UID + **默认值** – 无 + **数据类型** – 字符串 用于访问数据库的数据库用户名。 此参数为必需参数。 ## 用户 + **默认值** – 无 + **数据类型** – 字符串 通过 IDP 使用 IAM 身份验证进行连接时，这是 idp\$1host 服务器的用户名。使用标准身份验证时，这可用于 Amazon Redshift 数据库用户名。 此参数为可选的。 ## webIdentityToken + **默认值** – 无 + **数据类型** – 字符串 身份提供者提供的 OAuth 2.1 访问令牌或 OpenID Connect ID 令牌。您的应用程序必须通过 Web 身份提供者对您的应用程序用户进行身份验证来获取此令牌。在为 Plugin\$1Name 选项指定 BasicJwtCredentialsProvider 时，请确保指定此参数。 如果您为 Plugin\$1Name 选项指定 BasicJwtCredentialsProvider，则此参数为必填项。