API de tabela

• Estrutura Table

• Estrutura TableInput

• Estrutura FederatedTable

• Estrutura da coluna

• Estrutura StorageDescriptor

• Estrutura SchemaReference

• Estrutura SerDeInfo

• Estrutura Order

• Estrutura SkewedInfo

• Estrutura TableVersion

• Estrutura TableError

• Estrutura TableVersionError

• Estrutura SortCriterion

• Estrutura TableIdentifier

• Estrutura KeySchemaElement

• Estrutura PartitionIndex

• Estrutura PartitionIndexDescriptor

• Estrutura BackfillError

• Estrutura IcebergInput

• Estrutura OpenTableFormatInput

• Estrutura ViewDefinition

• Estrutura ViewDefinitionInput

• Estrutura ViewRepresentation

• Estrutura ViewRepresentationInput

Campos

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, ele deve ser inserido todo em letras minúsculas.

• DatabaseName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados no qual os metadados da tabela residem. Para a compatibilidade com o Hive, ele deve ser todo inserido em letras minúsculas.

• Description – String de descrição, inferior a 2048 bytes de comprimento, correspondente a URI address multi-line string pattern.

  A descrição da tabela.

• Owner – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O proprietário da tabela.

• CreateTime – Timestamp.

  A hora em que a definição da tabela foi criada no Catálogo de dados.

• UpdateTime – Timestamp.

  A última vez que a tabela foi atualizada.

• LastAccessTime – Timestamp.

  A última vez que a tabela foi acessada. Ela geralmente é extraída do HDFS e pode não ser confiável.

• LastAnalyzedTime – Timestamp.

  A última vez em que as estatísticas da coluna foram computadas para esta tabela.

• Retention – Número (inteiro), não mais do que None (Nenhum).

  O tempo de retenção para esta tabela.

• StorageDescriptor – Um objeto StorageDescriptor.

  Um descritor de armazenamento contendo informações sobre o armazenamento físico desta tabela.

• PartitionKeys – Uma matriz de objetos Coluna.

  Uma lista de colunas pela qual a tabela é particionada. Apenas os tipos primitivos são compatíveis como chaves de partição.

  Ao criar uma tabela usada pelo Amazon Athena, e você não especificar nenhum partitionKeys, você deve definir pelo menos o valor de partitionKeys para uma lista vazia. Por exemplo:

  "PartitionKeys": []

• ViewOriginalText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Incluído para compatibilidade com o Apache Hive. Não usado no curso normal de operações do AWS Glue. Se a tabela for uma VIRTUAL_VIEW, algumas configurações do Athena serão codificadas em base64.

• ViewExpandedText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Incluído para compatibilidade com o Apache Hive. Não usado no curso normal de operações do AWS Glue.

• TableType – String UTF-8 com comprimento não superior a 255 bytes.

  O tipo dessa tabela. O AWS Glue criará tabelas com o tipo EXTERNAL_TABLE. Outros serviços, como o Athena, poderão criar tabelas com tipos adicionais de tabela.

  Tipos de tabela relacionados ao AWS Glue:

  EXTERNAL_TABLE

  Atributo compatível com o Hive: indica uma tabela não gerenciada pelo Hive.

  GOVERNED

  Usado pelo AWS Lake Formation. O AWS Glue Data Catalog entende GOVERNED.

• Parameters – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string de chave, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Cada valor é uma string UTF-8 com comprimento não superior a 512.000 bytes.

  Esses pares de chave/valor definem propriedades associadas com a tabela.

• CreatedBy – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  A pessoa ou entidade que criou a tabela.

• IsRegisteredWithLakeFormation – Booleano.

  Indica se a tabela foi registrada com o AWS Lake Formation.

• TargetTable – Um objeto TableIdentifier.

  Uma estrutura de TableIdentifier que descreve uma tabela de destino para vinculação de recursos.

• 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 do catálogo de dados em que a tabela reside.

• VersionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da versão da tabela.

• FederatedTable – Um objeto FederatedTable.

  Uma estrutura FederatedTable que referencia uma entidade fora do AWS Glue Data Catalog.

• ViewDefinition – Um objeto ViewDefinition.

  Uma estrutura que contém todas as informações que definem a visualização, incluindo o dialeto ou dialetos da visualização e a consulta.

• IsMultiDialectView – Booleano.

  Especifica se a visualização oferece suporte aos dialetos SQL de um ou mais mecanismos de consulta diferentes e, portanto, que ela pode ser lida por esses mecanismos.

Campos

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, as letras são transformadas em minúsculas quando a tabela é armazenada.

• Description – String de descrição, inferior a 2048 bytes de comprimento, correspondente a URI address multi-line string pattern.

  A descrição da tabela.

• Owner – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O proprietário da tabela. Incluído para compatibilidade com o Apache Hive. Não usado no curso normal de operações do AWS Glue.

• LastAccessTime – Timestamp.

  A última vez que a tabela foi acessada.

• LastAnalyzedTime – Timestamp.

  A última vez em que as estatísticas da coluna foram computadas para esta tabela.

• Retention – Número (inteiro), não mais do que None (Nenhum).

  O tempo de retenção para esta tabela.

• StorageDescriptor – Um objeto StorageDescriptor.

  Um descritor de armazenamento contendo informações sobre o armazenamento físico desta tabela.

• PartitionKeys – Uma matriz de objetos Coluna.

  Uma lista de colunas pela qual a tabela é particionada. Apenas os tipos primitivos são compatíveis como chaves de partição.

  Ao criar uma tabela usada pelo Amazon Athena, e você não especificar nenhum partitionKeys, você deve definir pelo menos o valor de partitionKeys para uma lista vazia. Por exemplo:

  "PartitionKeys": []

• ViewOriginalText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Incluído para compatibilidade com o Apache Hive. Não usado no curso normal de operações do AWS Glue. Se a tabela for uma VIRTUAL_VIEW, algumas configurações do Athena serão codificadas em base64.

• ViewExpandedText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Incluído para compatibilidade com o Apache Hive. Não usado no curso normal de operações do AWS Glue.

• TableType – String UTF-8 com comprimento não superior a 255 bytes.

  O tipo dessa tabela. O AWS Glue criará tabelas com o tipo EXTERNAL_TABLE. Outros serviços, como o Athena, poderão criar tabelas com tipos adicionais de tabela.

  Tipos de tabela relacionados ao AWS Glue:

  EXTERNAL_TABLE

  Atributo compatível com o Hive: indica uma tabela não gerenciada pelo Hive.

  GOVERNED

  Usado pelo AWS Lake Formation. O AWS Glue Data Catalog entende GOVERNED.

• Parameters – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string de chave, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Cada valor é uma string UTF-8 com comprimento não superior a 512.000 bytes.

  Esses pares de chave/valor definem propriedades associadas com a tabela.

• TargetTable – Um objeto TableIdentifier.

  Uma estrutura de TableIdentifier que descreve uma tabela de destino para vinculação de recursos.

• ViewDefinition – Um objeto ViewDefinitionInput.

  Uma estrutura que contém todas as informações que definem a visualização, incluindo o dialeto ou dialetos da visualização e a consulta.

Campos

• Identifier – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Single-line string pattern.

  Um identificador exclusivo da tabela federada.

• DatabaseIdentifier – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Single-line string pattern.

  Um identificador exclusivo do banco de dados federado.

• ConnectionName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da conexão com o metastore externo.

Campos

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da Column.

• Type – String UTF-8 com comprimento não superior a 131.072 bytes, correspondente a Single-line string pattern.

  O tipo de dados da Column.

• Comment – String de comentário, inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Um comentário de texto livre.

• Parameters – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string de chave, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Cada valor é uma string UTF-8 com comprimento não superior a 512.000 bytes.

  Esses pares de chave-valor definem propriedades associadas à coluna.

Campos

• Columns – Uma matriz de objetos Coluna.

  Uma lista de Columns na tabela.

• Location – String de local, inferior a 2056 bytes de comprimento, correspondente a URI address multi-line string pattern.

  A localização física da tabela. Por padrão, assume o formato da localização do warehouse, seguida pela localização do banco de dados no warehouse, seguida pelo nome da tabela.

• AdditionalLocations – Uma matriz de strings UTF-8.

  Uma lista de locais que apontam para o caminho onde uma tabela do Delta está localizada.

• InputFormat – String de formato, inferior a 128 bytes de comprimento, correspondente a Single-line string pattern.

  O formato de entrada: SequenceFileInputFormat (binário), TextInputFormat ou um formato personalizado.

• OutputFormat – String de formato, inferior a 128 bytes de comprimento, correspondente a Single-line string pattern.

  O formato de saída: SequenceFileOutputFormat (binário), IgnoreKeyTextOutputFormat ou um formato personalizado.

• Compressed – Booleano.

  True se os dados da tabela estiverem compactados, ou False se não estiverem.

• NumberOfBuckets – Número (íntegro).

  Você deverá especificar se a tabela contiver qualquer coluna de dimensão.

• SerdeInfo – Um objeto SerDeInfo.

  As informações de serialização/desserialização (SerDe).

• BucketColumns – Uma matriz de strings UTF-8.

  Uma lista de colunas de agrupamento, armazenamento em clusters e armazenamento em buckets de reducers na tabela.

• SortColumns – Uma matriz de objetos Ordem.

  Uma lista que especifica a ordem de classificação de cada bucket na tabela.

• Parameters – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string de chave, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Cada valor é uma string UTF-8 com comprimento não superior a 512.000 bytes.

  As propriedades fornecidas pelo usuário em formato de chave/valor.

• SkewedInfo – Um objeto SkewedInfo.

  As informações sobre valores que aparecem com frequência em uma coluna (valores distorcidos).

• StoredAsSubDirectories – Booleano.

  True, se os dados na tabela estiverem armazenados em subdiretórios, ou False, caso contrário.

• SchemaReference – Um objeto SchemaReference.

  Um objeto que faz referência a um esquema armazenado no AWS Glue Schema Registry.

  Ao criar uma tabela, você pode passar uma lista vazia de colunas para o esquema e, em vez disso, usar uma referência de esquema.

Campos

• SchemaId – Um objeto SchemaId.

  Uma estrutura que contém campos de identidade de esquema. Esse ou o SchemaVersionId tem que ser fornecido.

• SchemaVersionId: string UTF-8, não menos do que 36 ou superior a 36 bytes de comprimento, correspondente a Custom string pattern #17.

  O ID exclusivo atribuído a uma versão do esquema. Esse ou o SchemaId tem que ser fornecido.

• SchemaVersionNumber: número (inteiro longo), não menos do que 1 ou superior a 100.000.

  O número da versão do esquema.

Campos

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome de SerDe.

• SerializationLibrary – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Normalmente, é a classe que implementa o SerDe. Um exemplo é org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe.

• Parameters – Um array de mapa dos pares de valor-chave.

  Cada chave é uma string de chave, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Cada valor é uma string UTF-8 com comprimento não superior a 512.000 bytes.

  Esses pares de chave/valor definem parâmetros de inicialização para SerDe.

Campos

• Column – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da coluna.

• SortOrder – Obrigatório: Número (inteiro), não mais do que 1.

  Indica se a coluna é classificada em ordem crescente (== 1) ou decrescente (==0).

Campos

• SkewedColumnNames – Uma matriz de strings UTF-8.

  Uma lista de nomes de colunas que contêm valores distorcidos.

• SkewedColumnValues – Uma matriz de strings UTF-8.

  Uma lista de valores que aparecem com tanta frequência que devem ser considerados distorcidos.

• SkewedColumnValueLocationMaps – Um array de mapa dos pares de valor-chave.

  Cada chave é uma sequência de caracteres UTF-8.

  Cada valor é uma sequência de caracteres UTF-8.

  Um mapeamento de valores distorcidos para as colunas nas quais estão presentes.

Campos

• Table – Um objeto Tabela.

  A tabela em questão.

• VersionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O valor de ID que identifica esta versão da tabela. Um VersionId é uma representação em string de um inteiro. Cada versão é incrementada em 1.

Campos

• TableName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, ele deve ser inserido todo em letras minúsculas.

• ErrorDetail – Um objeto ErrorDetail.

  Os detalhes sobre o erro.

Campos

• TableName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela em questão.

• VersionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O valor de ID da versão em questão. Um VersionID é uma representação em string de um inteiro. Cada versão é incrementada em 1.

• ErrorDetail – Um objeto ErrorDetail.

  Os detalhes sobre o erro.

Campos

• FieldName: valor de string não superior a 1.024 bytes de comprimento.

  O nome do campo no qual classificar.

• Sort: string UTF-8 (valores válidos: ASC="ASCENDING" | DESC="DESCENDING").

  Uma classificação crescente ou decrescente.

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 do catálogo de dados em que a tabela reside.

• DatabaseName – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados de catálogo que contém a tabela de destino.

• Name – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela de destino.

• Region – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  Região da tabela de destino.

Campos

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome de uma chave de partição.

• Type: obrigatório: string UTF-8 com comprimento não superior a 131.072 bytes, correspondente a Single-line string pattern.

  O tipo de uma chave de partição.

Campos

• Keys – Obrigatório: uma matriz de strings UTF-8, pelo menos 1 string.

  As chaves para o índice de partição.

• IndexName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do índice de partição.

Campos

• IndexName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do índice de partição.

• Keys: obrigatório: uma matriz de objetos KeySchemaElement, pelo menos uma estrutura.

  Uma lista de uma ou mais chaves, como estruturas KeySchemaElement, para o índice de partição.

• IndexStatus: obrigatório: string UTF-8 (valores válidos: CREATING | ACTIVE | DELETING | FAILED).

  O status do índice de partição.

  Os possíveis status são:

  • CREATING (CRIANDO): o índice está sendo criado. Quando um índice está em um estado CREATING, o índice ou sua tabela não podem ser excluídos.

  • ACTIVE (ATIVO): a criação do índice foi bem-sucedida.

  • FAILED (FALHOU): a criação do índice falhou.

  • DELETING (EXCLUINDO): o índice é excluído da lista de índices.

• BackfillErrors – Uma matriz de objetos BackfillError.

  Uma lista de erros que podem ocorrer no registro de índices de partição para uma tabela existente.

• EncryptedPartitionError: as partições são encriptadas.

• InvalidPartitionTypeDataError: o valor da partição não corresponde ao tipo de dados dessa coluna de partição.

• MissingPartitionValueError: as partições são criptografadas.

• UnsupportedPartitionCharacterError: caracteres dentro do valor da partição não são suportados. Por exemplo: U+0000, U+0001, U+0002.

• InternalError: qualquer erro que não pertence a outros códigos de erro.

Campos

• Code – String UTF-8 (valores válidos: ENCRYPTED_PARTITION_ERROR | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR | MISSING_PARTITION_VALUE_ERROR | UNSUPPORTED_PARTITION_CHARACTER_ERROR).

  O código de erro para um erro que ocorreu durante o registro de índices de partição para uma tabela existente.

• Partitions – Uma matriz de objetos PartitionValueList.

  Uma lista com um número limitado de partições na resposta.

Campos

• MetadataOperation: obrigatório: string UTF-8 (valores válidos: CREATE).

  Uma operação de metadados obrigatória. Só pode ser definida como CREATE.

• Version – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  A versão da tabela para a tabela do Iceberg. Padronizado como 2.

Campos

• IcebergInput – Um objeto IcebergInput.

  Especifica uma estrutura IcebergInput que define uma tabela de metadados do Apache Iceberg.

Campos

• IsProtected – Booleano.

  É possível definir esse sinalizador como verdadeiro para instruir o mecanismo a não inserir as operações fornecidas pelo usuário no plano lógico da exibição durante o planejamento da consulta. No entanto, definir esse sinalizador não garante que o mecanismo estará em conformidade. Consulte a documentação do mecanismo para entender as garantias fornecidas, se houver.

• Definer – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Single-line string pattern.

  O definidor de uma visualização em SQL.

• SubObjects – Uma matriz de strings UTF-8, no máximo 10 strings.

  Uma lista de nomes do recurso da Amazon (ARNs) da tabela.

• Representations: uma matriz de objetos ViewRepresentation, não menos do que 1 ou superior a 1.000 estruturas.

  Uma lista de representações.

Campos

• IsProtected – Booleano.

  É possível definir esse sinalizador como verdadeiro para instruir o mecanismo a não inserir as operações fornecidas pelo usuário no plano lógico da exibição durante o planejamento da consulta. No entanto, definir esse sinalizador não garante que o mecanismo estará em conformidade. Consulte a documentação do mecanismo para entender as garantias fornecidas, se houver.

• Definer – String UTF-8, superior a 1 e inferior a 512 bytes de comprimento, correspondente a Single-line string pattern.

  O definidor de uma visualização em SQL.

• Representations: uma matriz de objetos ViewRepresentationInput com não menos que 1 nem mais que 10 estruturas.

  Uma lista de estruturas que contém o dialeto da visualização e a consulta que define a visualização.

• SubObjects – Uma matriz de strings UTF-8, no máximo 10 strings.

  Uma lista dos ARNs da tabela base que compõem a visualização.

Campos

• Dialect – String UTF-8 (valores válidos: REDSHIFT | ATHENA | SPARK).

  O dialeto do mecanismo de consulta.

• DialectVersion: string UTF-8, não menos do que 1 ou superior a 255 bytes de comprimento.

  A versão do dialeto do mecanismo de consulta. Por exemplo, 3.0.0.

• ViewOriginalText – String UTF-8 com comprimento não superior a 409.600 bytes.

  A consulta SELECT fornecida pelo cliente durante CREATE VIEW DDL. Esse SQL não é usado durante uma consulta em uma visualização (ViewExpandedText é usado em vez disso). ViewOriginalText é usada para casos como SHOW CREATE VIEW quando os usuários querem ver o comando DDL original que criou a visualização.

• ViewExpandedText – String UTF-8 com comprimento não superior a 409.600 bytes.

  O SQL expandido para a visualização. Esse SQL é usado pelos mecanismos durante o processamento de uma consulta em uma visualização. Os mecanismos podem realizar operações durante a criação da visualização para transformar ViewOriginalText em ViewExpandedText. Por exemplo:

  • Identificadores totalmente qualificados: SELECT * from table1 -> SELECT * from db1.table1

• ValidationConnection – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da conexão a ser usada para validar a representação específica da visualização.

• IsStale – Booleano.

  Os dialetos marcados como obsoletos não são mais válidos e devem ser atualizados antes que possam ser consultados em seus respectivos mecanismos de consulta.

Campos

• Dialect – String UTF-8 (valores válidos: REDSHIFT | ATHENA | SPARK).

  Um parâmetro que especifica o tipo do mecanismo de uma representação específica.

• DialectVersion: string UTF-8, não menos do que 1 ou superior a 255 bytes de comprimento.

  Um parâmetro que especifica a versão do mecanismo de uma representação específica.

• ViewOriginalText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Uma string que representa a consulta SQL original que descreve a visualização.

• ValidationConnection – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da conexão a ser usada para validar a representação específica da visualização.

• ViewExpandedText – String UTF-8 com comprimento não superior a 409.600 bytes.

  Uma string que representa a consulta SQL que descreve a exibição com ARNs de recursos expandidos

• Ação CreateTable (Python: create_table)

• Ação UpdateTable (Python: update_table)

• Ação DeleteTable (Python: delete_table)

• Ação BatchDeleteTable (Python: batch_delete_table)

• Ação GetTable (Python: get_table)

• Ação GetTables (Python: get_tables)

• Ação GetTableVersion (Python: get_table_version)

• Ação GetTableVersions (Python: get_table_versions)

• Ação DeleteTableVersion (Python: delete_table_version)

• Ação BatchDeleteTableVersion (Python: batch_delete_table_version)

• Ação SearchTables (Python: search_tables)

• Ação GetPartitionIndexes (Python: get_partitions_indexes)

• Ação CreatePartitionIndex (Python: create_partition_index)

• Ação DeletePartitionIndex (Python: delete_partition_index)

• Ação GetColumnStatisticsForTable (Python: get_column_statistics_for_table)

• Ação UpdateColumnStatisticsForTable (Python: update_column_statistics_for_table)

• Ação DeleteColumnStatisticsForTable (Python: delete_column_statistics_for_table)

Solicitação

• 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 do catálogo de dados em que a Table será criada. Se nenhum valor for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados do catálogo em que a nova tabela será criada. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableInput – Obrigatório: um objeto TableInput.

  O objeto TableInput que define a tabela de metadados a ser criada no catálogo.

• PartitionIndexes: uma matriz de objetos PartitionIndex, não mais do que três estruturas.

  Uma lista de índices de partição, estruturas PartitionIndex, para criar na tabela.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação.

• OpenTableFormatInput – Um objeto OpenTableFormatInput.

  Especifica uma estrutura OpenTableFormatInput ao criar uma tabela de formato aberto.

Resposta

• Nenhum parâmetro de resposta.

Erros

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• ResourceNotReadyException

Solicitação

• 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 do catálogo de dados no qual reside a tabela. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados do catálogo no qual a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableInput – Obrigatório: um objeto TableInput.

  O objeto TableInput atualizado que define a tabela de metadados no catálogo.

• SkipArchive – Booleano.

  Por padrão, o UpdateTable sempre cria uma versão arquivada da tabela antes de atualizá-la. No entanto, se skipArchive estiver definido como true, UpdateTable não cria a versão arquivada.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação na qual atualizar o conteúdo da tabela.

• VersionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da versão na qual atualizar o conteúdo da tabela.

• ViewUpdateAction – String UTF-8 (valores válidos: ADD | REPLACE | ADD_OR_REPLACE | DROP).

  A operação a ser executada ao atualizar a visualização.

• Force – Booleano.

  Um sinalizador que pode ser definido como verdadeiro para ignorar os requisitos correspondentes de correspondência do descritor de armazenamento e do subobjeto.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

Solicitação

• 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 do catálogo de dados no qual reside a tabela. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados do catálogo no qual a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Nome da tabela a ser excluída. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação na qual excluir o conteúdo da tabela.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNotReadyException

Solicitação

• 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 do catálogo de dados no qual reside a tabela. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados de catálogo no qual as tabelas a serem excluídas residem. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TablesToDelete – Obrigatório: uma matriz de strings UTF-8, no máximo 100 strings.

  Uma lista da tabela a ser excluída.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação na qual excluir o conteúdo da tabela.

Resposta

• Errors – Uma matriz de objetos TableError.

  Uma lista de erros encontrados na tentativa de excluir as tabelas especificadas.

Erros

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

Solicitação

• 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 do catálogo de dados no qual reside a tabela. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados no catálogo em que a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• Name – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela para o qual recuperar a definição. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação na qual ler o conteúdo da tabela.

• QueryAsOfTime – Timestamp.

  A hora de ler o conteúdo da tabela. Se não estiver definido, o tempo de confirmação de transação mais recente será usado. Não pode ser especificado junto com TransactionId.

• IncludeStatusDetails – Booleano.

  Especifica se devem ser incluídos detalhes de status relacionados a uma solicitação para criar ou atualizar uma exibição do Catálogo de Dados do AWS Glue.

Resposta

• Table – Um objeto Tabela.

  O objeto Table que define a tabela especificada.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

Solicitação

• 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 do catálogo de dados no qual residem as tabelas. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados no catálogo cujas tabelas serão listadas. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• Expression – String UTF-8 com comprimento não superior a 2048 bytes, correspondente a Single-line string pattern.

  Um padrão de expressão regular. Se presente, apenas as tabelas cujos nomes correspondem ao padrão serão retornadas.

• NextToken – String UTF-8.

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

• MaxResults: número (inteiro), não menos do que 1 ou superior a 100.

  O número máximo de tabelas a serem retornados em uma única resposta.

• TransactionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Custom string pattern #16.

  O ID da transação na qual ler o conteúdo da tabela.

• QueryAsOfTime – Timestamp.

  A hora de ler o conteúdo da tabela. Se não estiver definido, o tempo de confirmação de transação mais recente será usado. Não pode ser especificado junto com TransactionId.

• IncludeStatusDetails – Booleano.

  Especifica se devem ser incluídos detalhes de status relacionados a uma solicitação para criar ou atualizar uma exibição do Catálogo de Dados do AWS Glue.

• AttributesToGet – Uma matriz de strings UTF-8.

  Especifica os campos do banco de dados retornados pela chamada GetTables. Esse parâmetro não aceita uma lista vazia. A solicitação deve incluir NAME.

  As seguintes combinações de valores são válidas:

  • NAME: nomes de todas as tabelas no banco de dados.

  • NAME, TABLE_TYPE: nomes de todas as tabelas e dos tipos de tabelas.

Resposta

• TableList – Uma matriz de objetos Tabela.

  Uma lista de objetos Table solicitados.

• NextToken – String UTF-8.

  Um token de continuação, presente se o segmento de lista atual não for o último.

Erros

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException

• FederationSourceException

• FederationSourceRetryableException

Solicitação

• 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 do catálogo de dados no qual residem as tabelas. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados no catálogo em que a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• VersionId – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O valor de ID da versão de tabela a ser recuperada. Um VersionID é uma representação em string de um inteiro. Cada versão é incrementada em 1.

Resposta

• TableVersion – Um objeto TableVersion.

  A versão da tabela solicitada.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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 do catálogo de dados no qual residem as tabelas. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados no catálogo em que a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• NextToken – String UTF-8.

  Um token de continuação, se esta não for a primeira chamada.

• MaxResults: número (inteiro), não menos do que 1 ou superior a 100.

  O número máximo de versões de tabela a ser retornado em uma resposta.

Resposta

• TableVersions – Uma matriz de objetos TableVersion.

  Uma lista de strings identificando versões disponíveis da tabela especificada.

• NextToken – String UTF-8.

  Um token de continuação, se a lista de versões disponíveis não incluir o último token.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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 do catálogo de dados no qual residem as tabelas. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados no catálogo em que a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• VersionId – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O ID da versão de tabela a ser excluída. Um VersionID é uma representação em string de um inteiro. Cada versão é incrementada em 1.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Solicitação

• 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 do catálogo de dados no qual residem as tabelas. Se nenhum for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O banco de dados no catálogo em que a tabela reside. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela. Para a compatibilidade com o Hive, o nome deve ser inserido todo em letras minúsculas.

• VersionIds – Obrigatório: uma matriz de strings UTF-8, no máximo 100 strings.

  Uma lista dos IDs das versões a serem excluídas. Um VersionId é uma representação em string de um inteiro. Cada versão é incrementada em 1.

Resposta

• Errors – Uma matriz de objetos TableVersionError.

  Uma lista de erros encontrados durante a tentativa de excluir as versões de tabela especificadas.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

Solicitação

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

  Um identificador exclusivo, que consiste em account_id.

• NextToken – String UTF-8.

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

• Filters – Uma matriz de objetos PropertyPredicate.

  Uma lista de pares de chave/valor e um comparador usado para filtrar os resultados da pesquisa. Retorna todas as entidades correspondentes ao predicado.

  O membro Comparator da estrutura PropertyPredicate é usado apenas para campos de tempo, e pode ser omitido para outros tipos de campo. Além disso, ao comparar valores de string, como quando Key=Name, um algoritmo de correspondência difusa é usado. O campo Key (por exemplo, o valor do campo Name) é dividido em tokens em certos caracteres de pontuação, por exemplo, -, :, # etc. Em seguida, cada token é comparado por correspondência exata com o membro Value de PropertyPredicate. Por exemplo, se Key=Name e Value=link, as tabelas denominadas customer-link e xx-link-yy são retornadas, mas xxlinkyy não é.

• SearchText: valor de string não superior a 1.024 bytes de comprimento.

  Uma string usada para uma pesquisa de texto.

  Especificar um valor em filtros de aspas com base em uma correspondência exata com o valor.

• SortCriteria: uma matriz de objetos SortCriterion, não mais do que uma estrutura.

  Uma lista de critérios para classificar os resultados por um nome de campo, em uma ordem crescente ou decrescente.

• MaxResults – Número (inteiro), superior a 1 ou mais que 1000.

  O número máximo de tabelas a serem retornados em uma única resposta.

• ResourceShareType – String UTF-8 (valores válidos: FOREIGN | ALL | FEDERATED).

  Permite que você especifique que deseja pesquisar as tabelas compartilhadas com sua conta. Os valores permitidos são FOREIGN ou ALL.

  • Se definido como FOREIGN, listará as tabelas compartilhadas com sua conta.

  • Se definido como ALL, listará as tabelas compartilhadas com sua conta, bem como as tabelas em sua conta local.

• IncludeStatusDetails – Booleano.

  Especifica se devem ser incluídos detalhes de status relacionados a uma solicitação para criar ou atualizar uma exibição do Catálogo de Dados do AWS Glue.

Resposta

• NextToken – String UTF-8.

  Um token de continuação, presente se o segmento de lista atual não for o último.

• TableList – Uma matriz de objetos Tabela.

  Uma lista de objetos Table solicitados. A resposta SearchTables retorna apenas as tabelas às quais você tem acesso.

Erros

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

Solicitação

• 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 no qual reside a tabela.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de um banco de dados a partir do qual você deseja recuperar índices de partição.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de uma tabela para a qual você deseja recuperar os índices da partição.

• NextToken – String UTF-8.

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

Resposta

• PartitionIndexDescriptorList – Uma matriz de objetos PartitionIndexDescriptor.

  Uma lista de descritores de índice.

• NextToken – String UTF-8.

  Um token de continuação, presente se o segmento de lista atual não for o último.

Erros

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

Solicitação

• 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 no qual reside a tabela.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de um banco de dados no qual você deseja criar um índice de partição.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de uma tabela na qual você deseja criar um índice de partição.

• PartitionIndex – Obrigatório: um objeto PartitionIndex.

  Especifica uma estrutura PartitionIndex para criar um índice de partição em uma tabela existente.

Resposta

• Nenhum parâmetro de resposta.

Erros

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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 no qual reside a tabela.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de um banco de dados do qual você deseja excluir um índice de partição.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  Especifica o nome de uma tabela da qual você deseja excluir um índice de partição.

• IndexName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do índice de partição a ser excluído.

Resposta

• Nenhum parâmetro de resposta.

Erros

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

• GlueEncryptionException

Solicitação

• 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 do catálogo de dados no qual residem as partições em questão. Se nenhum valor for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados de catálogos no qual as partições residem.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela das partições.

• ColumnNames – Obrigatório: uma matriz de strings UTF-8, no máximo 100 strings.

  Uma lista de nomes de coluna.

Resposta

• ColumnStatisticsList – Uma matriz de objetos ColumnStatistics.

  Lista de ColumnStatistics.

• Errors – Uma matriz de objetos ColumnError.

  Lista de ColumnStatistics cuja recuperação falhou.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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 do catálogo de dados no qual residem as partições em questão. Se nenhum valor for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados de catálogos no qual as partições residem.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela das partições.

• ColumnStatisticsList – Obrigatório: uma matriz de objetos ColumnStatistics, não mais de 25 estruturas.

  Uma lista de estatísticas de coluna.

Resposta

• Errors – Uma matriz de objetos ColumnStatisticsError.

  Lista de ColumnStatisticsErrors.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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 do catálogo de dados no qual residem as partições em questão. Se nenhum valor for fornecido, o ID da conta da AWS será usado por padrão.

• DatabaseName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome do banco de dados de catálogos no qual as partições residem.

• TableName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da tabela das partições.

• ColumnName – Obrigatório: string UTF-8, no mínimo 1 ou mais de 255 bytes de comprimento, correspondente a Single-line string pattern.

  O nome da coluna.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException