feat(client-s3tables): S3 Tables now supports sort and z-order compaction strategies for Iceberg tables in addition to binpack.

Author: awstools

clients/client-s3tables/src/commands/GetTableMaintenanceConfigurationCommand.ts

@@ -33,7 +33,7 @@ export interface GetTableMaintenanceConfigurationCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Gets details about the maintenance configuration of a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:GetTableMaintenanceConfiguration</code> permission to use this operation. </p> </dd> </dl>
+ * <p>Gets details about the maintenance configuration of a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:GetTableMaintenanceConfiguration</code> permission to use this operation. </p> </li> <li> <p>You must have the <code>s3tables:GetTableData</code> permission to use set the compaction strategy to <code>sort</code> or <code>zorder</code>.</p> </li> </ul> </dd> </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -55,6 +55,7 @@ export interface GetTableMaintenanceConfigurationCommandOutput
  * //       settings: { // TableMaintenanceSettings Union: only one key present
  * //         icebergCompaction: { // IcebergCompactionSettings
  * //           targetFileSizeMB: Number("int"),
+ * //           strategy: "auto" || "binpack" || "sort" || "z-order",
  * //         },
  * //         icebergSnapshotManagement: { // IcebergSnapshotManagementSettings
  * //           minSnapshotsToKeep: Number("int"),

clients/client-s3tables/src/commands/PutTableMaintenanceConfigurationCommand.ts

@@ -48,6 +48,7 @@ export interface PutTableMaintenanceConfigurationCommandOutput extends __Metadat
  *     settings: { // TableMaintenanceSettings Union: only one key present
  *       icebergCompaction: { // IcebergCompactionSettings
  *         targetFileSizeMB: Number("int"),
+ *         strategy: "auto" || "binpack" || "sort" || "z-order",
  *       },
  *       icebergSnapshotManagement: { // IcebergSnapshotManagementSettings
  *         minSnapshotsToKeep: Number("int"),

clients/client-s3tables/src/models/models_0.ts

@@ -991,6 +991,22 @@ export const TableMaintenanceType = {
  */
 export type TableMaintenanceType = (typeof TableMaintenanceType)[keyof typeof TableMaintenanceType];
 
+/**
+ * @public
+ * @enum
+ */
+export const IcebergCompactionStrategy = {
+  AUTO: "auto",
+  BINPACK: "binpack",
+  SORT: "sort",
+  ZORDER: "z-order",
+} as const;
+
+/**
+ * @public
+ */
+export type IcebergCompactionStrategy = (typeof IcebergCompactionStrategy)[keyof typeof IcebergCompactionStrategy];
+
 /**
  * <p>Contains details about the compaction settings for an Iceberg table.</p>
  * @public
@@ -1001,6 +1017,12 @@ export interface IcebergCompactionSettings {
    * @public
    */
   targetFileSizeMB?: number | undefined;
+
+  /**
+   * <p>The compaction strategy to use for the table. This determines how files are selected and combined during compaction operations.</p>
+   * @public
+   */
+  strategy?: IcebergCompactionStrategy | undefined;
 }
 
 /**

codegen/sdk-codegen/aws-models/s3tables.json

@@ -1376,7 +1376,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Gets details about the maintenance configuration of a table. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html\">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <p>You must have the <code>s3tables:GetTableMaintenanceConfiguration</code> permission to use this operation. </p> </dd> </dl>",
+        "smithy.api#documentation": "<p>Gets details about the maintenance configuration of a table. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html\">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p> <dl> <dt>Permissions</dt> <dd> <ul> <li> <p>You must have the <code>s3tables:GetTableMaintenanceConfiguration</code> permission to use this operation. </p> </li> <li> <p>You must have the <code>s3tables:GetTableData</code> permission to use set the compaction strategy to <code>sort</code> or <code>zorder</code>.</p> </li> </ul> </dd> </dl>",
         "smithy.api#http": {
           "uri": "/tables/{tableBucketARN}/{namespace}/{name}/maintenance",
           "method": "GET"
@@ -1873,12 +1873,47 @@
           "traits": {
             "smithy.api#documentation": "<p>The target file size for the table in MB.</p>"
           }
+        },
+        "strategy": {
+          "target": "com.amazonaws.s3tables#IcebergCompactionStrategy",
+          "traits": {
+            "smithy.api#documentation": "<p>The compaction strategy to use for the table. This determines how files are selected and combined during compaction operations.</p>"
+          }
         }
       },
       "traits": {
         "smithy.api#documentation": "<p>Contains details about the compaction settings for an Iceberg table.</p>"
       }
     },
+    "com.amazonaws.s3tables#IcebergCompactionStrategy": {
+      "type": "enum",
+      "members": {
+        "AUTO": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "auto"
+          }
+        },
+        "BINPACK": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "binpack"
+          }
+        },
+        "SORT": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "sort"
+          }
+        },
+        "ZORDER": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "z-order"
+          }
+        }
+      }
+    },
     "com.amazonaws.s3tables#IcebergMetadata": {
       "type": "structure",
       "members": {