

 从补丁 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/)。

# 查看零 ETL 集成
<a name="zero-etl-using.describing"></a>

您可以从 Amazon Redshift 控制台查看您的零 ETL 集成。在这里，可以查看其配置信息和当前状态，并打开屏幕来查询和共享数据。

------
#### [ Amazon Redshift console ]

**查看零 ETL 集成的详细信息**

1. 登录到 AWS 管理控制台并打开 Amazon Redshift 控制台，网址：[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)。

1. 从左侧导航窗格中，选择**无服务器**或**预置集群**控制面板。然后，选择**零 ETL 集成**。

1. 选择要查看的零 ETL 集成。对于每个集成，请提供以下信息：
   + **集成 ID** 是集成创建时返回的标识符。
   + **状态**可以是下列项之一：
     + `Active` – 零 ETL 集成正在将事务数据发送到目标 Amazon Redshift 数据仓库。
     + `Syncing` – 零 ETL 集成遇到了可恢复的错误，正在重新设置数据种子。受影响的表在完成重新同步之前无法在 Amazon Redshift 中进行查询。
     + `Failed` – 零 ETL 集成遇到了无法恢复的事件或错误，无法修复。您必须删除并重新创建零 ETL 集成。
     + `Creating` – 正在创建零 ETL 集成。
     + `Deleting` – 正在删除零 ETL 集成。
     + `Needs attention` – 零 ETL 集成遇到了需要手动干预才能解决的事件或错误。要修复此问题，请按照错误消息中的步骤操作。
   + **源类型**是复制到目标的源数据的类型。类型可以指定其它数据库管理器，例如 Aurora MySQL 兼容版、Amazon Aurora PostgreSQL、RDS for MySQL 和通过应用程序（`GlueSAAS`）。
   + **源 ARN** 是源数据的 ARN。对于大多数源，这是源数据库或表的 ARN。对于与应用程序源的零 ETL 集成，这是 AWS Glue 连接对象的 ARN。
   + **目标**是接收源数据的 Amazon Redshift 数据仓库的命名空间。
   + **数据库**可以是以下值之一：
     + `No database` – 没有用于集成的目标数据库。
     + `Creating` – Amazon Redshift 正在为集成创建目标数据库。
     + `Active` – 数据正在从集成源复制到 Amazon Redshift。
     + `Error` – 集成出现错误。
     + `Recovering` – 数据仓库重新启动后，集成正在恢复。
     + `Resyncing` – Amazon Redshift 正在重新同步集成中的表。
   + **目标类型**是 Amazon Redshift 数据仓库的类型。
   + **创建日期**是创建集成的日期和时间 (UTC)。

**注意**  
要查看数据仓库的集成详细信息，请选择已配置集群或无服务器命名空间的详细信息页面，然后选择**零 ETL 集成**选项卡。

从**零 ETL 集成**列表中，您可以选择**查询数据**以跳转至 Amazon Redshift 查询编辑器 v2。Amazon Redshift 目标数据库启用了 [enable\$1case\$1sensitive\$1identifier](https://docs.aws.amazon.com/redshift/latest/dg/r_enable_case_sensitive_identifier.html) 参数。编写 SQL 时，您可能需要用双引号 ("<name>") 将架构、表和列名括起来。有关在 Amazon Redshift 数据仓库中查询数据的更多信息，请参阅[使用查询编辑器 v2 查询数据库使用 Amazon Redshift 查询编辑器 v2 查询数据库](query-editor-v2.md)。

在**零 ETL 集成**列表中，您可以选择**共享数据**来创建数据共享。要为 Amazon Redshift 数据库创建数据共享，请按照**创建数据共享**页面上的说明进行操作。在共享 Amazon Redshift 数据库中的数据之前，您必须先创建目标数据库。有关数据共享的更多信息，请参阅 [Amazon Redshift 的数据共享概念](https://docs.aws.amazon.com/redshift/latest/dg/concepts.html)。

要刷新集成，可以使用 [ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html) 命令。这样做会将集成源中的所有数据复制到目标数据库中。以下示例刷新零 ETL 集成中所有已同步和失败的表。

```
ALTER DATABASE sample_integration_db INTEGRATION REFRESH ALL tables;
```

------
#### [ AWS CLI ]

要使用 AWS CLI 描述 Amazon DynamoDB 与 Amazon Redshift 的零 ETL 集成，请使用带有以下选项的 `describe-integrations` 命令：
+ `integration-arn` - 指定要描述的 DynamoDB 集成的 ARN。
+ `integration-name` - 指定可选的筛选条件，从而指定要返回的一个或多个资源。

以下示例通过提供集成 ARN 来描述集成。

```
aws redshift describe-integrations
                 
{
    "Integrations": [
        {
            "Status": "failed", 
            "IntegrationArn": "arn:aws:redshift:us-east-1:123456789012:integration:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", 
            "Errors": [
                {
                    "ErrorCode": "INVALID_TABLE_PERMISSIONS", 
                    "ErrorMessage": "Redshift does not have sufficient access on the table key. Refer to the Amazon DynamoDB Developer Guide."
                }
            ], 
            "Tags": [], 
            "CreateTime": "2023-11-09T00:32:46.444Z", 
            "KMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", 
            "TargetArn": "arn:aws:redshift:us-east-1:123456789012:namespace:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", 
            "IntegrationName": "ddb-to-provisioned-02", 
            "SourceArn": "arn:aws:dynamodb:us-east-1:123456789012:table/mytable"
        }
    ]
}
```

您也可以按 `integration-arn`、`source-arn`、`source-types` 或 `status` 筛选 `describe-integrations` 的结果。有关更多信息，请参阅《Amazon Redshift CLI 指南》**中的 [describe-integrations](https://docs.aws.amazon.com/cli/latest/reference/redshift/describe-integrations.html)。

------