# AWS Glue の統合 API ## データ型 + [統合構造](#aws-glue-api-integrations-Integration) + [IntegrationConfig 構造](#aws-glue-api-integrations-IntegrationConfig) + [IntegrationPartition 構造](#aws-glue-api-integrations-IntegrationPartition) + [IntegrationError 構造](#aws-glue-api-integrations-IntegrationError) + [IntegrationFilter 構造](#aws-glue-api-integrations-IntegrationFilter) + [InboundIntegration 構造](#aws-glue-api-integrations-InboundIntegration) + [SourceProcessingProperties 構造](#aws-glue-api-integrations-SourceProcessingProperties) + [TargetProcessingProperties 構造](#aws-glue-api-integrations-TargetProcessingProperties) + [SourceTableConfig 構造](#aws-glue-api-integrations-SourceTableConfig) + [TargetTableConfig 構造](#aws-glue-api-integrations-TargetTableConfig) ## 統合構造 ゼロ ETL 統合について説明します。 **フィールド** + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットの ARN。 + `Description` – UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明 + `IntegrationName` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の一意の名前。 + `IntegrationArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `KmsKeyId` – UTF-8 文字列。1～2,048 バイト長。 チャネルの暗号化に使用される KMS キーの ARN。 + `AdditionalEncryptionContext` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。これは `KMSKeyId` が指定されている場合にのみ提供されます。 + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。 キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。 + `Status` – *必須:* UTF-8 文字列 (有効な値: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`)。 次のようなステータスがあります。 + CREATING: 統合を作成中です。 + ACTIVE: 統合の作成が完了しました。 + MODIFYING: 統合を変更中です。 + FAILED: 統合を作成できませんでした。 + DELETING: 統合が削除されました。 + SYNCING: 統合を同期中です。 + NEEDS\$1ATTENTION: 統合では同期などに注意を払う必要があります。 + `CreateTime` – *必須:* タイムスタンプ。 統合が作成された時刻 (UTC)。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 統合に関連付けられたプロパティ。 + `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) オブジェクトの配列。 統合に関連するエラーのリスト。 + `DataFilter` – UTF-8 文字列。1～2,048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 ## IntegrationConfig 構造 統合に関連付けられたプロパティ。 **フィールド** + `RefreshInterval` – UTF-8 文字列、1～128 バイト長。 CDC (Change Data Capture) プルまたは増分ロードが発生する頻度を指定します。このパラメータは、更新レートを特定のデータ更新パターン、システム負荷に関する考慮事項、パフォーマンス最適化の目標に柔軟に合わせることができます。時間増分は 15 分から 8640 分 (6 日間) に設定できます。 + `SourceProperties` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 統合ソースの追加プロパティを指定するキーと値のペアのコレクション。これらのプロパティにより、データ統合操作中に ODB ソースの動作をカスタマイズするために使用できる設定オプションが提供されます。 + `ContinuousSync` – ブール。 1) SaaS アプリケーションから Amazon Redshift や Amazon S3 などの AWS データサービスへ、および 2) DynamoDB から Amazon S3 へ、オンデマンドデータ抽出の継続的な同期を有効にします。 ## IntegrationPartition 構造 ターゲットでのデータのパーテイション化の方法を説明する構造。 **フィールド** + `FieldName` – UTF-8 文字列、1～128 バイト長。 ターゲットでのデータのパーテイション化に使用されるフィールド名。各行に一意の値を持つ列 (「LastModifiedTimestamp」や「SystemModTimeStamp」など) をパーティション列として使用することは避けてください。このような列は、多数の小さなパーティションを作成するため、パーティション分割には適していません。パフォーマンスの問題が発生する可能性があります。 + `FunctionSpec` – UTF-8 文字列、1～128 バイト長。 ターゲットのデータをパーティション分割するために使用する関数を指定します。このパラメータで使用できる値は次のとおりです。 + `identity` - 変換なしでソース値を直接使用する + `year` - タイムスタンプ値から年を抽出する (例: 2023) + `month` - タイムスタンプ値から月を抽出する (例: 2023-01) + `day` - タイムスタンプ値から日を抽出する (例: 2023-01-15) + `hour` - タイムスタンプ値から時間を抽出する (例: 2023-01-15-14) + `ConversionSpec` – UTF-8 文字列、1～128 バイト長。 ソースデータのタイムスタンプ形式を指定します。次の値を指定できます。 + `epoch_sec` – UNIX エポックタイムスタンプ (秒単位) + `epoch_milli` – UNIX エポックタイムスタンプ (ミリ秒単位) + `iso` – ISO 8601 形式のタイムスタンプ **注記** タイムスタンプベースのパーティション関数 (年、月、日、時間) を使用するときにのみ `ConversionSpec` を指定します。AWS Glueゼロ ETL はこのパラメータを使用し、パーティショニング前にソースデータをタイムスタンプ形式に正しく変換します。 `identity` パーティション関数を持つ高カーディナリティ列を使用しないでください。高カーディナリティ列には次のものが含まれます。 プライマリキー タイムスタンプフィールド (`LastModifiedTimestamp` や `CreatedDate` など) システム生成されたタイムスタンプ ID パーティショニングを持つ高カーディナリティ列を使用すると、小さなパーティションが多く作成され、取り込みパフォーマンスが大幅に低下する可能性があります。 ## IntegrationError 構造 ゼロ ETL 統合に関連するエラー。 **フィールド** + `ErrorCode` – UTF-8 文字列、1～128 バイト長。 このエラーに関連付けられたコード。 + `ErrorMessage` – UTF-8 文字列。1～2048 バイト長。 エラーを説明するメッセージ。 ## IntegrationFilter 構造 `DescribeIntegrations` リクエストを呼び出すときに使用できるフィルター。 **フィールド** + `Name` – UTF-8 文字列、1～128 バイト長。 フィルターの名前。 + `Values` – UTF-8 文字列の配列。 フィルタ値のリスト。 ## InboundIntegration 構造 リソースにデータを書き込む統合の構造。 **フィールド** + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースリソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットリソースの ARN。 + `IntegrationArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ゼロ ETL 統合の ARN。 + `Status` – *必須:* UTF-8 文字列 (有効な値: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`)。 次のようなステータスがあります。 + CREATING: 統合を作成中です。 + ACTIVE: 統合の作成が完了しました。 + MODIFYING: 統合を変更中です。 + FAILED: 統合を作成できませんでした。 + DELETING: 統合が削除されました。 + SYNCING: 統合を同期中です。 + NEEDS\$1ATTENTION: 統合では同期などに注意を払う必要があります。 + `CreateTime` – *必須:* タイムスタンプ。 統合が作成された時刻 (UTC)。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 統合に関連付けられたプロパティ。 + `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) オブジェクトの配列。 統合に関連するエラーのリスト。 ## SourceProcessingProperties 構造 統合ソースに関連付けられたリソースプロパティ。 **フィールド** + `RoleArn` – UTF-8 文字列、1～128 バイト長。 AWS Glue 接続にアクセスするための IAM ロール。 ## TargetProcessingProperties 構造 統合ターゲットに関連付けられたリソースプロパティ。 **フィールド** + `RoleArn` – UTF-8 文字列、1～128 バイト長。 AWS Glue データベースにアクセスするための IAM ロール。 + `KmsArn` – UTF-8 文字列。1～2,048 バイト長。 暗号化に使用される KMS キーの ARN。 + `ConnectionName` – UTF-8 文字列、1～128 バイト長。 カスタマー VPC で実行されている AWS Glue ジョブを設定する AWS Glue ネットワーク接続。 + `EventBusArn` – UTF-8 文字列。1～2048 バイト長。 統合ステータスの通知を受け取る Eventbridge イベントバスの ARN。 ## SourceTableConfig 構造 ソースレッグがソースからのデータを処理する際に使用するプロパティ。 **フィールド** + `Fields` – UTF-8 文字列の配列。 列レベルのフィルタリングに使用されるフィールドのリスト。現在サポートされていません。 + `FilterPredicate` – UTF-8 文字列、1～128 バイト長。 行レベルのフィルタリングに使用される条件句。現在サポートされていません。 + `PrimaryKey` – UTF-8 文字列の配列。 このテーブルのプライマリキーセットを指定します。現在、リクエストに応じて SAP `EntityOf` エンティティ専用にサポートされています。AWS サポートに連絡して、この機能を利用できるようにします。 + `RecordUpdateField` – UTF-8 文字列、1～128 バイト長。 増分プルのタイムスタンプベースのフィールド。現在サポートされていません。 ## TargetTableConfig 構造 ターゲットのデータをパーティション化するためにターゲットレッグで使用されるプロパティ。 **フィールド** + `UnnestSpec` – UTF-8 文字列 (有効な値: `TOPLEVEL` \$1 `FULL` \$1 `NOUNNEST`)。 ネストされたオブジェクトを最上位の要素に平板化する方法を指定します。有効な値は "TOPLEVEL"、"FULL"、"NOUNNEST" のいずれかです。 + `PartitionSpec` – [IntegrationPartition](#aws-glue-api-integrations-IntegrationPartition) オブジェクトの配列。 ターゲットのファイルレイアウトを決定します。 + `TargetTableName` – UTF-8 文字列、1～128 バイト長。 ターゲットテーブルのオプションの名前です。 ## 操作 + [CreateIntegration アクション (Python: create\$1integration)](#aws-glue-api-integrations-CreateIntegration) + [ModifyIntegration アクション (Python: modify\$1integration)](#aws-glue-api-integrations-ModifyIntegration) + [DescribeIntegrations アクション (Python: describe\$1integrations)](#aws-glue-api-integrations-DescribeIntegrations) + [DeleteIntegration アクション (Python: delete\$1integration)](#aws-glue-api-integrations-DeleteIntegration) + [DescribeInboundIntegrations アクション (Python: describe\$1inbound\$1integrations)](#aws-glue-api-integrations-DescribeInboundIntegrations) + [CreateIntegrationTableProperties アクション (Python: create\$1integration\$1table\$1properties)](#aws-glue-api-integrations-CreateIntegrationTableProperties) + [UpdateIntegrationTableProperties アクション (Python: update\$1integration\$1table\$1properties)](#aws-glue-api-integrations-UpdateIntegrationTableProperties) + [GetIntegrationTableProperties アクション (Python: get\$1integration\$1table\$1properties)](#aws-glue-api-integrations-GetIntegrationTableProperties) + [DeleteIntegrationTableProperties アクション (Python: delete\$1integration\$1table\$1properties)](#aws-glue-api-integrations-DeleteIntegrationTableProperties) + [CreateIntegrationResourceProperty アクション (Python: create\$1integration\$1resource\$1property)](#aws-glue-api-integrations-CreateIntegrationResourceProperty) + [UpdateIntegrationResourceProperty アクション (Python: update\$1integration\$1resource\$1property)](#aws-glue-api-integrations-UpdateIntegrationResourceProperty) + [GetIntegrationResourceProperty アクション (Python: get\$1integration\$1resource\$1property)](#aws-glue-api-integrations-GetIntegrationResourceProperty) + [UntagResource アクション (Python: untag\$1resource)](#aws-glue-api-integrations-UntagResource) + [ListTagsForResource アクション (Python: list\$1tags\$1for\$1resource)](#aws-glue-api-integrations-ListTagsForResource) ## CreateIntegration アクション (Python: create\$1integration) Amazon リソースネーム (ARN) を持つ 2 つのリソースである `SourceArn` と `TargetArn` の間で、発信者のアカウントにゼロ ETL 統合を作成します。 **リクエスト** + `IntegrationName` – *必須:* UTF-8 文字列。1～128 バイト長。 AWS Glue での統合の一意の名前。 + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースリソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットリソースの ARN。 + `Description` – UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明。 + `DataFilter` – UTF-8 文字列。1～2,048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 + `KmsKeyId` – UTF-8 文字列。1～2,048 バイト長。 チャネルの暗号化に使用される KMS キーの ARN。 + `AdditionalEncryptionContext` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。これは `KMSKeyId` が指定されている場合にのみ提供されます。 + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。 キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 構成設定。 **応答** + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースリソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットリソースの ARN。 + `IntegrationName` – *必須:* UTF-8 文字列。1～128 バイト長。 AWS Glue での統合の一意の名前。 + `Description` - UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明。 + `IntegrationArn` – *必須:* UTF-8 文字列。1～128 バイト長。 作成した統合の Amazon リソースネーム (ARN)。 + `KmsKeyId` – UTF-8 文字列。1～2,048 バイト長。 チャネルの暗号化に使用される KMS キーの ARN。 + `AdditionalEncryptionContext` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。 + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。 キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。 + `Status` – *必須:* UTF-8 文字列 (有効な値: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`)。 作成中の統合のステータス。 次のようなステータスがあります。 + CREATING: 統合を作成中です。 + ACTIVE: 統合の作成が完了しました。 + MODIFYING: 統合を変更中です。 + FAILED: 統合を作成できませんでした。 + DELETING: 統合が削除されました。 + SYNCING: 統合を同期中です。 + NEEDS\$1ATTENTION: 統合では同期などに注意を払う必要があります。 + `CreateTime` – *必須:* タイムスタンプ。 統合が作成された時刻 (UTC)。 + `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) オブジェクトの配列。 統合の作成に関連するエラーのリスト。 + `DataFilter` – UTF-8 文字列、1～2048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 構成設定。 **エラー** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `IntegrationConflictOperationFault` + `IntegrationQuotaExceededFault` + `KMSKeyNotAccessibleFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `ResourceNumberLimitExceededException` + `InvalidInputException` ## ModifyIntegration アクション (Python: modify\$1integration) 発信者のアカウントでゼロ ETL 統合を変更します。 **リクエスト** + `IntegrationIdentifier` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `Description` – UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明。 + `DataFilter` – UTF-8 文字列。1～2,048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 統合の構成設定。現在、RefreshInterval のみを変更できます。 + `IntegrationName` – UTF-8 文字列、1～128 バイト長。 AWS Glue での統合の一意の名前。 **応答** + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットの ARN。 + `IntegrationName` – *必須:* UTF-8 文字列。1～128 バイト長。 AWS Glue での統合の一意の名前。 + `Description` - UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明。 + `IntegrationArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `KmsKeyId` – UTF-8 文字列。1～2,048 バイト長。 チャネルの暗号化に使用される KMS キーの ARN。 + `AdditionalEncryptionContext` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。 + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。 キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。 + `Status` – *必須:* UTF-8 文字列 (有効な値: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`)。 変更中の統合のステータス。 次のようなステータスがあります。 + CREATING: 統合を作成中です。 + ACTIVE: 統合の作成が完了しました。 + MODIFYING: 統合を変更中です。 + FAILED: 統合を作成できませんでした。 + DELETING: 統合が削除されました。 + SYNCING: 統合を同期中です。 + NEEDS\$1ATTENTION: 統合では同期などに注意を払う必要があります。 + `CreateTime` – *必須:* タイムスタンプ。 統合が作成された時刻 (UTC)。 + `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) オブジェクトの配列。 統合の変更に関連するエラーのリスト。 + `DataFilter` – UTF-8 文字列。1～2,048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) オブジェクト。 統合の更新された設定。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `IntegrationConflictOperationFault` + `InvalidIntegrationStateFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `InvalidStateException` + `InvalidInputException` ## DescribeIntegrations アクション (Python: describe\$1integrations) この API は統合のリストを取得するために使用されます。 **リクエスト** + `IntegrationIdentifier` – UTF-8 文字列、1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `Marker` – UTF-8 文字列、1～128 バイト長。 後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。 + `MaxRecords` – 数値 (整数)。 出力で返される項目の総数。 + `Filters` – [IntegrationFilter](#aws-glue-api-integrations-IntegrationFilter) オブジェクトの配列。 結果をフィルタリングするためのキーと値のリスト。サポートされているキーは "Status"、"IntegrationName"、"SourceArn" です。IntegrationName は 1 つの値のみに制限されています。 **応答** + `Integrations` – [統合](#aws-glue-api-integrations-Integration) オブジェクトの配列。 ゼロ ETL 統合のリスト。 + `Marker` – UTF-8 文字列、1～128 バイト長。 後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## DeleteIntegration アクション (Python: delete\$1integration) 指定されたゼロ ETL 統合を削除します。 **リクエスト** + `IntegrationIdentifier` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 **応答** + `SourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のソースの ARN。 + `TargetArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合のターゲットの ARN。 + `IntegrationName` – *必須:* UTF-8 文字列。1～128 バイト長。 AWS Glue での統合の一意の名前。 + `Description` - UTF-8 文字列。1,000 バイト長以下。[Custom string pattern #12](aws-glue-api-common.md#regex_12) に一致。 統合の説明。 + `IntegrationArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `KmsKeyId` – UTF-8 文字列。1～2,048 バイト長。 チャネルの暗号化に使用される KMS キーの ARN。 + `AdditionalEncryptionContext` – キーバリューペアのマップ配列。 各キーは UTF-8 文字列。 各値は UTF-8 文字列。 暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。 + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。 キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。 + `Status` – *必須:* UTF-8 文字列 (有効な値: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`)。 削除される統合のステータス。 次のようなステータスがあります。 + CREATING: 統合を作成中です。 + ACTIVE: 統合の作成が完了しました。 + MODIFYING: 統合を変更中です。 + FAILED: 統合を作成できませんでした。 + DELETING: 統合が削除されました。 + SYNCING: 統合を同期中です。 + NEEDS\$1ATTENTION: 統合では同期などに注意を払う必要があります。 + `CreateTime` – *必須:* タイムスタンプ。 統合が作成された時刻 (UTC)。 + `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) オブジェクトの配列。 統合に関連するエラーのリスト。 + `DataFilter` – UTF-8 文字列。1～2,048 バイト長。 Maxwell フィルター構文を使用して統合のソーステーブルを選択します。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `IntegrationConflictOperationFault` + `InvalidIntegrationStateFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `InvalidStateException` + `InvalidInputException` ## DescribeInboundIntegrations アクション (Python: describe\$1inbound\$1integrations) 指定された統合のインバウンド統合のリストを返します。 **リクエスト** + `IntegrationArn` – UTF-8 文字列、1～128 バイト長。 統合の Amazon リソースネーム (ARN)。 + `Marker` – UTF-8 文字列、1～128 バイト長。 ページ分割を始める場所を指定するトークン。こちらは以前に切り捨てられた応答のマーカーです。 + `MaxRecords` – 数値 (整数)。 出力で返される項目の総数。 + `TargetArn` – UTF-8 文字列、1～128 バイト長。 統合内のターゲットリソースの Amazon リソースネーム (ARN)。 **応答** + `InboundIntegrations` – [InboundIntegration](#aws-glue-api-integrations-InboundIntegration) オブジェクトの配列。 インバウンド統合のリスト。 + `Marker` – UTF-8 文字列、1～128 バイト長。 後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `TargetResourceNotFound` + `OperationNotSupportedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## CreateIntegrationTableProperties アクション (Python: create\$1integration\$1table\$1properties) この API は、レプリケートする必要があるテーブルに対してオプションのオーバーライドプロパティを提供するために使用されます。これらのプロパティには、ソーステーブルとターゲットテーブルのフィルタリングとパーテイション化のためのプロパティを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を `SourceTableConfig` で `ResourceArn` として、AWS Glue データベース ARN を `TargetTableConfig` で `ResourceArn` としてそれぞれ指定し、同じ API を呼び出す必要があります。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合テーブルプロパティを作成するターゲットテーブルの Amazon リソースネーム (ARN)。現在、この API はターゲットテーブルの統合テーブルプロパティ作成のみをサポートしており、提供される ARN は AWS Glue データカタログのターゲットテーブルの ARN である必要があります。ソース接続の統合テーブルプロパティの作成によるサポート (接続 ARN の使用) はまだ実装されておらず、今後のリリースに追加されます。 + `TableName` – *必須:* UTF-8 文字列。1～128 バイト長。 レプリケートするテーブルの名前。 + `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) オブジェクト。 ソーステーブル設定の構造。サポートされているソースプロパティのリストについては、`SourceTableConfig` 構造を参照してください。 + `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) オブジェクト。 ターゲットテーブル設定の構造。 **応答** + *応答パラメータはありません。* **エラー** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## UpdateIntegrationTableProperties アクション (Python: update\$1integration\$1table\$1properties) この API は、レプリケートする必要があるテーブルに対してオプションのオーバーライドプロパティを提供するために使用されます。これらのプロパティには、ソーステーブルとターゲットテーブルのフィルタリングとパーテイション化のためのプロパティを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を `SourceTableConfig` で `ResourceArn` として、AWS Glue データベース ARN を `TargetTableConfig` で `ResourceArn` としてそれぞれ指定し、同じ API を呼び出す必要があります。 オーバーライドは、同じ `ResourceArn` とソーステーブルを使用するすべての統合に反映されます。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `TableName` – *必須:* UTF-8 文字列。1～128 バイト長。 レプリケートするテーブルの名前。 + `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) オブジェクト。 ソーステーブル設定の構造。 + `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) オブジェクト。 ターゲットテーブル設定の構造。 **応答** + *応答パラメータはありません。* **エラー** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## GetIntegrationTableProperties アクション (Python: get\$1integration\$1table\$1properties) この API は、レプリケートする必要があるテーブルに対してオプションのオーバーライドプロパティを取得するために使用されます。これらのプロパティには、ソーステーブルとターゲットテーブルのフィルタリングとパーテイションのためのプロパティを含めることができます。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 統合テーブルプロパティを取得するターゲットテーブルの Amazon リソースネーム (ARN)。現在、この API はターゲットテーブルのプロパティ取得のみをサポートしており、提供される ARN は AWS Glue データカタログのターゲットテーブルの ARN である必要があります。ソース接続の統合テーブルプロパティの取得によるサポート (接続 ARN の使用) はまだ実装されておらず、今後のリリースに追加されます。 + `TableName` – *必須:* UTF-8 文字列。1～128 バイト長。 レプリケートするテーブルの名前。 **応答** + `ResourceArn` – UTF-8 文字列、1～128 バイト長。 統合テーブルプロパティを取得するターゲットテーブルの Amazon リソースネーム (ARN)。現在、この API はターゲットテーブルのプロパティ取得のみをサポートしており、提供される ARN は AWS Glue データカタログのターゲットテーブルの ARN である必要があります。ソース接続の統合テーブルプロパティの取得によるサポート (接続 ARN の使用) はまだ実装されておらず、今後のリリースに追加されます。 + `TableName` – UTF-8 文字列、1～128 バイト長。 レプリケートするテーブルの名前。 + `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) オブジェクト。 ソーステーブル設定の構造。 + `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) オブジェクト。 ターゲットテーブル設定の構造。 **エラー** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## DeleteIntegrationTableProperties アクション (Python: delete\$1integration\$1table\$1properties) レプリケートする必要があるテーブル用に作成されたテーブルプロパティを削除します。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `TableName` – *必須:* UTF-8 文字列。1～128 バイト長。 レプリケートするテーブルの名前。 **応答** + *応答パラメータはありません。* **エラー** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## CreateIntegrationResourceProperty アクション (Python: create\$1integration\$1resource\$1property) この API は、AWS Glue 接続の `ResourceProperty` (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) をセットアップするために使用できます。これらのプロパティには、接続またはデータベースにアクセスするためのロールを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を `SourceProcessingProperties` で `ResourceArn` として、AWS Glue データベース ARN を `TargetProcessingProperties` で `ResourceArn` としてそれぞれ指定し、同じ API を呼び出す必要があります。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) オブジェクト。 統合ソースに関連付けられたリソースプロパティ。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) オブジェクト。 統合ターゲットに関連付けられたリソースプロパティ。 **応答** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) オブジェクト。 統合ソースに関連付けられたリソースプロパティ。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) オブジェクト。 統合ターゲットに関連付けられたリソースプロパティ。 **エラー** + `ValidationException` + `AccessDeniedException` + `ConflictException` + `InternalServerException` + `ResourceNotFoundException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## UpdateIntegrationResourceProperty アクション (Python: update\$1integration\$1resource\$1property) この API は、AWS Glue 接続の `ResourceProperty` (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) を更新するために使用できます。これらのプロパティには、接続またはデータベースにアクセスするためのロールを含めることができます。同じリソースを複数の統合で使用できるため、リソースプロパティを更新すると、そのリソースを使用しているすべての統合に影響します。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) オブジェクト。 統合ソースに関連付けられたリソースプロパティ。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) オブジェクト。 統合ターゲットに関連付けられたリソースプロパティ。 **応答** + `ResourceArn` – UTF-8 文字列、1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) オブジェクト。 統合ソースに関連付けられたリソースプロパティ。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) オブジェクト。 統合ターゲットに関連付けられたリソースプロパティ。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `ResourceNotFoundException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## GetIntegrationResourceProperty アクション (Python: get\$1integration\$1resource\$1property) この API は、AWS Glue 接続の `ResourceProperty` (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) の取得に使用されます。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 **応答** + `ResourceArn` – UTF-8 文字列、1～128 バイト長。 ソースの接続 ARN、またはターゲットのデータベース ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) オブジェクト。 統合ソースに関連付けられたリソースプロパティ。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) オブジェクト。 統合ターゲットに関連付けられたリソースプロパティ。 **エラー** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `ResourceNotFoundException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## UntagResource アクション (Python: untag\$1resource) 統合リソースから指定したタグを削除します。 **リクエスト** + `ResourceArn` – *必須:* UTF-8 文字列。1～10,240 バイト長。[Custom string pattern #50](aws-glue-api-common.md#regex_50) に一致。 統合リソースの Amazon リソースネーム (ARN)。 + `TagsToRemove` – *必須:* UTF-8 文字列の配列。文字列 50 個以下。 リソースから削除するメタデータタグのリスト。 **応答** + *応答パラメータはありません。* **エラー** + `ResourceNotFoundException` ## ListTagsForResource アクション (Python: list\$1tags\$1for\$1resource) 指定したリソースに割り当てたメタデータタグの一覧。 **リクエスト** + `ResourceARN` – *必須:* UTF-8 文字列。1～10,240 バイト長。[Custom string pattern #50](aws-glue-api-common.md#regex_50) に一致。 リソースのリソース ARN。 **応答** + `Tags` – [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) オブジェクトの配列。構造体 10 個以下。 タグのリスト。 **エラー** + `ResourceNotFoundException` ## 例外 + [ResourceNotFoundException structure](#aws-glue-api-integrations-ResourceNotFoundException) + [InternalServerException 構造](#aws-glue-api-integrations-InternalServerException) + [IntegrationAlreadyExistsFault 構造](#aws-glue-api-integrations-IntegrationAlreadyExistsFault) + [IntegrationConflictOperationFault 構造](#aws-glue-api-integrations-IntegrationConflictOperationFault) + [IntegrationQuotaExceededFault 構造](#aws-glue-api-integrations-IntegrationQuotaExceededFault) + [KMSKeyNotAccessibleFault (構造)](#aws-glue-api-integrations-KMSKeyNotAccessibleFault) + [IntegrationNotFoundFault 構造](#aws-glue-api-integrations-IntegrationNotFoundFault) + [TargetResourceNotFound 構造](#aws-glue-api-integrations-TargetResourceNotFound) + [InvalidIntegrationStateFault 構造](#aws-glue-api-integrations-InvalidIntegrationStateFault) ## ResourceNotFoundException structure リソースが見つかりませんでした。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## InternalServerException 構造 内部サーバーエラーが発生しました。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## IntegrationAlreadyExistsFault 構造 指定された統合は既に存在します。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## IntegrationConflictOperationFault 構造 リクエストされたオペレーションは別のオペレーションと競合しています。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## IntegrationQuotaExceededFault 構造 統合によって処理されたデータがクォータを超えました。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## KMSKeyNotAccessibleFault (構造) 指定された KMS キーにアクセスできません。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## IntegrationNotFoundFault 構造 指定された統合が見つかりませんでした。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## TargetResourceNotFound 構造 ターゲットリソースが見つかりませんでした。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。 ## InvalidIntegrationStateFault 構造 統合が無効な状態です。 **フィールド** + `Message` – UTF-8 文字列。 問題を説明するメッセージ。