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 della partizione L'API Partition descrive i tipi di dati e le operazioni utilizzate per lavorare con le partizioni. ## Tipi di dati + [Struttura della partizione](#aws-glue-api-catalog-partitions-Partition) + [PartitionInput struttura](#aws-glue-api-catalog-partitions-PartitionInput) + [PartitionSpecWithSharedStorageDescriptor struttura](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor) + [PartitionListComposingSpec struttura](#aws-glue-api-catalog-partitions-PartitionListComposingSpec) + [PartitionSpecProxy struttura](#aws-glue-api-catalog-partitions-PartitionSpecProxy) + [PartitionValueList struttura](#aws-glue-api-catalog-partitions-PartitionValueList) + [Struttura del segmento](#aws-glue-api-catalog-partitions-Segment) + [PartitionError struttura](#aws-glue-api-catalog-partitions-PartitionError) + [BatchUpdatePartitionFailureEntry struttura](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry) + [BatchUpdatePartitionRequestEntry struttura](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry) + [StorageDescriptor struttura](#aws-glue-api-catalog-partitions-StorageDescriptor) + [SchemaReference struttura](#aws-glue-api-catalog-partitions-SchemaReference) + [SerDeInfo struttura](#aws-glue-api-catalog-partitions-SerDeInfo) + [SkewedInfo struttura](#aws-glue-api-catalog-partitions-SkewedInfo) ## Struttura della partizione Rappresenta una porzione dei dati della tabella. **Campi** + `Values`: una matrice di stringhe UTF-8. I valori della partizione. + `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 del catalogo in cui creare la partizione. + `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). Il nome della tabella di database in cui creare la partizione. + `CreationTime`: timestamp. L'ora in cui è stata creata la partizione. + `LastAccessTime`: timestamp. L'ora in cui è stato effettuato l'ultimo accesso alla partizione. + `StorageDescriptor`: un oggetto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Fornisce informazioni sulla posizione fisica in cui è memorizzata la partizione. + `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 per la partizione. + `LastAnalyzedTime`: timestamp. L'ultima volta in cui sono state calcolate le statistiche di colonna per questa partizione. + `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. ## PartitionInput struttura Struttura utilizzata per la creazione e per l'aggiornamento di una partizione. **Campi** + `Values`: una matrice di stringhe UTF-8. I valori della partizione. Sebbene questo parametro non sia richiesto dall'SDK, è necessario specificarlo per un input valido. I valori delle chiavi per la nuova partizione devono essere passati come una matrice di oggetti String che devono essere sistemati seguendo lo stesso ordine delle chiavi di partizione che appaiono nel prefisso Amazon S3. Altrimenti AWS Glue aggiungerà i valori alle chiavi sbagliate. + `LastAccessTime`: timestamp. L'ora in cui è stato effettuato l'ultimo accesso alla partizione. + `StorageDescriptor`: un oggetto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Fornisce informazioni sulla posizione fisica in cui è memorizzata la partizione. + `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 per la partizione. + `LastAnalyzedTime`: timestamp. L'ultima volta in cui sono state calcolate le statistiche di colonna per questa partizione. ## PartitionSpecWithSharedStorageDescriptor struttura Una specifica per le partizioni che condividono una posizione fisica. **Campi** + `StorageDescriptor`: un oggetto [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor). Le informazioni condivise sullo storage fisico. + `Partitions`: una matrice di oggetti [Partizione](#aws-glue-api-catalog-partitions-Partition). Un elenco di partizioni che condividono questa posizione fisica. ## PartitionListComposingSpec struttura Elenca le partizioni correlate. **Campi** + `Partitions`: una matrice di oggetti [Partizione](#aws-glue-api-catalog-partitions-Partition). Un elenco di partizioni nella specifica di composizione. ## PartitionSpecProxy struttura Fornisce un percorso radice per partizioni specifiche. **Campi** + `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 database del catalogo in cui risiedono le partizioni. + `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). Il nome della tabella che contiene le partizioni. + `RootPath`: 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 percorso radice del proxy per gestire le partizioni. + `PartitionSpecWithSharedSD`: un oggetto [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor). Una specifica delle partizioni che condividono la stessa posizione dello storage fisico. + `PartitionListComposingSpec`: un oggetto [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec). Specifica un elenco di partizioni. ## PartitionValueList struttura Contiene un elenco di valori che definiscono le partizioni. **Campi** + `Values` - *obbligatorio:* una matrice di stringhe UTF-8. L'elenco dei valori. ## Struttura del segmento Definisce una regione non sovrapposta delle partizioni di una tabella, consentendo l'esecuzione di più richieste in parallelo. **Campi** + `SegmentNumber`: *obbligatorio:* numero (intero), non superiore a Nessuno. Il numero dell'indice a base zero del segmento. Ad esempio, se il numero totale di segmenti è 4, i alori di `SegmentNumber` vanno da 0 a 3. + `TotalSegments`: *obbligatorio:* numero (intero), non inferiore a 1 o superiore a 10. Il numero totale dei segmenti. ## PartitionError struttura Contiene informazioni sull'errore di una partizione. **Campi** + `PartitionValues`: una matrice di stringhe UTF-8. I valori che definiscono la partizione. + `ErrorDetail`: un oggetto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Dettagli sull'errore della partizione. ## BatchUpdatePartitionFailureEntry struttura Contiene informazioni sull'errore di una partizione di aggiornamento in batch. **Campi** + `PartitionValueList`: una matrice di stringhe UTF-8, non superiore a 100. Un elenco di valori che definiscono le partizioni. + `ErrorDetail`: un oggetto [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail). Dettagli sull'errore della partizione di aggiornamento in batch. ## BatchUpdatePartitionRequestEntry struttura Una struttura che contiene i valori e la struttura utilizzati per aggiornare una partizione. **Campi** + `PartitionValueList`. *Obbligatorio:* una serie di stringhe UTF-8, non superiore a 100 stringhe. Un elenco di valori che definiscono le partizioni. + `PartitionInput` - *obbligatorio:* un oggetto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Struttura utilizzata per l'aggiornamento di una partizione. ## StorageDescriptor struttura Descrive lo storage fisico dei dati della tabella. **Campi** + `Columns`: una matrice di oggetti [Colonna](aws-glue-api-catalog-tables.md#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-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.md#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-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-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 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 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 ## SkewedInfo struttura 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. ## Operazioni + [CreatePartition azione (Python: create\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition) + [BatchCreatePartition azione (Python: batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition) + [UpdatePartition azione (Python: update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition) + [DeletePartition azione (Python: delete\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition) + [BatchDeletePartition azione (Python: batch\$1delete\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition) + [GetPartition azione (Python: get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition) + [GetPartitions azione (Python: get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions) + [BatchGetPartition azione (Python: batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition) + [BatchUpdatePartition azione (Python: batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition) + [GetColumnStatisticsForPartition azione (Python: get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition) + [UpdateColumnStatisticsForPartition azione (Python: update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition) + [DeleteColumnStatisticsForPartition azione (Python: delete\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition) ## CreatePartition azione (Python: create\$1partition) Crea una nuova partizione. **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 dell' AWS account del catalogo in cui deve essere creata la partizione. + `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 dei metadata in cui deve essere creata la 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). Il nome della tabella dei metadata in cui deve essere creata la partizione. + `PartitionInput` - *obbligatorio:* un oggetto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Una struttura `PartitionInput` che definisce la partizione da creare. **Risposta** + *Nessun parametro di risposta.* **Errori** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `EntityNotFoundException` + `OperationTimeoutException` + `GlueEncryptionException` ## BatchCreatePartition azione (Python: batch\$1create\$1partition) Crea una o più partizioni in un'operazione in batch. **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 deve essere creata la partizione. Attualmente, questo dovrebbe essere 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 dei metadata in cui deve essere creata la 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). Il nome della tabella dei metadata in cui deve essere creata la partizione. + `PartitionInputList`: *obbligatorio:* una matrice di oggetti [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput), non superiore a 100 strutture. Un elenco di strutture `PartitionInput` che definiscono le partizioni da creare. **Risposta** + `Errors`: una matrice di oggetti [PartitionError](#aws-glue-api-catalog-partitions-PartitionError). Errori rilevati durante il tentativo di creare le partizioni richieste. **Errori** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `EntityNotFoundException` + `OperationTimeoutException` + `GlueEncryptionException` ## UpdatePartition azione (Python: update\$1partition) Aggiorna una partizione. **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 trova la partizione da aggiornare. 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. + `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 in cui si trova la partizione da aggiornare. + `PartitionValueList`. *Obbligatorio:* una serie di stringhe UTF-8, non superiore a 100 stringhe. Elenco dei valori della chiave della partizione che definiscono la partizione da aggiornare. + `PartitionInput` - *obbligatorio:* un oggetto [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput). Il nuovo oggetto della partizione a cui aggiornare la partizione. La proprietà `Values` non può essere modificata. Se si desidera modificare i valori della chiave per una partizione, è necessario eliminare e creare nuovamente la partizione. **Risposta** + *Nessun parametro di risposta.* **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeletePartition azione (Python: delete\$1partition) Elimina una partizione 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 si trova la partizione da eliminare. 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. + `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 che contiene la partizione da eliminare. + `PartitionValues`. *Obbligatorio:* una serie di stringhe UTF-8. I valori che definiscono la partizione. **Risposta** + *Nessun parametro di risposta.* **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## BatchDeletePartition azione (Python: batch\$1delete\$1partition) Cancella una o più partizioni in un'operazione in batch. **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 trova la partizione da eliminare. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell' AWS 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. + `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 che contiene le partizioni da eliminare. + `PartitionsToDelete`. *Obbligatorio:* una serie di oggetti [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), non superiore a 25 strutture. Un elenco di strutture `PartitionInput` che definiscono le partizioni da eliminare. **Risposta** + `Errors`: una matrice di oggetti [PartitionError](#aws-glue-api-catalog-partitions-PartitionError). Errori rilevati durante il tentativo di cancellare le partizioni richieste. **Errori** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` ## GetPartition azione (Python: get\$1partition) Consente di recuperare informazioni su una partizione 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 si trova la partizione. 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 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). Il nome della tabella della partizione. + `PartitionValues`. *Obbligatorio:* una serie di stringhe UTF-8. I valori che definiscono la partizione. **Risposta** + `Partition`: un oggetto [Partizione](#aws-glue-api-catalog-partitions-Partition). Le informazioni richieste, sotto forma di un oggetto della `Partition`. **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetPartitions azione (Python: get\$1partitions) Recupera informazioni sulle partizioni in 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 si trovano le partizioni. 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 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. + `Expression`: stringa predicato, 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). Espressione che filtra le partizioni da restituire. L'espressione usa la sintassi SQL simile alla clausola di filtro SQL `WHERE`. Il parser di istruzioni SQL [JSQLParser](http://jsqlparser.sourceforge.net/home.php)analizza l'espressione. *Operatori*: di seguito sono elencati gli operatori che puoi usare nella chiamata API `Expression`: = Verifica se i valori dei due operandi sono uguali. In caso affermativo, la condizione diventa true. Esempio: presupponiamo che "variable a" contenga 10 e "variable b" contenga 20. (a = b) non è true. < > Verifica se i valori dei due operandi sono uguali. In caso negativo, la condizione diventa true. Esempio: (a < > b) è true. > Verifica se il valore dell'operando di sinistra è superiore al valore dell'operando di destra. In caso affermativo, la condizione diventa true. Esempio: (a > b) non è true. < Verifica se il valore dell'operando di sinistra è inferiore al valore dell'operando di destra. In caso affermativo, la condizione diventa true. Esempio: (a < b) è true. >= Verifica se il valore dell'operando di sinistra è superiore o uguale al valore dell'operando di destra. In caso affermativo, la condizione diventa true. Esempio: (a >= b) non è true. <= Verifica se il valore dell'operando di sinistra è inferiore o uguale al valore dell'operando di destra. In caso affermativo, la condizione diventa true. Esempio: (a <= b) è true. AND, OR, IN, BETWEEN, LIKE NOT, IS NULL Operatori logici. *Tipi di chiave di partizione supportati*: di seguito sono indicate le chiavi di partizione supportate. + `string` + `date` + `timestamp` + `int` + `bigint` + `long` + `tinyint` + `smallint` + `decimal` Se viene riscontrato un tipo non valido, viene generata un'eccezione. L'elenco seguente mostra gli operatori validi per ogni tipo. Quando definisci un crawler, il tipo `partitionKey` viene creato come `STRING`, perché sia compatibile con le partizioni del catalogo. *Chiamata API di esempio*: **Example** La tabella `twitter_partition` contiene tre partizioni: ``` year = 2015 year = 2016 year = 2017 ``` **Example** Get Partition `year` equivale a 2015 ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year*=*'2015'" ``` **Example** Get partition `year` tra 2016 e 2018 (esclusi) ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year>'2016' AND year<'2018'" ``` **Example** Get partition `year` tra 2015 e 2018 (inclusi). Le chiamate API seguenti si equivalgono tra loro ``` 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** Un filtro di partizione con caratteri jolly, in cui l'output di chiamata seguente è l'anno di partizione = 2017. Un'espressione regolare non è supportata in `LIKE`. ``` aws glue get-partitions --database-name dbname --table-name twitter_partition --expression "year LIKE '%7'" ``` + `NextToken`: stringa UTF-8. Un token di continuazione, se non è la prima chiamata per recuperare le partizioni. + `Segment`: un oggetto [Segment](#aws-glue-api-catalog-partitions-Segment). Il segmento delle partizioni della tabella per analizzare questa richiesta. + `MaxResults`: numero (intero), non inferiore a 1 o superiore a 1.000. Il numero massimo di partizioni da restituire in una risposta singola. + `ExcludeColumnSchema`: booleano. Se vero, specifica di non restituire lo schema della colonna di partizione. Utile quando sei interessato solo ad altri attributi di partizione, come i valori o la posizione delle partizioni. Questo approccio evita il problema di una risposta ampia non restituendo dati duplicati. + `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 partizione. + `QueryAsOfTime`: timestamp. Il momento a partire dal quale leggere il contenuto della partizione. Se non è impostato, verrà utilizzato l'orario di esecuzione del commit della transazione più recente. Non può essere specificato insieme a `TransactionId`. **Risposta** + `Partitions`: una matrice di oggetti [Partizione](#aws-glue-api-catalog-partitions-Partition). Un elenco di partizioni richieste. + `NextToken`: stringa UTF-8. Un token di continuazione, se l'elenco restituito di partizioni non include l'ultima. **Errori** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` + `InvalidStateException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## BatchGetPartition azione (Python: batch\$1get\$1partition) Recupera le partizioni in una richiesta di batch. **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' AWS 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 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. + `PartitionsToGet`: *obbligatorio:* una matrice di oggetti [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), non superiore a 1000 strutture. Un elenco di valori della partizione che identificano le partizioni da recuperare. **Risposta** + `Partitions`: una matrice di oggetti [Partizione](#aws-glue-api-catalog-partitions-Partition). Un elenco di tutte le partizioni richieste. + `UnprocessedKeys`: una matrice di oggetti [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList), non superiore a 1000 strutture. Un elenco dei valori della partizione nella richiesta per la quale le partizioni non sono state restituite. **Errori** + `InvalidInputException` + `EntityNotFoundException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` + `InvalidStateException` + `FederationSourceException` + `FederationSourceRetryableException` ## BatchUpdatePartition azione (Python: batch\$1update\$1partition) Aggiorna una o più partizioni in un'operazione in batch. **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 deve essere aggiornata la partizione. Attualmente, questo dovrebbe essere 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 di metadati in cui deve essere aggiornata la 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). Il nome della tabella di metadati in cui deve essere aggiornata la partizione. + `Entries`: *obbligatorio:* una matrice di oggetti [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry), non meno di 1 o più di 100 strutture. Un elenco fino a 100 oggetti `BatchUpdatePartitionRequestEntry` da aggiornare. **Risposta** + `Errors`: una matrice di oggetti [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry). Errori rilevati durante il tentativo di aggiornamento delle partizioni richieste. Elenco di oggetti `BatchUpdatePartitionFailureEntry`. **Errori** + `InvalidInputException` + `EntityNotFoundException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` ## GetColumnStatisticsForPartition azione (Python: get\$1column\$1statistics\$1for\$1partition) Recupera le statistiche della partizione delle colonne. L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `GetPartition`. **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. + `PartitionValues`. *Obbligatorio:* una serie di stringhe UTF-8. Un elenco di valori della partizione che identificano la 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). L'elenco di ColumnStatistics tali dati non è stato recuperato. + `Errors`: una matrice di oggetti [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError). Errore durante il recupero dei dati delle statistiche delle colonne. **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## UpdateColumnStatisticsForPartition azione (Python: update\$1column\$1statistics\$1for\$1partition) Crea o aggiorna le statistiche delle partizioni delle colonne. L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `UpdatePartition`. **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. + `PartitionValues`. *Obbligatorio:* una serie di stringhe UTF-8. Un elenco di valori della partizione che identificano la partizione. + `ColumnStatisticsList`. *Obbligatorio:* una serie 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). Errore durante l'aggiornamento dei dati delle statistiche delle colonne. **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeleteColumnStatisticsForPartition azione (Python: delete\$1column\$1statistics\$1for\$1partition) Elimina le statistiche della colonna della partizione di una colonna. L'autorizzazione Identity and Access Management (IAM) necessaria per questa operazione è `DeletePartition`. **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. + `PartitionValues`. *Obbligatorio:* una serie di stringhe UTF-8. Un elenco di valori della partizione che identificano la 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). Nome della colonna. **Risposta** + *Nessun parametro di risposta.* **Errori** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException`