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

• Estrutura UpdateOpenTableFormatInput

• Estrutura UpdateIcebergInput

• Estrutura CreateIcebergTableInput

• Estrutura UpdateIcebergTableInput

• Estrutura IcebergSortOrder

• Estrutura IcebergSortField

• Estrutura IcebergPartitionSpec

• Estrutura IcebergPartitionField

• Estrutura IcebergSchema

• Estrutura IcebergStructField

• Estrutura IcebergTableUpdate

• Estrutura IcebergTableMetadata

• Estrutura IcebergEncryptedKey

• Estrutura TableStatus

• Estrutura StatusDetails

• Estrutura ViewValidation

• Esrtutura AuditContext

Campos

• Name: 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.

  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 com no máximo 2.048 bytes de comprimento e 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 de colunas foram calculadas para esta tabela.

• Retention – Número (íntegro).

  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: um array 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.

  AWS GlueTipos de tabela relacionados ao :

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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.

• IsMaterializedView – Booleano.

  Indica que uma tabela é uma MaterializedView.

• IcebergTableMetadata – Um objeto IcebergTableMetadata.

  Os metadados mais recentes de tabela Apache Iceberg para a tabela, incluindo versão de formato, esquemas, especificações de partição e ordens de classificação. Esse campo é preenchido para tabelas Iceberg e reflete o estado atual dos metadados Iceberg da tabela.

• Status – Um objeto TableStatus.

  Indica o estado de uma alteração assíncrona em uma tabela.

Campos

• Name: 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.

  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 com no máximo 2.048 bytes de comprimento e 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 de colunas foram calculadas para esta tabela.

• Retention – Número (íntegro).

  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: um array 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.

  AWS GlueTipos de tabela relacionados ao :

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 512 bytes de comprimento e correspondente a Single-line string pattern.

  Um identificador exclusivo da tabela federada.

• DatabaseIdentifier – string UTF-8 com no mínimo 1 e no máximo 512 bytes de comprimento e 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.

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

  O tipo de conexão usada para acessar a tabela federada, especificando o protocolo ou método de conexão com a fonte de dados externa.

Campos

• Name: 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 #42.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: string Value com no mínimo 1 e no máximo 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O nome do índice de partição.

Campos

• IndexName: 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.

  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: um array 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: um array 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.

• CreateIcebergTableInput – Um objeto CreateIcebergTableInput.

  Os parâmetros de configuração necessários para criar uma nova tabela do Iceberg no Catálogo de Dados do AWS Glue, incluindo propriedades da tabela e especificações de metadados.

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 com no mínimo 1 e no máximo 512 bytes de comprimento e correspondente a Single-line string pattern.

  O definidor de uma visualização em SQL.

• ViewVersionId: número (longo), pelo menos -1.

  O valor de ID que identifica a versão dessa visualização. Para visualizações materializadas, o ID da versão é o ID do snapshot da tabela Apache Iceberg.

• ViewVersionToken – 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 Apache Iceberg.

• RefreshSeconds – Número (extenso).

  Intervalo em segundos de atualização automática da visualização materializada. Se não especificado, a visualização não será atualizada automaticamente.

• LastRefreshType – string UTF-8 (valores válidos: FULL | INCREMENTAL).

  Define o método usado para a atualização mais recente.

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

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

• SubObjectVersionIds: uma matriz de números inteiros com sinal de 64 bits, com no máximo 250 números.

  Lista das versões de tabela Apache Iceberg referenciadas pela visualização materializada.

• 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 com no mínimo 1 e no máximo 512 bytes de comprimento e 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.

• ViewVersionId: número (longo), pelo menos -1.

  O valor de ID que identifica a versão dessa visualização. Para visualizações materializadas, o ID da versão é o ID do snapshot da tabela Apache Iceberg.

• ViewVersionToken – 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 Apache Iceberg.

• RefreshSeconds – Número (extenso).

  Intervalo em segundos de atualização automática da visualização materializada. Se não especificado, a visualização não será atualizada automaticamente.

• LastRefreshType – string UTF-8 (valores válidos: FULL | INCREMENTAL).

  O tipo da última atualização da visualização materializada. Valores válidos: Full, Incremental.

• 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.

• SubObjectVersionIds: uma matriz de números inteiros com sinal de 64 bits, com no máximo 250 números.

  Lista das versões de tabela Apache Iceberg referenciadas pela visualização materializada.

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

Campos

• UpdateIcebergInput – Um objeto UpdateIcebergInput.

  Parâmetros de atualização específicos do Apache Iceberg que definem as modificações da tabela a serem aplicadas, incluindo alterações de esquema, especificações de partição e propriedades da tabela.

Campos

• UpdateIcebergTableInput – Obrigatório: um objeto UpdateIcebergTableInput.

  As operações de atualização específicas a serem aplicadas à tabela do Iceberg, contendo uma lista de atualizações que definem o novo estado da tabela, incluindo esquema, partições e propriedades.

Campos

• Location: – obrigatório: string de local com não mais do que 2.056 bytes de comprimento, combinando com URI address multi-line string pattern.

  O local no S3 onde os dados de tabelas do Iceberg serão armazenados.

• Schema – Obrigatório: um objeto IcebergSchema.

  A definição do esquema que especifica a estrutura, os tipos de campo e os metadados da tabela do Iceberg.

• PartitionSpec – Um objeto IcebergPartitionSpec.

  A especificação de particionamento que define como os dados da tabela do Iceberg serão organizados e particionados para otimizar o desempenho da consulta.

• WriteOrder – Um objeto IcebergSortOrder.

  A especificação da ordem de classificação que define como os dados deverão ser ordenados em cada partição para otimizar o desempenho da consulta.

• Properties – 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.

  Pares de chave e valor de propriedades adicionais de tabela e definições de configuração para a tabela do Iceberg.

Campos

• Updates – Obrigatório: uma matriz de objetos IcebergTableUpdate.

  A lista de operações de atualização de tabela que especificam as alterações a serem feitas na tabela do Iceberg, incluindo modificações no esquema, especificações de partição e propriedades da tabela.

Campos

• OrderId: obrigatório: número (inteiro).

  O identificador exclusivo para essa especificação de ordem de classificação nos metadados da tabela do Iceberg.

• Fields – Obrigatório: uma matriz de objetos IcebergSortField.

  A lista de campos e suas direções de classificação que definem os critérios de ordenação dos dados da tabela do Iceberg.

Campos

• SourceId: obrigatório: número (inteiro).

  O identificador do campo de origem do esquema da tabela no qual esse campo de classificação se baseia.

• Transform – Obrigatório: string UTF-8.

  A função de transformação aplicada ao campo de origem antes da classificação, como identidade, bucket ou truncar.

• Direction – Obrigatório: string UTF-8 (valores válidos: asc="ASC" | desc="DESC").

  A direção de classificação desse campo, ascendente ou descendente.

• NullOrder – Obrigatório: string UTF-8 (valores válidos: nulls-first="NULLS_FIRST" | nulls-last="NULLS_LAST").

  O comportamento de ordenação para os valores nulos nesse campo, especificando se os nulos devem aparecer primeiro ou por último na ordem de classificação.

Campos

• Fields – Obrigatório: uma matriz de objetos IcebergPartitionField.

  A lista de campos de partição que definem como os dados da tabela deverão ser particionados, incluindo campos de origem e suas transformações.

• SpecId – Número (íntegro).

  O identificador exclusivo para essa especificação de partição no histórico de metadados da tabela do Iceberg.

Campos

• SourceId: obrigatório: número (inteiro).

  O identificador do campo de origem do esquema da tabela no qual esse campo de partição se baseia.

• Transform – Obrigatório: string UTF-8.

  A função de transformação aplicada ao campo de origem para criar a partição, como identidade, bucket, truncar, ano, mês, dia ou hora.

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

  O nome do campo de partição conforme ele aparecerá na estrutura da tabela particionada.

• FieldId – Número (íntegro).

  O identificador exclusivo atribuído a esse campo de partição na especificação de partição da tabela do Iceberg.

Campos

• SchemaId – Número (íntegro).

  O identificador exclusivo dessa versão do esquema no histórico de evolução do esquema da tabela do Iceberg.

• IdentifierFieldIds – Uma matriz de números inteiros de 32 bits com sinal.

  A lista de identificadores de campo que identificam exclusivamente os registros na tabela, usados para operações no nível de linha e desduplicação.

• Type – string UTF-8 (valores válidos: struct="STRUCT").

  O tipo de raiz da estrutura do esquema, normalmente “struct” para esquemas de tabela do Iceberg.

• Fields – Obrigatório: uma matriz de objetos IcebergStructField.

  A lista de definições de campo que compõem o esquema da tabela, incluindo nomes, tipos e metadados de campo.

Campos

• Id: obrigatório: número (inteiro).

  O identificador exclusivo atribuído a esse campo no esquema de tabela do Iceberg, usado para evolução do esquema e rastreamento de campo.

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

  O nome do campo conforme ele aparece no esquema da tabela e nas operações de consulta.

• Type – obrigatório: uma estrutura vazia chamada IcebergDocument.

  A definição do tipo de dados para esse campo, especificando a estrutura e o formato dos dados que ele contém.

• Required: obrigatório: booleano.

  Indica se esse campo é obrigatório (não passível de anulação) ou opcional (passível de anulação) no esquema da tabela.

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

  Texto opcional descritivo ou de documentação que fornece contexto adicional sobre a finalidade e o uso deste campo.

• InitialDefault: uma estrutura vazia denominada IcebergDocument.

  Valor padrão usado para preencher o valor do campo em todos os registros gravados antes da adição do campo ao esquema. Isso garante compatibilidade com as versões anteriores ao adicionar novos campos às tabelas Iceberg existentes.

• WriteDefault: uma estrutura vazia denominada IcebergDocument.

  Valor padrão usado para preencher o valor do campo em qualquer registro gravado depois que o campo foi adicionado ao esquema, se o valor do campo não for fornecido. Isso pode ser alterado ao longo da evolução do esquema.

Campos

• Schema – Obrigatório: um objeto IcebergSchema.

  A definição de esquema atualizada para a tabela do Iceberg, especificando quaisquer alterações na estrutura do campo, nos tipos de dados ou nos metadados do esquema.

• PartitionSpec – Um objeto IcebergPartitionSpec.

  A especificação de particionamento atualizada que define como os dados da tabela devem ser reorganizados e particionados.

• SortOrder – Um objeto IcebergSortOrder.

  A especificação atualizada da ordem de classificação que define como os dados deverão ser ordenados nas partições para um desempenho ideal de consulta.

• Location: – obrigatório: string de local com não mais do que 2.056 bytes de comprimento, combinando com URI address multi-line string pattern.

  O local atualizado no S3 onde os dados de tabelas do Iceberg serão armazenados.

• Properties – 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.

  Pares atualizados de chave e valor de propriedades de tabela e definições de configuração para a tabela do Iceberg.

• Action – string UTF-8 (valores válidos: add-schema="ADD_SCHEMA" | set-current-schema="SET_CURRENT_SCHEMA" | add-spec="ADD_SPEC" | set-default-spec="SET_DEFAULT_SPEC" | add-sort-order="ADD_SORT_ORDER" | set-default-sort-order="SET_DEFAULT_SORT_ORDER" | set-location="SET_LOCATION" | set-properties="SET_PROPERTIES" | remove-properties="REMOVE_PROPERTIES" | add-encryption-key="ADD_ENCRYPTION_KEY" | remove-encryption-key="REMOVE_ENCRYPTION_KEY").

  O tipo de ação de atualização a ser executada na tabela Iceberg. Define a operação específica, como adição de esquema, definição do esquema atual, adição de especificações de partição ou gerenciamento de chaves de criptografia.

• EncryptionKey – Um objeto IcebergEncryptedKey.

  Informações da chave de criptografia associadas a uma operação de atualização de tabela Iceberg. Usado ao adicionar ou remover chaves de criptografia dos metadados da tabela durante a evolução da tabela.

• KeyId – string UTF-8, com não mais que 2056 bytes de comprimento, correspondente a URI address multi-line string pattern.

  Identificador da chave de criptografia envolvida em uma operação de atualização de tabela Iceberg. Referencia à chave específica que está sendo adicionada ou removida da configuração de criptografia da tabela.

Campos

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

  A versão do formato de tabela Apache Iceberg, como 1 ou 2. Determina o conjunto de atributos e o layout em disco compatíveis com a tabela.

• TableUuid – string UTF-8, com não mais que 100 bytes de comprimento, correspondente a Single-line string pattern.

  O identificador exclusivo (UUID) da tabela Iceberg, atribuído quando a tabela é criada e usado para rastrear a tabela em todas as atualizações de metadados.

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

  O local de base no S3 onde os dados e os arquivos de metadados da tabela Iceberg são armazenados.

• Properties – 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 mapa de pares de chave-valor que define propriedades e definições de configuração no nível da tabela para a tabela Iceberg.

• Schemas: um array de objetos IcebergSchema.

  A lista de esquemas que foram associados à tabela Iceberg ao longo do tempo, permitindo a evolução do esquema.

• CurrentSchemaId – Número (íntegro).

  O identificador do esquema atualmente ativo para a tabela Iceberg. Corresponde a uma entrada em Schemas.

• LastColumnId – Número (íntegro).

  O identificador de coluna superior que foi atribuído no esquema da tabela Iceberg, usado para garantir IDs exclusivos à medida que novas colunas são adicionadas.

• PartitionSpecs: um array de objetos IcebergPartitionSpec.

  A lista de especificações de partição que foram associadas à tabela Iceberg ao longo do tempo, permitindo a evolução do esquema.

• DefaultSpecId – Número (íntegro).

  O identificador da especificação de partição atualmente usada por padrão ao gravar novos dados na tabela Iceberg.

• LastPartitionId – Número (íntegro).

  O identificador do campo de partição superior que foi atribuído em todas as especificações de partição da tabela.

• SortOrders: um array de objetos IcebergSortOrder.

  A lista de especificações de ordem de classificação que foram associadas à tabela Iceberg ao longo do tempo.

• DefaultSortOrderId – Número (íntegro).

  O identificador da ordem de classificação atualmente usada por padrão ao gravar novos dados na tabela Iceberg.

Campos

• KeyId: – Obrigatório: string UTF-8 com não mais do que 2056 bytes de comprimento, correspondente a URI address multi-line string pattern.

  Identificador exclusivo da chave de criptografia usada na criptografia de tabelas Iceberg. Esse ID é usado para referenciar a chave nos metadados da tabela e rastrear qual foi a chave usada para criptografar dados específicos.

• EncryptedKeyMetadata: – Obrigatório: string UTF-8 com não mais do que 2056 bytes de comprimento, correspondente a URI address multi-line string pattern.

  Chave e metadados criptografados, codificados em base64. O formato dos metadados da chave criptografada é determinado pelo esquema de criptografia da tabela e pode ser um formato encapsulado específico do provedor de KMS da tabela.

• EncryptedById – string UTF-8, com não mais que 2056 bytes de comprimento, correspondente a URI address multi-line string pattern.

  ID opcional da chave usada para criptografar ou encapsular os metadados da chave na criptografia da tabela Iceberg. Esse campo referencia outra chave de criptografia que foi usada para criptografar os metadados da chave atual.

• Properties – 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 mapa de string para string dos metadados adicionais usados pelo esquema de criptografia da tabela. Essas propriedades fornecem contexto e configuração adicional para a implementação da chave de criptografia.

Campos

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

  O ARN do usuário que solicitou a alteração assíncrona.

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

  O ARN do último usuário que alterou manualmente a alteração assíncrona (solicitação de cancelamento etc.).

• RequestTime – Timestamp.

  Uma string de data no formato ISO 8601 indicando a hora em que a alteração foi iniciada.

• UpdateTime – Timestamp.

  Uma string de data no formato ISO 8601 indicando a hora da última atualização de estado.

• Action – string UTF-8 (valores válidos: UPDATE | CREATE).

  Indica a ação que foi chamada na tabela, atualmente somente CREATE ou UPDATE.

• State – string UTF-8 (valores válidos: QUEUED | IN_PROGRESS | SUCCESS | STOPPED | FAILED).

  Um status genérico da alteração em andamento, como QUEUED, IN_PROGRESS, SUCCESS ou FAILED.

• Error – Um objeto ErrorDetail.

  Um erro que só aparecerá quando o estado for "FAILED". Esta é uma mensagem de exceção do nível superior; pode haver Errors diferentes para cada dialeto.

• Details – Um objeto StatusDetails.

  Um objeto StatusDetails com informações sobre a alteração solicitada.

Campos

• RequestedChange – Um objeto Tabela.

  Um objeto Table representando as alterações solicitadas.

• ViewValidations: um array de objetos ViewValidation.

  Uma lista de objetos ViewValidation que contêm informações para um mecanismo analítico validar uma 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.

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

  A consulta SELECT que define a visualização, como fornecida pelo cliente.

• UpdateTime – Timestamp.

  A hora da última atualização.

• State – string UTF-8 (valores válidos: QUEUED | IN_PROGRESS | SUCCESS | STOPPED | FAILED).

  O estado da validação.

• Error – Um objeto ErrorDetail.

  Um erro associado à validação.

Campos

• AdditionalAuditContext – String UTF-8 com comprimento não superior a 2048 bytes.

  Uma string contendo as informações adicionais do contexto de auditoria.

• RequestedColumns – Uma matriz de strings UTF-8.

  As colunas solicitadas para auditoria.

• AllColumnsRequested – Booleano.

  Todas as solicitações de colunas para auditoria.

• 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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O ID do catálogo de dados em que a será criada Table. Se nenhum valor for fornecido, o ID da conta da AWS será usado por padrão.

• 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.

  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.

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

  O identificador exclusivo da tabela no banco de dados especificado que será criado no Catálogo de Dados do AWS Glue.

• TableInput – Um objeto TableInput.

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

• PartitionIndexes: um array de objetos PartitionIndex.

  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 #41.

  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

• FederationSourceException

• FederationSourceRetryableException

Solicitação

• 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a Single-line string pattern.

  O identificador exclusivo da tabela no banco de dados especificado que será criado no Catálogo de Dados do AWS Glue.

• TableInput – 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 #41.

  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.

• UpdateOpenTableFormatInput – Um objeto UpdateOpenTableFormatInput.

  Parâmetros de entrada para atualizar tabelas de formato de tabela aberta no Catálogo de Dados do AWS Glue, servindo como um wrapper para operações de atualização de formatos específicos, como o Apache Iceberg.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

• AlreadyExistsException

Solicitação

• 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 #41.

  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

• FederationSourceException

• FederationSourceRetryableException

Solicitação

• 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 #41.

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

Resposta

• Errors: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 #41.

  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.

• AuditContext – Um objeto AuditContext.

  Uma estrutura que contém o contexto de auditoria do Lake Formation.

• 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 GetTable. Esse parâmetro não aceita uma lista vazia.

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

  • DEFAULT: retorna a definição da tabela no estilo Hive apenas.

  • LATEST_ICEBERG_METADATA: retorna apenas os metadados mais recentes da tabela Apache Iceberg.

  • DEFAULT, LATEST_ICEBERG_METADATA: retorna a definição da tabela no estilo Hive e os metadados mais recentes da tabela Apache Iceberg.

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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 máximo de 2.048 bytes e 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 #41.

  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.

• AuditContext – Um objeto AuditContext.

  Uma estrutura que contém o contexto de auditoria do Lake Formation.

• 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array 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: string Value com no mínimo 1 e no máximo 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O ID de catálogo no qual reside a 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O ID de catálogo no qual reside a 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.

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

• 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O ID de catálogo no qual reside a 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.

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

• 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.

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

• IndexName: 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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: um array de objetos ColumnStatistics.

  Lista de ColumnStatistics.

• Errors: um array 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 colunas.

Resposta

• Errors: um array de objetos ColumnStatisticsError.

  Lista de ColumnStatisticsErrors.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

Solicitação

• 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.

  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 com no mínimo 1 e no máximo 255 bytes de comprimento e 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 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a Single-line string pattern.

  O nome da tabela das partições.

• ColumnName: 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.

  O nome da coluna.

Resposta

• Nenhum parâmetro de resposta.

Erros

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException