Ottimizzatore di tabelle API - AWS Glue
 —  tipi di dati  —TableOptimizerTableOptimizerConfigurationTableOptimizerRunBatchGetTableOptimizerEntryBatchTableOptimizerBatchGetTableOptimizerErrorRunMetrics —  operazioni  —GetTableOptimizer (get_table_optimizer)BatchGetTableOptimizer (batch_get_table_optimizer)ListTableOptimizerRuns (list_table_optimizer_runs)CreateTableOptimizer (create_table_optimizer)DeleteTableOptimizer (delete_table_optimizer)UpdateTableOptimizer (update_table_optimizer)

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

Ottimizzatore di tabelle API

L'ottimizzatore di tabelle API descrive come abilitare la compattazione AWS Glue API per migliorare le prestazioni di lettura.

Tipi di dati

TableOptimizer struttura

Contiene dettagli su un ottimizzatore associato a una tabella.

Campi

  • type— UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle. Attualmente, l'unico valore valido è compaction.

  • configuration: un oggetto TableOptimizerConfiguration.

    Un oggetto TableOptimizerConfiguration specificato durante la creazione o l'aggiornamento di un ottimizzatore di tabelle.

  • lastRun: un oggetto TableOptimizerRun.

    Un oggetto TableOptimizerRun che rappresenta l'ultima esecuzione dell'ottimizzatore di tabelle.

TableOptimizerConfiguration struttura

Contiene dettagli sulla configurazione di un ottimizzatore di tabelle. Questa configurazione viene passata quando si crea o si aggiorna un ottimizzatore di tabelle.

Campi

  • roleArn— UTF -8 stringhe, di lunghezza non inferiore a 1 o più di 512 byte, corrispondente a. Single-line string pattern

    Un ruolo passato dal chiamante che autorizza il servizio ad aggiornare le risorse associate all'ottimizzatore per suo conto.

  • enabled: booleano.

    Se l'ottimizzazione delle tabelle è abilitata.

TableOptimizerRun struttura

Contiene i dettagli per l'esecuzione di un ottimizzatore di tabelle.

Campi

  • eventType— UTF -8 stringhe (valori validi: starting="STARTING" completed="COMPLETED" | | failed="FAILED" |in_progress="IN_PROGRESS").

    Un tipo di evento che rappresenta lo stato dell'esecuzione dell'ottimizzatore di tabella.

  • startTimestamp: timestamp.

    Rappresenta il timestamp di epoca in cui è stato avviato il processo di compattazione all'interno di Lake Formation.

  • endTimestamp: timestamp.

    Rappresenta il timestamp di epoca in cui è terminato il processo di compattazione.

  • metrics: un oggetto RunMetrics.

    Un oggetto RunMetrics contenente i parametri per l'esecuzione dell'ottimizzatore.

  • error— UTF -8 stringhe.

    Un errore che si è verificato durante l'esecuzione dell'ottimizzatore.

BatchGetTableOptimizerEntry struttura

Rappresenta un ottimizzatore di tabella da recuperare durante l'operazione BatchGetTableOptimizer.

Campi

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

  • databaseName— UTF -8 stringhe, lunghe almeno 1 byte.

    Il nome del database nel catalogo in cui risiede la tabella.

  • tableName— UTF -8 stringhe, lunghe almeno 1 byte.

    Nome della tabella.

  • type— UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle.

BatchTableOptimizer struttura

Contiene i dettagli per uno degli ottimizzatori di tabella restituiti dall'operazione BatchGetTableOptimizer.

Campi

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

  • databaseName— UTF -8 stringhe, lunghe almeno 1 byte.

    Il nome del database nel catalogo in cui risiede la tabella.

  • tableName— UTF -8 stringhe, lunghe almeno 1 byte.

    Nome della tabella.

  • tableOptimizer: un oggetto TableOptimizer.

    Un oggetto TableOptimizer che contiene i dettagli sulla configurazione e l'ultima esecuzione di un ottimizzatore di tabella.

BatchGetTableOptimizerError struttura

Contiene dettagli su uno degli errori nell'elenco degli errori restituito dall'operazione BatchGetTableOptimizer.

Campi

  • error: un oggetto ErrorDetail.

    Un oggetto ErrorDetail contenente i dettagli del codice e del messaggio di errore.

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

  • databaseName— UTF -8 stringhe, lunghe almeno 1 byte.

    Il nome del database nel catalogo in cui risiede la tabella.

  • tableName— UTF -8 stringhe, lunghe almeno 1 byte.

    Nome della tabella.

  • type— UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle.

RunMetrics struttura

Parametri per l'esecuzione dell'ottimizzatore.

Campi

  • NumberOfBytesCompacted— UTF -8 corde.

    Il numero di byte rimossi dall'esecuzione del processo di compattazione.

  • NumberOfFilesCompacted— UTF -8 corde.

    Il numero di file rimossi dall'esecuzione del processo di compattazione.

  • NumberOfDpus— UTF -8 corde.

    Il numero di DPU ore impiegate dal lavoro.

  • JobDurationInHour— UTF -8 corde.

    La durata del processo in ore.

Operazioni

GetTableOptimizer azione (Python: get_table_optimizer)

Restituisce la configurazione di tutti gli ottimizzatori associati a una tabella specificata.

Richiesta

  • CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

    L'ID del catalogo della tabella.

  • DatabaseName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • Type— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle.

Risposta

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

  • DatabaseName— UTF -8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— UTF -8 stringhe, di lunghezza non inferiore a 1 o più di 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • TableOptimizer: un oggetto TableOptimizer.

    L'ottimizzatore associato alla tabella specificata.

Errori

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer azione (Python: batch_get_table_optimizer)

Restituisce la configurazione per gli ottimizzatori di tabella specificati.

Richiesta

  • Entries: obbligatorio: una matrice di oggetti BatchGetTableOptimizerEntry.

    Un elenco di oggetti BatchGetTableOptimizerEntry che specificano gli ottimizzatori di tabella da recuperare.

Risposta
Errori

  • InternalServiceException

ListTableOptimizerRuns azione (Python: list_table_optimizer_runs)

Elenca la cronologia delle esecuzioni dell'ottimizzatore precedenti per una tabella specifica.

Richiesta

  • CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

    L'ID del catalogo della tabella.

  • DatabaseName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • Type— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle. Attualmente, l'unico valore valido è compaction.

  • MaxResults: numero (intero).

    Il numero massimo di esecuzioni dell'ottimizzatore da restituire per ogni chiamata.

  • NextToken— UTF -8 stringhe.

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

Risposta

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

  • DatabaseName— UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— UTF -8 stringhe, di lunghezza non inferiore a 1 o più di 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • NextToken— UTF -8 stringhe.

    Un token di continuazione per impaginare l'elenco restituito di esecuzioni dell'ottimizzatore, restituite se il segmento corrente dell'elenco non è l'ultimo.

  • TableOptimizerRuns: una matrice di oggetti TableOptimizerRun.

    Un elenco delle esecuzioni di ottimizzazione associate a una tabella.

Errori

  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer azione (Python: create_table_optimizer)

Crea un nuovo ottimizzatore di tabella per una funzione specifica. compaction è l'unico tipo di ottimizzatore attualmente supportato.

Richiesta

  • CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

    L'ID del catalogo della tabella.

  • DatabaseName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • Type— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle. Attualmente, l'unico valore valido è compaction.

  • TableOptimizerConfiguration: obbligatorio: un oggetto TableOptimizerConfiguration.

    Un oggetto TableOptimizerConfiguration che rappresenta la configurazione dell'ottimizzatore di tabelle.

Risposta

  • Nessun parametro di risposta.

Errori

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

DeleteTableOptimizer azione (Python: delete_table_optimizer)

Elimina un ottimizzatore e tutti i metadati associati per una tabella. L'ottimizzazione non verrà più eseguita sulla tabella.

Richiesta

  • CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

    L'ID del catalogo della tabella.

  • DatabaseName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • Type— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle.

Risposta

  • Nessun parametro di risposta.

Errori

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer azione (Python: update_table_optimizer)

Aggiorna la configurazione per un ottimizzatore di tabelle esistente.

Richiesta

  • CatalogId - Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern

    L'ID del catalogo della tabella.

  • DatabaseName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Il nome del database nel catalogo in cui risiede la tabella.

  • TableName— Obbligatorio: UTF -8 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string pattern

    Nome della tabella.

  • Type— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION").

    Il tipo di ottimizzatore di tabelle. Attualmente, l'unico valore valido è compaction.

  • TableOptimizerConfiguration: obbligatorio: un oggetto TableOptimizerConfiguration.

    Un oggetto TableOptimizerConfiguration che rappresenta la configurazione dell'ottimizzatore di tabelle.

Risposta

  • Nessun parametro di risposta.

Errori

  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException