Amazon Redshift
管理指南 (API Version 2012-12-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

在 Microsoft Windows 操作系统上安装和配置 Amazon Redshift ODBC 驱动程序

系统要求

您可以在可访问 Amazon Redshift 数据仓库的客户端计算机上安装 Amazon Redshift ODBC 驱动程序。不过,您要在其上安装该驱动程序的每台计算机都必须满足以下最低系统要求:

  • Microsoft Windows Vista 操作系统或更高版本

  • 55MB 可用磁盘空间

  • 客户端计算机的管理员权限

  • 要连接到数据库的 Amazon Redshift 主用户或用户账户

在 Windows 操作系统上安装 Amazon Redshift 驱动程序

按照此部分中的步骤下载适用于 Microsoft Windows 操作系统的 Amazon Redshift ODBC 驱动程序。如果您当前运行的第三方应用程序获得了使用 Amazon Redshift 的认证并且需要使用特定于此应用程序的驱动程序,则您应只使用该驱动程序,而非上述驱动程序。

安装 ODBC 驱动程序

  1. 根据您的 SQL 客户端工具或应用程序的系统架构,下载以下驱动程序之一:

    注意

    根据您的 SQL 客户端工具或应用程序的系统架构,下载相应的 MSI 包。例如,如果您的 SQL 客户端工具是 64 位,则安装 64 位驱动程序。

    然后,下载并阅读 Amazon Redshift ODBC Driver License Agreement。如果您需要将这些驱动程序分发给客户或其他第三方,请发送电子邮件至 redshift-pm@amazon.com 以安排合适的许可证。

  2. 双击 .msi 文件,然后按照向导中的步骤安装驱动程序。

在 Microsoft Windows 上为 ODBC 连接创建系统 DSN 条目

下载并安装 ODBC 驱动程序后,您需要向客户端计算机或 Amazon EC2 实例添加数据源名称 (DSN) 条目。SQL 客户端工具将使用此数据源连接到 Amazon Redshift 数据库。

注意

对于使用 AWS Identity and Access Management (IAM) 凭证或身份提供商 (IdP) 凭证的身份验证,需要执行其他步骤。有关更多信息,请参阅 配置 JDBC 或 ODBC 连接以使用 IAM 凭证

创建系统 DSN 条目

  1. 开始菜单上,从程序列表中找到相应的驱动程序文件夹。

    注意

    如果您安装的是 32 位驱动程序,则文件夹名称是 Amazon Redshift ODBC Driver (32-bit)。如果您安装的是 64 位驱动程序,则文件夹名称是 Amazon Redshift ODBC Driver (64-bit)。如果您同时安装了这两个驱动程序,则会找到两个文件夹。

  2. 单击 ODBC Administrator,然后按照系统提示键入您的管理员凭证。

  3. 如果您想为计算机上的所有用户配置驱动程序,请选择 System DSN 选项卡;如果您只想为自己的用户账户配置驱动程序,请选择 User DSN 选项卡。

  4. 单击 Add。系统随即打开 Create New Data Source 窗口。

  5. 选择 Amazon Redshift ODBC 驱动程序,然后单击 Finish。系统随即打开 Amazon Redshift ODBC Driver DSN Setup 窗口。

  6. Connection Settings 下,输入以下信息:

    Data Source Name

    键入数据源的名称。在稍后创建到群集的连接时,您可以使用任何名称来标识该数据源。例如,如果您遵循的是 Amazon Redshift 入门,则可键入 exampleclusterdsn,以便轻松记住您将与此 DSN 关联的群集。

    Server

    为您的 Amazon Redshift 群集指定终端节点。您可以在群集的详细信息页面上的 Amazon Redshift console 中找到此信息。有关更多信息,请参阅 在 Amazon Redshift 中配置连接

    Port

    键入数据库使用的端口号。默认情况下,Amazon Redshift 使用 5439,但您应使用在群集启动时配置使用的端口。

    Database

    键入 Amazon Redshift 数据库的名称。如果您在启动群集时没有指定数据库名称,请键入 dev;否则,请使用您在启动时选择的名称。如果您遵循的是 Amazon Redshift 入门,请键入 dev

  7. Credentials 下,输入以下信息:

    User

    键入与要用其访问数据库的数据库用户账户相对应的用户名。如果您遵循的是 Amazon Redshift 入门,请键入 masteruser

    Password

    键入与数据库用户账户相对应的密码。

  8. SSL Settings 下,指定以下项目的值:

    SSL Authentication

    选择处理安全套接字层 (SSL) 的模式。在测试环境中,您可以使用 prefer,但在生产环境中,如果需要安全交换数据,请使用 verify-caverify-full。有关使用 SSL 的更多信息,请参阅使用 SSL 进行连接

  9. Additional Options 下,选择下列某个选项,以指定如何将查询结果返回至您的 SQL 客户端工具或应用程序:

    • Single Row Mode。如果您希望查询结果一次向 SQL 客户端工具或应用程序返回一行,请选择此选项。如果您计划查询大型结果集,但是不希望将完整结果检索到内存中,请使用此选项。禁用此选项可提高性能,但会导致发生内存不足错误的次数增加。

    • Use Declare/Fetch。如果您希望查询结果一次向 SQL 客户端工具或应用程序返回特定数量的行,请选择此选项。在 Cache Size 中指定行数。

    • Use Multiple Statements。选择此选项,以基于查询中的多个 SQL 语句返回结果。

    • Retrieve Entire Result Into Memory。如果您希望查询结果一次性全部返回至 SQL 客户端工具或应用程序,请选择此选项。默认处于启用状态。

  10. Logging Options 中,指定以下项目的值:

    • Log Level。选择相应选项,以指定是否启用日志记录以及您希望在日志中捕捉的详细信息级别。

      重要

      只有在需要捕捉某个问题的相关信息时,您才应启用日志记录。日志记录会降低性能,并会占用大量磁盘空间。

    • Log Path。指定您要保存日志文件的目标文件夹的完整路径。

    然后单击 OK

  11. Data Type Options 中,指定以下项目的值:

    • Use Unicode。选择此选项以启用对 Unicode 字符的支持。默认处于启用状态。

    • Show Boolean Column As String。如果您希望布尔值显示为字符串值而非位值,请选择此选项。如果您启用此选项,系统将显示 "1""0" 而非 10。默认处于启用状态。

    • Text as LongVarChar。选择此选项以支持采用 LongVarChar 显示文本。默认处于启用状态。

    • Max Varchar。指定 Varchar 数据类型的最大值。Varchar 字段在值大于所指定的最大值时会被提升为 LongVarchar。默认值是 255。

    • Max LongVarChar。指定 LongVarChar 数据类型的最大值。LongVarChar 字段值在大于所指定的最大值时会被截断。默认值是 8190。

    • Max Bytea。指定 Bytea 数据类型的最大值。Bytea 字段值在大于所指定的最大值时会被截断。默认值是 255。

      注意

      Bytea 数据类型仅适用于 Amazon Redshift 系统表和视图,而不支持其他使用情况。

    然后单击 OK

  12. 单击 Test。如果客户端计算机可以连接到 Amazon Redshift 数据库,您将会看到以下信息:Connection successful

如果客户端计算机无法连接到数据库,您可以进行故障排除,解决可能存在的问题。有关更多信息,请参阅 排查 Amazon Redshift 中的连接问题