# API do otimizador de tabelas A API do otimizador de tabelas descreve a API do AWS Glue para habilitar a compactação a fim de melhorar a performance de leitura. ## Tipos de dados + [Estrutura do TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer) + [Estrutura do TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) + [Estrutura de TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration) + [Estrutura CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration) + [Estrutura IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration) + [Estrutura TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun) + [Estrutura BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry) + [Estrutura BatchTableTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer) + [Estrutura BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError) + [Estrutura RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration) + [Estrutura IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration) + [Estrutura OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration) + [Estrutura IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration) + [Estrutura CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics) + [Estrutura RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics) + [Estrutura OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics) + [Estrutura IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics) + [Estrutura IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics) + [Estrutura IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics) + [Estrutura RunMetrics](#aws-glue-api-table-optimizers-RunMetrics) ## Estrutura do TableOptimizer Contém detalhes sobre um otimizador associado a uma tabela. **Campos** + `type` – String UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. Os valores válidos são: + `compaction`: para gerenciar a compactação com um otimizador de tabela. + `retention`: para gerenciar a retenção de snapshots com um otimizador de tabela. + `orphan_file_deletion`: para gerenciar a exclusão de arquivos órfãos com um otimizador de tabela. + `configuration` – Um objeto [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration). Um objeto `TableOptimizerConfiguration` que foi especificado ao criar ou atualizar um otimizador de tabelas. + `lastRun` – Um objeto [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun). Um objeto `TableOptimizerRun` que representa a última execução do otimizador de tabelas. + `configurationSource`: string UTF-8 (valores válidos: `catalog="CATALOG"` \$1 `table="TABLE"`). Especifica a fonte da configuração do otimizador. Indica como o otimizador de tabelas foi configurado e qual entidade ou serviço iniciou a configuração. ## Estrutura do TableOptimizerConfiguration Contém detalhes sobre a configuração de um otimizador de tabelas. Você passa essa configuração ao criar ou atualizar um otimizador de tabelas. **Campos** + `roleArn` – String UTF-8, superior a 20 e inferior a 2048 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Uma função passada pelo chamador que concede ao serviço permissão para atualizar os recursos associados ao otimizador em nome do chamador. + `enabled` – Booleano. Se a otimização da tabela está habilitada. + `vpcConfiguration` – Um objeto [TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration). Um objeto `TableOptimizerVpcConfiguration` que representa a configuração da VPC de um otimizador de tabela. Essa configuração é necessária para a execução da otimização de tabelas que estão na VPC de um cliente. + `compactionConfiguration` – Um objeto [CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration). A configuração de um otimizador de compactação. Essa configuração define como os arquivos de dados em sua tabela serão compactados para melhorar o desempenho das consultas e reduzir os custos de armazenamento. + `retentionConfiguration` – Um objeto [RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration). A configuração de um otimizador de retenção de snapshots. + `orphanFileDeletionConfiguration` – Um objeto [OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration). A configuração de um otimizador de exclusão de arquivos órfãos. ## Estrutura de TableOptimizerVpcConfiguration Um objeto que descreve a configuração da VPC de um otimizador de tabela. Essa configuração é necessária para a execução da otimização de tabelas que estão na VPC de um cliente. **Campos** + `glueConnectionName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome da conexão do AWS Glue usada para a VPC do otimizador de tabelas. ## Estrutura CompactionConfiguration A configuração de um otimizador de compactação. Essa configuração define como os arquivos de dados em sua tabela serão compactados para melhorar o desempenho das consultas e reduzir os custos de armazenamento. **Campos** + `icebergConfiguration` – Um objeto [IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration). A configuração de um otimizador de compactação do Iceberg. ## Estrutura IcebergCompactionConfiguration A configuração de um otimizador de compactação do Iceberg. Essa configuração define parâmetros para otimizar o layout dos arquivos de dados nas tabelas do Iceberg. **Campos** + `strategy` – String UTF-8 (valores válidos: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`). A estratégia a ser usada para compactação. Os valores válidos são: + `binpack`: combina arquivos pequenos em arquivos maiores, geralmente direcionado a tamanhos acima de 100 MB, enquanto aplica todas as exclusões pendentes. Essa é a estratégia de compactação recomendada para a maioria dos casos de uso. + `sort`: organiza os dados com base em colunas especificadas que são classificadas hierarquicamente durante a compactação, melhorando o desempenho da consulta para operações filtradas. Essa estratégia é recomendada quando suas consultas filtram frequentemente colunas específicas. Para usar essa estratégia, primeiro você precisará definir uma ordem de classificação nas propriedades da tabela do Iceberg usando a propriedade de tabela `sort_order`. + `z-order`: otimiza a organização de dados combinando vários atributos em um único valor escalar que pode ser usado para classificação, permitindo consultas eficientes em várias dimensões. Essa estratégia é recomendada quando você precisa consultar dados em várias dimensões simultaneamente. Para usar essa estratégia, primeiro você precisará definir uma ordem de classificação nas propriedades da tabela do Iceberg usando a propriedade de tabela `sort_order`. Se uma entrada não for fornecida, o valor padrão “binpack” será usado. + `minInputFiles` – Número (íntegro). O número mínimo de arquivos de dados que devem estar presentes em uma partição antes que a compactação realmente compacte os arquivos. Esse parâmetro ajuda a controlar quando a compactação é acionada, evitando operações desnecessárias em partições com poucos arquivos. Se uma entrada de não for fornecida, o valor padrão 100 será usado. + `deleteFileThreshold` – Número (íntegro). O número mínimo de exclusões que devem estar presentes em um arquivo de dados para que ele seja elegível para compactação. Esse parâmetro ajuda a otimizar a compactação, concentrando-se em arquivos que contêm um número significativo de operações de exclusão, podendo então melhorar o desempenho da consulta ao remover registros excluídos. Se uma entrada de não for fornecida, o valor padrão de 1 será usado. ## Estrutura TableOptimizerRun Contém detalhes para a execução de um otimizador de tabelas. **Campos** + `eventType` – String UTF-8 (valores válidos: `starting="STARTING"` \$1 `completed="COMPLETED"` \$1 `failed="FAILED"` \$1 `in_progress="IN_PROGRESS"`). Um tipo de evento que representa o status da execução do otimizador de tabelas. + `startTimestamp` – Timestamp. Representa a marca de data e hora do epoch em que o trabalho de compactação foi iniciado no Lake Formation. + `endTimestamp` – Timestamp. Representa a marca de data e hora do epoch em que o trabalho de compactação terminou. + `metrics` – Um objeto [RunMetrics](#aws-glue-api-table-optimizers-RunMetrics). Um objeto `RunMetrics` que contém métricas para a execução do otimizador. Esse membro é obsoleto. Veja os membros individuais da métrica para compactação, retenção e exclusão de arquivos órfãos. + `error` – String UTF-8. Um erro que ocorreu durante a execução do otimizador. + `compactionMetrics` – Um objeto [CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics). Um objeto `CompactionMetrics` que contém métricas para a execução do otimizador. + `compactionStrategy` – String UTF-8 (valores válidos: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`). A estratégia usada para a execução da compactação. Indica qual algoritmo foi aplicado para determinar como os arquivos foram selecionados e combinados durante o processo de compactação. Os valores válidos são: + `binpack`: combina arquivos pequenos em arquivos maiores, geralmente direcionado a tamanhos acima de 100 MB, enquanto aplica todas as exclusões pendentes. Essa é a estratégia de compactação recomendada para a maioria dos casos de uso. + `sort`: organiza os dados com base em colunas especificadas que são classificadas hierarquicamente durante a compactação, melhorando o desempenho da consulta para operações filtradas. Essa estratégia é recomendada quando suas consultas filtram frequentemente colunas específicas. Para usar essa estratégia, primeiro você precisará definir uma ordem de classificação nas propriedades da tabela do Iceberg usando a propriedade de tabela `sort_order`. + `z-order`: otimiza a organização de dados combinando vários atributos em um único valor escalar que pode ser usado para classificação, permitindo consultas eficientes em várias dimensões. Essa estratégia é recomendada quando você precisa consultar dados em várias dimensões simultaneamente. Para usar essa estratégia, primeiro você precisará definir uma ordem de classificação nas propriedades da tabela do Iceberg usando a propriedade de tabela `sort_order`. + `retentionMetrics` – Um objeto [RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics). Um objeto `RetentionMetrics` que contém métricas para a execução do otimizador. + `orphanFileDeletionMetrics` – Um objeto [OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics). Um objeto `OrphanFileDeletionMetrics` que contém métricas para a execução do otimizador. ## Estrutura BatchGetTableOptimizerEntry Representa um otimizador de tabelas a ser recuperado na operação `BatchGetTableOptimizer`. **Campos** + `catalogId`: string de ID de catálogo com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `databaseName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome do banco de dados no catálogo em que a tabela reside. + `tableName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome da tabela. + `type` – String UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. ## Estrutura BatchTableTableOptimizer Contém detalhes de um dos otimizadores de tabela retornados pela operação `BatchGetTableOptimizer`. **Campos** + `catalogId`: string de ID de catálogo com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `databaseName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome do banco de dados no catálogo em que a tabela reside. + `tableName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome da tabela. + `tableOptimizer` – Um objeto [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer). Um objeto `TableOptimizer` que contém detalhes da configuração e da última execução de um otimizador de tabelas. ## Estrutura BatchGetTableOptimizerError Contém detalhes sobre um dos erros na lista de erros retornada pela operação `BatchGetTableOptimizer`. **Campos** + `error` – Um objeto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Um objeto `ErrorDetail` que contém detalhes de código e mensagens sobre o erro. + `catalogId`: string de ID de catálogo com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `databaseName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome do banco de dados no catálogo em que a tabela reside. + `tableName`: string UTF-8 com pelo menos 1 byte de comprimento. O nome da tabela. + `type` – String UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. ## Estrutura RetentionConfiguration A configuração de um otimizador de retenção de snapshots. **Campos** + `icebergConfiguration` – Um objeto [IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration). A configuração de um otimizador de retenção de snapshots do Iceberg. ## Estrutura IcebergRetentionConfiguration A configuração de um otimizador de retenção de snapshots do Iceberg. **Campos** + `snapshotRetentionPeriodInDays` – Número (íntegro). O número de dias para reter os snapshots do Iceberg. Se uma entrada não for fornecida, o campo de configuração da tabela Iceberg correspondente será usado ou, se não estiver presente, o valor padrão 5 será usado. + `numberOfSnapshotsToRetain` – Número (íntegro). O número de snapshots do Iceberg a serem retidos no período de retenção. Se uma entrada não for fornecida, o campo de configuração da tabela Iceberg correspondente será usado ou, se não estiver presente, o valor padrão 1 será usado. + `cleanExpiredFiles` – Booleano. Se definido como false, os snapshots são excluídos somente dos metadados da tabela, e os arquivos de dados e metadados subjacentes não são excluídos. + `runRateInHours` – Número (íntegro). O intervalo em horas entre as execuções de trabalhos de retenção. Este parâmetro controla a frequência com que o otimizador de retenção será executado para limpar snapshots expirados. O valor deve estar entre 3 e 168 horas (7 dias). Se uma entrada de não for fornecida, o valor padrão de 24 será usado. ## Estrutura OrphanFileDeletionConfiguration A configuração de um otimizador de exclusão de arquivos órfãos. **Campos** + `icebergConfiguration` – Um objeto [IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration). A configuração de um otimizador de exclusão de arquivos órfãos do Iceberg. ## Estrutura IcebergOrphanFileDeletionConfiguration A configuração de um otimizador de exclusão de arquivos órfãos do Iceberg. **Campos** + `orphanFileRetentionPeriodInDays` – Número (íntegro). O número de dias que os arquivos órfãos devem ser retidos antes da exclusão do arquivo. Se uma entrada de não for fornecida, o valor padrão 3 será usado. + `location` – String UTF-8. Especifica um diretório no qual procurar arquivos (o padrão é a localização da tabela). Você pode escolher um subdiretório em vez da localização da tabela de nível superior. + `runRateInHours` – Número (íntegro). O intervalo em horas entre execuções do trabalho de exclusão de arquivos órfãos. Esse parâmetro controla com que frequência o otimizador de exclusão de arquivos órfãos será executado para limpar arquivos órfãos. O valor deve estar entre 3 e 168 horas (7 dias). Se uma entrada de não for fornecida, o valor padrão de 24 será usado. ## Estrutura CompactionMetrics Uma estrutura que contém as métricas de compactação para a execução do otimizador. **Campos** + `IcebergMetrics` – Um objeto [IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics). Uma estrutura que contém as métricas de compactação do Iceberg para a execução do otimizador. ## Estrutura RetentionMetrics Uma estrutura que contém as métricas de retenção para a execução do otimizador. **Campos** + `IcebergMetrics` – Um objeto [IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics). Uma estrutura que contém as métricas de retenção do Iceberg para a execução do otimizador. ## Estrutura OrphanFileDeletionMetrics Uma estrutura que contém as métricas de exclusão de arquivos órfãos para a execução do otimizador. **Campos** + `IcebergMetrics` – Um objeto [IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics). Uma estrutura que contém as métricas de exclusão de arquivos órfãos do Iceberg para a execução do otimizador. ## Estrutura IcebergCompactionMetrics Métricas de compactação do Iceberg para a execução do otimizador. **Campos** + `DpuHours` – Número (duplo). O número de horas de DPU consumidas pelo trabalho. + `NumberOfDpus`: número (inteiro). O número de DPUs consumidas pela tarefa, arredondado para o número inteiro mais próximo. + `JobDurationInHour` – Número (duplo). A duração do trabalho, em horas. ## Estrutura IcebergRetentionMetrics Métricas de retenção de snapshots do Iceberg para a execução do otimizador. **Campos** + `DpuHours` – Número (duplo). O número de horas de DPU consumidas pelo trabalho. + `NumberOfDpus`: número (inteiro). O número de DPUs consumidas pela tarefa, arredondado para o número inteiro mais próximo. + `JobDurationInHour` – Número (duplo). A duração do trabalho, em horas. ## Estrutura IcebergOrphanFileDeletionMetrics Métricas de exclusão de arquivos órfãos do Iceberg para a execução do otimizador. **Campos** + `DpuHours` – Número (duplo). O número de horas de DPU consumidas pelo trabalho. + `NumberOfDpus`: número (inteiro). O número de DPUs consumidas pela tarefa, arredondado para o número inteiro mais próximo. + `JobDurationInHour` – Número (duplo). A duração do trabalho, em horas. ## Estrutura RunMetrics Métricas para a execução do otimizador. Esta estrutura está obsoleta. Veja os membros individuais da métrica para compactação, retenção e exclusão de arquivos órfãos. **Campos** + `NumberOfBytesCompacted` – String UTF-8. O número de bytes removidos pela execução do trabalho de compactação. + `NumberOfFilesCompacted` – String UTF-8. O número de arquivos removidos pela execução do trabalho de compactação. + `NumberOfDpus` – String UTF-8. O número de DPUs consumidas pela tarefa, arredondado para o número inteiro mais próximo. + `JobDurationInHour` – String UTF-8. A duração do trabalho, em horas. ## Operações + [Ação GetTableOptimizer (Python: get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-GetTableOptimizer) + [Ação BatchGetTableOptimizer (Python: batch\$1get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-BatchGetTableOptimizer) + [Ação ListTableOptimizerRuns (Python: list\$1table\$1optimizer\$1runs)](#aws-glue-api-table-optimizers-ListTableOptimizerRuns) + [Ação CreateTableOptimizer (Python: create\$1table\$1optimizer)](#aws-glue-api-table-optimizers-CreateTableOptimizer) + [Ação DeleteTableOptimizer (Python: delete\$1table\$1optimizer)](#aws-glue-api-table-optimizers-DeleteTableOptimizer) + [Ação UpdateTableOptimizer (Python: update\$1table\$1optimizer)](#aws-glue-api-table-optimizers-UpdateTableOptimizer) ## Ação GetTableOptimizer (Python: get\$1table\$1optimizer) Retorna a configuração de todos os otimizadores associados a uma tabela especificada. **Solicitação** + `CatalogId` – *Obrigatório*: string de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `Type` – *Obrigatório:* string UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. **Resposta** + `CatalogId`: string de ID de catálogo com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `TableOptimizer` – Um objeto [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer). O otimizador associado à tabela especificada. **Erros** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## Ação BatchGetTableOptimizer (Python: batch\$1get\$1table\$1optimizer) Retorna a configuração para os otimizadores de tabela especificados. **Solicitação** + `Entries` – *Obrigatório:* uma matriz de objetos [BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry). Uma lista de objetos `BatchGetTableOptimizerEntry` que especifica os otimizadores de tabelas a serem recuperados. **Resposta** + `TableOptimizers`: um array de objetos [BatchTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer). Uma lista dos objetos `BatchTableOptimizer`. + `Failures`: um array de objetos [BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError). Uma lista de erros da operação. **Erros** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## Ação ListTableOptimizerRuns (Python: list\$1table\$1optimizer\$1runs) Lista o histórico de execuções anteriores do otimizador para uma tabela específica. **Solicitação** + `CatalogId` – *Obrigatório*: string de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `Type` – *Obrigatório:* string UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. + `MaxResults` – Número (íntegro). O número máximo de execuções do otimizador a serem retornadas em cada chamada. + `NextToken` – String UTF-8. Um token de continuação, se esta for uma chamada de continuação. **Resposta** + `CatalogId`: string de ID de catálogo com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `NextToken` – String UTF-8. Um token de continuação para paginação da lista de execuções do otimizador retornada, retornado se o segmento atual da lista não for o último. + `TableOptimizerRuns`: um array de objetos [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun). Uma lista das execuções de otimizador associadas a uma tabela. **Erros** + `EntityNotFoundException` + `AccessDeniedException` + `InvalidInputException` + `ValidationException` + `InternalServiceException` + `ThrottlingException` ## Ação CreateTableOptimizer (Python: create\$1table\$1optimizer) Cria um novo otimizador de tabela para uma função específica. **Solicitação** + `CatalogId` – *Obrigatório*: string de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `Type` – *Obrigatório:* string UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. + `TableOptimizerConfiguration` – *Obrigatório:* um objeto [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration). Um `TableOptimizerConfiguration` objeto que representa a configuração de um otimizador de tabela. **Resposta** + *Nenhum parâmetro de resposta.* **Erros** + `EntityNotFoundException` + `ValidationException` + `InvalidInputException` + `AccessDeniedException` + `AlreadyExistsException` + `InternalServiceException` + `ThrottlingException` ## Ação DeleteTableOptimizer (Python: delete\$1table\$1optimizer) Exclui um otimizador e todos os metadados associados de uma tabela. A otimização não será mais executada na tabela. **Solicitação** + `CatalogId` – *Obrigatório*: string de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `Type` – *Obrigatório:* string UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. **Resposta** + *Nenhum parâmetro de resposta.* **Erros** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `InternalServiceException` + `ThrottlingException` ## Ação UpdateTableOptimizer (Python: update\$1table\$1optimizer) Atualiza a configuração de um otimizador de tabela existente. **Solicitação** + `CatalogId` – *Obrigatório*: string de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O ID de catálogo da tabela. + `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome do banco de dados no catálogo em que a tabela reside. + `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). O nome da tabela. + `Type` – *Obrigatório:* string UTF-8 (valores válidos: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`). O tipo de otimizador de tabelas. + `TableOptimizerConfiguration` – *Obrigatório:* um objeto [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration). Um `TableOptimizerConfiguration` objeto que representa a configuração de um otimizador de tabela. **Resposta** + *Nenhum parâmetro de resposta.* **Erros** + `EntityNotFoundException` + `InvalidInputException` + `AccessDeniedException` + `ValidationException` + `InternalServiceException` + `ThrottlingException` + `ConcurrentModificationException`