本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 資料表最佳化工具 API 資料表最佳化工具 資料表最佳化工具 API 說明用於啟用壓縮以改善讀取效能的 AWS Glue API。 ## 資料類型  —  資料類型  — + [TableOptimizer 結構](#aws-glue-api-table-optimizers-TableOptimizer) + [TableOptimizerConfiguration 結構](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) + [TableOptimizerVpcConfiguration 結構](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration) + [EncryptionConfiguration 結構](#aws-glue-api-table-optimizers-CompactionConfiguration) + [IcebergCompactionConfiguration 結構](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration) + [TableOptimizerRun 結構](#aws-glue-api-table-optimizers-TableOptimizerRun) + [BatchGetTableOptimizerEntry 結構](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry) + [BatchTableOptimizer 結構](#aws-glue-api-table-optimizers-BatchTableOptimizer) + [BatchGetTableOptimizerError 結構](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError) + [RetentionConfiguration 結構](#aws-glue-api-table-optimizers-RetentionConfiguration) + [IcebergRetentionConfiguration 結構](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration) + [OrphanFileDeletionConfiguration 結構](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration) + [IcebergOrphanFileDeletionConfiguration 結構](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration) + [EvaluationMetrics 結構](#aws-glue-api-table-optimizers-CompactionMetrics) + [RetentionMetrics 結構](#aws-glue-api-table-optimizers-RetentionMetrics) + [OrphanFileDeletionMetrics 結構](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics) + [IcebergCompactionMetrics 結構](#aws-glue-api-table-optimizers-IcebergCompactionMetrics) + [IcebergRetentionMetrics 結構](#aws-glue-api-table-optimizers-IcebergRetentionMetrics) + [IcebergOrphanFileDeletionMetrics 結構](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics) + [RunMetrics 結構](#aws-glue-api-table-optimizers-RunMetrics) ## TableOptimizer 結構 TableOptimizer 包含與資料表相關聯之最佳化工具的相關詳細資料。 **欄位** + `type` – UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。有效值為： + `compaction`：用於使用資料表最佳化工具管理壓縮。 + `retention`：用於使用資料表最佳化工具管理快照的保留。 + `orphan_file_deletion`：用於使用資料表最佳化工具管理孤立檔案的刪除。 + `configuration` – [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 物件。 建立或更新資料表最佳化工具時，會指定的 `TableOptimizerConfiguration` 物件。 + `lastRun` – [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun) 物件。 表示上次執行之資料表最佳化工具的 `TableOptimizerRun` 物件。 + `configurationSource` – UTF-8 字串 (有效值：`catalog="CATALOG"` \$1 `table="TABLE"`)。 指定最佳化工具組態的來源。這表示資料表最佳化工具的設定方式，及啟動組態的實體或服務。 ## TableOptimizerConfiguration 結構 TableOptimizerConfiguration 包含資料表最佳化工具組態的相關詳細資料。您會在建立或更新資料表最佳化工具時傳遞此組態。 **欄位** + `roleArn` – UTF-8 字串，長度不可小於 20 個位元組，也不可以超過 2048 個位元組，且需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 呼叫者傳遞的角色，可提供服務權限，以代表呼叫者更新與最佳化工具相關聯的資源。 + `enabled` – 布林值。 無論資料表最佳化是否已啟用。 + `vpcConfiguration` – [TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration) 物件。 表示資料表最佳化工具的 VPC 組態的 `TableOptimizerVpcConfiguration` 物件。 此組態是對客戶 VPC 中的資料表執行最佳化的必要組態。 + `compactionConfiguration` – [CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration) 物件。 壓縮最佳化工具的組態。此組態會定義如何壓縮資料表中的資料檔案，以改善查詢效能並降低儲存成本。 + `retentionConfiguration` – [RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration) 物件。 快照保留最佳化工具的組態。 + `orphanFileDeletionConfiguration` – [OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration) 物件。 孤立檔案刪除最佳化工具的組態。 ## TableOptimizerVpcConfiguration 結構 TableOptimizerVpcConfiguration 描述資料表最佳化工具的 VPC 組態的物件。 此組態是對客戶 VPC 中的資料表執行最佳化的必要組態。 **欄位** + `glueConnectionName`：UTF-8 字串，長度至少為 1 個位元組。 用於資料表最佳化工具之 VPC 的 AWS Glue 連線名稱。 ## EncryptionConfiguration 結構 CompactionConfiguration 壓縮最佳化工具的組態。此組態會定義如何壓縮資料表中的資料檔案，以改善查詢效能並降低儲存成本。 **欄位** + `icebergConfiguration` – [IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration) 物件。 Iceberg 壓縮最佳化工具的組態。 ## IcebergCompactionConfiguration 結構 IcebergCompactionConfiguration Iceberg 壓縮最佳化工具的組態。此組態定義了最佳化 Iceberg 資料表中資料檔案配置的參數。 **欄位** + `strategy` – UTF-8 字串 (有效值：`binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`)。 用於壓縮的策略。有效的值如下： + `binpack`：將小型檔案合併為較大的檔案，通常以大小超過 100 MB 為目標，同時套用任何待定的刪除。這是適用於大多數使用案例的建議壓縮策略。 + `sort`：根據在壓縮期間以階層方式排序的所指定資料欄來組織資料，從而改善篩選操作的查詢效能。在您的查詢經常篩選特定資料欄時，建議使用此策略。若要使用此策略，您必須先使用 `sort_order` 資料表屬性在 Iceberg 資料表屬性中定義排序順序。 + `z-order`：透過將多個屬性混合到可用於排序的單一純量值來最佳化資料組織，從而實現跨多個維度的有效查詢。在您需要同時查詢多個維度的資料時，建議使用此策略。若要使用此策略，您必須先使用 `sort_order` 資料表屬性在 Iceberg 資料表屬性中定義排序順序。 如果未提供輸入，則會使用預設值 'binpack'。 + `minInputFiles` – 數字 (整數)。 壓縮實際上會壓縮檔案之前，分區中必須存在的資料檔案數目下限。此參數有助於控制何時觸發壓縮，防止在具有少量檔案的分區上進行不必要的壓縮操作。如果未提供輸入，則會使用預設值 100。 + `deleteFileThreshold` – 數字 (整數)。 資料檔案中必須存在才能使其符合壓縮資格的刪除次數下限。此參數透過專注於包含大量刪除操作的檔案，來協助最佳化壓縮，這可以透過移除已刪除的記錄來改善查詢效能。如果未提供輸入，則會使用預設值 1。 ## TableOptimizerRun 結構 TableOptimizerRun 包含資料表最佳化工具執行的詳細資料。 **欄位** + `eventType` – UTF-8 字串 (有效值：`starting="STARTING"` \$1 `completed="COMPLETED"` \$1 `failed="FAILED"` \$1 `in_progress="IN_PROGRESS"`)。 表示資料表最佳化工具執行狀態的事件類型。 + `startTimestamp` – 時間戳記。 表示 Lake Formation 內的壓縮任務開始時的 Epoch 時間戳記。 + `endTimestamp` – 時間戳記。 表示壓縮任務結束時的 Epoch 時間戳記。 + `metrics` – [RunMetrics](#aws-glue-api-table-optimizers-RunMetrics) 物件。 包含最佳化工具執行之指標的 `RunMetrics` 物件。 此成員已淘汰。如需壓縮、保留及孤立檔案刪除，請參閱個別指標成員。 + `error` – UTF-8 字串。 最佳化工具執行期間發生的錯誤。 + `compactionMetrics` – [CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics) 物件。 包含最佳化工具執行之指標的 `CompactionMetrics` 物件。 + `compactionStrategy` – UTF-8 字串 (有效值：`binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`)。 用於壓縮執行的策略。指出套用哪些演算法來判斷在壓縮程序期間如何選取和合併檔案。有效的值如下： + `binpack`：將小型檔案合併為較大的檔案，通常以大小超過 100 MB 為目標，同時套用任何待定的刪除。這是適用於大多數使用案例的建議壓縮策略。 + `sort`：根據在壓縮期間以階層方式排序的所指定資料欄來組織資料，從而改善篩選操作的查詢效能。在您的查詢經常篩選特定資料欄時，建議使用此策略。若要使用此策略，您必須先使用 `sort_order` 資料表屬性在 Iceberg 資料表屬性中定義排序順序。 + `z-order`：透過將多個屬性混合到可用於排序的單一純量值來最佳化資料組織，從而實現跨多個維度的有效查詢。在您需要同時查詢多個維度的資料時，建議使用此策略。若要使用此策略，您必須先使用 `sort_order` 資料表屬性在 Iceberg 資料表屬性中定義排序順序。 + `retentionMetrics` – [RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics) 物件。 包含最佳化工具執行之指標的 `RetentionMetrics` 物件。 + `orphanFileDeletionMetrics` – [OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics) 物件。 包含最佳化工具執行的指標的 `OrphanFileDeletionMetrics` 物件。 ## BatchGetTableOptimizerEntry 結構 BatchGetTableOptimizerEntry 表示要在 `BatchGetTableOptimizer` 操作中擷取的資料表最佳化工具。 **欄位** + `catalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `databaseName`：UTF-8 字串，長度至少為 1 個位元組。 資料表所在目錄的資料庫的名稱。 + `tableName`：UTF-8 字串，長度至少為 1 個位元組。 資料表的名稱。 + `type` – UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 ## BatchTableOptimizer 結構 BatchTableOptimizer 包含 `BatchGetTableOptimizer` 操作傳回之其中一個資料表最佳化工具的詳細資料。 **欄位** + `catalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `databaseName`：UTF-8 字串，長度至少為 1 個位元組。 資料表所在目錄的資料庫的名稱。 + `tableName`：UTF-8 字串，長度至少為 1 個位元組。 資料表的名稱。 + `tableOptimizer` – [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer) 物件。 包含組態和上次執行之資料表最佳化工具相關詳細資料的 `TableOptimizer` 物件。 ## BatchGetTableOptimizerError 結構 BatchGetTableOptimizerError 包含 `BatchGetTableOptimizer` 操作傳回的錯誤清單中之其中一個錯誤的相關詳細資料。 **欄位** + `error` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 物件。 包含與錯誤相關之程式碼和訊息詳細資料的 `ErrorDetail` 物件。 + `catalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `databaseName`：UTF-8 字串，長度至少為 1 個位元組。 資料表所在目錄的資料庫的名稱。 + `tableName`：UTF-8 字串，長度至少為 1 個位元組。 資料表的名稱。 + `type` – UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 ## RetentionConfiguration 結構 RetentionConfiguration 快照保留最佳化工具的組態。 **欄位** + `icebergConfiguration` – [IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration) 物件。 Iceberg 快照保留最佳化工具的組態。 ## IcebergRetentionConfiguration 結構 IcebergRetentionConfiguration Iceberg 快照保留最佳化工具的組態。 **欄位** + `snapshotRetentionPeriodInDays` – 數字 (整數)。 保留 Iceberg 快照的天數。如果未提供輸入，則會使用對應的 Iceberg 資料表組態欄位，如果不存在，則會使用預設值 5。 + `numberOfSnapshotsToRetain` – 數字 (整數)。 在保留期間內要保留的 Iceberg 快照數目。如果未提供輸入，則會使用對應的 Iceberg 資料表組態欄位，如果不存在，則會使用預設值 1。 + `cleanExpiredFiles` – 布林值。 如果設定為 false，快照只會從資料表中繼資料中刪除，且不會刪除基礎資料和中繼資料檔案。 + `runRateInHours` – 數字 (整數)。 保留任務執行之間的間隔 (以小時為單位)。此參數控制保留最佳化工具將執行以清除過期快照的頻率。值必須介於 3 至 168 小時 (7 天) 之間。如果未提供輸入，則會使用預設值 24。 ## OrphanFileDeletionConfiguration 結構 OrphanFileDeletionConfiguration 孤立檔案刪除最佳化工具的組態。 **欄位** + `icebergConfiguration` – [IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration) 物件。 Iceberg 孤立檔案刪除最佳化工具的組態。 ## IcebergOrphanFileDeletionConfiguration 結構 IcebergOrphanFileDeletionConfiguration Iceberg 孤立檔案刪除最佳化工具的組態。 **欄位** + `orphanFileRetentionPeriodInDays` – 數字 (整數)。 刪除檔案之前，應保留孤立檔案的天數。如果未提供輸入，則會使用預設值 3。 + `location` – UTF-8 字串。 指定要在其中尋找檔案的型錄 (預設為資料表的位置)。您可以選擇子型錄，而不是最上層的資料表位置。 + `runRateInHours` – 數字 (整數)。 孤立檔案刪除任務執行之間的間隔 (以小時為單位)。此參數控制孤立檔案刪除最佳化工具將執行以清除孤立檔案的頻率。值必須介於 3 至 168 小時 (7 天) 之間。如果未提供輸入，則會使用預設值 24。 ## EvaluationMetrics 結構 CompactionMetrics 包含最佳化工具執行的壓縮指標的結構。 **欄位** + `IcebergMetrics` – [IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics) 物件。 包含最佳化工具執行的 Iceberg 壓縮指標的結構。 ## RetentionMetrics 結構 RetentionMetrics 包含最佳化工具執行的保留指標的結構。 **欄位** + `IcebergMetrics` – [IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics) 物件。 包含最佳化工具執行的 Iceberg 保留指標的結構。 ## OrphanFileDeletionMetrics 結構 OrphanFileDeletionMetrics 包含最佳化工具執行的孤立檔案刪除指標的結構。 **欄位** + `IcebergMetrics` – [IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics) 物件。 包含最佳化工具執行的 Iceberg 孤立檔案刪除指標的結構。 ## IcebergCompactionMetrics 結構 IcebergCompactionMetrics Iceberg 用於最佳化工具執行的壓縮指標。 **欄位** + `DpuHours` – 數字 (雙位數)。 任務花費的 DPU 小時數。 + `NumberOfDpus` – 數字 (整數)。 任務耗用的 DPU 數目，四捨五入至最接近的整數。 + `JobDurationInHour` – 數字 (雙位數)。 任務的持續時間 (以小時為單位)。 ## IcebergRetentionMetrics 結構 IcebergRetentionMetrics Iceberg 用於最佳化工具執行的快照保留指標。 **欄位** + `DpuHours` – 數字 (雙位數)。 任務花費的 DPU 小時數。 + `NumberOfDpus` – 數字 (整數)。 任務耗用的 DPU 數目，四捨五入至最接近的整數。 + `JobDurationInHour` – 數字 (雙位數)。 任務的持續時間 (以小時為單位)。 ## IcebergOrphanFileDeletionMetrics 結構 IcebergOrphanFileDeletionMetrics Iceberg 用於最佳化工具執行的孤立檔案刪除指標。 **欄位** + `DpuHours` – 數字 (雙位數)。 任務花費的 DPU 小時數。 + `NumberOfDpus` – 數字 (整數)。 任務耗用的 DPU 數目，四捨五入至最接近的整數。 + `JobDurationInHour` – 數字 (雙位數)。 任務的持續時間 (以小時為單位)。 ## RunMetrics 結構 RunMetrics 最佳化工具執行的指標。 此結構已棄用。如需壓縮、保留及孤立檔案刪除，請參閱個別指標成員。 **欄位** + `NumberOfBytesCompacted` – UTF-8 字串。 壓縮任務執行移除的位元組數。 + `NumberOfFilesCompacted` – UTF-8 字串。 壓縮任務執行移除檔案數。 + `NumberOfDpus` – UTF-8 字串。 任務耗用的 DPU 數目，四捨五入至最接近的整數。 + `JobDurationInHour` – UTF-8 字串。 任務的持續時間 (以小時為單位)。 ## 作業  —  operations  — + [GetTableOptimizer 動作 (Python：get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-GetTableOptimizer) + [BatchGetTableOptimizer 動作 (Python：batch\$1get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-BatchGetTableOptimizer) + [ListTableOptimizerRuns 動作 (Python：list\$1table\$1optimizer\$1runs)](#aws-glue-api-table-optimizers-ListTableOptimizerRuns) + [CreateTableOptimizer action (Python：create\$1table\$1optimizer)](#aws-glue-api-table-optimizers-CreateTableOptimizer) + [DeleteTableOptimizer 動作 (Python：delete\$1table\$1optimizer)](#aws-glue-api-table-optimizers-DeleteTableOptimizer) + [UpdateTableOptimizer 動作 (Python：update\$1table\$1optimizer)](#aws-glue-api-table-optimizers-UpdateTableOptimizer) ## GetTableOptimizer 動作 (Python：get\$1table\$1optimizer) GetTableOptimizer (get\$1table\$1optimizer) 傳回與指定資料表相關聯之所有最佳化工具的組態。 **請求** + `CatalogId` – *必要：*目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `Type` – *必要：*UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 **回應** + `CatalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `TableOptimizer` – [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer) 物件。 與指定資料表相關聯的最佳化工具。 **錯誤** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## BatchGetTableOptimizer 動作 (Python：batch\$1get\$1table\$1optimizer) BatchGetTableOptimizer (batch\$1get\$1table\$1optimizer) 傳回指定資料表最佳化工具的組態。 **請求** + `Entries` – *必要：*一個 [BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry) 物件。 指定要擷取之資料表最佳化工具的 `BatchGetTableOptimizerEntry` 物件清單。 **回應** + `TableOptimizers` – 一個 [BatchTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer) 物件陣列。 `BatchTableOptimizer` 物件的清單。 + `Failures` – 一個 [BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError) 物件陣列。 操作中的錯誤清單。 **錯誤** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## ListTableOptimizerRuns 動作 (Python：list\$1table\$1optimizer\$1runs) ListTableOptimizerRuns (list\$1table\$1optimizer\$1runs) 列出先前針對特定資料表之最佳化工具執行的歷史記錄。 **請求** + `CatalogId` – *必要：*目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `Type` – *必要：*UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 + `MaxResults` – 數字 (整數)。 每次呼叫時最佳化工具執行的傳回數上限。 + `NextToken` – UTF-8 字串。 接續符記，如果這是接續呼叫。 **回應** + `CatalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `NextToken` – UTF-8 字串。 用於將傳回的最佳化工具執行清單分頁的持續權杖，如果清單的目前區段不是最後區段則會傳回。 + `TableOptimizerRuns` – 一個 [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun) 物件陣列。 與資料表相關聯的最佳化工具執行清單。 **錯誤** + `EntityNotFoundException` + `AccessDeniedException` + `InvalidInputException` + `ValidationException` + `InternalServiceException` + `ThrottlingException` ## CreateTableOptimizer action (Python：create\$1table\$1optimizer) CreateTableOptimizer (create\$1table\$1optimizer) 為特定函數建立新的資料表最佳化工具。 **請求** + `CatalogId` – *必要：*目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `Type` – *必要：*UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 + `TableOptimizerConfiguration` – *必要：*[TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 物件。 表示資料表最佳化工具組態的 `TableOptimizerConfiguration` 物件。 **回應** + *無回應參數。* **錯誤** + `EntityNotFoundException` + `ValidationException` + `InvalidInputException` + `AccessDeniedException` + `AlreadyExistsException` + `InternalServiceException` + `ThrottlingException` ## DeleteTableOptimizer 動作 (Python：delete\$1table\$1optimizer) DeleteTableOptimizer (delete\$1table\$1optimizer) 針對資料表刪除最佳化工具和所有相關的中繼資料。系統將不會再針對該資料表執行最佳化。 **請求** + `CatalogId` – *必要：*目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `Type` – *必要：*UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 **回應** + *無回應參數。* **錯誤** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## UpdateTableOptimizer 動作 (Python：update\$1table\$1optimizer) UpdateTableOptimizer (update\$1table\$1optimizer) 針對現有的資料表最佳化工具更新組態。 **請求** + `CatalogId` – *必要：*目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的目錄 ID。 + `DatabaseName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表所在目錄的資料庫的名稱。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。 資料表的名稱。 + `Type` – *必要：*UTF-8 字串 (有效值：`compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`)。 資料表最佳化工具類型。 + `TableOptimizerConfiguration` – *必要：*[TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 物件。 表示資料表最佳化工具組態的 `TableOptimizerConfiguration` 物件。 **回應** + *無回應參數。* **錯誤** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `ValidationException` + `InternalServiceException` + `ThrottlingException` + `ConcurrentModificationException`