Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

从 2025 年 11 月 1 日起，Amazon Redshift 将不再支持创建新的 Python UDF。如果您想要使用 Python UDF，请在该日期之前创建 UDF。现有的 Python UDF 将继续正常运行。有关更多信息，请参阅博客文章。

将预置集群迁移到 Amazon Redshift Serverless

可以将现有的预置集群迁移到 Amazon Redshift Serverless，从而实现按需和自动扩展计算资源。将预置集群迁移到 Amazon Redshift Serverless 后，您只需为使用的资源付费，并可根据工作负载需求自动扩展容量，从而优化成本。迁移的常见用例包括运行临时查询、定期数据处理任务，或在不过度预置资源的情况下处理不可预测的工作负载。执行以下一组任务，将预置 Amazon Redshift 集群迁移到无服务器部署选项。

创建预置集群的快照

要将数据从您的预置集群传输到 Amazon Redshift Serverless，请为您的预置集群创建快照，然后在 Amazon Redshift Serverless 中还原该快照。

有关预置集群快照的更多信息，请参阅 Amazon Redshift 快照。

使用驱动程序连接到 Amazon Redshift Serverless

要使用首选的 SQL 客户端连接到 Amazon Redshift Serverless，可以使用 Amazon Redshift 提供的 JDBC 驱动程序版本 2.x。我们建议使用最新版本的 Amazon Redshift JDBC 驱动程序版本 2.x 连接到 Amazon Redshift。端口号是可选的。如果您未将端口号包括在内，则 Amazon Redshift Serverless 将默认使用端口号 5439。您可以更改为 5431-5455 或 8191-8215 端口范围内的另一个端口。要更改无服务器端点的默认端口，请使用 Amazon CLI 和 Amazon Redshift API。

要查找用于 JDBC、ODBC 或 Python 驱动程序的确切端点，请参阅 Amazon Redshift Serverless 中的工作组配置。您还可以使用 Amazon Redshift Serverless API 操作 GetWorkgroup 或 Amazon CLI 操作 get-workgroups，以返回有关您工作组的信息，然后进行连接。

使用基于密码的身份验证进行连接

要使用 Amazon Redshift JDBC 驱动程序版本 2.x 以及基于密码的身份验证来建立连接，请使用以下语法：

jdbc:redshift://<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com:5439/?username=username&password=password

要使用 Amazon Redshift Python 连接器以及基于密码的身份验证来建立连接，请使用以下语法：

import redshift_connector
with redshift_connector.connect(
    host='<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com',
    database='<database-name>',
    user='username',
    password='password'
    # port value of 5439 is specified by default
) as conn:
    pass

要使用 Amazon Redshift ODBC 驱动程序版本 2.x 以及基于密码的身份验证来建立连接，请使用以下语法：

Driver={Amazon Redshift ODBC Driver (x64)}; Server=<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com; Database=database-name; User=username; Password=password

使用 IAM 进行连接

如果您更喜欢使用 IAM 进行登录，请使用 Amazon Redshift Serverless GetCredentials API 操作。

要使用 IAM 身份验证，请将 iam: 添加到 Amazon Redshift JDBC URL 中 jdbc:redshift: 的后面，如以下示例所示。

jdbc:redshift:iam://<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com:5439/<database-name>

此 Amazon Redshift Serverless 端点不支持自定义 dbUser、dbGroup 或 auto-create。默认情况下，该驱动程序会在登录时自动创建数据库用户。然后，它会基于在 IAM 中指定的标签或基于在身份提供者（IdP）中定义的组，将用户分配给 Amazon Redshift 数据库角色。

请确保您的 Amazon 身份具有适用于 redshift-serverless:GetCredentials 操作的正确 IAM 策略。下面是一个示例 IAM 策略，它授予对 Amazon 身份的正确权限，用于连接到 Amazon Redshift Serverless。有关 IAM 权限的更多信息，请参阅《IAM 用户指南》中的添加和删除 IAM 身份权限。

JSON

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": "redshift-serverless:GetCredentials",
            "Resource": "*"
        }
    ]
}

要使用 Amazon Redshift Python 连接器以及基于 IAM 的身份验证来建立连接，请在代码中使用 iam=true，如以下语法所示：

import redshift_connector
with redshift_connector.connect(
    iam=True,
    host='<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com',
    database='<database-name>'
    <IAM credentials>
) as conn:
    pass

对于 IAM credentials，可以使用任何凭证，包括以下各项：

要使用 Amazon Redshift ODBC 驱动程序版本 2.x 以及基于 IAM 的身份验证和配置文件来建立连接，请使用以下语法：

Driver={Amazon Redshift ODBC Driver (x64)}; IAM=true; Server=<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com; Database=database-name; Profile=aws-profile-name;

将 IAM 和 GetClusterCredentials API 结合使用来进行连接

可以使用 GetClusterCredentials API 建立与 Amazon Redshift Serverless 的连接。要实现此身份验证方法，请通过纳入以下参数来修改客户端或应用程序：

以下示例演示了所有三个驱动程序中的 BrowserSAML 插件。这代表几种可用的身份验证方法之一。可以根据具体要求修改示例，以使用其它身份验证方法或插件。

GetClusterCredentials 的 IAM 策略权限

以下是一个示例 IAM 策略，该策略具有将 GetClusterCredentials 与 Amazon Redshift Serverless 结合使用所需的权限：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "redshift:CreateClusterUser",
                "redshift:JoinGroup",
                "redshift:GetClusterCredentials",
                "redshift:ExecuteQuery",
                "redshift:FetchResults",
                "redshift:DescribeClusters",
                "redshift:DescribeTable"
            ],
            "Resource": [
                "arn:aws:redshift:us-east-1:<account-id>:cluster:redshift-serverless-<workgroup-name>",
                "arn:aws:redshift:us-east-1:<account-id>:dbgroup:redshift-serverless-<workgroup-name>",
                "arn:aws:redshift:us-east-1:<account-id>:dbname:redshift-serverless-<workgroup-name>/${redshift:DbName}",
                "arn:aws:redshift:us-east-1:<account-id>:dbuser:redshift-serverless-<workgroup-name>/${redshift:DbUser}"
            ]
        }
    ]
}

要使用 Amazon Redshift JDBC 驱动程序版本 2.x 以及 GetClusterCredentials 来建立连接，请使用以下语法：

jdbc:redshift:iam://redshift-serverless-<workgroup-name>:<aws-region>/<database-name>?plugin_name=com.amazon.redshift.plugin.BrowserSamlCredentialsProvider&login_url=<single sign-on URL from IdP>"

要使用 Amazon Redshift Python 连接器以及 GetClusterCredentials 来建立连接，请使用以下语法：

import redshift_connector
with redshift_connector.connect(
    iam=True,
    cluster_identifier='redshift-serverless-<workgroup-name>',
    region='<aws-region>',
    database='<database-name>',
    credentials_provider='BrowserSamlCredentialsProvider'
    login_url='<single sign-on URL from IdP>'
    # port value of 5439 is specified by default
) as conn:
    pass

要使用 Amazon Redshift ODBC 驱动程序版本 2.x 以及 GetClusterCredentials 来建立连接，请使用以下语法：

Driver= {Amazon Redshift ODBC Driver (x64)}; IAM=true; isServerless=true; ClusterId=redshift-serverless-<workgroup-name>; region=<aws-region>; plugin_name=BrowserSAML;login_url=<single sign-on URL from IdP>

以下是 Windows 中的 ODBC DSN 配置示例：

使用 Amazon Redshift Serverless SDK

如果您使用 Amazon Redshift SDK 编写了任何管理脚本，则必须使用新的 Amazon Redshift Serverless SDK 来管理您的 Amazon Redshift Serverless 和关联资源。有关可用 API 操作的更多信息，请参阅《Amazon Redshift Serverless API 参考指南》。