Windows - Amazon Athena

Windows

若想使用 Windows 客户端计算机访问 Amazon Athena,则需要 Amazon Athena ODBC 驱动程序。

Windows 系统要求

在可以直接访问 Amazon Athena 数据库的客户端计算机上安装 Amazon Athena ODBC 驱动程序,而无需使用 Web 浏览器。

所用的 Windows 系统必须满足以下要求:

安装 Amazon Athena ODBC 驱动程序

下载并安装适用于 Windows 的 Amazon Athena ODBC 驱动程序
  1. 下载 AmazonAthenaODBC-2.x.x.x.msi 安装文件。

  2. 启动安装文件,然后选择下一步

  3. 要接受许可协议条款,选中复选框,然后选择下一步

  4. 要更改安装位置,选择浏览,浏览到所需的文件夹,然后选择确定

  5. 要接受安装位置,选择下一步

  6. 选择安装

  7. 在安装完成时,选择完成

设置驱动程序配置选项的方法

要在 Windows 中控制 Amazon Athena ODBC 驱动程序的行为,可通过以下方式设置驱动程序配置选项:

  • 配置数据来源名称(DSN)时,在 ODBC 数据来源管理器程序中。

  • 通过在以下位置添加或更改 Windows 注册表项:

    HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME
  • 在以编程方式连接时,通过在连接字符串中设置驱动程序选项。

在 Windows 上配置数据来源名称

在下载并安装 ODBC 驱动程序后,必须将数据来源名称(DSN)条目添加到客户端计算机或 Amazon EC2 实例。SQL 客户端工具将使用此数据来源连接和查询 Amazon Athena。

创建系统 DSN 条目
  1. 在 Windows 的开始菜单中,右键单击 ODBC 数据来源(64 位),然后选择更多以管理员身份运行

  2. ODBC 数据来源管理器中,选择驱动程序选项卡。

  3. 名称列中,确认是否存在 Amazon Athena ODBC(x64)

  4. 请执行以下操作之一:

    • 要为计算机上的所有用户配置驱动程序,选择系统 DSN 选项卡。由于使用不同账户加载数据的应用程序可能检测不到来自其他账户的用户 DSN,因而建议使用系统 DSN 配置选项。

      注意

      要使用系统 DSN 选项,需要管理权限。

    • 要仅为您的用户账户配置驱动程序,选择用户 DSN 选项卡。

  5. 选择 添加。随即打开新建数据来源对话框。

  6. 选择 Amazon Athena ODBC(x64),然后选择完成

  7. Amazon Athena ODBC 配置对话框中,输入以下信息。有关这些选项的详细信息,请参阅 主要 ODBC 2.x 连接参数

    • 数据来源名称中,输入要用于识别数据来源的名称。

    • 对于描述,输入描述以帮助您识别数据来源。

    • 区域中,输入要在其中使用 Athena 的 AWS 区域 名称(例如, us-west-1)。

    • 目录中,输入 Amazon Athena 目录的名称。默认为 AwsDataCatalog,供 AWS Glue 使用。

    • 数据库中,输入 Amazon Athena 数据库的名称。默认为默认

    • 对于工作组,输入 Amazon Athena 工作组的名称。默认为主要

    • 对于 S3 输出位置,输入 Amazon S3 中存储查询结果的位置(例如 s3://DOC-EXAMPLE-BUCKET/)。

    • (可选)对于加密选项,选择一个加密选项。默认为 NOT_SET

    • (可选)对于 KMS 密钥,根据需要选择加密 KMS 密钥。

  8. 要指定用于 IAM 身份验证的配置选项,选择身份验证选项

  9. 输入以下信息:

    • 对于身份验证类型,选择 IAM 凭证。这是默认模式。有关可用身份验证类型的更多信息,请参阅 身份验证选项

    • 对于用户名,输入用户名。

    • 对于密码,输入密码。

    • 对于会话令牌,如果要使用临时 AWS 凭证,则输入会话令牌。有关临时凭证的更多信息,请参阅《IAM 用户指南》中的将临时凭证用于 AWS 资源

  10. 选择确定

  11. Amazon Athena ODBC 配置对话框的底部,选择测试。如果客户端计算机成功连接到 Amazon Athena,则连接测试框会报告连接成功。否则,该框将报告连接失败并显示相应的错误信息。

  12. 要关闭测试连接,选择确定。现在,您创建的数据来源在数据来源名称列表中显示。

在 Windows 上使用无 DSN 连接

您可以使用无 DSN 连接来连接到没有数据来源名称(DSN)的数据库。以下示例显示了连接到 Amazon Athena 的 Amazon Athena ODBC(x64)ODBC 驱动程序的连接字符串。

DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation= s3://DOC-EXAMPLE-BUCKET/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;