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 di visualizzazione materializzata L'API di visualizzazione materializzata descrive AWS Glue i tipi di dati e le operazioni per l'avvio, l'interruzione e il monitoraggio delle esecuzioni delle attività di aggiornamento delle viste materializzate. ## Tipi di dati + [MaterializedViewRefreshTaskRun struttura](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun) ## MaterializedViewRefreshTaskRun struttura L'oggetto che mostra i dettagli dell'operazione di aggiornamento delle viste materializzate eseguita. **Campi** + `CustomerId`— UTF-8 stringa, lunga non più di 12 byte. L'ID AWS dell'account. + `MaterializedViewRefreshTaskRunId`— UTF-8 stringa, corrispondente a[Custom string pattern #48](aws-glue-api-common.md#regex_48). L'identificatore dell'operazione di aggiornamento della vista materializzata eseguita. + `DatabaseName`— stringa. UTF-8 Il database in cui risiede la tabella. + `TableName`— UTF-8 corda. Il nome della vista materializzata. + `CatalogId`: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID del catalogo dati in cui risiede la tabella Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account . + `Role`— UTF-8 corda. Il ruolo IAM che il servizio assume per eseguire l'attività di aggiornamento della vista materializzata. + `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](aws-glue-api-common.md#aws-glue-api-regex-uri). Il messaggio di errore per il processo. + `DPUSeconds`: numero (doppio). L'utilizzo della DPU calcolato in secondi per tutti i worker con scalabilità automatica. + `RefreshType`— UTF-8 stringa (valori validi: `FULL` \|`INCREMENTAL`). Il tipo di operazione di aggiornamento eseguita. COMPLETO o INCREMENTALE. + `ProcessedBytes`: numero (lungo). Il numero di byte scansionati dall'operazione di aggiornamento eseguita per aggiornare la vista materializzata. ## Operazioni + [StartMaterializedViewRefreshTaskRun azione (Python: start\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun) + [StopMaterializedViewRefreshTaskRun azione (Python: stop\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun) + [GetMaterializedViewRefreshTaskRun azione (Python: get\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun) + [ListMaterializedViewRefreshTaskRuns azione (Python: list\_materialized\_view\_refresh\_task\_runs)](#aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns) ## StartMaterializedViewRefreshTaskRun azione (Python: start\_materialized\_view\_refresh\_task\_run) Avvia un'operazione di aggiornamento della vista materializzata eseguita per una vista materializzata specificata. **Richiesta** + `CatalogId`— * Obbligatoria: * UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) L'ID del catalogo dati in cui risiede la tabella. Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account . + `DatabaseName`— * * UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Il nome della vista materializzata per cui eseguire l'attività di aggiornamento. + `FullRefresh`: booleano. Specifica se si tratta di un aggiornamento completo dell'operazione eseguita. **Risposta** + `MaterializedViewRefreshTaskRunId`— UTF-8 stringa, corrispondente a. [Custom string pattern #48](aws-glue-api-common.md#regex_48) L'identificatore per l'esecuzione del task di aggiornamento della vista materializzata. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `MaterializedViewRefreshTaskRunningException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InvalidInputException` ## StopMaterializedViewRefreshTaskRun azione (Python: stop\_materialized\_view\_refresh\_task\_run) Interrompe l'esecuzione di un'attività di aggiornamento della vista materializzata per una vista materializzata specificata. **Richiesta** + `CatalogId`— * Obbligatoria: * UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) L'ID del catalogo dati in cui risiede la tabella. Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account . + `DatabaseName`— * * UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Il nome della vista materializzata. **Risposta** + *Nessun parametro di risposta.* **Errori** + `AccessDeniedException` + `MaterializedViewRefreshTaskNotRunningException` + `MaterializedViewRefreshTaskStoppingException` + `InvalidInputException` + `OperationTimeoutException` ## GetMaterializedViewRefreshTaskRun azione (Python: get\_materialized\_view\_refresh\_task\_run) Ottiene l'associato per l'esecuzione di un'attività, a cui viene assegnato un ID di esecuzione dell'attività. metadata/information **Richiesta** + `CatalogId`— * Obbligatorio: * UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) L'ID del catalogo dati in cui risiede la tabella Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account . + `MaterializedViewRefreshTaskRunId`— * Obbligatorio: * UTF-8 stringa, corrispondente a. [Custom string pattern #48](aws-glue-api-common.md#regex_48) L'identificatore per la particolare attività di aggiornamento della vista materializzata eseguita. **Risposta** + `MaterializedViewRefreshTaskRun`: un oggetto [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun). Un MaterializedViewRefreshTaskRun oggetto che rappresenta i dettagli dell'esecuzione dell'operazione. **Errori** + `AccessDeniedException` + `EntityNotFoundException` + `OperationTimeoutException` + `InvalidInputException` ## ListMaterializedViewRefreshTaskRuns azione (Python: list\_materialized\_view\_refresh\_task\_runs) Elenca tutte le attività eseguite per un determinato account. **Richiesta** + `CatalogId`— * Obbligatoria: * UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) L'ID del catalogo dati in cui risiede la tabella Se non viene fornito, per impostazione predefinita viene utilizzato l'ID dell'account . + `DatabaseName`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Il database in cui risiede la tabella. + `TableName`— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Il nome della vista materializzata. + `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** + `MaterializedViewRefreshTaskRuns`: una matrice di oggetti [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun). I risultati dell' ListMaterializedViewRefreshTaskRuns azione. + `NextToken`— UTF-8 stringa. Un token di continuazione, se non sono ancora stati restituiti tutti gli ID delle esecuzioni dell'attività. **Errori** + `AccessDeniedException` + `InvalidInputException` + `OperationTimeoutException` ## Eccezioni + [MaterializedViewRefreshTaskRunningException struttura](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException) + [MaterializedViewRefreshTaskNotRunningException struttura](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException) + [MaterializedViewRefreshTaskStoppingException struttura](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException) ## MaterializedViewRefreshTaskRunningException struttura Eccezione generata quando un'attività è già in esecuzione. **Campi** + `Message`— UTF-8 stringa. Messaggio che descrive il problema. ## MaterializedViewRefreshTaskNotRunningException struttura Eccezione generata quando si interrompe un'attività che non è in esecuzione. **Campi** + `Message`— UTF-8 stringa. Messaggio che descrive il problema. ## MaterializedViewRefreshTaskStoppingException struttura Eccezione generata quando un'attività è già in stato di arresto. **Campi** + `Message`— UTF-8 stringa. Messaggio che descrive il problema.