AWS Glue の統合 API - AWS Glue

AWS Glue の統合 API

データ型

統合構造

ゼロ ETL 統合について説明します。

フィールド
  • SourceArn必須: UTF-8 文字列。1~128 バイト長。

    統合のソースの ARN。

  • TargetArn必須: UTF-8 文字列。1~128 バイト長。

    統合のターゲットの ARN。

  • Description – UTF-8 文字列。1,000 バイト長以下。Custom string pattern #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 が指定されている場合にのみ提供されます。

  • TagsTag オブジェクトの配列。

    キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。

  • Status必須: UTF-8 文字列 (有効な値: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING | NEEDS_ATTENTION)。

    次のようなステータスがあります。

    • CREATING: 統合を作成中です。

    • ACTIVE: 統合の作成が完了しました。

    • MODIFYING: 統合を変更中です。

    • FAILED: 統合を作成できませんでした。

    • DELETING: 統合が削除されました。

    • SYNCING: 統合を同期中です。

    • NEEDS_ATTENTION: 統合では同期などに注意を払う必要があります。

  • CreateTime必須: タイムスタンプ。

    統合が作成された時刻 (UTC)。

  • IntegrationConfigIntegrationConfig オブジェクト。

    統合に関連付けられたプロパティ。

  • ErrorsIntegrationError オブジェクトの配列。

    統合に関連するエラーのリスト。

  • DataFilter – UTF-8 文字列。1~2,048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

IntegrationConfig 構造

統合に関連付けられたプロパティ。

フィールド
  • RefreshInterval – UTF-8 文字列、1~128 バイト長。

    CDC (Change Data Capture) プルまたは増分ロードが発生する頻度を指定します。このパラメータは、更新レートを特定のデータ更新パターン、システム負荷に関する考慮事項、パフォーマンス最適化の目標に柔軟に合わせることができます。時間増分は 15 分から 8640 分 (6 日間) に設定できます。現在、RefreshInterval の作成のみをサポートしています。

IntegrationPartition 構造

ターゲットでのデータのパーテイション化の方法を説明する構造。

フィールド
  • FieldName – UTF-8 文字列、1~128 バイト長。

    ターゲットでのデータのパーテイション化に使用されるフィールド名。各行に一意の値を持つ列 (「LastModifiedTimestamp」や「SystemModTimeStamp」など) をパーティション列として使用することは避けてください。このような列は、多数の小さなパーティションを作成するため、パーティション分割には適していません。パフォーマンスの問題が発生する可能性があります。

  • FunctionSpec – UTF-8 文字列、1~128 バイト長。

    ターゲットのデータをパーティション分割するために使用する関数を指定します。このパラメータで許可される唯一の値は "identity" (文字列) です。"identity" 関数は、ターゲット上のデータパーティション分割がソースと同じスキームに従うことを保証します。したがって、ソースデータのパーティション構造がターゲット送信先に保持されます。

  • ConversionSpec – UTF-8 文字列、1~128 バイト長。

    ソースデータのタイムスタンプ形式を指定します。次の値を指定できます:

    • epoch_sec – UNIX エポックタイムスタンプ (秒単位)

    • epoch_milli – UNIX エポックタイムスタンプ (ミリ秒単位)

    • iso – ISO 8601 形式のタイムスタンプ

    注記

    タイムスタンプベースのパーティション関数 (年、月、日、時間) を使用するときにのみ ConversionSpec を指定します。AWS Glueゼロ ETL はこのパラメータを使用し、パーティショニング前にソースデータをタイムスタンプ形式に正しく変換します。

    identity パーティション関数を持つ高カーディナリティ列を使用しないでください。高カーディナリティ列には次のものが含まれます。

    • プライマリキー

    • タイムスタンプフィールド (LastModifiedTimestampCreatedDate など)

    • システム生成されたタイムスタンプ

    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 | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING | NEEDS_ATTENTION)。

    次のようなステータスがあります。

    • CREATING: 統合を作成中です。

    • ACTIVE: 統合の作成が完了しました。

    • MODIFYING: 統合を変更中です。

    • FAILED: 統合を作成できませんでした。

    • DELETING: 統合が削除されました。

    • SYNCING: 統合を同期中です。

    • NEEDS_ATTENTION: 統合では同期などに注意を払う必要があります。

  • CreateTime必須: タイムスタンプ。

    統合が作成された時刻 (UTC)。

  • IntegrationConfigIntegrationConfig オブジェクト。

    統合に関連付けられたプロパティ。

  • ErrorsIntegrationError オブジェクトの配列。

    統合に関連するエラーのリスト。

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 | FULL | NOUNNEST)。

    ネストされたオブジェクトを最上位の要素に平板化する方法を指定します。有効な値は "TOPLEVEL"、"FULL"、"NOUNNEST" のいずれかです。

  • PartitionSpecIntegrationPartition オブジェクトの配列。

    ターゲットのファイルレイアウトを決定します。

  • TargetTableName – UTF-8 文字列、1~128 バイト長。

    ターゲットテーブルのオプションの名前です。

操作

CreateIntegration アクション (Python: create_integration)

Amazon リソースネーム (ARN) を持つ 2 つのリソースである SourceArnTargetArn の間で、発信者のアカウントにゼロ 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 に一致。

    統合の説明。

  • DataFilter – UTF-8 文字列。1~2,048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

  • KmsKeyId – UTF-8 文字列。1~2,048 バイト長。

    チャネルの暗号化に使用される KMS キーの ARN。

  • AdditionalEncryptionContext – キーバリューペアのマップ配列。

    各キーは UTF-8 文字列。

    各値は UTF-8 文字列。

    暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。これは KMSKeyId が指定されている場合にのみ提供されます。

  • TagsTag オブジェクトの配列。

    キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。

  • IntegrationConfigIntegrationConfig オブジェクト。

    構成設定。

レスポンス
  • 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 に一致。

    統合の説明。

  • IntegrationArn必須: UTF-8 文字列。1~128 バイト長。

    作成した統合の Amazon リソースネーム (ARN)。

  • KmsKeyId – UTF-8 文字列。1~2,048 バイト長。

    チャネルの暗号化に使用される KMS キーの ARN。

  • AdditionalEncryptionContext – キーバリューペアのマップ配列。

    各キーは UTF-8 文字列。

    各値は UTF-8 文字列。

    暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。

  • TagsTag オブジェクトの配列。

    キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。

  • Status必須: UTF-8 文字列 (有効な値: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING | NEEDS_ATTENTION)。

    作成中の統合のステータス。

    次のようなステータスがあります。

    • CREATING: 統合を作成中です。

    • ACTIVE: 統合の作成が完了しました。

    • MODIFYING: 統合を変更中です。

    • FAILED: 統合を作成できませんでした。

    • DELETING: 統合が削除されました。

    • SYNCING: 統合を同期中です。

    • NEEDS_ATTENTION: 統合では同期などに注意を払う必要があります。

  • CreateTime必須: タイムスタンプ。

    統合が作成された時刻 (UTC)。

  • ErrorsIntegrationError オブジェクトの配列。

    統合の作成に関連するエラーのリスト。

  • DataFilter – UTF-8 文字列、1~2048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

  • IntegrationConfigIntegrationConfig オブジェクト。

    構成設定。

エラー
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • IntegrationConflictOperationFault

  • IntegrationQuotaExceededFault

  • KMSKeyNotAccessibleFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • ResourceNumberLimitExceededException

  • InvalidInputException

ModifyIntegration アクション (Python: modify_integration)

発信者のアカウントでゼロ ETL 統合を変更します。

リクエスト
  • IntegrationIdentifier必須: UTF-8 文字列。1~128 バイト長。

    統合の Amazon リソースネーム (ARN)。

  • Description – UTF-8 文字列。1,000 バイト長以下。Custom string pattern #12 に一致。

    統合の説明。

  • DataFilter – UTF-8 文字列。1~2,048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

  • 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 に一致。

    統合の説明。

  • IntegrationArn必須: UTF-8 文字列。1~128 バイト長。

    統合の Amazon リソースネーム (ARN)。

  • KmsKeyId – UTF-8 文字列。1~2,048 バイト長。

    チャネルの暗号化に使用される KMS キーの ARN。

  • AdditionalEncryptionContext – キーバリューペアのマップ配列。

    各キーは UTF-8 文字列。

    各値は UTF-8 文字列。

    暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。

  • TagsTag オブジェクトの配列。

    キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。

  • Status必須: UTF-8 文字列 (有効な値: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING | NEEDS_ATTENTION)。

    変更中の統合のステータス。

    次のようなステータスがあります。

    • CREATING: 統合を作成中です。

    • ACTIVE: 統合の作成が完了しました。

    • MODIFYING: 統合を変更中です。

    • FAILED: 統合を作成できませんでした。

    • DELETING: 統合が削除されました。

    • SYNCING: 統合を同期中です。

    • NEEDS_ATTENTION: 統合では同期などに注意を払う必要があります。

  • CreateTime必須: タイムスタンプ。

    統合が作成された時刻 (UTC)。

  • ErrorsIntegrationError オブジェクトの配列。

    統合の変更に関連するエラーのリスト。

  • DataFilter – UTF-8 文字列。1~2,048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeIntegrations アクション (Python: describe_integrations)

この API は統合のリストを取得するために使用されます。

リクエスト
  • IntegrationIdentifier – UTF-8 文字列、1~128 バイト長。

    統合の Amazon リソースネーム (ARN)。

  • Marker – UTF-8 文字列、1~128 バイト長。

    後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。

  • MaxRecords – 数値 (整数)。

    出力で返される項目の総数。

  • FiltersIntegrationFilter オブジェクトの配列。

    結果をフィルタリングするためのキーと値のリスト。サポートされているキーは "Status"、"IntegrationName"、"SourceArn" です。IntegrationName は 1 つの値のみに制限されています。

応答
  • IntegrationsIntegration オブジェクトの配列。

    ゼロ ETL 統合のリスト。

  • Marker – UTF-8 文字列、1~128 バイト長。

    後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegration アクション (Python: delete_integration)

指定されたゼロ 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 に一致。

    統合の説明。

  • IntegrationArn必須: UTF-8 文字列。1~128 バイト長。

    統合の Amazon リソースネーム (ARN)。

  • KmsKeyId – UTF-8 文字列。1~2,048 バイト長。

    チャネルの暗号化に使用される KMS キーの ARN。

  • AdditionalEncryptionContext – キーバリューペアのマップ配列。

    各キーは UTF-8 文字列。

    各値は UTF-8 文字列。

    暗号化のための追加のコンテキスト情報を含む、シークレット以外のキーと値のペアのオプションセット。

  • TagsTag オブジェクトの配列。

    キーと値のペアのリストで構成されるリソースに割り当てられるメタデータ。

  • Status必須: UTF-8 文字列 (有効な値: CREATING | ACTIVE | MODIFYING | FAILED | DELETING | SYNCING | NEEDS_ATTENTION)。

    削除される統合のステータス。

    次のようなステータスがあります。

    • CREATING: 統合を作成中です。

    • ACTIVE: 統合の作成が完了しました。

    • MODIFYING: 統合を変更中です。

    • FAILED: 統合を作成できませんでした。

    • DELETING: 統合が削除されました。

    • SYNCING: 統合を同期中です。

    • NEEDS_ATTENTION: 統合では同期などに注意を払う必要があります。

  • CreateTime必須: タイムスタンプ。

    統合が作成された時刻 (UTC)。

  • ErrorsIntegrationError オブジェクトの配列。

    統合に関連するエラーのリスト。

  • DataFilter – UTF-8 文字列。1~2,048 バイト長。

    Maxwell フィルター構文を使用して統合のソーステーブルを選択します。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • IntegrationConflictOperationFault

  • InvalidIntegrationStateFault

  • EntityNotFoundException

  • InternalServiceException

  • ConflictException

  • InvalidStateException

  • InvalidInputException

DescribeInboundIntegrations アクション (Python: describe_inbound_integrations)

指定された統合のインバウンド統合のリストを返します。

リクエスト
  • IntegrationArn – UTF-8 文字列、1~128 バイト長。

    統合の Amazon リソースネーム (ARN)。

  • Marker – UTF-8 文字列、1~128 バイト長。

    ページ分割を始める場所を指定するトークン。こちらは以前に切り捨てられた応答のマーカーです。

  • MaxRecords – 数値 (整数)。

    出力で返される項目の総数。

  • TargetArn – UTF-8 文字列、1~128 バイト長。

    統合内のターゲットリソースの Amazon リソースネーム (ARN)。

応答
  • InboundIntegrationsInboundIntegration オブジェクトの配列。

    インバウンド統合のリスト。

  • Marker – UTF-8 文字列、1~128 バイト長。

    後続のリクエストにおけるレスポンスレコードの次回のセット開始点を示す値。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • IntegrationNotFoundFault

  • TargetResourceNotFound

  • OperationNotSupportedException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationTableProperties アクション (Python: create_integration_table_properties)

この API は、レプリケートする必要があるテーブルに対してオプションのオーバーライドプロパティを提供するために使用されます。これらのプロパティには、ソーステーブルとターゲットテーブルのフィルタリングとパーテイション化のためのプロパティを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を SourceTableConfigResourceArn として、AWS Glue データベース ARN を TargetTableConfigResourceArn としてそれぞれ指定し、同じ API を呼び出す必要があります。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    統合テーブルプロパティを作成するターゲットテーブルの Amazon リソースネーム (ARN)。現在、この API はターゲットテーブルの統合テーブルプロパティ作成のみをサポートしており、提供される ARN は AWS Glue データカタログのターゲットテーブルの ARN である必要があります。ソース接続の統合テーブルプロパティの作成によるサポート (接続 ARN の使用) はまだ実装されておらず、今後のリリースに追加されます。

  • TableName必須: UTF-8 文字列。1~128 バイト長。

    レプリケートするテーブルの名前。

  • SourceTableConfigSourceTableConfig オブジェクト。

    ソーステーブル設定の構造。サポートされているソースプロパティのリストについては、SourceTableConfig 構造を参照してください。

  • TargetTableConfigTargetTableConfig オブジェクト。

    ターゲットテーブル設定の構造。

レスポンス
  • 応答パラメータはありません。

エラー
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationTableProperties アクション (Python: update_integration_table_properties)

この API は、レプリケートする必要があるテーブルに対してオプションのオーバーライドプロパティを提供するために使用されます。これらのプロパティには、ソーステーブルとターゲットテーブルのフィルタリングとパーテイション化のためのプロパティを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を SourceTableConfigResourceArn として、AWS Glue データベース ARN を TargetTableConfigResourceArn としてそれぞれ指定し、同じ API を呼び出す必要があります。

オーバーライドは、同じ ResourceArn とソーステーブルを使用するすべての統合に反映されます。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • TableName必須: UTF-8 文字列。1~128 バイト長。

    レプリケートするテーブルの名前。

  • SourceTableConfigSourceTableConfig オブジェクト。

    ソーステーブル設定の構造。

  • TargetTableConfigTargetTableConfig オブジェクト。

    ターゲットテーブル設定の構造。

レスポンス
  • 応答パラメータはありません。

エラー
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationTableProperties アクション (Python: get_integration_table_properties)

この 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 バイト長。

    レプリケートするテーブルの名前。

  • SourceTableConfigSourceTableConfig オブジェクト。

    ソーステーブル設定の構造。

  • TargetTableConfigTargetTableConfig オブジェクト。

    ターゲットテーブル設定の構造。

エラー
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

DeleteIntegrationTableProperties アクション (Python: delete_integration_table_properties)

レプリケートする必要があるテーブル用に作成されたテーブルプロパティを削除します。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • TableName必須: UTF-8 文字列。1~128 バイト長。

    レプリケートするテーブルの名前。

レスポンス
  • 応答パラメータはありません。

エラー
  • ValidationException

  • AccessDeniedException

  • ResourceNotFoundException

  • InternalServerException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

CreateIntegrationResourceProperty アクション (Python: create_integration_resource_property)

この API は、AWS Glue 接続の ResourceProperty (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) をセットアップするために使用できます。これらのプロパティには、接続またはデータベースにアクセスするためのロールを含めることができます。ソースとターゲットの両方のプロパティを設定するには、AWS Glue 接続 ARN を SourceProcessingPropertiesResourceArn として、AWS Glue データベース ARN を TargetProcessingPropertiesResourceArn としてそれぞれ指定し、同じ API を呼び出す必要があります。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • SourceProcessingPropertiesSourceProcessingProperties オブジェクト。

    統合ソースに関連付けられたリソースプロパティ。

  • TargetProcessingPropertiesTargetProcessingProperties オブジェクト。

    統合ターゲットに関連付けられたリソースプロパティ。

レスポンス
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • SourceProcessingPropertiesSourceProcessingProperties オブジェクト。

    統合ソースに関連付けられたリソースプロパティ。

  • TargetProcessingPropertiesTargetProcessingProperties オブジェクト。

    統合ターゲットに関連付けられたリソースプロパティ。

エラー
  • ValidationException

  • AccessDeniedException

  • ConflictException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UpdateIntegrationResourceProperty アクション (Python: update_integration_resource_property)

この API は、AWS Glue 接続の ResourceProperty (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) を更新するために使用できます。これらのプロパティには、接続またはデータベースにアクセスするためのロールを含めることができます。同じリソースを複数の統合で使用できるため、リソースプロパティを更新すると、そのリソースを使用しているすべての統合に影響します。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • SourceProcessingPropertiesSourceProcessingProperties オブジェクト。

    統合ソースに関連付けられたリソースプロパティ。

  • TargetProcessingPropertiesTargetProcessingProperties オブジェクト。

    統合ターゲットに関連付けられたリソースプロパティ。

レスポンス
  • ResourceArn – UTF-8 文字列、1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • SourceProcessingPropertiesSourceProcessingProperties オブジェクト。

    統合ソースに関連付けられたリソースプロパティ。

  • TargetProcessingPropertiesTargetProcessingProperties オブジェクト。

    統合ターゲットに関連付けられたリソースプロパティ。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

GetIntegrationResourceProperty アクション (Python: get_integration_resource_property)

この API は、AWS Glue 接続の ResourceProperty (ソースの場合) または AWS Glue データベース ARN (ターゲットの場合) の取得に使用されます。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

レスポンス
  • ResourceArn – UTF-8 文字列、1~128 バイト長。

    ソースの接続 ARN、またはターゲットのデータベース ARN。

  • SourceProcessingPropertiesSourceProcessingProperties オブジェクト。

    統合ソースに関連付けられたリソースプロパティ。

  • TargetProcessingPropertiesTargetProcessingProperties オブジェクト。

    統合ターゲットに関連付けられたリソースプロパティ。

エラー
  • ValidationException

  • AccessDeniedException

  • InternalServerException

  • ResourceNotFoundException

  • EntityNotFoundException

  • InternalServiceException

  • InvalidInputException

UntagResource アクション (Python: untag_resource)

統合リソースから指定したタグを削除します。

リクエスト
  • ResourceArn必須: UTF-8 文字列。1~10,240 バイト長。Custom string pattern #49 に一致。

    統合リソースの Amazon リソースネーム (ARN)。

  • TagsToRemove必須: UTF-8 文字列の配列。文字列 50 個以下。

    リソースから削除するメタデータタグのリスト。

レスポンス
  • 応答パラメータはありません。

エラー
  • ResourceNotFoundException

ListTagsForResource アクション (Python: list_tags_for_resource)

指定したリソースに割り当てたメタデータタグの一覧。

リクエスト
  • ResourceARN必須: UTF-8 文字列。1~10,240 バイト長。Custom string pattern #49 に一致。

    リソースのリソース ARN。

レスポンス
  • TagsTag オブジェクトの配列。構造体 10 個以下。

    タグのリスト。

エラー
  • ResourceNotFoundException

例外

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 文字列。

    問題を説明するメッセージ。