API delle statistiche delle colonne - AWS Glue
 - tipi di dati -ColumnStatisticsTaskRunColumnStatisticsTaskSettingsExecutionAttempt - operazioni -StartColumnStatisticsTaskRun (start_column_statistics_task_run)GetColumnStatisticsTaskRun (get_column_statistics_task_run)GetColumnStatisticsTaskRuns (get_column_statistics_task_runs)ListColumnStatisticsTaskRuns (list_column_statistics_task_runs)StopColumnStatisticsTaskRun (stop_column_statistics_task_run)CreateColumnStatisticsTaskSettings (create_column_statistics_task_settings)UpdateColumnStatisticsTaskSettings (update_column_statistics_task_settings)GetColumnStatisticsTaskSettings (get_column_statistics_task_settings)DeleteColumnStatisticsTaskSettings (delete_column_statistics_task_settings)StartColumnStatisticsTaskRunSchedule (start_column_statistics_task_run_schedule)StopColumnStatisticsTaskRunSchedule (stop_column_statistics_task_run_schedule) - eccezioni -ColumnStatisticsTaskRunningExceptionColumnStatisticsTaskNotRunningExceptionColumnStatisticsTaskStoppingExceptionColumnStatisticsTaskAutoConcurrencyLimitExceptionInvalidCatalogSettingException

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 Column Statistics descrive come AWS Glue APIs restituire 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: stringa UTF-8, non superiore a 12 byte di lunghezza.

    L'ID AWS dell'account.

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

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

  • DatabaseName: stringa UTF-8.

    Il database in cui risiede la tabella.

  • TableName: stringa UTF-8.

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

  • ColumnNameList: una matrice di stringhe UTF-8.

    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, per impostazione predefinita viene utilizzato l'ID dell' AWS account.

  • Role: stringa UTF-8.

    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: stringa UTF-8, non superiore a 128 byte di lunghezza.

    Nome della configurazione di sicurezza utilizzata per crittografare CloudWatch i log per l'esecuzione dell'attività 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: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

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

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

    Il tipo di calcolo delle statistiche sulle colonne.

  • Status: stringa UTF-8 (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), non superiore a None (Nessuno).

    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: stringa UTF-8.

    Nome del database in cui risiede la tabella.

  • TableName: stringa UTF-8.

    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 matrice di stringhe UTF-8.

    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: stringa UTF-8.

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

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

    La percentuale di dati da campionare.

  • SecurityConfiguration: stringa UTF-8, non superiore a 128 byte di lunghezza.

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

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

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

  • SettingSource: stringa UTF-8 (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: stringa UTF-8 (valori validi: FAILED | STARTED).

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

  • ColumnStatisticsTaskRunId: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 per generare statistiche.

  • ColumnNameList: una matrice di stringhe UTF-8.

    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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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: stringa UTF-8, 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 viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account AWS .

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

    Nome della configurazione di sicurezza utilizzata per crittografare i log per l'esecuzione dell'attività Column stats. CloudWatch

Risposta

  • ColumnStatisticsTaskRunId: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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)

Ottieni l'associato per l'esecuzione di un'attività, con un ID di esecuzione dell'attività. metadata/information

Richiesta

  • ColumnStatisticsTaskRunId - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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: stringa UTF-8.

    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: stringa UTF-8.

    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: stringa UTF-8.

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

Risposta

  • ColumnStatisticsTaskRunIds: una matrice di stringhe UTF-8, non superiore a 100.

    Un elenco di attività di statistica delle colonne eseguite. IDs

  • NextToken: stringa UTF-8.

    Un token di continuazione, se non tutte le attività eseguite IDs sono state ancora restituite.

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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 per cui generare le statistiche sulle colonne.

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

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

  • Schedule: stringa UTF-8.

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

  • ColumnNameList: una matrice di stringhe UTF-8.

    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: stringa UTF-8, 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.

  • SecurityConfiguration: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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 stringa UTF-8, non inferiore a 1 o superiore a 128 byte di lunghezza.

    Ogni valore è una stringa UTF-8, 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 per cui generare le statistiche sulle colonne.

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

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

  • Schedule: stringa UTF-8.

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

  • ColumnNameList: una matrice di stringhe UTF-8.

    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: stringa UTF-8, 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.

  • SecurityConfiguration: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 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 - obbligatorio: stringa UTF-8, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.

    Nome del database 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 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: stringa UTF-8.

    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: stringa UTF-8.

    Messaggio che descrive il problema.

ColumnStatisticsTaskStoppingException struttura

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

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

ColumnStatisticsTaskAutoConcurrencyLimitException struttura

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

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

InvalidCatalogSettingException struttura

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

Campi

  • Message: stringa UTF-8.

    Messaggio che descrive il problema.