Amazon Redshift は、パッチ 198 以降、新しい 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 マネジメントコンソール にサインインして、[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/) で Amazon Redshift コンソールを開きます。

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\_case\_sensitive\_identifier](https://docs.aws.amazon.com/redshift/latest/dg/r_enable_case_sensitive_identifier.html) パラメータが有効になっています。SQL を作成する際は、スキーマ名、テーブル名、列名を二重引用符で囲む必要がある場合があります ("<名前>")。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 Redshift と Amazon DynamoDB のゼロ ETL 統合を記述するには、次のオプションで `describe-integrations` コマンドを使用します。
+ `integration-arn` - 記述する DynamoDB 統合の ARN を指定します。
+ `integration-name` - 返すために 1 つ以上のリソースを指定するオプションのフィルターを指定します。

次の例では、統合 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)」を参照してください。

------