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

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

    Using getTableOptimizer

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getTableOptimizer(args: GetTableOptimizerArgs, opts?: InvokeOptions): Promise<GetTableOptimizerResult>
    function getTableOptimizerOutput(args: GetTableOptimizerOutputArgs, opts?: InvokeOutputOptions): Output<GetTableOptimizerResult>
    def get_table_optimizer(catalog_id: Optional[str] = None,
                            database_name: Optional[str] = None,
                            table_name: Optional[str] = None,
                            type: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetTableOptimizerResult
    def get_table_optimizer_output(catalog_id: pulumi.Input[Optional[str]] = None,
                            database_name: pulumi.Input[Optional[str]] = None,
                            table_name: pulumi.Input[Optional[str]] = None,
                            type: pulumi.Input[Optional[str]] = None,
                            opts: Optional[InvokeOutputOptions] = None) -> Output[GetTableOptimizerResult]
    func LookupTableOptimizer(ctx *Context, args *LookupTableOptimizerArgs, opts ...InvokeOption) (*LookupTableOptimizerResult, error)
    func LookupTableOptimizerOutput(ctx *Context, args *LookupTableOptimizerOutputArgs, opts ...InvokeOption) LookupTableOptimizerResultOutput

    > Note: This function is named LookupTableOptimizer in the Go SDK.

    public static class GetTableOptimizer 
    {
        public static Task<GetTableOptimizerResult> InvokeAsync(GetTableOptimizerArgs args, InvokeOptions? opts = null)
        public static Output<GetTableOptimizerResult> Invoke(GetTableOptimizerInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetTableOptimizerResult> Invoke(GetTableOptimizerInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetTableOptimizerResult> getTableOptimizer(GetTableOptimizerArgs args, InvokeOptions options)
    public static Output<GetTableOptimizerResult> getTableOptimizer(GetTableOptimizerArgs args, InvokeOptions options)
    public static Output<GetTableOptimizerResult> getTableOptimizer(GetTableOptimizerArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:glue:getTableOptimizer
      arguments:
        # arguments dictionary
    data "aws-native_glue_get_table_optimizer" "name" {
        # arguments
    }

    The following arguments are supported:

    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.
    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.
    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.
    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.
    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.
    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.
    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.
    type String
    The type of table optimizer.

    getTableOptimizer Result

    The following output properties are available:

    TableOptimizerConfiguration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    table_optimizer_configuration object
    Specifies configuration details of a table optimizer.
    tableOptimizerConfiguration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    tableOptimizerConfiguration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    table_optimizer_configuration TableOptimizerConfiguration
    Specifies configuration details of a table optimizer.
    tableOptimizerConfiguration Property Map
    Specifies configuration details of a table optimizer.

    Supporting Types

    TableOptimizerCompactionConfiguration

    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

    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

    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

    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

    TableOptimizerOrphanFileDeletionConfiguration

    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

    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

    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