Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# API Table
<a name="aws-glue-api-catalog-tables"></a>

L'API Table descrive i tipi di dati e le operazioni associate alle tabelle.

## Tipi di dati
<a name="aws-glue-api-catalog-tables-objects"></a>
+ [Struttura della tabella](#aws-glue-api-catalog-tables-Table)
+ [TableInput struttura](#aws-glue-api-catalog-tables-TableInput)
+ [FederatedTable struttura](#aws-glue-api-catalog-tables-FederatedTable)
+ [Struttura delle colonne](#aws-glue-api-catalog-tables-Column)
+ [StorageDescriptor struttura](#aws-glue-api-catalog-tables-StorageDescriptor)
+ [SchemaReference struttura](#aws-glue-api-catalog-tables-SchemaReference)
+ [SerDeInfo struttura](#aws-glue-api-catalog-tables-SerDeInfo)
+ [Struttura dell'ordine](#aws-glue-api-catalog-tables-Order)
+ [SkewedInfo struttura](#aws-glue-api-catalog-tables-SkewedInfo)
+ [TableVersion struttura](#aws-glue-api-catalog-tables-TableVersion)
+ [TableError struttura](#aws-glue-api-catalog-tables-TableError)
+ [TableVersionError struttura](#aws-glue-api-catalog-tables-TableVersionError)
+ [SortCriterion struttura](#aws-glue-api-catalog-tables-SortCriterion)
+ [TableIdentifier struttura](#aws-glue-api-catalog-tables-TableIdentifier)
+ [KeySchemaElement struttura](#aws-glue-api-catalog-tables-KeySchemaElement)
+ [PartitionIndex struttura](#aws-glue-api-catalog-tables-PartitionIndex)
+ [PartitionIndexDescriptor struttura](#aws-glue-api-catalog-tables-PartitionIndexDescriptor)
+ [BackfillError struttura](#aws-glue-api-catalog-tables-BackfillError)
+ [IcebergInput struttura](#aws-glue-api-catalog-tables-IcebergInput)
+ [OpenTableFormatInput struttura](#aws-glue-api-catalog-tables-OpenTableFormatInput)
+ [ViewDefinition struttura](#aws-glue-api-catalog-tables-ViewDefinition)
+ [ViewDefinitionInput struttura](#aws-glue-api-catalog-tables-ViewDefinitionInput)
+ [ViewRepresentation struttura](#aws-glue-api-catalog-tables-ViewRepresentation)
+ [ViewRepresentationInput struttura](#aws-glue-api-catalog-tables-ViewRepresentationInput)
+ [UpdateOpenTableFormatInput struttura](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput)
+ [UpdateIcebergInput struttura](#aws-glue-api-catalog-tables-UpdateIcebergInput)
+ [CreateIcebergTableInput struttura](#aws-glue-api-catalog-tables-CreateIcebergTableInput)
+ [UpdateIcebergTableInput struttura](#aws-glue-api-catalog-tables-UpdateIcebergTableInput)
+ [IcebergSortOrder struttura](#aws-glue-api-catalog-tables-IcebergSortOrder)
+ [IcebergSortField struttura](#aws-glue-api-catalog-tables-IcebergSortField)
+ [IcebergPartitionSpec struttura](#aws-glue-api-catalog-tables-IcebergPartitionSpec)
+ [IcebergPartitionField struttura](#aws-glue-api-catalog-tables-IcebergPartitionField)
+ [IcebergSchema struttura](#aws-glue-api-catalog-tables-IcebergSchema)
+ [IcebergStructField struttura](#aws-glue-api-catalog-tables-IcebergStructField)
+ [IcebergTableUpdate struttura](#aws-glue-api-catalog-tables-IcebergTableUpdate)
+ [AuditContext struttura](#aws-glue-api-catalog-tables-AuditContext)

## Struttura della tabella
<a name="aws-glue-api-catalog-tables-Table"></a>

Rappresenta una raccolta di dati correlati organizzati in colonne e righe.

**Campi**
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.
+ `DatabaseName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome del database dei metadati in cui risiedono i metadati della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.
+ `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Descrizione della tabella.
+ `Owner`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il proprietario della tabella.
+ `CreateTime`: timestamp.

  Ora della creazione della definizione della tabella nel catalogo dati.
+ `UpdateTime`: timestamp.

  L'ultima volta che la tabella è stata aggiornata.
+ `LastAccessTime`: timestamp.

  L'ultima volta che la tabella è stata consultata. Questo dato in genere viene fornito dall'HDFS e potrebbe non essere affidabile.
+ `LastAnalyzedTime`: timestamp.

  L'ultima volta in cui sono state calcolate le statistiche di colonna per questa tabella.
+ `Retention`: numero (intero), non superiore a Nessuno.

  Tempo di conservazione per questa tabella.
+ `StorageDescriptor`: un oggetto [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor).

  Un descrittore di archiviazione contenente informazioni sull'archiviazione fisica di questa tabella.
+ `PartitionKeys`: una matrice di oggetti [Colonna](#aws-glue-api-catalog-tables-Column).

  Un elenco di colonne in base al quale la tabella è partizionata. Solo i tipi primitivi sono supportati come chiavi di partizione.

  Quando crei una tabella utilizzata da Amazon Athena e non specifichi una `partitionKeys`, è necessario almeno impostare il valore di `partitionKeys` su un elenco vuoto. Ad esempio:

  `"PartitionKeys": []`
+ `ViewOriginalText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle AWS Glue operazioni. Se la tabella è una`VIRTUAL_VIEW`, una determinata Athena configurazione è codificata in base64.
+ `ViewExpandedText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue 
+ `TableType`: stringa UTF-8, non superiore a 255 byte di lunghezza.

  Il tipo di tabella. AWS Glue creerà tabelle con il `EXTERNAL_TABLE` tipo. Altri servizi, ad esempio Athena, possono creare tabelle con tipi di tabelle aggiuntivi. 

  AWS Glue tipi di tabelle correlati:  
EXTERNAL\$1TABLE  
Attributo compatibile con Hive. Indica una tabella non gestita da Hive.  
GOVERNED  
Usato da AWS Lake Formation. Il AWS Glue Data Catalog capisce`GOVERNED`.
+ `Parameters`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Ogni valore è una stringa UTF-8, lunga non più di 512000 byte.

  Queste coppie chiave-valore definiscono proprietà associate a questa tabella.
+ `CreatedBy`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Persona o entità che ha creato la tabella.
+ `IsRegisteredWithLakeFormation`: booleano.

  Indica se la tabella è stata registrata con AWS Lake Formation.
+ `TargetTable`: un oggetto [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier).

  Una struttura `TableIdentifier` che descrive una tabella di destinazione per il collegamento delle risorse.
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella.
+ `VersionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID della versione della tabella.
+ `FederatedTable`: un oggetto [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable).

  Una struttura `FederatedTable` che fa riferimento a un'entità esterna al AWS Glue Data Catalog.
+ `ViewDefinition`: un oggetto [ViewDefinition](#aws-glue-api-catalog-tables-ViewDefinition).

  Una struttura che contiene tutte le informazioni che definiscono la vista, compresi il dialetto o i dialetti della vista, e la query.
+ `IsMultiDialectView`: booleano.

  Specifica se la vista supporta i dialetti SQL di uno o più motori di query diversi e può quindi essere letta da tali motori.

## TableInput struttura
<a name="aws-glue-api-catalog-tables-TableInput"></a>

Una struttura utilizzata per definire una tabella.

**Campi**
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella. Per la compatibilità Hive, questo viene scritto in minuscolo durante la memorizzazione.
+ `Description`: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Descrizione della tabella.
+ `Owner`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il proprietario della tabella. Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle AWS Glue operazioni.
+ `LastAccessTime`: timestamp.

  L'ultima volta che la tabella è stata consultata.
+ `LastAnalyzedTime`: timestamp.

  L'ultima volta in cui sono state calcolate le statistiche di colonna per questa tabella.
+ `Retention`: numero (intero), non superiore a Nessuno.

  Tempo di conservazione per questa tabella.
+ `StorageDescriptor`: un oggetto [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor).

  Un descrittore di archiviazione contenente informazioni sull'archiviazione fisica di questa tabella.
+ `PartitionKeys`: una matrice di oggetti [Colonna](#aws-glue-api-catalog-tables-Column).

  Un elenco di colonne in base al quale la tabella è partizionata. Solo i tipi primitivi sono supportati come chiavi di partizione.

  Quando crei una tabella utilizzata da Amazon Athena e non specifichi una `partitionKeys`, è necessario almeno impostare il valore di `partitionKeys` su un elenco vuoto. Ad esempio:

  `"PartitionKeys": []`
+ `ViewOriginalText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle AWS Glue operazioni. Se la tabella è una`VIRTUAL_VIEW`, una determinata Athena configurazione è codificata in base64.
+ `ViewExpandedText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Incluso per la compatibilità con Apache Hive. Non utilizzato nel normale corso delle operazioni. AWS Glue 
+ `TableType`: stringa UTF-8, non superiore a 255 byte di lunghezza.

  Il tipo di tabella. AWS Glue creerà tabelle con il `EXTERNAL_TABLE` tipo. Altri servizi, ad esempio Athena, possono creare tabelle con tipi di tabelle aggiuntivi. 

  AWS Glue tipi di tabelle correlati:  
EXTERNAL\$1TABLE  
Attributo compatibile con Hive. Indica una tabella non gestita da Hive.  
GOVERNED  
Usato da AWS Lake Formation. Il AWS Glue Data Catalog capisce`GOVERNED`.
+ `Parameters`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Ogni valore è una stringa UTF-8, lunga non più di 512000 byte.

  Queste coppie chiave-valore definiscono proprietà associate a questa tabella.
+ `TargetTable`: un oggetto [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier).

  Una struttura `TableIdentifier` che descrive una tabella di destinazione per il collegamento delle risorse.
+ `ViewDefinition`: un oggetto [ViewDefinitionInput](#aws-glue-api-catalog-tables-ViewDefinitionInput).

  Una struttura che contiene tutte le informazioni che definiscono la vista, compresi il dialetto o i dialetti della vista, e la query.

## FederatedTable struttura
<a name="aws-glue-api-catalog-tables-FederatedTable"></a>

Una tabella che punta a un'entità esterna al AWS Glue Data Catalog.

**Campi**
+ `Identifier`: stringa UTF-8, non inferiore a 1 o superiore a 512 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identificatore univoco per la tabella federata.
+ `DatabaseIdentifier`: stringa UTF-8, non inferiore a 1 o superiore a 512 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identificatore univoco per la tabella federata.
+ `ConnectionName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della connessione al metastore esterno.
+ `ConnectionType`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il tipo di connessione utilizzato per accedere alla tabella federata, che specifica il protocollo o il metodo per la connessione all'origine dati esterna.

## Struttura delle colonne
<a name="aws-glue-api-catalog-tables-Column"></a>

Una colonna in una `Table`.

**Campi**
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della `Column`.
+ `Type`: stringa UTF-8, non superiore a 131072 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il tipo di dati di `Column`.
+ `Comment`: stringa di commento, non superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Commento con testo in formato libero.
+ `Parameters`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Ogni valore è una stringa UTF-8, lunga non più di 512000 byte.

  Queste coppie chiave-valore definiscono proprietà associate alla colonna.

## StorageDescriptor struttura
<a name="aws-glue-api-catalog-tables-StorageDescriptor"></a>

Descrive lo storage fisico dei dati della tabella.

**Campi**
+ `Columns`: una matrice di oggetti [Colonna](#aws-glue-api-catalog-tables-Column).

  Un elenco delle `Columns` nella tabella.
+ `Location`: stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  La posizione fisica della tabella. Per default utilizza il formato della posizione del warehouse, seguita dalla posizione del database nel warehouse, seguita dal nome della tabella.
+ `AdditionalLocations`: una matrice di stringhe UTF-8.

  Un elenco di posizioni che puntano al percorso in cui si trova una tabella Delta.
+ `InputFormat`: stringa di formato, non superiore a 128 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il formato di input: `SequenceFileInputFormat` (binario) o `TextInputFormat` o un formato personalizzato.
+ `OutputFormat`: stringa di formato, non superiore a 128 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il formato di output: `SequenceFileOutputFormat` (binario) o `IgnoreKeyTextOutputFormat` o un formato personalizzato.
+ `Compressed`: booleano.

  `True` se i dati nella tabella sono compressi, in caso contrario `False`.
+ `NumberOfBuckets`: numero (intero).

  Deve essere specificato se la tabella contiene una qualsiasi colonna di dimensione.
+ `SerdeInfo`: un oggetto [SerDeInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo).

  Le informazioni serialization/deserialization (SerDe).
+ `BucketColumns`: una matrice di stringhe UTF-8.

  Un elenco di colonne per il raggruppamento del reducer, colonne di clustering, colonne di bucketing nella tabella.
+ `SortColumns`: una matrice di oggetti [Ordine](#aws-glue-api-catalog-tables-Order).

  Un elenco specificando l'ordine di ciascuna bucket nella tabella.
+ `Parameters`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Ogni valore è una stringa UTF-8, lunga non più di 512000 byte.

  Le proprietà fornite dall'utente nel modulo chiave-valore.
+ `SkewedInfo`: un oggetto [SkewedInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SkewedInfo).

  Informazioni sui valori che appaiono di frequente in una colonna (valori disallineati).
+ `StoredAsSubDirectories`: booleano.

  `True` se i dati nella tabella sono archiviati nelle sottodirectory, in caso contrario `False`.
+ `SchemaReference`: un oggetto [SchemaReference](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference).

  Un oggetto che fa riferimento a uno schema memorizzato nel registro degli AWS Glue schemi.

  Quando crei una tabella, puoi passare un elenco vuoto di colonne per lo schema e utilizzare invece un riferimento allo schema.

## SchemaReference struttura
<a name="aws-glue-api-catalog-tables-SchemaReference"></a>

Un oggetto che fa riferimento a uno schema memorizzato nel registro degli AWS Glue schemi.

**Campi**
+ `SchemaId`: un oggetto [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId).

  Una struttura che contiene campi di identità dello schema. Deve essere fornito questo o `SchemaVersionId`.
+ `SchemaVersionId`: stringa UTF-8, non inferiore a 36 o superiore a 36 byte di lunghezza, corrispondente a [Custom string pattern #45](aws-glue-api-common.md#regex_45).

  L'ID univoco assegnato a una versione dello schema. Deve essere fornito questo o `SchemaId`.
+ `SchemaVersionNumber`: numero (intero), non inferiore a 1 o superiore a 100000.

  Il numero di versione dello schema.

## SerDeInfo struttura
<a name="aws-glue-api-catalog-tables-SerDeInfo"></a>

Informazioni su un serialization/deserialization programma (SerDe) che funge da estrattore e caricatore.

**Campi**
+ `Name`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome del. SerDe
+ `SerializationLibrary`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Di solito la classe che implementa. SerDe Un esempio è `org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe`.
+ `Parameters`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa chiave, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Ogni valore è una stringa UTF-8, lunga non più di 512000 byte.

  Queste coppie chiave-valore definiscono i parametri di inizializzazione per. SerDe

## Struttura dell'ordine
<a name="aws-glue-api-catalog-tables-Order"></a>

Specifica l'ordine di una colonna ordinata.

**Campi**
+ `Column` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della colonna.
+ `SortOrder` - *obbligatorio:* numero (intero), non superiore a 1.

  Indica che la colonna è in ordine crescente (`== 1`) o in ordine decrescente (`==0`).

## SkewedInfo struttura
<a name="aws-glue-api-catalog-tables-SkewedInfo"></a>

Specifica i valori disallineati in una tabella. I valori disallineati sono quelli che si verificano con una frequenza molto elevata.

**Campi**
+ `SkewedColumnNames`: una matrice di stringhe UTF-8.

  Un elenco di nomi delle colonne contenenti i valori disallineati.
+ `SkewedColumnValues`: una matrice di stringhe UTF-8.

  Un elenco di valori che appaiono così frequentemente da poter essere considerati disallineati.
+ `SkewedColumnValueLocationMaps`: una matrice della mappa di coppie chiave-valore.

  Ogni chiave è una stringa UTF-8.

  Ogni valore è una stringa UTF-8.

  Una mappatura di valori disallineati per le colonne che li contengono.

## TableVersion struttura
<a name="aws-glue-api-catalog-tables-TableVersion"></a>

Specifica una versione di una tabella.

**Campi**
+ `Table`: un oggetto [Tabella](#aws-glue-api-catalog-tables-Table).

  La tabella in questione
+ `VersionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il valore ID identificativo di questa versione della tabella. `VersionId` è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

## TableError struttura
<a name="aws-glue-api-catalog-tables-TableError"></a>

Un record di errore per le operazioni di tabella.

**Campi**
+ `TableName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella. Per la compatibilità Hive, deve essere interamente in caratteri minuscoli.
+ `ErrorDetail`: un oggetto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  I dettagli sull'errore.

## TableVersionError struttura
<a name="aws-glue-api-catalog-tables-TableVersionError"></a>

Un record di errore per le operazioni table-version.

**Campi**
+ `TableName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella in questione.
+ `VersionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il valore ID della versione in questione. `VersionID` è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.
+ `ErrorDetail`: un oggetto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail).

  I dettagli sull'errore.

## SortCriterion struttura
<a name="aws-glue-api-catalog-tables-SortCriterion"></a>

Specifica un campo in base al quale ordinare e un ordinamento.

**Campi**
+ `FieldName`: stringa Value, non inferiore a 1 o superiore a 1024 byte di lunghezza.

  Il nome del campo in base al quale eseguire l'ordinamento.
+ `Sort`: stringa UTF-8 (valori validi: `ASC="ASCENDING"` \$1 `DESC="DESCENDING"`).

  Un ordinamento crescente o decrescente.

## TableIdentifier struttura
<a name="aws-glue-api-catalog-tables-TableIdentifier"></a>

Una struttura che descrive una tabella di destinazione per il collegamento delle risorse.

**Campi**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella.
+ `DatabaseName`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database di catalogo che contiene la tabella di destinazione.
+ `Name`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella di destinazione.
+ `Region`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La regione della tabella di destinazione.

## KeySchemaElement struttura
<a name="aws-glue-api-catalog-tables-KeySchemaElement"></a>

Una coppia di chiavi di partizione costituita da un nome e un tipo.

**Campi**
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome di una chiave di partizione.
+ `Type` - *obbligatorio:* stringa UTF-8, non superiore a 131072 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il tipo di una chiave di partizione.

## PartitionIndex struttura
<a name="aws-glue-api-catalog-tables-PartitionIndex"></a>

Una struttura per un indice della partizione.

**Campi**
+ `Keys` - *obbligatorio:* una matrice di stringhe UTF-8, almeno 1 stringa.

  Le chiavi per l'indice della partizione.
+ `IndexName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome dell'indice della partizione.

## PartitionIndexDescriptor struttura
<a name="aws-glue-api-catalog-tables-PartitionIndexDescriptor"></a>

Un descrittore per un indice della partizione in una tabella.

**Campi**
+ `IndexName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome dell'indice della partizione.
+ `Keys` - *obbligatorio:* una matrice di oggetti [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement), almeno 1 struttura.

  Un elenco di una o più chiavi, come strutture `KeySchemaElement`, per l'indice della partizione.
+ `IndexStatus` - *obbligatorio:* stringa UTF-8 (valori validi: `CREATING` \$1 `ACTIVE` \$1 `DELETING` \$1 `FAILED`).

  Lo stato dell'indice della partizione. 

  I possibili stati sono:
  + CREATING: l'indice è in fase di creazione. Quando un indice è in uno stato CREATING, l'indice o la relativa tabella non possono essere eliminati.
  + ACTIVE: la creazione dell'indice ha esito positivo.
  + FAILED: la creazione dell'indice non riesce. 
  + DELETING: l'indice viene eliminato dall'elenco degli indici.
+ `BackfillErrors`: una matrice di oggetti [BackfillError](#aws-glue-api-catalog-tables-BackfillError).

  Un elenco degli errori che possono verificarsi durante la registrazione degli indici delle partizioni per una tabella esistente.

## BackfillError struttura
<a name="aws-glue-api-catalog-tables-BackfillError"></a>

Un elenco degli errori che possono verificarsi durante la registrazione degli indici delle partizioni per una tabella esistente.

Questi errori forniscono i dettagli sul motivo per cui una registrazione dell'indice non è riuscita e forniscono un numero limitato di partizioni nella risposta, in modo da poter correggere le partizioni in errore e provare a registrare nuovamente l'indice. La serie più comune di errori che possono verificarsi sono classificati come segue:
+ EncryptedPartitionError: Le partizioni sono criptate.
+ InvalidPartitionTypeDataError: il valore della partizione non corrisponde al tipo di dati per quella colonna di partizione.
+ MissingPartitionValueError: le partizioni sono crittografate.
+ UnsupportedPartitionCharacterError: I caratteri all'interno del valore della partizione non sono supportati. Ad esempio: U\$10000, U\$10001, U\$10002.
+ InternalError: Qualsiasi errore che non appartiene ad altri codici di errore.

**Campi**
+ `Code`: stringa UTF-8 (valori validi: `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `UNSUPPORTED_PARTITION_CHARACTER_ERROR`).

  Il codice di errore per un errore che si è verificato durante la registrazione degli indici delle partizioni per una tabella esistente.
+ `Partitions`: una matrice di oggetti [PartitionValueList](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList).

  Un elenco di un numero limitato di partizioni nella risposta.

## IcebergInput struttura
<a name="aws-glue-api-catalog-tables-IcebergInput"></a>

Una struttura che definisce una tabella di metadati di Apache Iceberg da creare nel catalogo.

**Campi**
+ `MetadataOperation` - *obbligatorio:* stringa UTF-8 (valori validi: `CREATE`).

  Un'operazione sui metadati richiesta. Questa opzione può essere impostata solo su `CREATE`.
+ `Version`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  La versione della tabella per le tabelle Iceberg. L'impostazione predefinita è 2.
+ `CreateIcebergTableInput`: un oggetto [CreateIcebergTableInput](#aws-glue-api-catalog-tables-CreateIcebergTableInput).

  I parametri di configurazione necessari per creare una nuova tabella Iceberg nel AWS Glue Data Catalog, incluse le proprietà della tabella e le specifiche dei metadati.

## OpenTableFormatInput struttura
<a name="aws-glue-api-catalog-tables-OpenTableFormatInput"></a>

Una struttura che rappresenta una tabella in formato aperto.

**Campi**
+ `IcebergInput`: un oggetto [IcebergInput](#aws-glue-api-catalog-tables-IcebergInput).

  Specifica una struttura `IcebergInput` che definisce una tabella di metadati di Apache Iceberg.

## ViewDefinition struttura
<a name="aws-glue-api-catalog-tables-ViewDefinition"></a>

Una struttura contenente i dettagli delle rappresentazioni.

**Campi**
+ `IsProtected`: booleano.

  È possibile impostare questo flag come true per ordinare al motore di non inviare le operazioni fornite dall'utente nel piano logico della vista durante la pianificazione delle query. Tuttavia, l'impostazione di questo flag non garantisce che il motore rispetti l'ordine. Consultare la documentazione del motore per comprendere le eventuali garanzie fornite.
+ `Definer`: stringa UTF-8, non inferiore a 20 o superiore a 2048 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il definitore in una vista in SQL.
+ `SubObjects`: una matrice di stringhe UTF-8, non superiore a 10 stringhe.

  Un elenco di tabelle Amazon Resource Names (ARNs).
+ `Representations`: una matrice di oggetti [ViewRepresentation](#aws-glue-api-catalog-tables-ViewRepresentation), non inferiore a 1 o superiore a 1.000 strutture.

  Un elenco di rappresentazioni.

## ViewDefinitionInput struttura
<a name="aws-glue-api-catalog-tables-ViewDefinitionInput"></a>

Una struttura contenente i dettagli per la creazione o l'aggiornamento di una AWS Glue vista.

**Campi**
+ `IsProtected`: booleano.

  È possibile impostare questo flag come true per ordinare al motore di non inviare le operazioni fornite dall'utente nel piano logico della vista durante la pianificazione delle query. Tuttavia, l'impostazione di questo flag non garantisce che il motore rispetti l'ordine. Consultare la documentazione del motore per comprendere le eventuali garanzie fornite.
+ `Definer`: stringa UTF-8, non inferiore a 20 o superiore a 2048 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il definitore in una vista in SQL.
+ `Representations`— Una serie di [ViewRepresentationInput](#aws-glue-api-catalog-tables-ViewRepresentationInput) oggetti, non meno di 1 o più di 10 strutture.

  Un elenco di strutture contenente il dialetto della vista e la query che la definisce.
+ `SubObjects`: una matrice di stringhe UTF-8, non superiore a 10 stringhe.

  Un elenco di tabelle di base ARNs che costituiscono la vista.

## ViewRepresentation struttura
<a name="aws-glue-api-catalog-tables-ViewRepresentation"></a>

Una struttura contenente il dialetto della vista e la query che la definisce.

**Campi**
+ `Dialect`: stringa UTF-8 (valori validi: `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  Il dialetto del motore di query.
+ `DialectVersion`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza.

  La versione del dialetto del motore di query. Ad esempio, 3.0.0.
+ `ViewOriginalText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  La query `SELECT` fornita dal cliente durante `CREATE VIEW DDL`. Questo codice SQL non viene utilizzato durante la query su una vista (viene invece utilizzato `ViewExpandedText`). `ViewOriginalText` viene usato in casi come `SHOW CREATE VIEW` in cui gli utenti desiderano vedere il comando DDL originale che ha creato la vista.
+ `ViewExpandedText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  L'SQL esteso per la vista. Questo SQL viene utilizzato dai motori durante l'elaborazione di una query su una vista. I motori possono eseguire operazioni durante la creazione della vista per trasformare `ViewOriginalText` in `ViewExpandedText`. Esempio:
  + Identificatori completi: `SELECT * from table1 -> SELECT * from db1.table1`
+ `ValidationConnection`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della connessione da utilizzare per convalidare la rappresentazione specifica della vista.
+ `IsStale`: booleano.

  I dialetti contrassegnati come obsoleti non sono più validi e devono essere aggiornati prima che sia possibile eseguire query nei rispettivi motori di query.

## ViewRepresentationInput struttura
<a name="aws-glue-api-catalog-tables-ViewRepresentationInput"></a>

Una struttura contenente i dettagli di una rappresentazione per aggiornare o creare una vista Lake Formation.

**Campi**
+ `Dialect`: stringa UTF-8 (valori validi: `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  Un parametro che specifica il tipo di motore di una rappresentazione specifica.
+ `DialectVersion`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza.

  Un parametro che specifica la versione del motore di una rappresentazione specifica.
+ `ViewOriginalText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Una stringa che rappresenta la query SQL originale che descrive la vista.
+ `ValidationConnection`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della connessione da utilizzare per convalidare la rappresentazione specifica della vista.
+ `ViewExpandedText`: stringa UTF-8, non superiore a 409600 byte di lunghezza.

  Una stringa che rappresenta la query SQL che descrive la vista con risorsa espansa ARNs

## UpdateOpenTableFormatInput struttura
<a name="aws-glue-api-catalog-tables-UpdateOpenTableFormatInput"></a>

Parametri di input per l'aggiornamento di tabelle aperte in AWS Glue Data Catalog, che fungono da wrapper per operazioni di aggiornamento specifiche di formato come Apache Iceberg.

**Campi**
+ `UpdateIcebergInput`: un oggetto [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput).

  Parametri di aggiornamento specifici di Apache Iceberg che definiscono le modifiche da apportare alla tabella, tra cui modifiche allo schema, specifiche di partizione e proprietà della tabella.

## UpdateIcebergInput struttura
<a name="aws-glue-api-catalog-tables-UpdateIcebergInput"></a>

Parametri di input specifici per l'aggiornamento delle tabelle Apache Iceberg in AWS Glue Data Catalog, contenenti le operazioni di aggiornamento da applicare a una tabella Iceberg esistente.

**Campi**
+ `UpdateIcebergTableInput` - *obbligatorio:* oggetto [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-UpdateIcebergTableInput).

  Le operazioni di aggiornamento specifiche da applicare alla tabella Iceberg, contenenti un elenco di aggiornamenti che definiscono il nuovo stato della tabella, tra cui schema, partizioni e proprietà.

## CreateIcebergTableInput struttura
<a name="aws-glue-api-catalog-tables-CreateIcebergTableInput"></a>

I parametri di configurazione necessari per creare una nuova tabella Iceberg nel AWS Glue Data Catalog, incluse le proprietà della tabella e le specifiche dei metadati.

**Campi**
+ `Location` - *obbligatorio*, stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  La posizione S3 in cui saranno archiviati i dati della tabella Iceberg.
+ `Schema` - *obbligatorio:* oggetto [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema).

  La definizione dello schema che specifica la struttura, i tipi di campo e i metadati della tabella Iceberg.
+ `PartitionSpec`: un oggetto [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec).

  La specifica di partizionamento che definisce come saranno organizzati e partizionati i dati della tabella Iceberg per garantire prestazioni di query ottimali.
+ `WriteOrder`: un oggetto [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder).

  La specifica di ordinamento che definisce come devono essere ordinati i dati all'interno di ogni partizione per ottimizzare le prestazioni di query.
+ `Properties` – 

  Coppie chiave-valore di proprietà aggiuntive della tabella e impostazioni di configurazione della tabella Iceberg.

## UpdateIcebergTableInput struttura
<a name="aws-glue-api-catalog-tables-UpdateIcebergTableInput"></a>

Contiene le operazioni di aggiornamento da applicare a una tabella Iceberg esistente in AWS Glue Data Catalog, definendo il nuovo stato dei metadati della tabella. 

**Campi**
+ `Updates` - *obbligatorio:* una matrice di oggetti [IcebergTableUpdate](#aws-glue-api-catalog-tables-IcebergTableUpdate).

  L'elenco delle operazioni di aggiornamento della tabella che specificano le modifiche da apportare alla tabella Iceberg, tra cui modifiche dello schema, specifiche di partizione e proprietà della tabella.

## IcebergSortOrder struttura
<a name="aws-glue-api-catalog-tables-IcebergSortOrder"></a>

Definisce la specifica di ordinamento di una tabella Iceberg, che determina come devono essere ordinati i dati all'interno delle partizioni per ottimizzare le prestazioni di query.

**Campi**
+ `OrderId` - *obbligatorio:* numero (intero).

  L'identificatore univoco per questa specifica di ordinamento all'interno dei metadati della tabella Iceberg.
+ `Fields` - *obbligatorio:* una matrice di oggetti [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField).

  L'elenco dei campi e delle relative direzioni di ordinamento che definiscono i criteri di ordinamento per i dati della tabella Iceberg.

## IcebergSortField struttura
<a name="aws-glue-api-catalog-tables-IcebergSortField"></a>

Definisce un singolo campo all'interno di una specifica di ordinamento Iceberg, compresi il campo di origine, la trasformazione, la direzione di ordinamento e l'ordine dei valori null.

**Campi**
+ `SourceId` - *obbligatorio:* numero (intero).

  L'identificatore del campo di origine dallo schema della tabella su cui è basato questo campo di ordinamento.
+ `Transform` - *obbligatorio:* stringa UTF-8.

  La funzione di trasformazione applicata al campo di origine prima dell'ordinamento, come identità, bucket o troncamento.
+ `Direction` - *obbligatorio:* stringa UTF-8 (valori validi: `asc="ASC"` \$1 `desc="DESC"`).

  La direzione di ordinamento di questo campo, ascendente o discendente.
+ `NullOrder` - *obbligatorio:* stringa UTF-8 (valori validi: `nulls-first="NULLS_FIRST"` \$1 `nulls-last="NULLS_LAST"`).

  Il comportamento di ordinamento dei valori null in questo campo, che specifica se tali valori devono comparire per primi o per ultimi nell'ordinamento.

## IcebergPartitionSpec struttura
<a name="aws-glue-api-catalog-tables-IcebergPartitionSpec"></a>

Definisce la specifica di partizionamento di una tabella Iceberg, che determina come saranno organizzati e partizionati i dati della tabella Iceberg per garantire prestazioni di query ottimali.

**Campi**
+ `Fields` - *obbligatorio:* una matrice di oggetti [IcebergPartitionField](#aws-glue-api-catalog-tables-IcebergPartitionField).

  L'elenco dei campi di partizione che definiscono come devono essere partizionati i dati della tabella, compresi i campi di origine e le relative trasformazioni.
+ `SpecId`: numero (intero).

  L'identificatore univoco per questa specifica di partizione all'interno della cronologia dei metadati della tabella Iceberg.

## IcebergPartitionField struttura
<a name="aws-glue-api-catalog-tables-IcebergPartitionField"></a>

Definisce un singolo campo di partizione all'interno di una specifica di partizione Iceberg, compresi il campo di origine, la funzione di trasformazione, il nome della partizione e l'identificatore univoco.

**Campi**
+ `SourceId` - *obbligatorio:* numero (intero).

  L'identificatore del campo di origine dallo schema della tabella su cui è basato questo campo di partizione.
+ `Transform` - *obbligatorio:* stringa UTF-8.

  La funzione di trasformazione applicata al campo di origine per creare la partizione, come identità, bucket, troncamento, anno, mese, giorno oppure ora.
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 1024 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del campo di partizione come verrà visualizzato nella struttura della tabella partizionata.
+ `FieldId`: numero (intero).

  L'identificatore univoco assegnato a questo campo di partizione all'interno della specifica di partizione della tabella Iceberg.

## IcebergSchema struttura
<a name="aws-glue-api-catalog-tables-IcebergSchema"></a>

Definisce la struttura dello schema di una tabella Iceberg, compresi le definizioni dei campi, i tipi di dati e i metadati dello schema.

**Campi**
+ `SchemaId`: numero (intero).

  L'identificatore univoco di questa versione dello schema all'interno della storia di evoluzione dello schema della tabella Iceberg.
+ `IdentifierFieldIds`: una matrice di numeri interi a 32 bit firmati.

  L'elenco di identificatori dei campi che identificano in modo univoco i record nella tabella, utilizzati nelle operazioni e nella deduplicazione a livello di riga.
+ `Type`: stringa UTF-8 (valori validi: `struct="STRUCT"`).

  Il tipo di root della struttura dello schema, generalmente “struct” per gli schemi delle tabelle Iceberg.
+ `Fields` - *obbligatorio:* una matrice di oggetti [IcebergStructField](#aws-glue-api-catalog-tables-IcebergStructField).

  L'elenco delle definizioni dei campi che costituiscono lo schema della tabella, tra cui nomi e tipi di campi e metadati.

## IcebergStructField struttura
<a name="aws-glue-api-catalog-tables-IcebergStructField"></a>

Definisce un singolo campo all'interno dello schema di una tabella Iceberg, compresi l'identificatore, il nome, il tipo di dati, la possibilità di ammettere valori null e la documentazione correlati.

**Campi**
+ `Id` - *obbligatorio:* numero (intero).

  L'identificatore univoco assegnato a questo campo all'interno dello schema della tabella Iceberg, utilizzato per l'evoluzione dello schema e il monitoraggio dei campi.
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 1024 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del campo come visualizzato nello schema della tabella e nelle operazioni di query.
+ `Type` -*obbligatorio*, una struttura vuota chiamata `IcebergDocument`.

  La definizione del tipo di dati di questo campo, che specifica la struttura e il formato dei dati in esso contenuti.
+ `Required` - *obbligatorio:* booleano.

  Indica se questo campo è obbligatorio (non ammette valori null) o facoltativo (ammette valori null) nello schema della tabella.
+ `Doc`: stringa di commento, non superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Documentazione o descrizione in formato testuale facoltative che forniscono contesto aggiuntivo sullo scopo e sull'utilizzo di questo campo.

## IcebergTableUpdate struttura
<a name="aws-glue-api-catalog-tables-IcebergTableUpdate"></a>

Definisce un set completo di aggiornamenti da applicare a una tabella Iceberg, tra cui modifiche relative a schema, partizione, ordinamento, posizione e proprietà.

**Campi**
+ `Schema` - *obbligatorio:* oggetto [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema).

  La definizione dello schema aggiornata per la tabella Iceberg, che specifica eventuali modifiche alla struttura dei campi, ai tipi di dati o ai metadati dello schema.
+ `PartitionSpec`: un oggetto [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec).

  La specifica di partizionamento aggiornata che definisce il modo in cui devono essere riorganizzati e partizionati i dati della tabella.
+ `SortOrder`: un oggetto [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder).

  La specifica di ordinamento aggiornata che definisce come devono essere ordinati i dati all'interno delle partizioni per garantire prestazioni di query ottimali.
+ `Location` - *obbligatorio*, stringa di posizione, non superiore a 2056 byte di lunghezza, corrispondente a [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  La posizione S3 aggiornata in cui saranno archiviati i dati della tabella Iceberg.
+ `Properties` – 

  Le coppie chiave-valore aggiornate di proprietà della tabella e le impostazioni di configurazione della tabella Iceberg.

## AuditContext struttura
<a name="aws-glue-api-catalog-tables-AuditContext"></a>

Una struttura contenente il contesto Lake Formation di audit.

**Campi**
+ `AdditionalAuditContext`— Stringa UTF-8, lunga non più di 2048 byte.

  Una stringa contenente le informazioni aggiuntive sul contesto di controllo.
+ `RequestedColumns`: una matrice di stringhe UTF-8.

  Le colonne richieste per l'audit.
+ `AllColumnsRequested`: booleano.

  Richiesta di revisione per tutte le colonne.

## Operazioni
<a name="aws-glue-api-catalog-tables-actions"></a>
+ [CreateTable azione (Python: create\$1table)](#aws-glue-api-catalog-tables-CreateTable)
+ [UpdateTable azione (Python: update\$1table)](#aws-glue-api-catalog-tables-UpdateTable)
+ [DeleteTable azione (Python: delete\$1table)](#aws-glue-api-catalog-tables-DeleteTable)
+ [BatchDeleteTable azione (Python: batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable)
+ [GetTable azione (Python: get\$1table)](#aws-glue-api-catalog-tables-GetTable)
+ [GetTables azione (Python: get\$1tables)](#aws-glue-api-catalog-tables-GetTables)
+ [GetTableVersion azione (Python: get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion)
+ [GetTableVersions azione (Python: get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions)
+ [DeleteTableVersion azione (Python: delete\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion)
+ [BatchDeleteTableVersion azione (Python: batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
+ [SearchTables azione (Python: search\$1tables)](#aws-glue-api-catalog-tables-SearchTables)
+ [GetPartitionIndexes azione (Python: get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes)
+ [CreatePartitionIndex azione (Python: create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex)
+ [DeletePartitionIndex azione (Python: delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex)
+ [GetColumnStatisticsForTable azione (Python: get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
+ [UpdateColumnStatisticsForTable azione (Python: update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
+ [DeleteColumnStatisticsForTable azione (Python: delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)

## CreateTable azione (Python: create\$1table)
<a name="aws-glue-api-catalog-tables-CreateTable"></a>

Crea una nuova definizione di tabella nel catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui creare la `Table`. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il database del catalogo in cui creare la nuova tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `Name`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identificatore univoco per la tabella all'interno del database specificato che verrà creato nel AWS Glue Data Catalog.
+ `TableInput`: un oggetto [TableInput](#aws-glue-api-catalog-tables-TableInput).

  L'oggetto `TableInput` che definisce la tabella di metadati da creare nel catalogo.
+ `PartitionIndexes`: una matrice di oggetti [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex), non superiore a 3 strutture.

  Un elenco di indici delle partizioni, `PartitionIndex` strutture, da creare nella tabella.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  L'ID della transazione.
+ `OpenTableFormatInput`: un oggetto [OpenTableFormatInput](#aws-glue-api-catalog-tables-OpenTableFormatInput).

  Specifica una struttura `OpenTableFormatInput` durante la creazione di una tabella in formato aperto.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## UpdateTable azione (Python: update\$1table)
<a name="aws-glue-api-catalog-tables-UpdateTable"></a>

Aggiorna una tabella di metadati nel catalogo dati.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `Name`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'identificatore univoco per la tabella all'interno del database specificato che verrà creato nel AWS Glue Data Catalog.
+ `TableInput`: un oggetto [TableInput](#aws-glue-api-catalog-tables-TableInput).

  Un'oggetto `TableInput` avanzato per la definizione della tabella di metadati nel catalogo.
+ `SkipArchive`: booleano.

  Per impostazione predefinita, `UpdateTable` crea sempre una versione archiviata della tabella prima di aggiornarla. Se tuttavia `skipArchive` è impostato su true, `UpdateTable` non crea la versione archiviata.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID transazione in cui aggiornare il contenuto della tabella. 
+ `VersionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID della versione in cui aggiornare il contenuto della tabella. 
+ `ViewUpdateAction`: stringa UTF-8 (valori validi: `ADD` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `DROP`).

  L'operazione da eseguire durante l'aggiornamento della vista.
+ `Force`: booleano.

  Un flag che può essere impostato su true per ignorare i requisiti di corrispondenza di descrittore di archiviazione e oggetto secondario.
+ `UpdateOpenTableFormatInput`: un oggetto [UpdateOpenTableFormatInput](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput).

  Parametri di input per l'aggiornamento di tabelle aperte in AWS Glue Data Catalog, che fungono da wrapper per operazioni di aggiornamento specifiche di formati come Apache Iceberg.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`

## DeleteTable azione (Python: delete\$1table)
<a name="aws-glue-api-catalog-tables-DeleteTable"></a>

Rimuove una definizione di tabella dal catalogo dati.

**Nota**  
Una volta completata questa operazione, non potrai più accedere alle versioni e alle partizioni delle tabelle che appartengono alle tabelle eliminate. AWS Glue elimina tempestivamente queste risorse "orfane" in modo asincrono, a discrezione del servizio.  
Per garantire l'eliminazione immediata di tutte le risorse correlate, prima di chiamare `DeleteTable`, utilizza `DeleteTableVersion` o `BatchDeleteTableVersion` e `DeletePartition` o `BatchDeletePartition` per eliminare eventuali risorse che appartengono alla tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella da eliminare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID transazione in cui eliminare il contenuto della tabella.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchDeleteTable azione (Python: batch\$1delete\$1table)
<a name="aws-glue-api-catalog-tables-BatchDeleteTable"></a>

Elimina più tabelle contemporaneamente.

**Nota**  
Una volta completata questa operazione, non potrai più accedere alle versioni e alle partizioni delle tabelle che appartengono alle tabelle eliminate. AWS Glue elimina tempestivamente queste risorse “orfane” in modo asincrono, a discrezione del servizio.  
Per garantire l'eliminazione immediata di tutte le risorse correlate, prima di chiamare `BatchDeleteTable`, utilizza `DeleteTableVersion` o `BatchDeleteTableVersion` e `DeletePartition` o `BatchDeletePartition` per eliminare eventuali risorse che appartengono alla tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiede la tabella da eliminare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TablesToDelete` - *obbligatorio:* una matrice di stringhe UTF-8, non superiore a 100 stringhe.

  Un elenco della tabella da eliminare.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID transazione in cui eliminare il contenuto della tabella.

**Risposta**
+ `Errors`: una matrice di oggetti [TableError](#aws-glue-api-catalog-tables-TableError).

  Un elenco di errori riscontrati nel tentativo di eliminazione delle tabelle specificate.

**Errori**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`

## GetTable azione (Python: get\$1table)
<a name="aws-glue-api-catalog-tables-GetTable"></a>

Consente di recuperare la definizione `Table` in un catalogo dati per una tabella specificata.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database nel catalogo in cui risiede la tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `Name` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella per cui recuperare la definizione. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID transazione in cui leggere il contenuto della tabella. 
+ `QueryAsOfTime`: timestamp.

  Il momento a partire dal quale leggere il contenuto della tabella. Se non è impostato, verrà utilizzato l'orario di esecuzione del commit della transazione più recente. Non può essere specificato insieme a `TransactionId`.
+ `AuditContext`: un oggetto [AuditContext](#aws-glue-api-catalog-tables-AuditContext).

  Una struttura contenente il [contesto Lake Formation di controllo](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html).
+ `IncludeStatusDetails`: booleano.

  Speciifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.

**Risposta**
+ `Table`: un oggetto [Tabella](#aws-glue-api-catalog-tables-Table).

  L'oggetto `Table` che definisce la tabella specificata.

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetTables azione (Python: get\$1tables)
<a name="aws-glue-api-catalog-tables-GetTables"></a>

Consente di recuperare le definizioni di alcune o di tutte le tabelle in un determinato `Database`.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il database nel catalogo delle tabelle da elencare. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `Expression`: stringa UTF-8, non superiore a 2048 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un modello di espressione regolare. Se presente, vengono restituite solo le tabelle con i nomi corrispondenti al modello.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, incluso se si tratta di una chiamata di continuazione.
+ `MaxResults`: numero (intero), non inferiore a 1 o superiore a 100.

  Il numero massimo di tabelle da restituire in una risposta singola.
+ `TransactionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Custom string pattern #44](aws-glue-api-common.md#regex_44).

  ID transazione in cui leggere il contenuto della tabella.
+ `QueryAsOfTime`: timestamp.

  Il momento a partire dal quale leggere il contenuto della tabella. Se non è impostato, verrà utilizzato l'orario di esecuzione del commit della transazione più recente. Non può essere specificato insieme a `TransactionId`.
+ `AuditContext`: un oggetto [AuditContext](#aws-glue-api-catalog-tables-AuditContext).

  Una struttura contenente il [contesto Lake Formation di controllo](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html).
+ `IncludeStatusDetails`: booleano.

  Speciifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.
+ `AttributesToGet`: una matrice di stringhe UTF-8.

   Specifica i campi della tabella restituiti dalla chiamata `GetTables`. Questo parametro non accetta un elenco vuoto. La richiesta deve includere `NAME`.

  Di seguito sono riportate le combinazioni di valori valide:
  + `NAME`: i nomi di tutte le tabelle nel database.
  + `NAME`, `TABLE_TYPE`: i nomi di tutte le tabelle e i tipi di tabelle.

**Risposta**
+ `TableList`: una matrice di oggetti [Tabella](#aws-glue-api-catalog-tables-Table).

  Un elenco di tutti gli oggetti `Table` richiesti.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.

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

## GetTableVersion azione (Python: get\$1table\$1version)
<a name="aws-glue-api-catalog-tables-GetTableVersion"></a>

Consente di recuperare una versione specificata di una tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `VersionId`: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il valore ID della versione della tabella da recuperare. `VersionID` è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1. 

**Risposta**
+ `TableVersion`: un oggetto [TableVersion](#aws-glue-api-catalog-tables-TableVersion).

  La versione richiesta della tabella.

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

## GetTableVersions azione (Python: get\$1table\$1versions)
<a name="aws-glue-api-catalog-tables-GetTableVersions"></a>

Consente di recuperare un elenco di stringhe identificativo delle versioni disponibili di una tabella specificata.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, se non è la prima chiamata.
+ `MaxResults`: numero (intero), non inferiore a 1 o superiore a 100.

  Il numero massimo di versioni della tabella da restituire in una risposta.

**Risposta**
+ `TableVersions`: una matrice di oggetti [TableVersion](#aws-glue-api-catalog-tables-TableVersion).

  Un elenco di stringhe identificativo delle versioni disponibili della tabella specificata.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, se l'elenco delle versioni disponibili non comprende l'ultima.

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

## DeleteTableVersion azione (Python: delete\$1table\$1version)
<a name="aws-glue-api-catalog-tables-DeleteTableVersion"></a>

Elimina una versione specificata di una tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `VersionId` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il valore ID della versione della tabella da eliminare. `VersionID` è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeleteTableVersion azione (Python: batch\$1delete\$1table\$1version)
<a name="aws-glue-api-catalog-tables-BatchDeleteTableVersion"></a>

Elimina un batch di versioni specificato di una tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui risiede la tabella. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui la tabella risiede. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nome della tabella. Per la compatibilità Hive, questo nome è scritto interamente in caratteri minuscoli.
+ `VersionIds` - *obbligatorio:* una serie di stringhe UTF-8, non superiore a 100 stringhe.

  Un elenco IDs delle versioni da eliminare. `VersionId` è una rappresentazione di stringa di un numero intero. Ogni versione viene incrementata di 1.

**Risposta**
+ `Errors`: una matrice di oggetti [TableVersionError](#aws-glue-api-catalog-tables-TableVersionError).

  Un elenco di errori riscontrati nel tentativo di eliminazione delle versioni della tabella specificata.

**Errori**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## SearchTables azione (Python: search\$1tables)
<a name="aws-glue-api-catalog-tables-SearchTables"></a>

Cerca un set di tabelle in base alle proprietà nei metadati della tabella nonché nel database padre. Puoi eseguire ricerche su condizioni di testo o filtro. 

Puoi ottenere solo tabelle a cui hai accesso in base alle policy di sicurezza definite in Lake Formation. È necessario almeno un accesso in sola lettura alla tabella affinché venga restituita. Se non disponi dell'accesso a tutte le colonne della tabella, non verranno eseguite ricerche in queste colonne quando l'elenco delle tabelle viene restituito. Se disponi dell'accesso alle colonne ma non ai dati nelle colonne, tali colonne e i metadati associati a tali colonne saranno inclusi nella ricerca. 

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Un identificatore univoco, costituito da `account_id`.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, incluso se si tratta di una chiamata di continuazione.
+ `Filters`: una matrice di oggetti [PropertyPredicate](aws-glue-api-common.md#aws-glue-api-common-PropertyPredicate).

  Un elenco di coppie chiave-valore e un comparatore utilizzato per filtrare i risultati della ricerca. Restituisce tutte le entità che corrispondono al predicato.

  Il membro `Comparator` della struttura `PropertyPredicate` viene utilizzata solo per i campi ora e può essere omesso per altri tipi di campo. Inoltre, quando si confrontano i valori di stringa, ad esempio quando `Key=Name`, viene utilizzato un algoritmo di corrispondenza parziale. Il campo `Key` (ad esempio, il valore del campo `Name`) è diviso su determinati caratteri di punteggiatura, ad esempio -, :, \$1, ecc. in token. Quindi ogni token è una corrispondenza esatta rispetto al membro `Value` di `PropertyPredicate`. Ad esempio se `Key=Name` e `Value=link`, le tabelle denominate `customer-link` e `xx-link-yy` vengono restituite, ma`xxlinkyy` non viene restituita.
+ `SearchText`: stringa Value, non inferiore a 1 o superiore a 1024 byte di lunghezza.

  Una stringa utilizzata per una ricerca di testo.

  Specifica un valore in filtri tra virgolette basato su una corrispondenza esatta con il valore.
+ `SortCriteria`: una matrice di oggetti [SortCriterion](#aws-glue-api-catalog-tables-SortCriterion), non superiore a 1 struttura.

  Un elenco di criteri per ordinare i risultati in base a un nome di campo, in ordine crescente o decrescente.
+ `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000.

  Il numero massimo di tabelle da restituire in una risposta singola.
+ `ResourceShareType`: stringa UTF-8 (valori validi: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).

  Consente di specificare che si desidera eseguire la ricerca nelle tabelle condivise con l'account. I valori consentiti sono `FOREIGN` o `ALL`. 
  + Se impostato su `FOREIGN`, cercherà le tabelle condivise con l'account. 
  + Se impostato su `ALL`, cercherà le tabelle condivise con l'account, così come le tabelle nell'account locale. 
+ `IncludeStatusDetails`: booleano.

  Speciifica se includere i dettagli sullo stato relativi a una richiesta di creazione o aggiornamento di una vista del catalogo AWS Glue dati.

**Risposta**
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.
+ `TableList`: una matrice di oggetti [Tabella](#aws-glue-api-catalog-tables-Table).

  Un elenco di tutti gli oggetti `Table` richiesti. La risposta `SearchTables` restituisce solo le tabelle a cui hai accesso.

**Errori**
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## GetPartitionIndexes azione (Python: get\$1partition\$1indexes)
<a name="aws-glue-api-catalog-tables-GetPartitionIndexes"></a>

Recupera gli indici delle partizioni associati a una tabella.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo in cui si trova la tabella.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di un database da cui si desidera recuperare gli indici delle partizioni.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di una tabella da cui si desidera recuperare gli indici delle partizioni.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, incluso se si tratta di una chiamata di continuazione.

**Risposta**
+ `PartitionIndexDescriptorList`: una matrice di oggetti [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor).

  Un elenco di descrittori di indice.
+ `NextToken`: stringa UTF-8.

  Un token di continuazione, presente se il segmento dell'elenco corrente non è l'ultimo.

**Errori**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`

## CreatePartitionIndex azione (Python: create\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-CreatePartitionIndex"></a>

Crea un indice della partizione specificato in una tabella esistente.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo in cui si trova la tabella.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di un database in cui si desidera creare un indice della partizione.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di una tabella in cui si desidera creare un indice della partizione.
+ `PartitionIndex` - *obbligatorio:* un oggetto [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex).

  Specifica una struttura `PartitionIndex` per creare un indice della partizione in una tabella esistente.

**Risposta**
+ *Nessun parametro di risposta.*

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

## DeletePartitionIndex azione (Python: delete\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-DeletePartitionIndex"></a>

Elimina un indice della partizione specificato da una tabella esistente.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo in cui si trova la tabella.
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di un database da cui si desidera eliminare un indice della partizione.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Specifica il nome di una tabella da cui si desidera eliminare un indice della partizione.
+ `IndexName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome dell'indice della partizione da eliminare.

**Risposta**
+ *Nessun parametro di risposta.*

**Errori**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `GlueEncryptionException`

## GetColumnStatisticsForTable azione (Python: get\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-GetColumnStatisticsForTable"></a>

Recupera le statistiche delle colonne della tabella.

L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `GetTable`.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiedono le partizioni.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella della partizione.
+ `ColumnNames` - *obbligatorio:* una serie di stringhe UTF-8, non superiore a 100 stringhe.

  Un elenco dei nomi delle colonne.

**Risposta**
+ `ColumnStatisticsList`: una matrice di oggetti [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics).

  Elenco di ColumnStatistics.
+ `Errors`: una matrice di oggetti [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError).

  L'elenco ColumnStatistics di questi non è stato recuperato.

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

## UpdateColumnStatisticsForTable azione (Python: update\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable"></a>

Crea o aggiorna le statistiche delle tabelle della colonna.

L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `UpdateTable`.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiedono le partizioni.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella della partizione.
+ `ColumnStatisticsList` - *obbligatorio:* una matrice di oggetti [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics), non superiore a 25 strutture.

  Un elenco delle statistiche delle colonne.

**Risposta**
+ `Errors`: una matrice di oggetti [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError).

  Elenco di ColumnStatisticsErrors.

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

## DeleteColumnStatisticsForTable azione (Python: delete\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable"></a>

Recupera le statistiche delle colonne della tabella.

L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `DeleteTable`.

**Richiesta**
+ `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  L'ID del catalogo dati in cui si trovano le partizioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell'account. AWS 
+ `DatabaseName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome del database del catalogo in cui risiedono le partizioni.
+ `TableName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della tabella della partizione.
+ `ColumnName` - *obbligatorio:* stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Il nome della colonna.

**Risposta**
+ *Nessun parametro di risposta.*

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