# API de partição
<a name="aws-glue-api-catalog-partitions"></a>

A Partição da API descreve os tipos de dados e operações usadas para trabalhar com partições.

## Tipos de dados
<a name="aws-glue-api-catalog-partitions-objects"></a>
+ [Estrutura Partition](#aws-glue-api-catalog-partitions-Partition)
+ [Estrutura PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput)
+ [Estrutura PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
+ [Estrutura PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
+ [Estrutura PartitionSpecProxy](#aws-glue-api-catalog-partitions-PartitionSpecProxy)
+ [Estrutura PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList)
+ [Estrutura Segment](#aws-glue-api-catalog-partitions-Segment)
+ [Estrutura PartitionError](#aws-glue-api-catalog-partitions-PartitionError)
+ [Estrutura BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
+ [Estrutura BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
+ [Estrutura StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor)
+ [Estrutura SchemaReference](#aws-glue-api-catalog-partitions-SchemaReference)
+ [Estrutura SerDeInfo](#aws-glue-api-catalog-partitions-SerDeInfo)
+ [Estrutura SkewedInfo](#aws-glue-api-catalog-partitions-SkewedInfo)

## Estrutura Partition
<a name="aws-glue-api-catalog-partitions-Partition"></a>

Representa uma fatia dos dados da tabela.

**Campos**
+ `Values` – Uma matriz de strings UTF-8.

  Os valores da partição.
+ `DatabaseName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados de catálogo no qual a função será criada.
+ `TableName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela do banco de dados na qual criar a partição.
+ `CreationTime` – Timestamp.

  A hora em que a partição foi criada.
+ `LastAccessTime` – Timestamp.

  A hora em que a partição foi acessada pela última vez.
+ `StorageDescriptor` – Um objeto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  Fornece informações sobre o local físico no qual a partição está armazenada.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

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

  Esses pares de chave/valor definem parâmetros de partição.
+ `LastAnalyzedTime` – Timestamp.

  A última vez em que as estatísticas de colunas foram calculadas para esta partiçã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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do Data Catalog em que a partição reside.

## Estrutura PartitionInput
<a name="aws-glue-api-catalog-partitions-PartitionInput"></a>

A estrutura usada para criar e atualizar uma partição.

**Campos**
+ `Values` – Uma matriz de strings UTF-8.

  Os valores da partição. Embora este parâmetro não seja exigido pelo SDK, você deve especificá-lo para uma entrada válida.

  Os valores das chaves da nova partição devem ser passados como uma matriz de objetos String que devem ser classificados na mesma ordem que as chaves de partição que aparecem no prefixo do Amazon S3. Caso contrário, o AWS Glue adicionará os valores às chaves incorretas.
+ `LastAccessTime` – Timestamp.

  A hora em que a partição foi acessada pela última vez.
+ `StorageDescriptor` – Um objeto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  Fornece informações sobre o local físico no qual a partição está armazenada.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

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

  Esses pares de chave/valor definem parâmetros de partição.
+ `LastAnalyzedTime` – Timestamp.

  A última vez em que as estatísticas de colunas foram calculadas para esta partição.

## Estrutura PartitionSpecWithSharedStorageDescriptor
<a name="aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor"></a>

Uma especificação de partição para partições que compartilham um local físico.

**Campos**
+ `StorageDescriptor` – Um objeto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor).

  As informações do armazenamento físico compartilhado.
+ `Partitions`: um array de objetos [Partition](#aws-glue-api-catalog-partitions-Partition).

  Uma lista das partições que compartilham este local físico.

## Estrutura PartitionListComposingSpec
<a name="aws-glue-api-catalog-partitions-PartitionListComposingSpec"></a>

Lista as partições relacionadas.

**Campos**
+ `Partitions`: um array de objetos [Partition](#aws-glue-api-catalog-partitions-Partition).

  Uma lista das partições na especificação de composição.

## Estrutura PartitionSpecProxy
<a name="aws-glue-api-catalog-partitions-PartitionSpecProxy"></a>

Fornece um caminho raiz para as partições especificadas.

**Campos**
+ `DatabaseName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O banco de dados de catálogo no qual residem as partições.
+ `TableName` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela que contém as partições.
+ `RootPath` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O caminho raiz do proxy para as partições.
+ `PartitionSpecWithSharedSD` – Um objeto [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor).

  Uma especificação de partições que compartilham o mesmo local de armazenamento físico.
+ `PartitionListComposingSpec` – Um objeto [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec).

  Especifica uma lista de partições.

## Estrutura PartitionValueList
<a name="aws-glue-api-catalog-partitions-PartitionValueList"></a>

Contém uma lista dos valores que definem as partições.

**Campos**
+ `Values`: *obrigatório:* uma matriz de strings UTF-8.

  A lista de valores.

## Estrutura Segment
<a name="aws-glue-api-catalog-partitions-Segment"></a>

Define uma região não sobreposta das partições de uma tabela, permitindo que várias solicitações sejam executadas simultaneamente.

**Campos**
+ `SegmentNumber` – *Obrigatório:* número (inteiro), não mais do que Nenhum.

  O número de índice baseado em zero do segmento. Por exemplo, se o número total de segmentos for 4, os valores de `SegmentNumber` vão variar de 0 a 3.
+ `TotalSegments` – *Obrigatório:* número (inteiro), no mínimo 1 ou mais que 10.

  O número total de segmentos.

## Estrutura PartitionError
<a name="aws-glue-api-catalog-partitions-PartitionError"></a>

Contém informações sobre um erro de partição.

**Campos**
+ `PartitionValues` – Uma matriz de strings UTF-8.

  Os valores que definem a partição.
+ `ErrorDetail` – Um objeto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Os detalhes sobre o erro de partição.

## Estrutura BatchUpdatePartitionFailureEntry
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry"></a>

Contém informações sobre um erro de partição de atualização em lote.

**Campos**
+ `PartitionValueList` – Uma matriz de strings UTF-8, no máximo 100 strings.

  Uma lista dos valores que definem as partições.
+ `ErrorDetail` – Um objeto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  Os detalhes sobre o erro de partição de atualização em lote.

## Estrutura BatchUpdatePartitionRequestEntry
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry"></a>

Uma estrutura que contém os valores e a estrutura usados para atualizar uma partição.

**Campos**
+ `PartitionValueList` – *Obrigatório:* uma matriz de strings UTF-8, no máximo 100 strings.

  Uma lista dos valores que definem as partições.
+ `PartitionInput` – *Obrigatório:* um objeto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  A estrutura usada para atualizar uma partição.

## Estrutura StorageDescriptor
<a name="aws-glue-api-catalog-partitions-StorageDescriptor"></a>

Descreve o armazenamento físico dos dados da tabela.

**Campos**
+ `Columns`: um array de objetos [Coluna](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column).

  Uma lista de `Columns` na tabela.
+ `Location` – String de local, inferior a 2056 bytes de comprimento, correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](#aws-glue-api-catalog-partitions-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](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](#aws-glue-api-catalog-partitions-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](#aws-glue-api-catalog-partitions-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.

## Estrutura SchemaReference
<a name="aws-glue-api-catalog-partitions-SchemaReference"></a>

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

**Campos**
+ `SchemaId` – Um objeto [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-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 #45](aws-glue-api-common.md#regex_45).

  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.

## Estrutura SerDeInfo
<a name="aws-glue-api-catalog-partitions-SerDeInfo"></a>

As informações sobre um programa de serialização/desserialização (SerDe), que serve como extrator e carregador.

**Campos**
+ `Name` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome de SerDe.
+ `SerializationLibrary` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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.

## Estrutura SkewedInfo
<a name="aws-glue-api-catalog-partitions-SkewedInfo"></a>

Especifica valores distorcidos em uma tabela. Valores distorcidos são aqueles que ocorrem com muita frequência.

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

## Operações
<a name="aws-glue-api-catalog-partitions-actions"></a>
+ [Ação CreatePartition (Python: create\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition)
+ [Ação BatchCreatePartition (Python: batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition)
+ [Ação UpdatePartition (Python: update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition)
+ [Ação DeletePartition (Python: delete\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition)
+ [Ação BatchDeletePartition (Python: batch\$1delete\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition)
+ [Ação GetPartition (Python: get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition)
+ [Ação GetPartitions (Python: get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions)
+ [Ação BatchGetPartition (Python: batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition)
+ [Ação BatchUpdatePartition (Python: batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition)
+ [Ação GetColumnStatisticsForPartition (Python: get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
+ [Ação UpdateColumnStatisticsForPartition (Python: update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
+ [Ação DeleteColumnStatisticsForPartition (Python: delete\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)

## Ação CreatePartition (Python: create\$1partition)
<a name="aws-glue-api-catalog-partitions-CreatePartition"></a>

Cria uma nova partição.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID da conta da AWS do catálogo no qual a partição deve ser criada.
+ `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados de metadados no qual a partição deve ser criada.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela de metadados na qual a partição deve ser criada.
+ `PartitionInput` – *Obrigatório:* um objeto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  Uma estrutura `PartitionInput` que define a partição a ser criada.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## Ação BatchCreatePartition (Python: batch\$1create\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchCreatePartition"></a>

Cria uma ou mais partições em uma operação em lote.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo no qual a partição deve ser criada. No momento, deve ser o ID da conta da AWS.
+ `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados de metadados no qual a partição deve ser criada.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela de metadados na qual a partição deve ser criada.
+ `PartitionInputList` – *Obrigatório:* uma matriz de objetos [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput), não mais de 100 estruturas.

  Uma lista das estruturas `PartitionInput` que definem as partições a serem criadas.

**Resposta**
+ `Errors`: um array de objetos [PartitionError](#aws-glue-api-catalog-partitions-PartitionError).

  Os erros encontrados ao tentar criar as partições solicitadas.

**Erros**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## Ação UpdatePartition (Python: update\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdatePartition"></a>

Atualiza uma partição.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo de dados no qual reside a partição a ser atualizada. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados do catálogo no qual a tabela em questão reside.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela de metadados na qual a partição a ser atualizada está localizada.
+ `PartitionValueList` – *Obrigatório:* uma matriz de strings UTF-8, no máximo 100 strings.

  Lista de valores de chaves-valor de partição que definem a partição a ser atualizada.
+ `PartitionInput` – *Obrigatório:* um objeto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput).

  O novo objeto de partição para o qual a partição será atualizada.

  A propriedade `Values` não pode ser alterada. Se você quiser alterar as chaves-valor de uma partição, exclua e recrie a partição.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## Ação DeletePartition (Python: delete\$1partition)
<a name="aws-glue-api-catalog-partitions-DeletePartition"></a>

Exclui uma partição especificada.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo de dados no qual reside a partição a ser excluída. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados do catálogo no qual a tabela em questão reside.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela que contém a partição a ser excluída.
+ `PartitionValues`: *obrigatório:* uma matriz de strings UTF-8.

  Os valores que definem a partição.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação BatchDeletePartition (Python: batch\$1delete\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchDeletePartition"></a>

Exclui uma ou mais partições em uma operação em lote.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo de dados no qual reside a partição a ser excluída. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados do catálogo no qual a tabela em questão reside.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela que contém as partições a serem excluídas.
+ `PartitionsToDelete` – *Obrigatório:* uma matriz de objetos [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), não mais de 25 estruturas.

  Uma lista das estruturas `PartitionInput` que definem as partições a serem excluídas.

**Resposta**
+ `Errors`: um array de objetos [PartitionError](#aws-glue-api-catalog-partitions-PartitionError).

  Os erros encontrados ao tentar excluir as partições solicitadas.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## Ação GetPartition (Python: get\$1partition)
<a name="aws-glue-api-catalog-partitions-GetPartition"></a>

Recupera informações sobre uma partição especificada.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo de dados no qual reside a partição em questão. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados de catálogos no qual a partição reside.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela da partição.
+ `PartitionValues`: *obrigatório:* uma matriz de strings UTF-8.

  Os valores que definem a partição.

**Resposta**
+ `Partition` – Um objeto [Partition](#aws-glue-api-catalog-partitions-Partition).

  A informação solicitada, na forma de um objeto `Partition`.

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## Ação GetPartitions (Python: get\$1partitions)
<a name="aws-glue-api-catalog-partitions-GetPartitions"></a>

Recupera informações sobre as partições em uma tabela.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID do catálogo de dados no qual residem as partições em questão. 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela das partições.
+ `Expression` – String de predicado, inferior a 2048 bytes de comprimento, correspondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Uma expressão que filtra as partições a serem retornadas.

  A expressão usa sintaxe SQL semelhante à cláusula de filtro SQL `WHERE`. O analisador de instrução SQL [JSQLParser](http://jsqlparser.sourceforge.net/home.php) analisa a expressão. 

  *Operadores*: estes são os operadores que você pode usar na chamada de API `Expression`:  
=  
Verifica se os valores dos dois operandos são iguais. Em caso afirmativo, a condição é verdadeira.  
Exemplo: suponha que a "variável a" seja 10 e a "variável b" 20.   
(a = b) não é verdadeiro.  
< >  
Verifica se os valores dos dois operandos são iguais. Se os valores não forem iguais, a condição será verdadeira.  
Exemplo: (a < > b) é verdadeiro.  
>  
Verifica se o valor do operando esquerdo é maior que o valor do operando direito. Em caso afirmativo, a condição é verdadeira.  
Exemplo: (a > b) não é verdadeiro.  
<  
Verifica se o valor do operando esquerdo é menor que o valor do operando direito. Em caso afirmativo, a condição é verdadeira.  
Exemplo: (a < b) é verdadeiro.  
>=  
Verifica se o valor do operando esquerdo é maior ou igual ao valor do operando direito. Em caso afirmativo, a condição é verdadeira.  
Exemplo: (a >= b) não é verdadeiro.  
<=  
Verifica se o valor do operando esquerdo é menor ou igual ao valor do operando direito. Em caso afirmativo, a condição é verdadeira.  
Exemplo: (a \$1<= b) é verdadeiro.  
AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL  
Operadores lógicos.

  *Tipos de chave de partição compatíveis*: veja a seguir as chaves de partição compatíveis.
  + `string`
  + `date`
  + `timestamp`
  + `int`
  + `bigint`
  + `long`
  + `tinyint`
  + `smallint`
  + `decimal`

  Se um tipo que não seja válido for encontrado, uma exceção será lançada. 

  A lista a seguir mostra os operadores válidos em cada tipo. Quando você define um crawler, o tipo `partitionKey` é criado como um `STRING`, para ser compatível com as partições do catálogo. 

  *Exemplo de chamada de API*:   
**Example**  

  A tabela `twitter_partition` tem três partições:

  ```
  year = 2015
          year = 2016
          year = 2017
  ```  
**Example**  

  Obter `year` da partição igual a 2015

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year*=*'2015'"
  ```  
**Example**  

  Obter `year` da partição entre 2016 e 2018 (exclusivo)

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>'2016' AND year<'2018'"
  ```  
**Example**  

  Obtenha o `year` da partição entre 2015 e 2018 (inclusivo). As seguintes chamadas de API são equivalentes entre si:

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>='2015' AND year<='2018'"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year BETWEEN 2015 AND 2018"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year IN (2015,2016,2017,2018)"
  ```  
**Example**  

  Um filtro de partição curinga, onde a saída de chamada a seguir terá o ano de partição = 2017. Uma expressão regular não é suportada em `LIKE`.

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year LIKE '%7'"
  ```
+ `NextToken` – String UTF-8.

  Um token de continuação, se esta não for a primeira chamada para recuperar essas partições.
+ `Segment` – Um objeto [Segmento](#aws-glue-api-catalog-partitions-Segment).

  O segmento de partições da tabela a ser verificado nesta solicitação.
+ `MaxResults` – Número (inteiro), superior a 1 ou mais que 1000.

  O número máximo de partições a serem retornados em uma única resposta.
+ `ExcludeColumnSchema` – Booleano.

  Quando verdadeiro, especifica não retornar o esquema da coluna de partição. Útil quando você está interessado apenas em outros atributos de partição, como valores ou localização de partição. Essa abordagem evita o problema de uma resposta grande ao não retornar dados duplicados.
+ `TransactionId` – String UTF-8, superior a 1 e inferior a 255 bytes de comprimento, correspondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  O ID da transação na qual ler o conteúdo da partição.
+ `QueryAsOfTime` – Timestamp.

  A hora de ler o conteúdo da partição. 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`.

**Resposta**
+ `Partitions`: um array de objetos [Partition](#aws-glue-api-catalog-partitions-Partition).

  Uma lista de partições solicitadas.
+ `NextToken` – String UTF-8.

  Um token de continuação, se a lista de partições retornada não incluir o último token.

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## Ação BatchGetPartition (Python: batch\$1get\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchGetPartition"></a>

Recupera partições em uma solicitação de lote.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela das partições.
+ `PartitionsToGet` – *Obrigatório:* uma matriz de objetos [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), não mais de 1000 estruturas.

  Uma lista de valores de partição que identifica as partições a serem recuperadas.

**Resposta**
+ `Partitions`: um array de objetos [Partition](#aws-glue-api-catalog-partitions-Partition).

  Uma lista das partições solicitadas.
+ `UnprocessedKeys` – Uma matriz de objetos [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), não mais de 1000 estruturas.

  Uma lista dos valores de partição na solicitação para a qual as partições não foram retornadas.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## Ação BatchUpdatePartition (Python: batch\$1update\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartition"></a>

Atualiza uma ou mais partições em uma operação em lote.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O ID de catálogo no qual a partição deve ser atualizada. No momento, deve ser o ID da conta da AWS.
+ `DatabaseName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome do banco de dados de metadados no qual a partição deve ser atualizada.
+ `TableName`: *obrigatório:* string UTF-8 com no mínimo 1 e no máximo 255 bytes de comprimento e correspondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela de metadados na qual a partição deve ser atualizada.
+ `Entries`: *obrigatório:* uma matriz de objetos [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry), com número de estruturas entre 1 e 100.

  Uma lista de até 100 objetos `BatchUpdatePartitionRequestEntry` a serem atualizados.

**Resposta**
+ `Errors`: um array de objetos [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry).

  Os erros encontrados ao tentar atualizar as partições solicitadas. Uma lista dos objetos `BatchUpdatePartitionFailureEntry`.

**Erros**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

## Ação GetColumnStatisticsForPartition (Python: get\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition"></a>

Recupera estatísticas de partição das colunas.

A permissão de Identity and Access Management (IAM) necessária para essa operação é `GetPartition`.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela das partições.
+ `PartitionValues`: *obrigatório:* uma matriz de strings UTF-8.

  Uma lista de valores de partição que identifica a partição.
+ `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](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics).

  Lista de ColumnStatistics cuja recuperação falhou.
+ `Errors`: um array de objetos [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError).

  Ocorreu um erro durante a recuperação de dados de estatísticas de colunas.

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## Ação UpdateColumnStatisticsForPartition (Python: update\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition"></a>

Cria ou atualiza estatísticas de partição de colunas.

A permissão de Identity and Access Management (IAM) necessária para essa operação é `UpdatePartition`.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela das partições.
+ `PartitionValues`: *obrigatório:* uma matriz de strings UTF-8.

  Uma lista de valores de partição que identifica a partição.
+ `ColumnStatisticsList` – *Obrigatório:* uma matriz de objetos [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), não mais de 25 estruturas.

  Uma lista de estatísticas de colunas.

**Resposta**
+ `Errors`: um array de objetos [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError).

  Ocorreu um erro durante a atualização de dados de estatísticas de coluna

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## Ação DeleteColumnStatisticsForPartition (Python: delete\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition"></a>

Exclui as estatísticas de coluna de partição de uma coluna.

A permissão de Identity and Access Management (IAM) necessária para essa operação é `DeletePartition`.

**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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da tabela das partições.
+ `PartitionValues`: *obrigatório:* uma matriz de strings UTF-8.

  Uma lista de valores de partição que identifica a partição.
+ `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](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  O nome da coluna.

**Resposta**
+ *Nenhum parâmetro de resposta.*

**Erros**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`