1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. glue
  6. TableOptimizer

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi

    Resource Type definition for AWS::Glue::TableOptimizer

    Create TableOptimizer Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new TableOptimizer(name: string, args: TableOptimizerArgs, opts?: CustomResourceOptions);
    @overload
    def TableOptimizer(resource_name: str,
                       args: TableOptimizerArgs,
                       opts: Optional[ResourceOptions] = None)
    
    @overload
    def TableOptimizer(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       catalog_id: Optional[str] = None,
                       database_name: Optional[str] = None,
                       table_name: Optional[str] = None,
                       table_optimizer_configuration: Optional[TableOptimizerConfigurationArgs] = None,
                       type: Optional[str] = None)
    func NewTableOptimizer(ctx *Context, name string, args TableOptimizerArgs, opts ...ResourceOption) (*TableOptimizer, error)
    public TableOptimizer(string name, TableOptimizerArgs args, CustomResourceOptions? opts = null)
    public TableOptimizer(String name, TableOptimizerArgs args)
    public TableOptimizer(String name, TableOptimizerArgs args, CustomResourceOptions options)
    
    type: aws-native:glue:TableOptimizer
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_glue_table_optimizer" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args TableOptimizerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TableOptimizerArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TableOptimizerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TableOptimizerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TableOptimizerArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    TableOptimizer Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The TableOptimizer resource accepts the following input properties:

    CatalogId string
    The catalog ID of the table
    DatabaseName string
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    TableName string
    The table name. For Hive compatibility, this must be entirely lowercase.
    TableOptimizerConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    Type string
    The type of table optimizer.
    CatalogId string
    The catalog ID of the table
    DatabaseName string
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    TableName string
    The table name. For Hive compatibility, this must be entirely lowercase.
    TableOptimizerConfiguration TableOptimizerConfigurationArgs
    Specifies configuration details of a table optimizer.
    Type string
    The type of table optimizer.
    catalog_id string
    The catalog ID of the table
    database_name string
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    table_name string
    The table name. For Hive compatibility, this must be entirely lowercase.
    table_optimizer_configuration object
    Specifies configuration details of a table optimizer.
    type string
    The type of table optimizer.
    catalogId String
    The catalog ID of the table
    databaseName String
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    tableName String
    The table name. For Hive compatibility, this must be entirely lowercase.
    tableOptimizerConfiguration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    type String
    The type of table optimizer.
    catalogId string
    The catalog ID of the table
    databaseName string
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    tableName string
    The table name. For Hive compatibility, this must be entirely lowercase.
    tableOptimizerConfiguration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    type string
    The type of table optimizer.
    catalog_id str
    The catalog ID of the table
    database_name str
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    table_name str
    The table name. For Hive compatibility, this must be entirely lowercase.
    table_optimizer_configuration TableOptimizerConfigurationArgs
    Specifies configuration details of a table optimizer.
    type str
    The type of table optimizer.
    catalogId String
    The catalog ID of the table
    databaseName String
    The name of the database. For Hive compatibility, this is folded to lowercase when it is stored.
    tableName String
    The table name. For Hive compatibility, this must be entirely lowercase.
    tableOptimizerConfiguration Property Map
    Specifies configuration details of a table optimizer.
    type String
    The type of table optimizer.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the TableOptimizer resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    TableOptimizerCompactionConfiguration, TableOptimizerCompactionConfigurationArgs

    IcebergConfiguration TableOptimizerIcebergCompactionConfiguration
    The configuration for an Iceberg compaction optimizer.
    iceberg_configuration object
    The configuration for an Iceberg compaction optimizer.
    icebergConfiguration TableOptimizerIcebergCompactionConfiguration
    The configuration for an Iceberg compaction optimizer.
    icebergConfiguration TableOptimizerIcebergCompactionConfiguration
    The configuration for an Iceberg compaction optimizer.
    iceberg_configuration TableOptimizerIcebergCompactionConfiguration
    The configuration for an Iceberg compaction optimizer.
    icebergConfiguration Property Map
    The configuration for an Iceberg compaction optimizer.

    TableOptimizerConfiguration, TableOptimizerConfigurationArgs

    Enabled bool
    Whether the table optimization is enabled.
    RoleArn string
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    CompactionConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerCompactionConfiguration
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    OrphanFileDeletionConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerOrphanFileDeletionConfiguration
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    RetentionConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerRetentionConfiguration
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    VpcConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerVpcConfiguration
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    Enabled bool
    Whether the table optimization is enabled.
    RoleArn string
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    CompactionConfiguration TableOptimizerCompactionConfiguration
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    OrphanFileDeletionConfiguration TableOptimizerOrphanFileDeletionConfiguration
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    RetentionConfiguration TableOptimizerRetentionConfiguration
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    VpcConfiguration TableOptimizerVpcConfiguration
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    enabled bool
    Whether the table optimization is enabled.
    role_arn string
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    compaction_configuration object
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    orphan_file_deletion_configuration object
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    retention_configuration object
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    vpc_configuration object
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    enabled Boolean
    Whether the table optimization is enabled.
    roleArn String
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    compactionConfiguration TableOptimizerCompactionConfiguration
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    orphanFileDeletionConfiguration TableOptimizerOrphanFileDeletionConfiguration
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    retentionConfiguration TableOptimizerRetentionConfiguration
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    vpcConfiguration TableOptimizerVpcConfiguration
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    enabled boolean
    Whether the table optimization is enabled.
    roleArn string
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    compactionConfiguration TableOptimizerCompactionConfiguration
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    orphanFileDeletionConfiguration TableOptimizerOrphanFileDeletionConfiguration
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    retentionConfiguration TableOptimizerRetentionConfiguration
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    vpcConfiguration TableOptimizerVpcConfiguration
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    enabled bool
    Whether the table optimization is enabled.
    role_arn str
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    compaction_configuration TableOptimizerCompactionConfiguration
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    orphan_file_deletion_configuration TableOptimizerOrphanFileDeletionConfiguration
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    retention_configuration TableOptimizerRetentionConfiguration
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    vpc_configuration TableOptimizerVpcConfiguration
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.
    enabled Boolean
    Whether the table optimization is enabled.
    roleArn String
    A role passed by the caller which gives the service permission to update the resources associated with the optimizer on the caller's behalf.
    compactionConfiguration Property Map
    The configuration for a compaction optimizer. This configuration defines how data files in your table will be compacted to improve query performance and reduce storage costs.
    orphanFileDeletionConfiguration Property Map
    OrphanFileDeletionConfiguration is a property that can be included within the TableOptimizer resource. It controls the automatic deletion of orphaned files - files that are not tracked by the table metadata, and older than the configured age limit.
    retentionConfiguration Property Map
    The configuration for a snapshot retention optimizer for Apache Iceberg tables.
    vpcConfiguration Property Map
    An object that describes the VPC configuration for a table optimizer. This configuration is necessary to perform optimization on tables that are in a customer VPC.

    TableOptimizerIcebergCompactionConfiguration, TableOptimizerIcebergCompactionConfigurationArgs

    DeleteFileThreshold int
    The minimum number of deletes in a data file to make it eligible for compaction.
    MinInputFiles int
    The minimum number of input files before compaction is triggered.
    Strategy string
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    DeleteFileThreshold int
    The minimum number of deletes in a data file to make it eligible for compaction.
    MinInputFiles int
    The minimum number of input files before compaction is triggered.
    Strategy string
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    delete_file_threshold number
    The minimum number of deletes in a data file to make it eligible for compaction.
    min_input_files number
    The minimum number of input files before compaction is triggered.
    strategy string
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    deleteFileThreshold Integer
    The minimum number of deletes in a data file to make it eligible for compaction.
    minInputFiles Integer
    The minimum number of input files before compaction is triggered.
    strategy String
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    deleteFileThreshold number
    The minimum number of deletes in a data file to make it eligible for compaction.
    minInputFiles number
    The minimum number of input files before compaction is triggered.
    strategy string
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    delete_file_threshold int
    The minimum number of deletes in a data file to make it eligible for compaction.
    min_input_files int
    The minimum number of input files before compaction is triggered.
    strategy str
    The compaction strategy to use. Valid values are binpack, sort, and z-order.
    deleteFileThreshold Number
    The minimum number of deletes in a data file to make it eligible for compaction.
    minInputFiles Number
    The minimum number of input files before compaction is triggered.
    strategy String
    The compaction strategy to use. Valid values are binpack, sort, and z-order.

    TableOptimizerIcebergConfiguration, TableOptimizerIcebergConfigurationArgs

    Location string
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    OrphanFileRetentionPeriodInDays int
    The specific number of days you want to keep the orphan files.
    Location string
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    OrphanFileRetentionPeriodInDays int
    The specific number of days you want to keep the orphan files.
    location string
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    orphan_file_retention_period_in_days number
    The specific number of days you want to keep the orphan files.
    location String
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    orphanFileRetentionPeriodInDays Integer
    The specific number of days you want to keep the orphan files.
    location string
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    orphanFileRetentionPeriodInDays number
    The specific number of days you want to keep the orphan files.
    location str
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    orphan_file_retention_period_in_days int
    The specific number of days you want to keep the orphan files.
    location String
    Specifies a directory in which to look for orphan files (defaults to the table's location). You may choose a sub-directory rather than the top-level table location.
    orphanFileRetentionPeriodInDays Number
    The specific number of days you want to keep the orphan files.

    TableOptimizerIcebergRetentionConfiguration, TableOptimizerIcebergRetentionConfigurationArgs

    TableOptimizerOrphanFileDeletionConfiguration, TableOptimizerOrphanFileDeletionConfigurationArgs

    IcebergConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerIcebergConfiguration
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    IcebergConfiguration TableOptimizerIcebergConfiguration
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    iceberg_configuration object
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    icebergConfiguration TableOptimizerIcebergConfiguration
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    icebergConfiguration TableOptimizerIcebergConfiguration
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    iceberg_configuration TableOptimizerIcebergConfiguration
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.
    icebergConfiguration Property Map
    The IcebergConfiguration property helps optimize your Iceberg tables in AWS Glue by allowing you to specify format-specific settings that control how data is stored, compressed, and managed.

    TableOptimizerRetentionConfiguration, TableOptimizerRetentionConfigurationArgs

    IcebergConfiguration Pulumi.AwsNative.Glue.Inputs.TableOptimizerIcebergRetentionConfiguration
    The configuration for an Iceberg snapshot retention optimizer.
    IcebergConfiguration TableOptimizerIcebergRetentionConfiguration
    The configuration for an Iceberg snapshot retention optimizer.
    iceberg_configuration object
    The configuration for an Iceberg snapshot retention optimizer.
    icebergConfiguration TableOptimizerIcebergRetentionConfiguration
    The configuration for an Iceberg snapshot retention optimizer.
    icebergConfiguration TableOptimizerIcebergRetentionConfiguration
    The configuration for an Iceberg snapshot retention optimizer.
    iceberg_configuration TableOptimizerIcebergRetentionConfiguration
    The configuration for an Iceberg snapshot retention optimizer.
    icebergConfiguration Property Map
    The configuration for an Iceberg snapshot retention optimizer.

    TableOptimizerVpcConfiguration, TableOptimizerVpcConfigurationArgs

    GlueConnectionName string
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    GlueConnectionName string
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    glue_connection_name string
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    glueConnectionName String
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    glueConnectionName string
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    glue_connection_name str
    The name of the AWS Glue connection used for the VPC for the table optimizer.
    glueConnectionName String
    The name of the AWS Glue connection used for the VPC for the table optimizer.

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.76.0
    published on Monday, Aug 24, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial