主要 ODBC 2.x 连接参数
以下各节介绍了每个主要连接参数。
Data source name
指定数据来源的名称。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| DSN | 无 DSN 连接类型的可选项 | none |
DSN=AmazonAthenaOdbcUsWest1; |
描述
包含数据来源的描述。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| 描述 | 可选 | none |
Description=Connection to Amazon Athena us-west-1; |
目录
指定数据目录名称。有关目录的更多信息，请参阅《Amazon Athena API 参考》中的 DataCatalog。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| 目录 | 可选 | AwsDataCatalog |
Catalog=AwsDataCatalog; |
区域
指定 Amazon Web Services 区域。有关 Amazon Web Services 区域 的更多信息，请参阅区域和可用区
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| AwsRegion | 强制性 | none |
AwsRegion=us-west-1; |
数据库
指定数据库名称。有关数据库的更多信息，请参阅 Amazon Athena API 参考中的数据库。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| 架构 | 可选 | default |
Schema=default; |
工作组
指定工作组名称。有关工作组的更多信息，请参阅 Amazon Athena API 参考中的工作组。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| 工作组 | 可选 | primary |
Workgroup=primary; |
输出位置
指定存储查询结果的 Amazon S3 位置。有关输出位置的更多信息，请参阅 Amazon Athena API 参考中的 ResultConfiguration。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| S3OutputLocation | 强制性 | none |
S3OutputLocation=s3://DOC-EXAMPLE-BUCKET/; |
加密选项
对话框参数名称：加密选项
指定加密选项。有关加密选项的更多信息，请参阅 Amazon Athena API 参考中的 EncryptionConfiguration。
| 连接字符串名称 | 参数类型 | 默认值 | 可能的值 | 连接字符串示例 |
|---|---|---|---|---|
| S3OutputEncOption | 可选 | none |
NOT_SET, SSE_S3, SSE_KMS,
CSE_KMS |
S3OutputEncOption=SSE_S3; |
KMS 密钥
指定用于加密的 KMS 密钥。有关 KMS 密钥的加密配置的更多信息，请参阅 Amazon Athena API 参考中的 EncryptionConfiguration。
| 连接字符串名称 | 参数类型 | 默认值 | 连接字符串示例 |
|---|---|---|---|
| S3OutputEncKMSKey | 可选 | none |
S3OutputEncKMSKey=your_key; |
连接测试
ODBC 数据来源管理器提供了一个测试选项，可用于测试 ODBC 2.x 与 Amazon Athena 的连接。要查看步骤，请参阅 在 Windows 上配置数据来源名称。在测试连接时，ODBC 驱动程序会调用 GetWorkGroup Athena API 操作。该调用使用您指定的身份验证类型和相应的凭证提供程序来检索凭证。使用 ODBC 2.x 驱动程序时，连接测试不收费。该测试不会在 Amazon S3 存储桶中生成查询结果。