Otimizador de tabela API - AWS Glue
 — tipos de dados —TableOptimizerTableOptimizerConfigurationTableOptimizerRunRunMetricsBatchGetTableOptimizerEntryBatchTableOptimizerBatchGetTableOptimizerError — operações —GetTableOptimizer (get_table_optimizer)BatchGetTableOptimizer (batch_get_table_optimizer)ListTableOptimizerRuns (lista_table_optimizer_runs)CreateTableOptimizer (criar_table_optimizer)DeleteTableOptimizer (delete_table_optimizer)UpdateTableOptimizer (update_table_optimizer)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Otimizador de tabela API

O otimizador de tabela API descreve o modo como habilitar a compactação AWS Glue API para melhorar o desempenho de leitura.

Tipos de dados

TableOptimizer estrutura

Contém detalhes sobre um otimizador associado a uma tabela.

Campos

  • type— UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas. Atualmente, o único valor válido é compaction.

  • configuration – Um objeto TableOptimizerConfiguration.

    Um objeto TableOptimizerConfiguration que foi especificado ao criar ou atualizar um otimizador de tabelas.

  • lastRun – Um objeto TableOptimizerRun.

    Um objeto TableOptimizerRun que representa a última execução do otimizador de tabelas.

TableOptimizerConfiguration estrutura

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— UTF -8 string, não menos que 1 ou mais de 512 bytes de comprimento, correspondendo a. Single-line string pattern

    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.

TableOptimizerRun estrutura

Contém detalhes para a execução de um otimizador de tabelas.

Campos

  • eventType— UTF -8 string (valores válidos: starting="STARTING" | | completed="COMPLETED" failed="FAILED" |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.

    Um objeto RunMetrics que contém métricas para a execução do otimizador.

  • error— UTF -8 cordas.

    Um erro que ocorreu durante a execução do otimizador.

RunMetrics estrutura

Métricas para a execução do otimizador.

Campos

  • NumberOfBytesCompacted— UTF -8 cordas.

    O número de bytes removidos pela execução do trabalho de compactação.

  • NumberOfFilesCompacted— UTF -8 cordas.

    O número de arquivos removidos pela execução do trabalho de compactação.

  • NumberOfDpus— UTF -8 cordas.

    O número de DPU horas consumidas pelo trabalho.

  • JobDurationInHour— UTF -8 cordas.

    A duração do trabalho, em horas.

BatchGetTableOptimizerEntry estrutura

Representa um otimizador de tabelas a ser recuperado na operação BatchGetTableOptimizer.

Campos

  • catalogId – String de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

    O ID de catálogo da tabela.

  • databaseName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome do banco de dados no catálogo em que a tabela reside.

  • tableName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome da tabela.

  • type— UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas.

BatchTableOptimizer estrutura

Contém detalhes de um dos otimizadores de tabela retornados pela operação BatchGetTableOptimizer.

Campos

  • catalogId – String de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

    O ID de catálogo da tabela.

  • databaseName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome do banco de dados no catálogo em que a tabela reside.

  • tableName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome da tabela.

  • tableOptimizer – Um objeto TableOptimizer.

    Um objeto TableOptimizer que contém detalhes da configuração e da última execução de um otimizador de tabelas.

BatchGetTableOptimizerError estrutura

Contém detalhes sobre um dos erros na lista de erros retornada pela operação BatchGetTableOptimizer.

Campos

  • error – Um objeto ErrorDetail.

    Um objeto ErrorDetail que contém detalhes de código e mensagens sobre o erro.

  • catalogId – String de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

    O ID de catálogo da tabela.

  • databaseName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome do banco de dados no catálogo em que a tabela reside.

  • tableName— UTF -8 string, com pelo menos 1 byte de comprimento.

    O nome da tabela.

  • type— UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas.

Operações

GetTableOptimizer ação (Python: get_table_optimizer)

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.

    O ID de catálogo da tabela.

  • DatabaseName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • Type— Obrigatório: UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas.

Resposta

  • CatalogId – String de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

    O ID de catálogo da tabela.

  • DatabaseName— UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • TableOptimizer – Um objeto TableOptimizer.

    O otimizador associado à tabela especificada.

Erros

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer ação (Python: batch_get_table_optimizer)

Retorna a configuração para os otimizadores de tabela especificados.

Solicitação

  • Entries – Obrigatório: uma matriz de objetos BatchGetTableOptimizerEntry.

    Uma lista de objetos BatchGetTableOptimizerEntry que especifica os otimizadores de tabelas a serem recuperados.

Resposta
Erros

  • InternalServiceException

ListTableOptimizerRuns ação (Python: list_table_optimizer_runs)

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.

    O ID de catálogo da tabela.

  • DatabaseName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • Type— Obrigatório: UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas. Atualmente, o único valor válido é compaction.

  • MaxResults – Número (íntegro).

    O número máximo de execuções do otimizador a serem retornadas em cada chamada.

  • NextToken— UTF -8 cordas.

    Um token de continuação, se esta for uma chamada de continuação.

Resposta

  • CatalogId – String de ID de catálogo, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

    O ID de catálogo da tabela.

  • DatabaseName— UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • NextToken— UTF -8 cordas.

    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 – Uma matriz de objetos TableOptimizerRun.

    Uma lista das execuções de otimizador associadas a uma tabela.

Erros

  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer ação (Python: create_table_optimizer)

Cria um novo otimizador de tabela para uma função específica. No momento, compaction é o único tipo de otimizador que pode ser usado.

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.

    O ID de catálogo da tabela.

  • DatabaseName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • Type— Obrigatório: UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas. Atualmente, o único valor válido é compaction.

  • TableOptimizerConfiguration – Obrigatório: um objeto TableOptimizerConfiguration.

    Um TableOptimizerConfiguration objeto que representa a configuração de um otimizador de tabela.

Resposta

  • Nenhum parâmetro de resposta.

Erros

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

DeleteTableOptimizer ação (Python: delete_table_optimizer)

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.

    O ID de catálogo da tabela.

  • DatabaseName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • Type— Obrigatório: UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas.

Resposta

  • Nenhum parâmetro de resposta.

Erros

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer ação (Python: update_table_optimizer)

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.

    O ID de catálogo da tabela.

  • DatabaseName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome do banco de dados no catálogo em que a tabela reside.

  • TableName— Obrigatório: UTF -8 string, não menos que 1 ou mais de 255 bytes de comprimento, correspondendo a. Single-line string pattern

    O nome da tabela.

  • Type— Obrigatório: UTF -8 string (valores válidos:compaction="COMPACTION").

    O tipo de otimizador de tabelas. Atualmente, o único valor válido é compaction.

  • TableOptimizerConfiguration – Obrigatório: um objeto TableOptimizerConfiguration.

    Um TableOptimizerConfiguration objeto que representa a configuração de um otimizador de tabela.

Resposta

  • Nenhum parâmetro de resposta.

Erros

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException