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 統合のトラブルシューティング
以下のシナリオを使用して、ゼロ ETL 統合で発生する問題をトラブルシューティングします。
## Aurora MySQL とのゼロ ETL 統合のトラブルシューティング
Aurora MySQL とのゼロ ETL 統合に関する一般的な問題のトラブルシューティングを行うには、次の情報を利用してください。
**Topics**
+ [統合の作成に失敗しました](#zero-etl-using.troubleshooting.creation)
+ [テーブルにプライマリキーがない](#zero-etl-using.troubleshooting.primary-key)
+ [Aurora MySQL テーブルが Amazon Redshift にレプリケートされない](#zero-etl-using.troubleshooting.not-replicating)
+ [テーブル内のサポートされていないデータ型](#zero-etl-using.troubleshooting.unsupported-data)
+ [データ操作言語コマンドが失敗しました](#zero-etl-using.troubleshooting.failed-dml)
+ [データソース間の変更履歴が一致しません](#zero-etl-using.troubleshooting.tracked-changes-failure)
+ [認可に失敗しました](#zero-etl-using.troubleshooting.authorization)
+ [テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている](#zero-etl-using.troubleshooting.table-limits)
+ [Amazon Redshift がデータをロードできません](#zero-etl-using.troubleshooting.data-load)
+ [ワークグループのパラメータ設定が間違っています](#zero-etl-using.troubleshooting.case-sensitive)
+ [ゼロ ETL 統合を有効にするためにデータベースが作成されていません](#zero-etl-using.troubleshooting.db-creation)
+ [テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています](#zero-etl-using.troubleshooting.resync)
+ [統合時の遅延の増加](#zero-etl-using.troubleshooting.integration-lag)
### 統合の作成に失敗しました
ゼロ ETL 統合の作成に失敗した場合、統合のステータスは `Inactive` になります。以下がソースの Aurora DB クラスターに当てはまることを確認してください。
+ Amazon RDS コンソールでクラスターを作成しました。
+ ソースの Aurora DB クラスターはサポートされているバージョンを実行しています。サポートされているバージョンのリストについては、「[Amazon Redshift とのゼロ ETL 統合でサポートされているリージョンと Aurora DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.Aurora_Fea_Regions_DB-eng.Feature.Zero-ETL.html)」を参照してください。これを確認するには、クラスターの **[設定]** タブに移動して、**[エンジンのバージョン]** を確認します。
+ クラスターの binlog パラメータ設定を正しく設定しました。Aurora MySQL バイナリログパラメータが正しく設定されていないか、ソース Aurora DB クラスターに関連付けられていない場合、作成は失敗します。「[Configure DB cluster parameters](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.setting-up.html#zero-etl.parameters)」を参照してください。
さらに、Amazon Redshift データウェアハウスに以下が当てはまることを確認してください。
+ 大文字と小文字の区別がオンになっています。「[データウェアハウスの大文字と小文字の区別を有効にする](zero-etl-setting-up.case-sensitivity.md)」を参照してください。
+ 名前空間に適切な認証済みプリンシパルと統合ソースを追加しました。「[Amazon Redshift データウェアハウスの認可を設定する](zero-etl-using.redshift-iam.md)」を参照してください。
### テーブルにプライマリキーがない
このデスティネーションデータベースには、1 つまたは複数のテーブルにプライマリキーがなく、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。テーブルにプライマリキーを追加すると、Amazon Redshift がテーブルを再同期します。または、テーブルを Aurora にドロップして、プライマリキーを持つテーブルを作成することもできますが、この方法はお勧めしません。詳細については、「[Amazon Redshift best practices for designing tables](https://docs.aws.amazon.com/redshift/latest/dg/c_designing-tables-best-practices.html)」を参照してください。
### Aurora MySQL テーブルが Amazon Redshift にレプリケートされない
Amazon Redshift に 1 つ以上のテーブルが反映されていない場合は、次のコマンドを実行してテーブルを再同期できます。{{dbname}} を Amazon Redshift データベースの名前に置き換えます。また、{{table1}} と {{table2}} を同期するテーブルの名前に置き換えます。
```
ALTER DATABASE {{dbname}} INTEGRATION REFRESH TABLES {{table1}}, {{table2}};
```
詳細については、「*Amazon Redshift データベースデベロッパーガイド*」の「[ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html)」を参照してください。
1 つ以上のソーステーブルにプライマリキーがないため、データがレプリケートされていない可能性があります。Amazon Redshift のモニタリングダッシュボードには、これらのテーブルのステータスが `Failed` と表示され、ゼロ ETL 統合全体のステータスが `Needs attention` に変わります。この問題を解決するには、プライマリキーとなる既存のキーをテーブル内で特定するか、合成プライマリキーを追加することができます。具体的な解決策については、*AWS データベースブログ*の「[Handle tables without primary keys while creating Amazon Aurora MySQL or RDS for MySQL zero-ETL integrations with Amazon Redshift](https://aws.amazon.com/blogs/database/handle-tables-without-primary-keys-while-creating-amazon-aurora-mysql-or-amazon-rds-for-mysql-zero-etl-integrations-with-amazon-redshift/)」を参照してください。
また、ターゲットが Amazon Redshift クラスターの場合、クラスターが一時停止していないことを確認します。
### テーブル内のサポートされていないデータ型
Amazon Redshift での統合で作成され、Aurora DB クラスターからデータがレプリケートされたデータベースでは、サポートされていないデータ型が単一または複数のテーブルにあるため、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。次に、これらのテーブルを削除し、Amazon RDS に新しいテーブルを再作成します。サポートされていないデータ型の詳細については、「**Amazon Aurora ユーザーガイド」の「[Aurora データベースと Amazon Redshift データベース間のデータ型の違い](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.querying.html#zero-etl.data-type-mapping)」を参照してください。
### データ操作言語コマンドが失敗しました
Amazon Redshift は Redshift テーブルで DML コマンドを実行できませんでした。この問題を解決するには、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。Amazon Redshift は、このエラーを解決するためにテーブルを自動的に再同期します。
### データソース間の変更履歴が一致しません
このエラーは、Amazon Aurora と Amazon Redshift 間の変更が一致せず、統合が `Failed` 状態になる場合に発生します。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deletinging.html)」を参照してください。
### 認可に失敗しました
ソース Aurora DB クラスターが Amazon Redshift データウェアハウスの認可された統合ソースとして削除されたため、認可に失敗しました。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deleting.html)」を参照してください。
### テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている
デスティネーションデータウェアハウスのテーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えています。Amazon Aurora が Amazon Redshift にデータを送信できません。テーブルとスキーマの数が、設定された制限を超えています。この問題を解決するには、ソースデータベースから不要なスキーマまたはテーブルを削除します。
### Amazon Redshift がデータをロードできません
Amazon Redshift がゼロ ETL 統合にデータをロードできません。
この問題を解決するには、Amazon RDS のゼロ ETL 統合を削除してから再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deleting.html)」を参照してください。
### ワークグループのパラメータ設定が間違っています
ワークグループで大文字と小文字の区別がオンになっていません。
この問題を解決するには、統合の詳細ページの **[プロパティ]** タブに移動してパラメータグループを選択し、**[プロパティ]** タブで大文字と小文字を区別する識別子をオンにします。既存のパラメータグループがない場合は、大文字と小文字を区別する識別子をオンにしてパラメータグループを作成してください。次に、Amazon RDS に新しいゼロ ETL 統合を作成します。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」を参照してください。
### ゼロ ETL 統合を有効にするためにデータベースが作成されていません
ゼロ ETL 統合を有効にするためのデータベースが作成されていません。
この問題を解決するには、統合用のデータベースを作成します。詳細については、「[Amazon Redshift でのデスティネーションデータベースの作成](zero-etl-using.creating-db.md)」を参照してください。
### テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています
テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています。
テーブルがこのような状態になっている理由に関する詳細なエラー情報を収集するには、[SYS\_LOAD\_ERROR\_DETAIL](https://docs.aws.amazon.com/redshift/latest/dg/SYS_LOAD_ERROR_DETAIL.html) システムビューを使用します。
### 統合時の遅延の増加
ソースデータベースで SAVEPOINT が頻繁に使用されていると、ゼロ ETL 統合の統合遅延が大きくなる可能性があります。
## Aurora PostgreSQL とのゼロ ETL 統合のトラブルシューティング
Aurora PostgreSQL とのゼロ ETL 統合に関する一般的な問題のトラブルシューティングを行うには、次の情報を利用してください。
**Topics**
+ [統合の作成に失敗しました](#zero-etl-using.troubleshooting.creation)
+ [テーブルにプライマリキーがない](#zero-etl-using.troubleshooting.primary-key)
+ [Aurora PostgreSQL テーブルが Amazon Redshift にレプリケートされない](#zero-etl-using.troubleshooting.not-replicating)
+ [テーブル内のサポートされていないデータ型](#zero-etl-using.troubleshooting.unsupported-data)
+ [データ操作言語コマンドが失敗しました](#zero-etl-using.troubleshooting.failed-dml)
+ [データソース間の変更履歴が一致しません](#zero-etl-using.troubleshooting.tracked-changes-failure)
+ [認可に失敗しました](#zero-etl-using.troubleshooting.authorization)
+ [テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている](#zero-etl-using.troubleshooting.table-limits)
+ [Amazon Redshift がデータをロードできません](#zero-etl-using.troubleshooting.data-load)
+ [ワークグループのパラメータ設定が間違っています](#zero-etl-using.troubleshooting.case-sensitive)
+ [ゼロ ETL 統合を有効にするためにデータベースが作成されていません](#zero-etl-using.troubleshooting.db-creation)
+ [テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています](#zero-etl-using.troubleshooting.resync)
### 統合の作成に失敗しました
ゼロ ETL 統合の作成に失敗した場合、統合のステータスは `Inactive` になります。以下がソースの Aurora DB クラスターに当てはまることを確認してください。
+ Amazon RDS コンソールでクラスターを作成しました。
+ ソースの Aurora DB クラスターはサポートされているバージョンを実行しています。サポートされているバージョンのリストについては、「[Amazon Redshift とのゼロ ETL 統合でサポートされているリージョンと Aurora DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.Aurora_Fea_Regions_DB-eng.Feature.Zero-ETL.html#Concepts.Aurora_Fea_Regions_DB-eng.Feature.Zero-ETL-Postgres)」を参照してください。これを確認するには、クラスターの **[設定]** タブに移動して、**[エンジンのバージョン]** を確認します。
+ クラスターの binlog パラメータ設定を正しく設定しました。Aurora PostgreSQL binlog パラメータの設定が適切でないか、ソースの Aurora DB クラスターに関連付けられていない場合、作成は失敗します。「[Configure DB cluster parameters](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.setting-up.html#zero-etl.parameters)」を参照してください。
さらに、Amazon Redshift データウェアハウスに以下が当てはまることを確認してください。
+ 大文字と小文字の区別がオンになっています。「[データウェアハウスの大文字と小文字の区別を有効にする](zero-etl-setting-up.case-sensitivity.md)」を参照してください。
+ endterm="zero-etl-using.redshift-iam.title"/> に、正しい承認されたプリンシパルと統合ソースを追加しました。
### テーブルにプライマリキーがない
このデスティネーションデータベースには、1 つまたは複数のテーブルにプライマリキーがなく、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。テーブルにプライマリキーを追加すると、Amazon Redshift がテーブルを再同期します。または、テーブルを Aurora にドロップして、プライマリキーを持つテーブルを作成することもできますが、この方法はお勧めしません。詳細については、「[Amazon Redshift best practices for designing tables](https://docs.aws.amazon.com/redshift/latest/dg/c_designing-tables-best-practices.html)」を参照してください。
### Aurora PostgreSQL テーブルが Amazon Redshift にレプリケートされない
Amazon Redshift に 1 つ以上のテーブルが反映されていない場合は、次のコマンドを実行してテーブルを再同期できます。{{dbname}} を Amazon Redshift データベースの名前に置き換えます。また、{{table1}} と {{table2}} を同期するテーブルの名前に置き換えます。
```
ALTER DATABASE {{dbname}} INTEGRATION REFRESH TABLES {{table1}}, {{table2}};
```
詳細については、「*Amazon Redshift データベースデベロッパーガイド*」の「[ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html)」を参照してください。
1 つ以上のソーステーブルにプライマリキーがないため、データがレプリケートされていない可能性があります。Amazon Redshift のモニタリングダッシュボードには、これらのテーブルのステータスが `Failed` と表示され、ゼロ ETL 統合全体のステータスが `Needs attention` に変わります。この問題を解決するには、プライマリキーとなる既存のキーをテーブル内で特定するか、合成プライマリキーを追加することができます。具体的な解決策については、*AWS データベースブログ*の「[Handle tables without primary keys while creating Amazon Aurora PostgreSQL zero-ETL integrations with Amazon Redshift](https://aws.amazon.com/blogs/database/handle-tables-without-primary-keys-while-creating-amazon-aurora-postgresql-zero-etl-integrations-with-amazon-redshift/)」を参照してください。
また、ターゲットが Amazon Redshift クラスターの場合、クラスターが一時停止していないことを確認します。
### テーブル内のサポートされていないデータ型
Amazon Redshift での統合で作成され、Aurora DB クラスターからデータがレプリケートされたデータベースでは、サポートされていないデータ型が単一または複数のテーブルにあるため、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。次に、これらのテーブルを削除し、Amazon RDS に新しいテーブルを再作成します。サポートされていないデータ型の詳細については、「**Amazon Aurora ユーザーガイド」の「[Aurora データベースと Amazon Redshift データベース間のデータ型の違い](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.querying.html#zero-etl.data-type-mapping)」を参照してください。
### データ操作言語コマンドが失敗しました
Amazon Redshift は Redshift テーブルで DML コマンドを実行できませんでした。この問題を解決するには、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。Amazon Redshift は、このエラーを解決するためにテーブルを自動的に再同期します。
### データソース間の変更履歴が一致しません
このエラーは、Amazon Aurora と Amazon Redshift 間の変更が一致せず、統合が `Failed` 状態になる場合に発生します。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deletinging.html)」を参照してください。
### 認可に失敗しました
ソース Aurora DB クラスターが Amazon Redshift データウェアハウスの認可された統合ソースとして削除されたため、認可に失敗しました。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deleting.html)」を参照してください。
### テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている
デスティネーションデータウェアハウスのテーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えています。Amazon Aurora が Amazon Redshift にデータを送信できません。テーブルとスキーマの数が、設定された制限を超えています。この問題を解決するには、ソースデータベースから不要なスキーマまたはテーブルを削除します。
### Amazon Redshift がデータをロードできません
Amazon Redshift がゼロ ETL 統合にデータをロードできません。
この問題を解決するには、Amazon RDS のゼロ ETL 統合を削除してから再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.deleting.html)」を参照してください。
### ワークグループのパラメータ設定が間違っています
ワークグループで大文字と小文字の区別がオンになっていません。
この問題を解決するには、統合の詳細ページの **[プロパティ]** タブに移動してパラメータグループを選択し、**[プロパティ]** タブで大文字と小文字を区別する識別子をオンにします。既存のパラメータグループがない場合は、大文字と小文字を区別する識別子をオンにしてパラメータグループを作成してください。次に、Amazon RDS に新しいゼロ ETL 統合を作成します。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.creating.html)」を参照してください。
### ゼロ ETL 統合を有効にするためにデータベースが作成されていません
ゼロ ETL 統合を有効にするためのデータベースが作成されていません。
この問題を解決するには、統合用のデータベースを作成します。詳細については、「[Amazon Redshift でのデスティネーションデータベースの作成](zero-etl-using.creating-db.md)」を参照してください。
### テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています
テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています。
テーブルがこのような状態になっている理由に関する詳細なエラー情報を収集するには、[SYS\_LOAD\_ERROR\_DETAIL](https://docs.aws.amazon.com/redshift/latest/dg/SYS_LOAD_ERROR_DETAIL.html) システムビューを使用します。
## RDS for MySQL とのゼロ ETL 統合のトラブルシューティング
RDS for MySQL とのゼロ ETL 統合に関する一般的な問題のトラブルシューティングを行うには、次の情報を利用してください。
**Topics**
+ [統合の作成に失敗しました](#zero-etl-using.troubleshooting.creation)
+ [テーブルにプライマリキーがない](#zero-etl-using.troubleshooting.primary-key)
+ [RDS for MySQL テーブルが Amazon Redshift にレプリケートされない](#zero-etl-using.troubleshooting.not-replicating)
+ [テーブル内のサポートされていないデータ型](#zero-etl-using.troubleshooting.unsupported-data)
+ [データ操作言語コマンドが失敗しました](#zero-etl-using.troubleshooting.failed-dml)
+ [データソース間の変更履歴が一致しません](#zero-etl-using.troubleshooting.tracked-changes-failure)
+ [認可に失敗しました](#zero-etl-using.troubleshooting.authorization)
+ [テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている](#zero-etl-using.troubleshooting.table-limits)
+ [Amazon Redshift がデータをロードできません](#zero-etl-using.troubleshooting.data-load)
+ [ワークグループのパラメータ設定が間違っています](#zero-etl-using.troubleshooting.case-sensitive)
+ [ゼロ ETL 統合を有効にするためにデータベースが作成されていません](#zero-etl-using.troubleshooting.db-creation)
+ [テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています](#zero-etl-using.troubleshooting.resync)
### 統合の作成に失敗しました
ゼロ ETL 統合の作成に失敗した場合、統合のステータスは `Inactive` になります。ソースの RDS DB インスタンスで次が適切であるかを確認します。
+ Amazon RDS コンソールでインスタンスを作成しました。
+ ソース RDS DB インスタンスは、RDS for MySQL のサポートされているバージョンを実行しています。サポートされているバージョンのリストについては、「[Amazon RDS と Amazon Redshift のゼロ ETL 統合でサポートされているリージョンと DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RDS_Fea_Regions_DB-eng.Feature.ZeroETL.html)」を参照してください。これを確認するには、クラスターの **[設定]** タブに移動して、**[エンジンのバージョン]** をチェックします。
+ クラスインスタンスの binlog パラメータ設定が適切に設定されています。RDS for MySQL binlog パラメータの設定が適切でないか、ソースの RDS DB インスタンスに関連付けられていない場合、作成は失敗します。「[DB インスタンスパラメータを設定する](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.setting-up.html#zero-etl.parameters)」を参照してください。
さらに、Amazon Redshift データウェアハウスに以下が当てはまることを確認してください。
+ 大文字と小文字の区別がオンになっています。「[データウェアハウスの大文字と小文字の区別を有効にする](zero-etl-setting-up.case-sensitivity.md)」を参照してください。
+ 名前空間に適切な認証済みプリンシパルと統合ソースを追加しました。「[Amazon Redshift データウェアハウスの認可を設定する](zero-etl-using.redshift-iam.md)」を参照してください。
### テーブルにプライマリキーがない
このデスティネーションデータベースには、1 つまたは複数のテーブルにプライマリキーがなく、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。テーブルにプライマリキーを追加すると、Amazon Redshift がテーブルを再同期します。または、テーブルを RDS にドロップして、プライマリキーを持つテーブルを作成することもできますが、この方法はお勧めしません。詳細については、「[Amazon Redshift best practices for designing tables](https://docs.aws.amazon.com/redshift/latest/dg/c_designing-tables-best-practices.html)」を参照してください。
### RDS for MySQL テーブルが Amazon Redshift にレプリケートされない
Amazon Redshift に 1 つ以上のテーブルが反映されていない場合は、次のコマンドを実行してテーブルを再同期できます。{{dbname}} を Amazon Redshift データベースの名前に置き換えます。また、{{table1}} と {{table2}} を同期するテーブルの名前に置き換えます。
```
ALTER DATABASE {{dbname}} INTEGRATION REFRESH TABLES {{table1}}, {{table2}};
```
詳細については、「*Amazon Redshift データベースデベロッパーガイド*」の「[ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html)」を参照してください。
1 つ以上のソーステーブルにプライマリキーがないため、データがレプリケートされていない可能性があります。Amazon Redshift のモニタリングダッシュボードには、これらのテーブルのステータスが `Failed` と表示され、ゼロ ETL 統合全体のステータスが `Needs attention` に変わります。この問題を解決するには、プライマリキーとなる既存のキーをテーブル内で特定するか、合成プライマリキーを追加することができます。詳細な解決策については、*AWS データベースブログ*の「[Amazon Aurora MySQL または Amazon RDS for MySQL と Amazon Redshift とのゼロ ETL 統合を作成する際に、プライマリキーがないテーブルを処理する](https://aws.amazon.com/blogs/database/handle-tables-without-primary-keys-while-creating-amazon-aurora-mysql-or-amazon-rds-for-mysql-zero-etl-integrations-with-amazon-redshift/)」を参照してください。
また、ターゲットが Amazon Redshift クラスターの場合、クラスターが一時停止していないことを確認します。
### テーブル内のサポートされていないデータ型
Amazon Redshift での統合で作成され、RDS DB インスタンスからデータがレプリケートされたデータベースでは、サポートされていないデータ型が単一または複数のテーブルにあるため、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。次に、これらのテーブルを削除し、Amazon RDS に新しいテーブルを再作成します。サポートされていないデータ型の詳細については、「**Amazon RDS ユーザーガイド」の「[RDS データベースと Amazon Redshift データベース間のデータ型の違い](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/zero-etl.querying.html#zero-etl.data-type-mapping)」を参照してください。
### データ操作言語コマンドが失敗しました
Amazon Redshift は Redshift テーブルで DML コマンドを実行できませんでした。この問題を解決するには、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。Amazon Redshift は、このエラーを解決するためにテーブルを自動的に再同期します。
### データソース間の変更履歴が一致しません
このエラーは、Amazon Aurora と Amazon Redshift 間の変更が一致せず、統合が `Failed` 状態になる場合に発生します。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.deletinging.html)」を参照してください。
### 認可に失敗しました
ソース RDS DB インスタンスが Amazon Redshift データウェアハウスの認可された統合ソースとして削除されたため、認可に失敗しました。
この問題を解決するには、ゼロ ETL 統合を削除して Amazon RDS で再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.deleting.html)」を参照してください。
### テーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えている
デスティネーションデータウェアハウスのテーブルの数が 10 万を超えているか、スキーマの数が 4950 を超えています。Amazon Aurora が Amazon Redshift にデータを送信できません。テーブルとスキーマの数が、設定された制限を超えています。この問題を解決するには、ソースデータベースから不要なスキーマまたはテーブルを削除します。
### Amazon Redshift がデータをロードできません
Amazon Redshift がゼロ ETL 統合にデータをロードできません。
この問題を解決するには、Amazon RDS のゼロ ETL 統合を削除してから再度作成してください。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.creating.html)」と「[Deleting zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.deleting.html)」を参照してください。
### ワークグループのパラメータ設定が間違っています
ワークグループで大文字と小文字の区別がオンになっていません。
この問題を解決するには、統合の詳細ページの **[プロパティ]** タブに移動してパラメータグループを選択し、**[プロパティ]** タブで大文字と小文字を区別する識別子をオンにします。既存のパラメータグループがない場合は、大文字と小文字を区別する識別子をオンにしてパラメータグループを作成してください。次に、Amazon RDS に新しいゼロ ETL 統合を作成します。詳細については、「[Creating zero-ETL integrations](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/zero-etl.creating.html)」を参照してください。
### ゼロ ETL 統合を有効にするためにデータベースが作成されていません
ゼロ ETL 統合を有効にするためのデータベースが作成されていません。
この問題を解決するには、統合用のデータベースを作成します。詳細については、「[Amazon Redshift でのデスティネーションデータベースの作成](zero-etl-using.creating-db.md)」を参照してください。
### テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています
テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています。
テーブルがこのような状態になっている理由に関する詳細なエラー情報を収集するには、[SYS\_LOAD\_ERROR\_DETAIL](https://docs.aws.amazon.com/redshift/latest/dg/SYS_LOAD_ERROR_DETAIL.html) システムビューを使用します。
## DynamoDB とのゼロ ETL 統合のトラブルシューティング
以下の情報を使用して、Amazon DynamoDB でのゼロ ETL 統合に関する一般的な問題をトラブルシューティングしてください。
**Topics**
+ [統合の作成に失敗しました](#zero-etl-dynamodb-integrations-troubleshooting-creation)
+ [テーブル内のサポートされていないデータ型](#zero-etl-dynamodb-integrations-troubleshooting-unsupported-data-types)
+ [サポートされていないテーブル名と属性名](#zero-etl-dynamodb-integrations-troubleshooting-unsupported-table-names)
+ [認可に失敗しました](#zero-etl-dynamodb-integrations-troubleshooting-authorization)
+ [Amazon Redshift がデータをロードできません](#zero-etl-dynamodb-integrations-troubleshooting-data-load)
+ [ワークグループまたはクラスターのパラメータ設定が間違っています](#zero-etl-dynamodb-integrations-troubleshooting-case-sensitive)
+ [ゼロ ETL 統合を有効にするためにデータベースが作成されていません](#zero-etl-dynamodb-integrations-troubleshooting-db-creation)
+ [ソース DynamoDB テーブルで、ポイントインタイムリカバリ (PITR) が有効になっていません](#zero-etl-dynamodb-integrations-troubleshooting-pitr-recovery)
+ [KMS キーアクセスが拒否されました](#zero-etl-dynamodb-integrations-troubleshooting-kms-key)
+ [Amazon Redshift が DynamoDB テーブルキーにアクセスできません](#zero-etl-dynamodb-integrations-troubleshooting-ddb-table-key)
### 統合の作成に失敗しました
ゼロ ETL 統合の作成に失敗した場合、統合のステータスは `Inactive` になります。Amazon Redshift データウェアハウスとソース DynamoDB テーブルが、以下のとおりであることを確認してください。
+ データウェアハウスの大文字と小文字の区別を有効にする。「*Amazon Redshift 管理ガイド*」の「[大文字と小文字の区別を有効にする](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.setting-up.html#zero-etl-setting-up.case-sensitivity)」を参照してください。
+ Amazon Redshift の名前空間に適切な認証済みプリンシパルと統合ソースを追加しました。「*Amazon Redshift 管理ガイド*」の「[Amazon Redshift データウェアハウスの認可を設定する](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.setting-up.html#zero-etl-using.redshift-iam)」を参照してください。
+ ソース DynamoDB テーブルに正しいリソースベースのポリシーを追加しました。「*IAM ユーザーガイド*」の「[IAM でのポリシーとアクセス許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)」を参照してください。
### テーブル内のサポートされていないデータ型
DynamoDB 番号は、Amazon Redshift で DECIMAL (38,10) に変換されます。この精度範囲を超える数値は、自動的に (38,10) に変換されます。統合を削除し、数値の精度を統一してから、統合を再作成します。
### サポートされていないテーブル名と属性名
Amazon Redshift は、最大 127 文字のテーブルと属性名をサポートしています。DynamoDB テーブル名、パーティションキー、ソートキー列名など、名前が長いために統合に失敗した場合は、短い名前を使用して修正し、統合を再作成します。
### 認可に失敗しました
ソース DynamoDB インスタンスが Amazon Redshift データウェアハウスの認可された統合ソースとして削除された場合、認可に失敗することがあります。
この問題を解決するには、ゼロ ETL 統合を削除し、Amazon DynamoDB を使用して再作成します。
### Amazon Redshift がデータをロードできません
Amazon Redshift がゼロ ETL 統合からデータをロードできません。
この問題を解決するには、ALTER DATABASE で統合を更新します。
```
ALTER DATABASE {{sample_integration_db}} INTEGRATION REFRESH ALL TABLES
```
### ワークグループまたはクラスターのパラメータ設定が間違っています
ワークグループまたはクラスターで大文字と小文字の区別がオンになっていません。
この問題を解決するには、統合の詳細ページの **[プロパティ]** タブに移動してパラメータグループを選択し、**[プロパティ]** タブで大文字と小文字を区別する識別子をオンにします。既存のパラメータグループがない場合は、大文字と小文字を区別する識別子をオンにしてパラメータグループを作成してください。次に、DynamoDB で新しいゼロ ETL 統合を作成します。「*Amazon Redshift 管理ガイド*」の「[大文字と小文字の区別を有効にする](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.setting-up.html#zero-etl-setting-up.case-sensitivity)」を参照してください。
### ゼロ ETL 統合を有効にするためにデータベースが作成されていません
ゼロ ETL 統合を有効にするためのデータベースが作成されていません。
この問題を解決するには、統合用のデータベースを作成します。「*Amazon Redshift 管理ガイド*」の「[Amazon Redshift での送信先データベースの作成](https://docs.aws.amazon.com/redshift/latest/mgmt/zero-etl-using.creating-db.html)」を参照してください。
### ソース DynamoDB テーブルで、ポイントインタイムリカバリ (PITR) が有効になっていません
DynamoDB がデータをエクスポートするには、PITR を有効にする必要があります。PITR が常に有効になっていることを確認します。統合が有効な場合に PITR をオフにした場合は、エラーメッセージの指示に従って、ALTER DATABASE を使用して統合を更新する必要があります。
```
ALTER DATABASE {{sample_integration_db}} INTEGRATION REFRESH ALL TABLES
```
### KMS キーアクセスが拒否されました
ソーステーブルまたは統合に使用される KMS キーは、十分なアクセス許可を設定する必要があります。テーブルの暗号化または復号の詳細については、「*Amazon DynamoDB デベロッパーガイド*」の「[DynamoDB の保管時の暗号化](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/EncryptionAtRest.html)」を参照してください。
### Amazon Redshift が DynamoDB テーブルキーにアクセスできません
ソーステーブルの暗号化が AWS マネージドキー の場合は、AWS 所有のキー またはカスタマーマネージドキーに切り替えてください。テーブルがカスタマーマネージドキーで既に暗号化されている場合は、ポリシーに条件キーが含まれていないことを確認してください。
## アプリケーションとのゼロ ETL 統合のトラブルシューティング
以下の情報を参考にして、Salesforce、SAP、ServiceNow、Zendesk などのアプリケーションとのゼロ ETL 統合に関してよく起きる問題をトラブルシューティングしてください。
**Topics**
+ [統合の作成に失敗しました](#zero-etl-using.troubleshooting.creation)
+ [テーブルが Amazon Redshift にレプリケートされない](#zero-etl-using.troubleshooting.primary-key)
+ [テーブル内のサポートされていないデータ型](#zero-etl-using.troubleshooting.unsupported-data)
+ [ワークグループのパラメータ設定が間違っています](#zero-etl-using.troubleshooting.case-sensitive)
+ [ゼロ ETL 統合を有効にするためにデータベースが作成されていません](#zero-etl-using.troubleshooting.db-creation)
+ [テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています](#zero-etl-using.troubleshooting.resync)
### 統合の作成に失敗しました
ゼロ ETL 統合の作成に失敗した場合、統合のステータスは `Inactive` になります。Amazon Redshift データウェアハウスに関して、以下の点が正しいことを確認してください。
+ 大文字と小文字の区別がオンになっています。「[データウェアハウスの大文字と小文字の区別を有効にする](zero-etl-setting-up.case-sensitivity.md)」を参照してください。
+ 名前空間に適切な認証済みプリンシパルと統合ソースを追加しました。「[Amazon Redshift データウェアハウスの認可を設定する](zero-etl-using.redshift-iam.md)」を参照してください。
### テーブルが Amazon Redshift にレプリケートされない
このデスティネーションデータベースには、1 つまたは複数のテーブルにプライマリキーがなく、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。テーブルにプライマリキーを追加すると、Amazon Redshift がテーブルを再同期します。次のコマンドを実行して再同期できます。{{dbname}} を Amazon Redshift データベースの名前に置き換えます。また、{{table1}} と {{table2}} を同期するテーブルの名前に置き換えます。
```
ALTER DATABASE {{dbname}} INTEGRATION REFRESH TABLES {{table1}}, {{table2}};
```
詳細については、「*Amazon Redshift データベースデベロッパーガイド*」の「[ALTER DATABASE](https://docs.aws.amazon.com/redshift/latest/dg/r_ALTER_DATABASE.html)」を参照してください。
### テーブル内のサポートされていないデータ型
Amazon Redshift で統合を通じて作成され、アプリケーションとのゼロ ETL 統合でデータがレプリケートされているデータベースで、1 つ以上のテーブルにサポート対象外のデータ型が含まれているため、同期できません。
この問題を解決するには、統合の詳細ページの **[テーブル統計]** タブに移動するか、SVV\_INTEGRATION\_TABLE\_STATE を使用して、障害が発生したテーブルを確認します。次に、これらのテーブルを削除し、ソースで新しいテーブルを再作成します。詳細については、「*AWS Glue デベロッパーガイド*」の「[ゼロ ETL 統合](https://docs.aws.amazon.com/glue/latest/dg/zero-etl-using.html)」を参照してください。
### ワークグループのパラメータ設定が間違っています
ワークグループで大文字と小文字の区別がオンになっていません。
この問題を解決するには、統合の詳細ページの **[プロパティ]** タブに移動してパラメータグループを選択し、**[プロパティ]** タブで大文字と小文字を区別する識別子をオンにします。既存のパラメータグループがない場合は、大文字と小文字を区別する識別子をオンにしてパラメータグループを作成してください。次に、新しいゼロ ETL 統合を作成します。詳細については、「*AWS Glue デベロッパーガイド*」の「[ゼロ ETL 統合](https://docs.aws.amazon.com/glue/latest/dg/zero-etl-using.html)」を参照してください。
### ゼロ ETL 統合を有効にするためにデータベースが作成されていません
ゼロ ETL 統合を有効にするためのデータベースが作成されていません。
この問題を解決するには、統合用のデータベースを作成します。詳細については、「[Amazon Redshift でのデスティネーションデータベースの作成](zero-etl-using.creating-db.md)」を参照してください。
### テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています
テーブルの状態が、**[再同期が必要です]** または **[再同期開始]** になっています。
テーブルがこのような状態になっている理由に関する詳細なエラー情報を収集するには、[SYS\_LOAD\_ERROR\_DETAIL](https://docs.aws.amazon.com/redshift/latest/dg/SYS_LOAD_ERROR_DETAIL.html) システムビューを使用します。