View a markdown version of this page

API delle statistiche delle colonne - AWS Aderenza

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 delle statistiche delle colonne

L'API per le statistiche delle colonne descrive le AWS Glue API per la restituzione di statistiche sulle colonne di una tabella.

Tipi di dati

ColumnStatisticsTaskRun struttura

L'oggetto che mostra i dettagli dell'esecuzione delle statistiche delle colonne.

Campi
  • CustomerId— UTF-8 stringa lunga non più di 12 byte.

    L'ID AWS dell'account.

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

    L'identificatore per l'esecuzione dell'attività delle statistiche delle colonne specifica.

  • DatabaseName— UTF-8 stringa.

    Il database in cui risiede la tabella.

  • TableName— UTF-8 corda.

    Il nome della tabella per cui vengono generate le statistiche delle colonne.

  • ColumnNameList— Una serie di UTF-8 stringhe.

    Un elenco dei nomi delle colonne. Se non viene fornito, per impostazione predefinita verranno utilizzati tutti i nomi delle colonne della tabella.

  • 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 risiede la tabella Se non ne viene fornito nessuno, l'ID AWS dell'account viene utilizzato per impostazione predefinita.

  • Role— UTF-8 stringa.

    Il ruolo IAM che assume il servizio per generare statistiche.

  • SampleSize: numero (doppio), non superiore a 100.

    La percentuale di righe utilizzate per generare statistiche. Se non viene fornita, per generare statistiche verrà utilizzata l'intera tabella.

  • SecurityConfiguration— UTF-8 stringa, lunga non più di 128 byte.

    Nome della configurazione di sicurezza utilizzata per crittografare CloudWatch i log per l'esecuzione del task column stats.

  • NumberOfWorkers: numero (intero), almeno 1.

    Il numero di worker utilizzati per generare statistiche delle colonne. Il processo è preconfigurato per scalare automaticamente fino a 25 istanze.

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

    Il tipo di worker utilizzati per generare statistiche. Il valore predefinito è g.1x.

  • ComputationType— UTF-8 stringa (valori validi: FULL |INCREMENTAL).

    Il tipo di calcolo delle statistiche sulle colonne.

  • Status— UTF-8 stringa (valori validi: STARTING | RUNNING | SUCCEEDED | FAILED |STOPPED).

    Lo stato dell'esecuzione dell'attività.

  • CreationTime: timestamp.

    L'ora di creazione di questa attività.

  • LastUpdated: timestamp.

    Il momento dell'ultima modifica di questa attività.

  • StartTime: timestamp.

    L'orario di inizio dell'attività.

  • EndTime: timestamp.

    L'orario di fine dell'attività.

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

    Il messaggio di errore per il processo.

  • DPUSeconds: numero (doppio).

    L'utilizzo della DPU calcolato in secondi per tutti i worker con scalabilità automatica.

ColumnStatisticsTaskSettings struttura

Le impostazioni di un'attività di statistica sulle colonne.

Campi
  • DatabaseName— UTF-8 corda.

    Nome del database in cui risiede la tabella.

  • TableName— UTF-8 corda.

    Il nome della tabella per cui generare le statistiche sulle colonne.

  • Schedule: un oggetto Schedule.

    Una pianificazione per l'esecuzione delle statistiche sulle colonne, specificata in sintassi CRON.

  • ColumnNameList— Una serie di UTF-8 stringhe.

    Un elenco di nomi delle colonne per le quali eseguire le statistiche.

  • 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 risiede il database.

  • Role— UTF-8 stringa.

    Il ruolo utilizzato per l'esecuzione delle statistiche sulle colonne.

  • SampleSize: numero (doppio), non superiore a 100.

    La percentuale di dati da campionare.

  • SecurityConfiguration— UTF-8 stringa, lunga non più di 128 byte.

    Nome della configurazione di sicurezza utilizzata per crittografare i log CloudWatch.

  • ScheduleType— UTF-8 stringa (valori validi: CRON |AUTO).

    Il tipo di pianificazione per un'attività di statistica sulle colonne. I valori possibili sono CRON o AUTO.

  • SettingSource— UTF-8 stringa (valori validi: CATALOG |TABLE).

    L'origine dell'impostazione dell'attività di statistica sulle colonne. I valori possibili sono CATALOG o TABLE.

  • LastExecutionAttempt: un oggetto ExecutionAttempt.

    L'ultimo ExecutionAttempt per l'esecuzione dell'attività di statistica sulle colonne.

ExecutionAttempt struttura

Un tentativo di esecuzione dell'attività di statistica sulle colonne.

Campi
  • Status— UTF-8 stringa (valori validi: FAILED |STARTED).

    Lo stato dell'ultima esecuzione dell'attività di statistica sulle colonne.

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

    Un ID esecuzione attività per l'esecuzione dell'attività di statistica sulle colonne.

  • ExecutionTimestamp: timestamp.

    Un timestamp del momento in cui si è verificata l'ultima esecuzione dell'attività di statistica sulle colonne.

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

    Un messaggio di errore associato all'ultima esecuzione dell'attività di statistica sulle colonne.

Operazioni

StartColumnStatisticsTaskRun azione (Python: start_column_statistics_task_run)

Avvia l'esecuzione di un'attività di statistica delle colonne, per una tabella e delle colonne specificate.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per generare statistiche.

  • ColumnNameList— Una serie di UTF-8 stringhe.

    Un elenco dei nomi delle colonne per generare statistiche. Se non viene fornito, per impostazione predefinita verranno utilizzati tutti i nomi delle colonne della tabella.

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

    Il ruolo IAM che assume il servizio per generare statistiche.

  • SampleSize: numero (doppio), non superiore a 100.

    La percentuale di righe utilizzate per generare statistiche. Se non viene fornita, per generare statistiche verrà utilizzata l'intera tabella.

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

    L'ID del catalogo dati in cui risiede la tabella. Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account AWS .

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

    Nome della configurazione di sicurezza utilizzata per crittografare CloudWatch i log per l'esecuzione del task column stats.

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

    L'identificatore per l'esecuzione dell'attività delle statistiche delle colonne.

Errori
  • AccessDeniedException

  • EntityNotFoundException

  • ColumnStatisticsTaskRunningException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • InvalidInputException

GetColumnStatisticsTaskRun azione (Python: get_column_statistics_task_run)

Ottiene l'associato per l'esecuzione di un'attività, a cui viene assegnato un ID di esecuzione dell'attività. metadata/information

Richiesta
  • ColumnStatisticsTaskRunId Obbligatorio: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern

    L'identificatore per l'esecuzione dell'attività delle statistiche delle colonne specifica.

Risposta
  • ColumnStatisticsTaskRun: un oggetto ColumnStatisticsTaskRun.

    Un oggetto ColumnStatisticsTaskRun che rappresenta i dettagli dell'esecuzione delle statistiche delle colonne.

Errori
  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

GetColumnStatisticsTaskRuns azione (Python: get_column_statistics_task_runs)

Recupera le informazioni su tutte le esecuzioni associate alla tabella specificata.

Richiesta
  • DatabaseName Obbligatorio: stringa. UTF-8

    Nome del database in cui risiede la tabella.

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

    Nome della tabella.

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

    La dimensione massima della risposta.

  • NextToken— UTF-8 stringa.

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

Risposta
  • ColumnStatisticsTaskRuns: una matrice di oggetti ColumnStatisticsTaskRun.

    Un elenco delle esecuzioni dell'attività delle statistiche delle colonne.

  • NextToken— UTF-8 corda.

    Un token di continuazione, se non sono ancora stati restituite tutte le esecuzioni dell'attività.

Errori
  • OperationTimeoutException

ListColumnStatisticsTaskRuns azione (Python: list_column_statistics_task_runs)

Elenca tutte le attività eseguite per un determinato account.

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

    La dimensione massima della risposta.

  • NextToken— UTF-8 stringa.

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

Risposta
  • ColumnStatisticsTaskRunIds— Una matrice di UTF-8 stringhe, non più di 100 stringhe.

    Un elenco degli ID delle esecuzioni dell'attività delle statistiche delle colonne.

  • NextToken— stringa UTF-8 .

    Un token di continuazione, se non sono ancora stati restituiti tutti gli ID delle esecuzioni dell'attività.

Errori
  • OperationTimeoutException

StopColumnStatisticsTaskRun azione (Python: stop_column_statistics_task_run)

Interrompe l'esecuzione di un'operazione per la tabella specificata.

Richiesta
  • DatabaseName Obbligatorio: stringa. UTF-8

    Nome del database in cui risiede la tabella.

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

    Nome della tabella.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • ColumnStatisticsTaskNotRunningException

  • ColumnStatisticsTaskStoppingException

  • OperationTimeoutException

CreateColumnStatisticsTaskSettings azione (Python: create_column_statistics_task_settings)

Crea le impostazioni per un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui generare le statistiche sulle colonne.

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

    Il ruolo utilizzato per l'esecuzione delle statistiche sulle colonne.

  • Schedule— UTF-8 stringa.

    Una pianificazione per l'esecuzione delle statistiche sulle colonne, specificata in sintassi CRON.

  • ColumnNameList— Una serie di UTF-8 stringhe.

    Un elenco di nomi delle colonne per le quali eseguire le statistiche.

  • SampleSize: numero (doppio), non superiore a 100.

    La percentuale di dati da campionare.

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

    L'ID del catalogo dati in cui risiede il database.

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

    Nome della configurazione di sicurezza utilizzata per crittografare i log CloudWatch.

  • Tags: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.

    Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.

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

    Una mappa di tag.

Risposta
  • Nessun parametro di risposta.

Errori
  • AlreadyExistsException

  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ColumnStatisticsTaskRunningException

UpdateColumnStatisticsTaskSettings azione (Python: update_column_statistics_task_settings)

Aggiorna le impostazioni per un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui generare le statistiche sulle colonne.

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

    Il ruolo utilizzato per l'esecuzione delle statistiche sulle colonne.

  • Schedule— UTF-8 stringa.

    Una pianificazione per l'esecuzione delle statistiche sulle colonne, specificata in sintassi CRON.

  • ColumnNameList— Una serie di UTF-8 stringhe.

    Un elenco di nomi delle colonne per le quali eseguire le statistiche.

  • SampleSize: numero (doppio), non superiore a 100.

    La percentuale di dati da campionare.

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

    L'ID del catalogo dati in cui risiede il database.

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

    Nome della configurazione di sicurezza utilizzata per crittografare i log CloudWatch.

Risposta
  • Nessun parametro di risposta.

Errori
  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • VersionMismatchException

  • OperationTimeoutException

GetColumnStatisticsTaskSettings azione (Python: get_column_statistics_task_settings)

Recupera le impostazioni per un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui recuperare le statistiche sulle colonne.

Risposta
  • ColumnStatisticsTaskSettings: un oggetto ColumnStatisticsTaskSettings.

    Un oggetto ColumnStatisticsTaskSettings che rappresenta le impostazioni per l'attività di statistica sulle colonne.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

DeleteColumnStatisticsTaskSettings azione (Python: delete_column_statistics_task_settings)

Elimina le impostazioni per un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui eliminare le statistiche sulle colonne.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

StartColumnStatisticsTaskRunSchedule azione (Python: start_column_statistics_task_run_schedule)

Avvia la pianificazione di esecuzione di un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui avviare la pianificazione di esecuzione di un'attività di statistica sulle colonne.

Risposta
  • Nessun parametro di risposta.

Errori
  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

StopColumnStatisticsTaskRunSchedule azione (Python: stop_column_statistics_task_run_schedule)

Interrompe la pianificazione di esecuzione di un'attività di statistica sulle colonne.

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

    Nome del database in cui risiede la tabella.

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

    Il nome della tabella per cui interrompere la pianificazione di esecuzione di un'attività di statistica sulle colonne.

Risposta
  • Nessun parametro di risposta.

Errori
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

Eccezioni

ColumnStatisticsTaskRunningException struttura

Un'eccezione generata quando si cerca di avviare un altro processo durante l'esecuzione di un processo di generazione di statistiche delle colonne.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

ColumnStatisticsTaskNotRunningException struttura

Un'eccezione generata quando si tenta di interrompere l'esecuzione di un'attività quando non è in esecuzione alcuna attività.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

ColumnStatisticsTaskStoppingException struttura

Un'eccezione generata quando si tenta di interrompere l'esecuzione di un'attività.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

ColumnStatisticsTaskAutoConcurrencyLimitException struttura

Un'eccezione generata quando è già stato raggiunto il limite di processi automatici di statistica simultanei.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.

InvalidCatalogSettingException struttura

Un'eccezione generata quando si verifica un problema con le impostazioni del catalogo.

Campi
  • Message— UTF-8 corda.

    Messaggio che descrive il problema.