テーブルオプティマイザー API

• TableOptimizer の構造

• TableOptimizerConfiguration の構造

• TableOptimizerVpcConfiguration 構造

• TableOptimizerRun の構造

• BatchGetTableOptimizerEntry の構造

• BatchTableOptimizer の構造

• BatchGetTableOptimizerError の構造

• RetentionConfiguration 構造

• IcebergRetentionConfiguration 構造

• OrphanFileDeletionConfiguration 構造

• IcebergOrphanFileDeletionConfiguration 構造

• CompactionMetrics 構造

• RetentionMetrics 構造

• OrphanFileDeletionMetrics 構造

• IcebergCompactionMetrics 構造

• IcebergRetentionMetrics 構造

• IcebergOrphanFileDeletionMetrics 構造

• RunMetrics の構造

フィールド

• type – UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。有効な値は以下のとおりです。

  • compaction: テーブルオプティマイザーで圧縮を管理する場合。

  • retention: テーブルオプティマイザーでスナップショットの保持を管理する場合。

  • orphan_file_deletion: テーブルオプティマイザーで孤立ファイルの削除を管理する場合。

• configuration – TableOptimizerConfiguration オブジェクト。

  テーブルオプティマイザーを作成または更新する際に指定された TableOptimizerConfiguration オブジェクト。

• lastRun – TableOptimizerRun オブジェクト。

  テーブルオプティマイザーの前回の実行を表す TableOptimizerRun オブジェクト。

フィールド

• roleArn - UTF-8 文字列。1 ～ 512 バイト長。Single-line string pattern に一致。

  呼び出し元によって渡されるロール。このロールは、呼び出し元に代わってオプティマイザーに関連付けられたリソースを更新するための許可をサービスに付与します。

• enabled – ブール。

  テーブル最適化が有効かどうか。

• vpcConfiguration – TableOptimizerVpcConfiguration オブジェクト。

  テーブルオプティマイザーの VPC の設定を表す TableOptimizerVpcConfiguration オブジェクト。

  この設定は、カスタマー VPC 内のテーブルを最適化するために必要です。

• retentionConfiguration – RetentionConfiguration オブジェクト。

  スナップショット保持オプティマイザー用の設定。

• orphanFileDeletionConfiguration – OrphanFileDeletionConfiguration オブジェクト。

  孤立ファイル削除オプティマイザー用の設定。

フィールド

• glueConnectionName – UTF-8 文字列

  テーブルオプティマイザーの VPC に使用される AWS Glue 接続の名前。

フィールド

• eventType – UTF-8 文字列 (有効な値: starting="STARTING" | completed="COMPLETED" | failed="FAILED" | in_progress="IN_PROGRESS")。

  テーブルオプティマイザーの実行のステータスを表すイベントタイプ。

• startTimestamp – タイムスタンプ。

  Lake Formation 内で圧縮ジョブが開始された時点のエポックタイムスタンプを表します。

• endTimestamp – タイムスタンプ。

  圧縮ジョブが終了した時点のエポックタイムスタンプを表します。

• metrics – RunMetrics オブジェクト。

  オプティマイザーの実行のメトリクスを含む RunMetrics オブジェクト。

  このメンバーは廃止されました。圧縮、保持、孤立ファイルの削除については、個々のメトリクスメンバーを参照してください。

• error – UTF-8 文字列。

  オプティマイザーの実行中に発生したエラー。

• compactionMetrics – CompactionMetrics オブジェクト。

  オプティマイザーの実行のメトリクスを含む CompactionMetrics オブジェクト。

• retentionMetrics – RetentionMetrics オブジェクト。

  オプティマイザーの実行のメトリクスを含む RetentionMetrics オブジェクト。

• orphanFileDeletionMetrics – OrphanFileDeletionMetrics オブジェクト。

  オプティマイザーの実行のメトリクスを含む OrphanFileDeletionMetrics オブジェクト。

フィールド

• catalogId – カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• databaseName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルが存在するカタログのデータベースの名前。

• tableName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルの名前。

• type – UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。

フィールド

• catalogId – カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• databaseName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルが存在するカタログのデータベースの名前。

• tableName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルの名前。

• tableOptimizer – TableOptimizer オブジェクト。

  テーブルオプティマイザーの設定と前回の実行に関する詳細を含む TableOptimizer オブジェクト。

フィールド

• error – ErrorDetail オブジェクト。

  エラーに関するコードとメッセージの詳細を含む ErrorDetail オブジェクト。

• catalogId – カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• databaseName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルが存在するカタログのデータベースの名前。

• tableName – UTF-8 文字列、少なくとも 1 バイト長。

  テーブルの名前。

• type – UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。

フィールド

• icebergConfiguration – IcebergRetentionConfiguration オブジェクト。

  Iceberg スナップショット保持オプティマイザー用の設定。

フィールド

• snapshotRetentionPeriodInDays – 数値 (整数)。

  Iceberg スナップショットを保持する日数。入力が指定されていない場合は、対応する Iceberg テーブルの設定フィールドが使用されます。存在しない場合は、デフォルト値の 5 が使用されます。

• numberOfSnapshotsToRetain – 数値 (整数)。

  保持期間内に保持する Iceberg スナップショットの数。入力が指定されていない場合は、対応する Iceberg テーブルの設定フィールドが使用されます。存在しない場合は、デフォルト値の 1 が使用されます。

• cleanExpiredFiles – ブール。

  false に設定すると、スナップショットはテーブルメタデータからのみ削除され、基になるデータとメタデータファイルは削除されません。

フィールド

• icebergConfiguration – IcebergOrphanFileDeletionConfiguration オブジェクト。

  Iceberg 孤立ファイル削除オプティマイザー用の設定。

フィールド

• orphanFileRetentionPeriodInDays – 数値 (整数)。

  ファイルを削除する前に孤立ファイルを保持する日数。入力が指定されていない場合は、デフォルト値の 3 が使用されます。

• location – UTF-8 文字列。

  ファイルを検索するディレクトリを指定します (デフォルトはテーブルの場所です)。最上位のテーブルの場所ではなく、サブディレクトリを選択することができます。

フィールド

• IcebergMetrics – IcebergCompactionMetrics オブジェクト。

  オプティマイザーの実行の Iceberg 圧縮メトリクスを含む構造。

フィールド

• IcebergMetrics – IcebergRetentionMetrics オブジェクト。

  オプティマイザーの実行の Iceberg 保持メトリクスを含む構造。

フィールド

• IcebergMetrics – IcebergOrphanFileDeletionMetrics オブジェクト。

  オプティマイザーの実行の Iceberg 孤立ファイル削除メトリクスを含む構造。

フィールド

• NumberOfDpus – 数値 (整数)。

  ジョブによって消費された DPU 時間数。

• JobDurationInHour – 数値 (double)。

  ジョブの実行時間 (単位: 時間)。

フィールド

• NumberOfDpus – 数値 (整数)。

  ジョブによって消費された DPU 時間数。

• JobDurationInHour – 数値 (double)。

  ジョブの実行時間 (単位: 時間)。

フィールド

• NumberOfDpus – 数値 (整数)。

  ジョブによって消費された DPU 時間数。

• JobDurationInHour – 数値 (double)。

  ジョブの実行時間 (単位: 時間)。

フィールド

• NumberOfBytesCompacted – UTF-8 文字列。

  圧縮ジョブの実行によって削除されたバイト数。

• NumberOfFilesCompacted – UTF-8 文字列。

  圧縮ジョブの実行によって削除されたファイル数。

• NumberOfDpus – UTF-8 文字列。

  ジョブによって消費された DPU 時間数。

• JobDurationInHour – UTF-8 文字列。

  ジョブの実行時間 (単位: 時間)。

• GetTableOptimizer アクション (Python: get_table_optimizer)

• BatchGetTableOptimizer アクション (Python: batch_get_table_optimizer)

• ListTableOptimizerRuns アクション (Python: list_table_optimizer_runs)

• CreateTableOptimizer アクション (Python: create_table_optimizer)

• DeleteTableOptimizer アクション (Python: delete_table_optimizer)

• UpdateTableOptimizer アクション (Python: update_table_optimizer)

リクエスト

• CatalogId – 必須: カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• Type – 必須: UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。

レスポンス

• CatalogId – カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• TableOptimizer – TableOptimizer オブジェクト。

  指定されたテーブルに関連付けられたオプティマイザー。

エラー

• EntityNotFoundException

• InvalidInputException

• AccessDeniedException

• InternalServiceException

• ThrottlingException

リクエスト

• Entries – 必須: BatchGetTableOptimizerEntry オブジェクトの配列。

  取得するテーブルオプティマイザーを指定する BatchGetTableOptimizerEntry オブジェクトのリスト。

応答

• TableOptimizers – BatchTableOptimizer オブジェクトの配列。

  BatchTableOptimizer オブジェクトのリスト。

• Failures – BatchGetTableOptimizerError オブジェクトの配列。

  オペレーションで発生したエラーのリスト。

エラー

• EntityNotFoundException

• InvalidInputException

• AccessDeniedException

• InternalServiceException

• ThrottlingException

リクエスト

• CatalogId – 必須: カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• Type – 必須: UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。現在、有効な値は compaction のみです。

• MaxResults – 数値 (整数)。

  各呼び出しで返すオプティマイザーの実行の最大数。

• NextToken – UTF-8 文字列。

  継続トークン (これが継続呼び出しの場合)。

応答

• CatalogId – カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• NextToken – UTF-8 文字列。

  返されたオプティマイザーの実行のリストをページ分割するための継続トークン。リストの現在のセグメントが最後のセグメントではない場合に返されます。

• TableOptimizerRuns – TableOptimizerRun オブジェクトの配列。

  テーブルに関連付けられているオプティマイザーの実行のリスト。

エラー

• EntityNotFoundException

• AccessDeniedException

• InvalidInputException

• ValidationException

• InternalServiceException

• ThrottlingException

リクエスト

• CatalogId – 必須: カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• Type – 必須: UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。現在、有効な値は compaction のみです。

• TableOptimizerConfiguration – 必須: TableOptimizerConfiguration オブジェクト。

  テーブルオプティマイザーの設定を表す TableOptimizerConfiguration オブジェクト。

レスポンス

• 応答パラメータはありません。

エラー

• EntityNotFoundException

• ValidationException

• InvalidInputException

• AccessDeniedException

• AlreadyExistsException

• InternalServiceException

• ThrottlingException

リクエスト

• CatalogId – 必須: カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• Type – 必須: UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。

レスポンス

• 応答パラメータはありません。

エラー

• EntityNotFoundException

• InvalidInputException

• AccessDeniedException

• InternalServiceException

• ThrottlingException

リクエスト

• CatalogId – 必須: カタログ ID 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルのカタログ ID。

• DatabaseName – 必須: UTF-8 文字列、1～255 バイト長、Single-line string pattern に一致。

  テーブルが存在するカタログのデータベースの名前。

• TableName – 必須: UTF-8 文字列、1～255 バイト長、「Single-line string pattern」に一致。

  テーブルの名前。

• Type – 必須: UTF-8 文字列 (有効な値: compaction="COMPACTION" | retention="RETENTION" | orphan_file_deletion="ORPHAN_FILE_DELETION")。

  テーブルオプティマイザーのタイプ。現在、有効な値は compaction のみです。

• TableOptimizerConfiguration – 必須: TableOptimizerConfiguration オブジェクト。

  テーブルオプティマイザーの設定を表す TableOptimizerConfiguration オブジェクト。

レスポンス

• 応答パラメータはありません。

エラー

• EntityNotFoundException

• InvalidInputException

• AccessDeniedException

• ValidationException

• InternalServiceException

• ThrottlingException

• ConcurrentModificationException