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

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

Tipi di dati

Struttura ColumnStatisticsTaskRun

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

Campi
  • CustomerId: stringa UTF-8, non superiore a 12 byte di lunghezza.

    ID dell'account AWS.

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

  • 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 i log di CloudWatch per l'esecuzione dell'attività delle statistiche delle colonne.

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

Struttura ColumnStatisticsTaskSettings

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

    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 log di CloudWatch.

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

Struttura ExecutionAttempt

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

Operazione StartColumnStatisticsTaskRun (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 di CloudWatch per l'esecuzione dell'attività delle statistiche delle colonne.

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

Operazione GetColumnStatisticsTaskRun (Python: get_column_statistics_task_run)

Ottieni i metadati/le informazioni associati per l'esecuzione di un'attività, con un ID di esecuzione attività.

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

Operazione GetColumnStatisticsTaskRuns (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 1000.

    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

Operazione ListColumnStatisticsTaskRuns (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 1000.

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

Operazione StopColumnStatisticsTaskRun (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

Operazione CreateColumnStatisticsTaskSettings (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 di 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

Operazione UpdateColumnStatisticsTaskSettings (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 di CloudWatch.

Risposta
  • Nessun parametro di risposta.

Errori
  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • VersionMismatchException

  • OperationTimeoutException

Operazione GetColumnStatisticsTaskSettings (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

Operazione DeleteColumnStatisticsTaskSettings (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

Operazione StartColumnStatisticsTaskRunSchedule (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

Operazione StopColumnStatisticsTaskRunSchedule (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

Struttura ColumnStatisticsTaskRunningException

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.

Struttura ColumnStatisticsTaskNotRunningException

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.

Struttura ColumnStatisticsTaskStoppingException

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

Campi
  • Message: stringa UTF-8.

    Messaggio che descrive il problema.

Struttura ColumnStatisticsTaskAutoConcurrencyLimitException

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.

Struttura InvalidCatalogSettingException

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

Campi
  • Message: stringa UTF-8.

    Messaggio che descrive il problema.