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"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle. I valori validi sono:
-
compaction
: per gestire la compattazione con un ottimizzatore di tabelle. -
retention
: per gestire la conservazione delle istantanee con un ottimizzatore di tabelle. -
orphan_file_deletion
: per gestire l'eliminazione di file orfani con un ottimizzatore di tabelle.
-
-
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 20 o superiore a 2048 byte, corrispondente a. Single-line string patternUn 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.
-
vpcConfiguration
: un oggetto TableOptimizerVpcConfiguration.Un
TableOptimizerVpcConfiguration
oggetto che rappresenta la VPC configurazione per un ottimizzatore di tabelle.Questa configurazione è necessaria per eseguire l'ottimizzazione sulle tabelle presenti in un clienteVPC.
-
retentionConfiguration
: un oggetto RetentionConfiguration.La configurazione per un ottimizzatore della conservazione delle istantanee.
-
orphanFileDeletionConfiguration
: un oggetto OrphanFileDeletionConfiguration.La configurazione per un ottimizzatore per l'eliminazione di file orfani.
TableOptimizerVpcConfiguration struttura
Un oggetto che descrive la VPC configurazione per un ottimizzatore di tabelle.
Questa configurazione è necessaria per eseguire l'ottimizzazione sulle tabelle presenti in un clienteVPC.
Campi
-
glueConnectionName
— UTF -8 stringhe, lunghe almeno 1 byte.Il nome della AWS Glue connessione utilizzata per l'ottimizzatore VPC for the table.
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.Questo membro è obsoleto. Visualizza i singoli membri della metrica per la compattazione, la conservazione e l'eliminazione dei file orfani.
-
error
— -8 stringheUTF.Un errore che si è verificato durante l'esecuzione dell'ottimizzatore.
-
compactionMetrics
: un oggetto CompactionMetrics.Un oggetto
CompactionMetrics
contenente i parametri per l'esecuzione dell'ottimizzatore. -
retentionMetrics
: un oggetto RetentionMetrics.Un oggetto
RetentionMetrics
contenente i parametri per l'esecuzione dell'ottimizzatore. -
orphanFileDeletionMetrics
: un oggetto OrphanFileDeletionMetrics.Un
OrphanFileDeletionMetrics
oggetto contenente le metriche per 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"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).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"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle.
RetentionConfiguration struttura
La configurazione per un ottimizzatore della conservazione delle istantanee.
Campi
-
icebergConfiguration
: un oggetto IcebergRetentionConfiguration.La configurazione per un ottimizzatore di conservazione delle istantanee Iceberg.
IcebergRetentionConfiguration struttura
La configurazione per un ottimizzatore di conservazione delle istantanee Iceberg.
Campi
-
snapshotRetentionPeriodInDays
: numero (intero).Il numero di giorni per conservare le istantanee Iceberg. Se non viene fornito un input, verrà utilizzato il campo di configurazione della tabella Iceberg corrispondente o, se non è presente, verrà utilizzato il valore predefinito 5.
-
numberOfSnapshotsToRetain
: numero (intero).Il numero di istantanee Iceberg da conservare entro il periodo di conservazione. Se non viene fornito un input, verrà utilizzato il campo di configurazione della tabella Iceberg corrispondente o, se non presente, verrà utilizzato il valore predefinito 1.
-
cleanExpiredFiles
: booleano.Se impostato su false, le istantanee vengono eliminate solo dai metadati della tabella e i file di dati e metadati sottostanti non vengono eliminati.
OrphanFileDeletionConfiguration struttura
La configurazione per un ottimizzatore di eliminazione di file orfani.
Campi
-
icebergConfiguration
: un oggetto IcebergOrphanFileDeletionConfiguration.La configurazione per un ottimizzatore per l'eliminazione di file orfani Iceberg.
IcebergOrphanFileDeletionConfiguration struttura
La configurazione per un ottimizzatore per l'eliminazione di file orfani Iceberg.
Campi
-
orphanFileRetentionPeriodInDays
: numero (intero).Il numero di giorni in cui i file orfani devono essere conservati prima dell'eliminazione dei file. Se non viene fornito un input, verrà utilizzato il valore predefinito 3.
-
location
— UTF -8 stringhe.Speciifica una directory in cui cercare i file (il valore predefinito è la posizione della tabella). È possibile scegliere una sottodirectory anziché la posizione della tabella di primo livello.
CompactionMetrics struttura
Una struttura che contiene le metriche di compattazione per il funzionamento dell'ottimizzatore.
Campi
-
IcebergMetrics
: un oggetto IcebergCompactionMetrics.Una struttura contenente le metriche di compattazione Iceberg per il funzionamento dell'ottimizzatore.
RetentionMetrics struttura
Una struttura che contiene le metriche di conservazione per l'esecuzione dell'ottimizzatore.
Campi
-
IcebergMetrics
: un oggetto IcebergRetentionMetrics.Una struttura contenente le metriche di conservazione di Iceberg per l'esecuzione dell'ottimizzatore.
OrphanFileDeletionMetrics struttura
Una struttura che contiene le metriche di eliminazione dei file orfani per l'esecuzione dell'ottimizzatore.
Campi
-
IcebergMetrics
: un oggetto IcebergOrphanFileDeletionMetrics.Una struttura contenente le metriche di eliminazione dei file orfani di Iceberg per l'esecuzione dell'ottimizzatore.
IcebergCompactionMetrics struttura
Metriche di compattazione per Iceberg per il funzionamento dell'ottimizzatore.
Campi
-
NumberOfDpus
— Numero (intero).Il numero di DPU ore impiegate dal lavoro.
-
JobDurationInHour
: numero (doppio).La durata del processo in ore.
IcebergRetentionMetrics struttura
Metriche di conservazione delle istantanee per Iceberg per l'esecuzione dell'ottimizzatore.
Campi
-
NumberOfDpus
— Numero (numero intero).Il numero di DPU ore impiegate dal lavoro.
-
JobDurationInHour
: numero (doppio).La durata del processo in ore.
IcebergOrphanFileDeletionMetrics struttura
metriche di eliminazione dei file orfani per Iceberg for the Optimizer.
Campi
-
NumberOfDpus
— Numero (numero intero).Il numero di DPU ore impiegate dal lavoro.
-
JobDurationInHour
: numero (doppio).La durata del processo in ore.
RunMetrics struttura
Parametri per l'esecuzione dell'ottimizzatore.
Questa struttura è obsoleta. Visualizza i singoli membri della metrica per la compattazione, la conservazione e l'eliminazione dei file orfani.
Campi
-
NumberOfBytesCompacted
— -8 stringheUTF.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
BatchGetTableOptimizer azione (Python: batch_get_table_optimizer)
ListTableOptimizerRuns azione (Python: list_table_optimizer_runs)
CreateTableOptimizer azione (Python: create_table_optimizer)
DeleteTableOptimizer azione (Python: delete_table_optimizer)
UpdateTableOptimizer azione (Python: update_table_optimizer)
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 patternL'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 patternIl 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 patternNome della tabella.
-
Type
— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).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 stringhe, di lunghezza non inferiore a 1 o superiore a 255 byte, corrispondente a. Single-line string patternIl 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 patternNome della tabella.
-
TableOptimizer
: un oggetto TableOptimizer.L'ottimizzatore associato alla tabella specificata.
Errori
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
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
-
TableOptimizers
: una matrice di oggetti BatchTableOptimizer.Elenco di oggetti
BatchTableOptimizer
. -
Failures
: una matrice di oggetti BatchGetTableOptimizerError.Un elenco di errori derivanti dall'operazione.
Errori
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
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 patternL'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 patternIl 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 patternNome della tabella.
-
Type
— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle.
-
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 patternIl 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 patternNome 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
ValidationException
InternalServiceException
ThrottlingException
CreateTableOptimizer azione (Python: create_table_optimizer)
Crea un nuovo ottimizzatore di tabella per una funzione specifica.
Richiesta
-
CatalogId
- Obbligatorio:: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string patternL'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 patternIl 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 patternNome della tabella.
-
Type
— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle.
-
TableOptimizerConfiguration
: obbligatorio: un oggetto TableOptimizerConfiguration.Un oggetto
TableOptimizerConfiguration
che rappresenta la configurazione dell'ottimizzatore di tabelle.
Risposta
Nessun parametro di risposta.
Errori
EntityNotFoundException
ValidationException
InvalidInputException
AccessDeniedException
AlreadyExistsException
InternalServiceException
ThrottlingException
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 patternL'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 patternIl 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 patternNome della tabella.
-
Type
— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle.
Risposta
Nessun parametro di risposta.
Errori
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
ThrottlingException
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 patternL'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 patternIl 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 patternNome della tabella.
-
Type
— Obbligatorio: UTF -8 stringhe (valori validi:compaction="COMPACTION"
|retention="RETENTION"
|orphan_file_deletion="ORPHAN_FILE_DELETION"
).Il tipo di ottimizzatore di tabelle.
-
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
ValidationException
InternalServiceException
ThrottlingException
ConcurrentModificationException