API della partizione - AWS Glue

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

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.

    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.

    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.

    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.

    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.

    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.

    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.

    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.

    Le informazioni condivise sullo storage fisico.

  • Partitions: una matrice di oggetti Partizione.

    Un elenco di partizioni che condividono questa posizione fisica.

PartitionListComposingSpec struttura

Elenca le partizioni correlate.

Campi
  • Partitions: una matrice di oggetti Partizione.

    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.

    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.

    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.

    Il percorso radice del proxy per gestire le partizioni.

  • PartitionSpecWithSharedSD: un oggetto PartitionSpecWithSharedStorageDescriptor.

    Una specifica delle partizioni che condividono la stessa posizione dello storage fisico.

  • PartitionListComposingSpec: un oggetto 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.

    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.

    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.

    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.

    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.

    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.

    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.

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

    Le informazioni di serializzazione/deserializzazione (). 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 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.

    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.

    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.

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

    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.

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

    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 programma di serializzazione/deserializzazione (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.

    SerDeNome del.

  • SerializationLibrary: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    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.

    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_partition)

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.

    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.

    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.

    Il nome della tabella dei metadata in cui deve essere creata la partizione.

  • PartitionInput: obbligatorio: un oggetto 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_create_partition)

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.

    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.

    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.

    Il nome della tabella dei metadata in cui deve essere creata la partizione.

  • PartitionInputList: obbligatorio: una matrice di oggetti PartitionInput, non superiore a 100 strutture.

    Un elenco di strutture PartitionInput che definiscono le partizioni da creare.

Risposta
  • Errors: una matrice di oggetti PartitionError.

    Errori rilevati durante il tentativo di creare le partizioni richieste.

Errori
  • InvalidInputException

  • AlreadyExistsException

  • ResourceNumberLimitExceededException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • GlueEncryptionException

UpdatePartition azione (Python: update_partition)

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.

    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.

    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.

    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.

    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_partition)

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.

    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.

    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.

    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_delete_partition)

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.

    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.

    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.

    Il nome della tabella che contiene le partizioni da eliminare.

  • PartitionsToDelete. Obbligatorio: una serie di oggetti PartitionValueelenco, non superiore a 25 strutture.

    Un elenco di strutture PartitionInput che definiscono le partizioni da eliminare.

Risposta
  • Errors: una matrice di oggetti PartitionError.

    Errori rilevati durante il tentativo di cancellare le partizioni richieste.

Errori
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetPartition azione (Python: get_partition)

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.

    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.

    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.

    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.

    Le informazioni richieste, sotto forma di un oggetto della Partition.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

  • FederationSourceException

  • FederationSourceRetryableException

GetPartitions azione (Python: get_partitions)

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.

    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.

    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.

    Il nome della tabella della partizione.

  • Expression: stringa predicato, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.

    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 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:

    La tabella twitter_partition contiene tre partizioni:

    year = 2015 year = 2016 year = 2017

    Get Partition year equivale a 2015

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

    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'"

    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)"

    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.

    Il segmento delle partizioni della tabella per analizzare questa richiesta.

  • MaxResults: numero (intero), non inferiore a 1 o superiore a 1000.

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

    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.

    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_get_partition)

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.

    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.

    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.

    Il nome della tabella della partizione.

  • PartitionsToGet: obbligatorio: una matrice di oggetti PartitionValueelenco, non superiore a 1000 strutture.

    Un elenco di valori della partizione che identificano le partizioni da recuperare.

Risposta
  • Partitions: una matrice di oggetti Partizione.

    Un elenco di tutte le partizioni richieste.

  • UnprocessedKeys: una matrice di oggetti PartitionValueelenco, 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_update_partition)

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.

    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.

    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.

    Il nome della tabella di metadati in cui deve essere aggiornata la partizione.

  • Entries: obbligatorio: una matrice di oggetti BatchUpdatePartitionRequestingresso, non meno di 1 o più di 100 strutture.

    Un elenco fino a 100 oggetti BatchUpdatePartitionRequestEntry da aggiornare.

Risposta
  • Errors: una matrice di oggetti BatchUpdatePartitionFailureingresso.

    Errori rilevati durante il tentativo di aggiornamento delle partizioni richieste. Elenco di oggetti BatchUpdatePartitionFailureEntry.

Errori
  • InvalidInputException

  • EntityNotFoundException

  • OperationTimeoutException

  • InternalServiceException

  • GlueEncryptionException

GetColumnStatisticsForPartition azione (Python: get_column_statistics_for_partition)

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.

    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.

    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.

    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.

    L'elenco di ColumnStatistics tali dati non è stato recuperato.

  • Errors: una matrice di oggetti ColumnError.

    Errore durante il recupero dei dati delle statistiche delle colonne.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

UpdateColumnStatisticsForPartition azione (Python: update_column_statistics_for_partition)

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.

    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.

    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.

    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, non superiore a 25 strutture.

    Un elenco delle statistiche delle colonne.

Risposta
  • Errors: una matrice di oggetti ColumnStatisticsError.

    Errore durante l'aggiornamento dei dati delle statistiche delle colonne.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

DeleteColumnStatisticsForPartition azione (Python: delete_column_statistics_for_partition)

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.

    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.

    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.

    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.

    Nome della colonna.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException