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à. # Aggiornamento dei dati in Amazon Quick Sight Durante l'aggiornamento dei dati, Amazon Quick Sight gestisce i set di dati in modo diverso a seconda delle proprietà di connessione e della posizione di archiviazione dei dati. Se Quick Sight si connette all'archivio dati utilizzando un'interrogazione diretta, i dati si aggiornano automaticamente quando apri un set di dati, un'analisi o un pannello di controllo associato. I controlli dei filtri vengono aggiornati automaticamente ogni 24 ore. Per aggiornare SPICE i set di dati, Quick Sight deve autenticarsi in modo indipendente utilizzando le credenziali archiviate per connettersi ai dati. Quick Sight non può aggiornare i dati caricati manualmente, nemmeno dai bucket S3, anche se sono archiviati in, SPICE perché Quick Sight non memorizza i metadati di connessione e posizione. Se desideri aggiornare automaticamente i dati archiviati in un bucket S3, crea un set di dati utilizzando la scheda dell'origine dati **S3**. Per i file caricati manualmente su SPICE, puoi aggiornarli manualmente importando nuovamente il file. Se desideri riutilizzare il nome del set di dati originale per il nuovo file, rinomina o elimina prima il set di dati originale. Quindi assegna il nome preferito al nuovo set di dati. Inoltre, controlla che i nomi dei campi abbiano lo stesso nome e tipo di dati. Apri l'analisi e sostituisci il set di dati originale con il nuovo set di dati. Per ulteriori informazioni, consulta [Sostituzione di set di dati](replacing-data-sets.md). Puoi aggiornare i set di dati di [SPICE](spice.md) in qualsiasi momento. L'aggiornamento importa nuovamente i dati in SPICE in modo che i dati includano tutte le modifiche apportate dopo l'ultima importazione. Per Amazon Quick Sight Standard Edition, puoi eseguire un aggiornamento completo dei tuoi SPICE dati in qualsiasi momento. Per Amazon Quick Sight Enterprise Edition, puoi eseguire un aggiornamento completo o incrementale (solo origini dati basate su SQL) in qualsiasi momento. **Nota** Se il tuo set di dati utilizza CustomSQL, l'aggiornamento incrementale potrebbe non essere vantaggioso. Se la query SQL è complessa, il database potrebbe non riuscire a ottimizzare il filtro con la finestra di riepilogo. Ciò può far sì che la query che richiede i dati impieghi più tempo di un aggiornamento completo. Si consiglia di provare a ridurre i tempi di esecuzione delle query eseguendo la rifattorizzazione dell'SQL personalizzato. Tieni presente che i risultati potrebbero variare a seconda del tipo di ottimizzazione effettuata. Puoi aggiornare i dati di SPICE usando uno dei seguenti approcci: + Puoi utilizzare le opzioni disponibili nella pagina **Set di dati**. + È possibile aggiornare un set di dati durante la modifica di un set di dati. + Puoi pianificare gli aggiornamenti nelle impostazioni del set di dati. + Puoi utilizzare l'operazione [CreateIngestion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateIngestion.html)API per aggiornare i dati. Quando crei o modifichi un set di dati SPICE, puoi abilitare le notifiche e-mail sullo stato di caricamento dei dati. Questa opzione avvisa i proprietari del set di dati se i dati non vengono caricati o aggiornati. Per attivare le notifiche, seleziona l'opzione **Invia e-mail ai proprietari quando un aggiornamento non riesce** che appare nella schermata **Termina la creazione del set di dati.** Questa opzione non è disponibile per i set di dati creati utilizzando **Carica un file** nella pagina dei set di dati. Negli argomenti seguenti è disponibile una spiegazione dei diversi approcci all'aggiornamento e all'utilizzo dei dati SPICE. **Topics** + [Importazione dei dati in SPICE](spice.md) + [Aggiornamento dei dati SPICE](refreshing-imported-data.md) + [Utilizzo dei dati SPICE in un'analisi](spice-in-an-analysis.md) + [Visualizza la cronologia di importazione di SPICE](view-history-of-spice-ingestion.md) + [Risoluzione degli errori relativi alle righe ignorate](troubleshooting-skipped-rows.md) + [Codici di errore di importazione di SPICE](errors-spice-ingestion.md) + [Aggiornamento dei file in un set di dati](updating-file-dataset.md) # Importazione dei dati in SPICE Quando importi dati in un set di dati anziché utilizzare una query SQL diretta, *SPICEquesti diventano dati* a causa del modo in cui vengono archiviati. *SPICE (Super-fast, Parallel, In-memory Calculation Engine)*è il robusto motore in memoria utilizzato da Amazon Quick Sight. È stato sviluppato per eseguire rapidamente calcoli avanzati e restituire dati significativi. Nella Enterprise Edition, i dati archiviati in SPICE vengono crittografati a riposo. Quando crei o modifichi un set di dati, scegli di utilizzare SPICE o una query diretta, a meno che il set di dati non contenga file caricati. L'importazione (detta anche *acquisizione*) dei dati in SPICE consente di risparmiare tempo e denaro: + Le tue query analitiche vengono elaborate più rapidamente. + Non è necessario attendere l'elaborazione di una query diretta. + I dati archiviati in SPICE possono essere riutilizzati più volte senza incorrere in costi aggiuntivi. Se utilizzi un'origine dati che addebita un costo per query, ti verranno addebitati i costi per l'esecuzione delle query sui dati quando crei il set di dati per la prima volta e successivamente quando aggiorni il set di dati. SPICEla capacità viene allocata separatamente per ciascuno di essi. Regione AWS La SPICE capacità predefinita viene assegnata automaticamente alla casa. Regione AWS Per ogni AWS account, la SPICE capacità è condivisa da tutte le persone che utilizzano Quick Sight in un unico Regione AWS account. Gli altri non Regioni AWS hanno SPICE capacità a meno che tu non scelga di acquistarne alcuni. Gli amministratori di Quick Sight possono visualizzare la [SPICE](#spice)capacità disponibile in ciascuna di esse Regione AWS e quanta di essa è attualmente in uso. Un amministratore di Quick Sight può acquistare più SPICE capacità o rilasciare la SPICE capacità inutilizzata secondo necessità. Per ulteriori informazioni, consulta [Configurare SPICE la capacità di memoria](managing-spice-capacity.md). **Topics** + [Stima delle dimensioni dei set di dati SPICE](#spice-capacity-formula) ## Stima delle dimensioni dei set di dati SPICE La dimensione di un set di dati SPICE rispetto alla SPICE capacità dell'account Quick è chiamata dimensione *logica*. La dimensione logica di un set di dati non è uguale alla dimensione del file o della tabella di origine del set di dati. Il calcolo della dimensione logica di un set di dati viene effettuato dopo che sono state definite tutte le trasformazioni dei tipi di dati e le colonne calcolate durante la preparazione dei dati. Questi campi compaiono in SPICE in un modo che ottimizza le prestazioni delle query. Qualsiasi modifica apportata in un'analisi non ha effetto sulla dimensione logica dei dati in SPICE. Solo le modifiche che vengono salvate nel set di dati si applicano alla capacità di SPICE. La dimensione logica di un set di dati SPICE dipende dai tipi di dati dei campi del set di dati e dal numero di righe del set di dati. I tre tipi di dati SPICE sono decimali, date e stringhe. Puoi trasformare il tipo di dati di un campo durante la fase di preparazione dei dati per adattarlo alle tue esigenze di visualizzazione dei dati. Ad esempio, è possibile che il file che desideri importare contenga tutte le stringhe (testo). Tuttavia, affinché queste possano essere utilizzate in modo significativo in un'analisi, devi preparare i dati cambiando i relativi tipi nella loro forma corretta. I campi contenenti i prezzi possono essere modificati da stringhe in decimali e i campi che contengono le date vengono cambiati da stringhe in date. Puoi anche creare campi calcolati ed escludere i campi che non ti servono dalla tabella di origine. Quando hai finito di preparare il set di dati e tutte le trasformazioni sono complete, puoi stimare la dimensione logica dello schema finale. **Nota** I tipi di dati geospaziali utilizzano i metadati per interpretare il tipo di dati fisico. Latitudine e longitudine sono valori numerici, mentre tutte le altre categorie geospaziali sono stringhe. Nella formula seguente, i decimali e le date vengono calcolati come 8 byte per cella con 4 byte aggiuntivi per i dati ausiliari. Le stringhe vengono calcolate in base alla lunghezza del testo nella codifica UTF-8 più 24 byte per la codifica ausiliaria. I tipi di dati di tipo stringa richiedono più spazio a causa dell'indicizzazione aggiuntiva richiesta da SPICE per fornire prestazioni di query elevate. ``` Logical dataset size in bytes = (Number of Numeric cells * (12 bytes per cell)) + (Number of Date cells * (12 bytes per cell)) + SUM ((24 bytes + UTF-8 encoded length) per Text cell) ``` La formula precedente deve essere utilizzata solo per stimare la dimensione di un singolo set di dati in SPICE. L'utilizzo SPICE della capacità è la dimensione totale di tutti i set di dati in un account in una regione specifica. Quick Sight non consiglia di utilizzare questa formula per stimare la SPICE capacità totale utilizzata dall'account Quick Sight. # Aggiornamento dei dati SPICE ## Aggiornamento di un set di dati **Utilizza la seguente procedura per aggiornare un [SPICE](spice.md)set di dati basato su un'origine dati Amazon S3 o un database nella scheda Dati.** Se si verifica una modifica dello schema in un database, Quick Sight non sarà in grado di rilevarla automaticamente, con conseguente errore di inserimento. Modifica e salva il set di dati per aggiornare lo schema ed evitare errori di inserimento. **Per aggiornare i dati SPICE dalla scheda Dati** 1. Seleziona **Data** dal menu di navigazione a sinistra. Nella scheda **Dataset**, scegli il set di dati per aprirlo. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**, quindi scegli **Aggiorna ora**. 1. Lascia il tipo di aggiornamento impostato su **Aggiornamento completo**. 1. In caso di aggiornamento di un set di dati Amazon S3, scegli una delle seguenti opzioni per **Manifesto S3**: + Per utilizzare lo stesso file manifesto che hai fornito l'ultima volta ad Amazon Quick Sight, scegli Existing **Manifest**. Se il file manifest è stato modificato nella posizione di file o nell'URL specificato in precedenza, i dati restituiti saranno conformi a tale modifica. + Per specificare un nuovo file manifest caricandolo dalla rete locale, scegliere **Upload Manifest (Carica manifest)**, quindi scegliere **Upload manifest file (Carica file manifest)**. Per **Open (Apri)**, scegliere un file, quindi scegliere **Open (Apri)**. + Per specificare un nuovo file manifest fornendo un URL, immettere l'URL del manifest in **Input manifest URL (URL manifest di input)**. L'URL del file manifesto è disponibile nella console Amazon S3 aprendo il menu contestuale (clic con il pulsante destro del mouse) relativo al file manifesto, scegliendo **Proprietà**, quindi cercando la casella **Collegamento**. 1. Scegliere **Refresh (Aggiorna)**. 1. In caso di aggiornamento di un set di dati Amazon S3, scegli **OK**, quindi di nuovo **OK**. In caso di aggiornamento di un set di dati di database, scegli **OK**. ## Aggiornamento incrementale di un set di dati | | | --- | |  Si applica a: Enterprise Edition  | Per le origini dati basate su SQL, come Amazon Redshift, Amazon Athena, PostgreSQL o Snowflake, puoi aggiornare i dati in modo incrementale entro una finestra temporale di riferimento. Un *aggiornamento incrementale* interroga solo i dati definiti dal set di dati all'interno di una finestra di look-back specificata. Trasferisce tutti gli inserimenti, le eliminazioni e le modifiche al set di dati, entro l'intervallo di tempo di quella finestra, dall'origine al set di dati. I dati attualmente presenti di SPICE all'interno di quella finestra vengono eliminati e sostituiti con gli aggiornamenti. Con gli aggiornamenti incrementali, per ogni aggiornamento vengono interrogati e trasferiti meno dati. Ad esempio, supponiamo che tu abbia un set di dati con 180.000 record che contiene dati dal 1° gennaio al 30 giugno. Il 1° luglio, esegui un aggiornamento incrementale dei dati con una finestra di riepilogo di sette giorni. Quick Sight interroga il database chiedendo tutti i dati dal 24 giugno (7 giorni fa), ovvero 7.000 record. Quick Sight elimina quindi i dati attualmente in arrivo SPICE dal 24 giugno in poi e aggiunge i nuovi dati interrogati. Il giorno successivo (2 luglio), Quick Sight esegue la stessa operazione, ma esegue una query a partire dal 25 giugno (di nuovo 7.000 record) e quindi li elimina dal set di dati esistente a partire dalla stessa data. Invece di dover importare 180.000 record ogni giorno, deve importare solo 7.000 record. **Utilizzare la procedura seguente per aggiornare in modo incrementale un [SPICE](spice.md)set di dati basato su un'origine dati SQL dalla scheda Datasets.** **Aggiornamento incrementale per un set di dati SPICE basato su SQL** 1. Scegli **Data dal menu** di navigazione a sinistra. Nella scheda **Datasets**, scegli il set di dati per aprirlo. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**, quindi scegli **Aggiorna ora**. 1. Per **Tipo di aggiornamento**, scegli **Aggiornamento incrementale**. 1. Se questo è il primo aggiornamento incrementale del set di dati, scegli **Configura** 1. Nella pagina **Configura aggiornamento incrementale**, effettua le seguenti operazioni: 1. Per **Colonna data**, scegli una colonna di date su cui basare la finestra di riepilogo. 1. Per **Dimensioni della finestra**, inserisci un numero per la **dimensione**, quindi scegli il periodo di tempo in cui desideri verificare le modifiche. È possibile scegliere di aggiornare le modifiche ai dati che sono state apportate entro un determinato numero di ore, giorni o settimane da oggi. Ad esempio, puoi scegliere di aggiornare le modifiche ai dati avvenute entro due settimane dalla data corrente. 1. Seleziona **Invia**. ## Aggiornamento di un set di dati durante la preparazione dei dati Utilizza la procedura seguente per aggiornare un set di dati [SPICE](spice.md) basato su un'origine dati Amazon S3 o su un'origine dati di database durante la preparazione dei dati. **Aggiornamento dei dati SPICE durante la preparazione dei dati** 1. Scegli **Dati** dal menu di navigazione a sinistra. Nella scheda **Set** di dati, scegli il set di dati, quindi scegli **Modifica set di dati**. 1. Nella schermata del set di dati, scegli **Aggiorna ora**. 1. Lascia il tipo di aggiornamento impostato su **Aggiornamento completo**. 1. (Facoltativo) In caso di aggiornamento di un set di dati Amazon S3, scegli una delle seguenti opzioni per **Manifesto S3**: + Per utilizzare lo stesso file manifesto che hai fornito l'ultima volta ad Amazon Quick Sight, scegli Existing **Manifest**. Se il file manifest è stato modificato nella posizione di file o nell'URL specificato in precedenza, i dati restituiti saranno conformi a tale modifica. + Per specificare un nuovo file manifest caricandolo dalla rete locale, scegliere **Upload Manifest (Carica manifest)**, quindi scegliere **Upload manifest file (Carica file manifest)**. Per **Open (Apri)**, scegliere un file, quindi scegliere **Open (Apri)**. + Per specificare un nuovo file manifest fornendo un URL, immettere l'URL del manifest in **Input manifest URL (URL manifest di input)**. L'URL del file manifesto è disponibile nella console Amazon S3 aprendo il menu contestuale (clic con il pulsante destro del mouse) relativo al file manifesto, scegliendo **Proprietà**, quindi cercando la casella **Collegamento**. 1. Scegliere **Refresh (Aggiorna)**. 1. In caso di aggiornamento di un set di dati Amazon S3, scegli **OK**, quindi di nuovo **OK**. In caso di aggiornamento di un set di dati di database, scegli **OK**. ## Aggiornamento di un set di dati in una pianificazione Utilizza la procedura seguente per pianificare l'aggiornamento dei dati. Se il set di dati è basato su una query diretta e non è archiviato in [SPICE](spice.md), puoi aggiornare i dati aprendo il set di dati oppure aggiornando la pagina in un'analisi o in un pannello di controllo. **Per aggiornare i dati [SPICE](spice.md) in una pianificazione** 1. Scegli **Data** dal menu di navigazione a sinistra. Nella scheda **Datasets**, scegli il set di dati per aprirlo. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**, quindi seleziona **Aggiungi nuova pianificazione**. 1. Nella schermata **Crea una pianificazione di aggiornamento** scegli le impostazioni della pianificazione. 1. In **Time zone (Fuso orario)** scegliere il fuso orario da applicare all'aggiornamento dei dati. 1. Per **Ora di inizio**, scegli una data e un'ora per l'inizio dell'aggiornamento. Utilizzare HH: MM e il formato basato su 24 ore, ad esempio 13:30. 1. Per **Frequenza**, scegli una delle opzioni seguenti: + Per le versioni Standard Edition o Enterprise Edition, è possibile scegliere **Daily (Ogni giorno)**, **Weekly (Ogni settimana)** o **Monthly (Ogni mese)**. + **Ogni giorno**: viene ripetuto ogni giorno. + **Ogni settimana**: viene ripetuto lo stesso giorno di ogni settimana. + **Monthly (Ogni mese)**: l'aggiornamento viene eseguito nello stesso giorno di ogni mese Per aggiornare i dati il giorno 29, 30 o 31 del mese, scegliere **Last day of month (Ultimo giorno del mese)** nell'elenco. + Solo per la versione Enterprise Edition, è possibile scegliere **Hourly (Ogni ora)**. Questa impostazione aggiorna il set di dati ogni ora, a partire dal momento in cui viene selezionata l'opzione. Pertanto, se si seleziona 13:05 come ora iniziale, i dati vengono aggiornati ai cinque minuti dopo l'ora, ogni ora. Se si decide di utilizzare un aggiornamento orario, non è possibile utilizzare altre pianificazioni degli aggiornamenti. Per creare una pianificazione oraria, rimuovi tutte le altre pianificazioni esistenti per il set di dati. Inoltre, rimuovere qualsiasi pianificazione oraria esistente prima di creare una pianificazione giornaliera, settimanale o mensile. 1. Scegli **Save** (Salva). Le importazioni pianificate di set di dati avvengono entro 10 minuti dalla data e dall'ora pianificate. Utilizzando la console Quick, puoi creare cinque pianificazioni per ogni set di dati. Dopo aver creato cinque pianificazioni, il pulsante **Crea** risulta disabilitato. ## Aggiornamento incrementale di un set di dati in una pianificazione | | | --- | |  Si applica a: Enterprise Edition  | Per le origini dati basate su SQL, come Amazon Redshift, Athena, PostgreSQL o Snowflake, puoi pianificare aggiornamenti incrementali. **Utilizzare la procedura seguente per aggiornare in modo incrementale un [SPICE](spice.md)set di dati basato su un'origine dati SQL nella scheda Datasets.** **Impostazione di una pianificazione di aggiornamento incrementale per un set di dati SPICE basato su SQL** 1. Scegli **Data dal menu** di navigazione a sinistra. Nella scheda **Datasets**, scegli il set di dati per aprirlo. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**, quindi seleziona **Aggiungi nuova pianificazione**. 1. Nella pagina **Crea una pianificazione**, per **Tipo di aggiornamento**, scegli **Aggiornamento incrementale**. 1. Se si tratta del primo aggiornamento incrementale per questo set di dati, scegli **Configura**, quindi procedi come segue: 1. Per **Colonna data**, scegli una colonna di date su cui basare la finestra di riepilogo. 1. Per **Dimensioni della finestra**, inserisci un numero per la **dimensione**, quindi scegli il periodo di tempo in cui desideri verificare le modifiche. È possibile scegliere di aggiornare le modifiche ai dati che sono state apportate entro un determinato numero di ore, giorni o settimane da oggi. Ad esempio, puoi scegliere di aggiornare le modifiche ai dati avvenute entro due settimane dalla data corrente. 1. Seleziona **Invia**. 1. In **Time zone (Fuso orario)** scegliere il fuso orario da applicare all'aggiornamento dei dati. 1. In **Repeats (Ripetizioni)** scegliere una delle opzioni seguenti: + Puoi scegliere **Ogni 15 minuti**, **Ogni 30 minuti**, **Ogni ora**, **Ogni giorno**, **Ogni settimana** o **Ogni mese**. + **Ogni 15 minuti**: si ripete ogni 15 minuti, a partire dall'ora scelta. Quindi, se si seleziona 1:05 come orario di inizio, i dati vengono aggiornati all'1:20, quindi di nuovo all'1:35 e così via. + **Ogni 30 minuti**: si ripete ogni 30 minuti, a partire dall'ora scelta. Quindi, se si seleziona 1:05 come orario di inizio, i dati vengono aggiornati all'1:35, quindi di nuovo alle 2:05 e così via. + **Ogni ora**: si ripete ogni ora, a partire dall'ora scelta. Pertanto, se si seleziona 13:05 come ora iniziale, i dati vengono aggiornati ai cinque minuti dopo l'ora, ogni ora. + **Ogni giorno**: viene ripetuto ogni giorno. + **Ogni settimana**: viene ripetuto lo stesso giorno di ogni settimana. + **Monthly (Ogni mese)**: l'aggiornamento viene eseguito nello stesso giorno di ogni mese Per aggiornare i dati il giorno 29, 30 o 31 del mese, scegliere **Last day of month (Ultimo giorno del mese)** nell'elenco. + Se si decide di utilizzare un aggiornamento ogni 15 o 30 minuti, non è possibile utilizzare altre pianificazioni degli aggiornamenti. Per creare una pianificazione di aggiornamento ogni 15 minuti, 30 minuti o ogni ora, rimuovi tutte le altre pianificazioni esistenti per quel set di dati. Inoltre, rimuovi qualsiasi pianificazione oraria esistente prima di creare una pianificazione giornaliera, settimanale o mensile. 1. Per **Inizio**: scegli una data per l'inizio dell'aggiornamento. 1. In **Alle**, specifica l'ora di inizio dell'aggiornamento. Utilizzare HH: MM e il formato basato su 24 ore, ad esempio 13:30. Le importazioni pianificate di set di dati avvengono entro 10 minuti dalla data e dall'ora pianificate. In alcuni casi, qualcosa potrebbe andare storto con il set di dati di aggiornamento incrementale che ti fa desiderare ripristinare il set di dati. Oppure potresti non voler più aggiornare il set di dati in modo incrementale. In tal caso, puoi eliminare l'aggiornamento pianificato. A tale scopo, scegli il set di dati nella pagina **Set di dati**, scegli **Pianifica un aggiornamento**, quindi scegli l'icona x a destra dell'aggiornamento pianificato. L'eliminazione di una configurazione di aggiornamento incrementale avvia un aggiornamento completo. Come parte di questo aggiornamento completo, tutte le configurazioni preparate per gli aggiornamenti incrementali vengono rimosse. # Utilizzo dei dati SPICE in un'analisi Quando utilizzi i dati archiviati per creare un'analisi, accanto all'elenco di set di dati nella parte superiore del riquadro **Elenco campi** viene visualizzato un indicatore di importazione dati. Quando apri l'analisi per la prima volta e il set di dati viene importato, viene visualizzata un'icona a forma di spinner. Al completamento dell'importazione SPICE, l'indicatore visualizza la percentuale di righe importate correttamente. Nella parte superiore del riquadro di visualizzazione viene inoltre visualizzato un messaggio che indica il conteggio delle righe importate e quello delle righe ignorate. Se sono presenti righe ignorate, puoi scegliere **View summary (Visualizza riepilogo)** all'interno del messaggio per visualizzare il motivo della mancata importazione delle righe. Per modificare il set di dati e risolvere i problemi associati alle righe ignorate, scegli **Modifica set di dati**. Per ulteriori informazioni sulle cause più comuni associate alle righe ignorate, consulta [Risoluzione degli errori relativi alle righe ignorate](troubleshooting-skipped-rows.md). Se l'importazione ha esito negativo, l'indicatore dell'importazione dei dati viene visualizzato come un'icona a forma di punto esclamativo. Viene visualizzato anche il messaggio **Import failed (Importazione non riuscita)**. # Visualizza la cronologia di importazione di SPICE Puoi visualizzare la cronologia di acquisizione dei set di dati SPICE per scoprire, ad esempio, quando è iniziata l'ultima importazione e in che stato si trova. La pagina della cronologia di importazione di SPICE include le seguenti informazioni: + Data e ora di inizio dell'acquisizione (UTC) + Stato dell'acquisizione + Tempo richiesto per l'acquisizione + Il numero di righe aggregate nel set di dati. + Il numero di righe importate durante un aggiornamento. + Righe ignorate e righe inserite (importate) con successo + Tipo di processo di aggiornamento: pianificato, aggiornamento completo e così via. Utilizza la procedura seguente per visualizzare la cronologia di importazione di SPICE per un set di dati. **Visualizzazione della cronologia di importazione di un set di dati SPICE** 1. Dalla home page, scegli **Dati** a sinistra. 1. Nella scheda **Set** di dati, scegli il set di dati che desideri esaminare. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**. La cronologia di importazione di SPICE è mostrata in basso. 1. (Facoltativo) Scegliere un intervallo di tempo in base al quale filtrare le voci, compreso tra l'ultima ora e gli ultimi 90 giorni. 1. (Facoltativo) Scegliere uno stato del processo specifico in base al quale filtrare le voci, ad esempio **Running (Esecuzione)** o **Completed (Completato)**. In alternativa, è possibile visualizzare tutte le voci scegliendo **All (Tutto)**. # Risoluzione degli errori relativi alle righe ignorate Quando importi dati, Amazon Quick Sight visualizza in anteprima una parte dei tuoi dati. Se non è in grado di interpretare una riga per qualsiasi motivo, Quick Sight salta la riga. In alcuni casi, l'importazione avrà esito negativo. Quando ciò accade, Quick Sight restituisce un messaggio di errore che spiega l'errore. Fortunatamente, c'è un numero limitato di cose che possono andare storte. Alcuni problemi possono essere evitati tenendo in considerazione esempi come i seguenti: + Assicurati che non vi sia alcuna incoerenza tra il tipo di dati e i dati dei campi, ad esempio dati stringa occasionali in un campo con un tipo di dati numerico. Ecco alcuni esempi che possono essere difficili da rilevare durante la scansione del contenuto di una tabella: + `''`: utilizzo di una stringa vuota per indicare un valore mancante + `'NULL'`: utilizzo della parola "null" per indicare un valore mancante + `$1000`: l'inclusione del simbolo del dollaro in un valore di valuta lo trasforma in una stringa + `'O'Brien'`: utilizzo della punteggiatura per contrassegnare una stringa che a sua volta contiene la stessa punteggiatura. Tuttavia, questo tipo di errore non è sempre così facile da rilevare, soprattutto se si dispone di molti dati o se i dati vengono digitati a mano. Ad esempio, alcune applicazioni di assistenza clienti o di vendita prevedono l'immissione di informazioni fornite verbalmente dai clienti. La persona che ha digitato originariamente i dati potrebbe averli inseriti nel campo sbagliato. Potrebbe aggiungere, o dimenticare di aggiungere, un carattere o una cifra. Ad esempio, potrebbero inserire la data "0/10/12020" o inserire il sesso di qualcuno in un campo destinato all'età. + Assicurati che il file importato venga elaborato correttamente con o senza un'intestazione. Se è presente una riga di intestazione, assicurati di scegliere l'opzione di caricamento dell'intestazione **Contiene l'intestazione**. + Assicurati che i dati non superino uno o più dei [Quote di origini dati](data-source-limits.md). + Verifica che i dati siano compatibili con i [Valori e tipi di dati supportati](supported-data-types-and-values.md). + Assicurati che i campi calcolati contengano dati compatibili con il calcolo, anziché essere incompatibili o esclusi dalla funzione nel campo calcolato. Ad esempio, se nel set di dati è presente un campo calcolato che utilizza[parseDate](parseDate-function.md), Quick Sight salta le righe in cui tale campo non contiene una data valida. Quick Sight fornisce un elenco dettagliato degli errori che si verificano quando il SPICE motore tenta di importare dati. Quando un set di dati salvato riporta righe ignorate, è possibile visualizzare gli errori in modo da poter intervenire per risolvere i problemi. **Visualizzazione degli errori relativi alle righe che sono state ignorate durante l'importazione SPICE (importazione dei dati)** 1. Scegli **Dati** a sinistra. Nella scheda Set di dati, scegli il **set** di dati problematico per aprirlo. 1. Nella pagina dei dettagli del set di dati che si apre, scegli la scheda **Aggiorna**. La cronologia di importazione di SPICE è mostrata in basso. 1. Per l'importazione con l'errore, scegli **Visualizza riepilogo degli errori**. Questo link si trova nella colonna **Stato**. 1. Esamina il **log di importazione dei file** che si apre. Visualizza le sezioni seguenti: + **Riepilogo**: fornisce un punteggio percentuale del numero di righe ignorate rispetto al numero totale di righe dell'importazione. Ad esempio, se sono state ignorate 864 righe su un totale di 1.728, il punteggio è del 50%. + **Righe ignorate**: fornisce il conteggio delle righe, il nome del campo e il messaggio di errore per ogni set di righe ignorate simili. + **Risoluzione dei problemi**: fornisce un collegamento per scaricare un file che contiene informazioni sugli errori. 1. In **Risoluzione dei problemi**, scegli **Scarica il file delle righe di errore**. Il file di errore contiene una riga per ogni errore. Il file è denominato `error-report_123_fe8.csv`, dove `123_fe8` viene sostituito da una stringa identificativa univoca. Il file contiene le seguenti colonne: + **ERROR\$1TYPE**: il tipo o il codice di errore dell'errore che si è verificato durante l'importazione di questa riga. È possibile cercare questo errore nella sezione [Codici di errore di importazione di SPICE](errors-spice-ingestion.md) che segue questa procedura. + **COLUMN\$1NAME**: il nome della colonna nei dati che ha causato l'errore. + Tutte le colonne della riga importata: le colonne rimanenti duplicano l'intera riga di dati. Se una riga presenta più di un errore, può apparire più volte in questo file. 1. Scegli **Modifica set di dati** per apportare modifiche al set di dati. Puoi filtrare i dati, omettere campi, modificare i tipi di dati, modificare i campi calcolati esistenti e aggiungere campi calcolati che convalidano i dati. 1. Dopo aver apportato le modifiche indicate dai codici di errore, importa nuovamente i dati. Se nel log compaiono altri errori di importazione di SPICE, ripeti questa procedura per correggere tutti gli errori rimanenti. **Suggerimento** Se non riesci a risolvere i problemi relativi ai dati in un lasso di tempo ragionevole utilizzando l'editor del set di dati, consulta gli amministratori o gli sviluppatori proprietari dei dati. A lungo termine, è più conveniente ripulire i dati più vicino all'origine piuttosto che aggiungere l'elaborazione delle eccezioni durante la preparazione dei dati per l'analisi. Correggendoli all'origine, si evita una situazione in cui più persone correggono gli errori in modi diversi, con conseguenti risultati di reporting diversi in seguito. **Esercitazione nella risoluzione dei problemi relativi alle righe ignorate** 1. Scarica [samples/csv-files-for-troubleshooting-skipped-rows.zip](samples/csv-files-for-troubleshooting-skipped-rows.zip). 1. Estrai i file in una cartella che puoi utilizzare per caricare il file.csv di esempio in Quick Sight. Il file zip contiene i seguenti due file di testo: + `sample dataset - data ingestion error.csv`: un file .csv di esempio che contiene problemi che causano l'omissione delle righe. Puoi provare a importare il file da solo per vedere come funziona il processo di errore. + `sample data ingestion error file`— Un file di errore di esempio generato SPICE durante l'importazione del file di esempio .csv in Quick Sight. 1. Importa i dati completando questi passaggi: 1. ****Scegliete **Dati, scheda Set di dati****, Nuovo, Set** di dati.**** 1. Scegliere **Upload a file (Carica un file)**. 1. Trova e scegli il file denominato `sample dataset - data ingestion error.csv`. 1. Scegli **Carica un file**, **Modifica impostazioni e prepara i dati**. 1. Scegli **Salva** per uscire. 1. Scegli il tuo set di dati per visualizzarne le informazioni, quindi scegli **Visualizza riepilogo degli errori**. Esamina gli errori e i dati per risolvere i problemi. # Codici di errore di importazione di SPICE L'elenco seguente di codici di errore e descrizioni aiuta a comprendere e risolvere i problemi relativi all'importazione dei dati in SPICE. ## Codici di errore per le righe ignorate L'elenco seguente di codici di errore e descrizioni aiuta a comprendere e risolvere i problemi relativi alle righe ignorate. ****ARITHMETIC\$1EXCEPTION****: si è verificata un'eccezione aritmetica durante l'elaborazione di un valore. ****ENCODING\$1EXCEPTION****: si è verificata un'eccezione sconosciuta durante la conversione e la codifica dei dati in SPICE. ****OPENSEARCH\$1CURSOR\$1NOT\$1ENABLED — Nel OpenSearch dominio non sono abilitati**** i cursori SQL (). `"opendistro.sql.cursor.enabled" : "true"` Per ulteriori informazioni, consulta [Autorizzazione delle connessioni ad Amazon Service OpenSearch](opensearch.md). ****INCORRECT\$1FIELD\$1COUNT****: una o più righe hanno troppi campi. Assicurati che il numero di campi in ogni riga corrisponda al numero di campi definiti nello schema. ****INCORRECT\$1SAGEMAKER\$1OUTPUT\$1FIELD\$1COUNT**** — L'output AI ha un numero imprevisto di campi. SageMaker ****INDEX\$1OUT\$1OF\$1BOUNDS****: il sistema ha richiesto un indice non valido per l'array o l'elenco in fase di elaborazione. ****MALFORMED\$1DATE****: un valore in un campo non può essere trasformato in una data valida. Ad esempio, se si prova a convertire un campo che contiene un valore come `"sale date"` o`"month-1"`, l'azione genera un errore di data con formato errato. Per correggere questo errore, rimuovi i valori non di data dall'origine dati. Verifica di non importare un file con un'intestazione di colonna mescolata ai dati. Se la stringa contiene una data o un'ora che non vengono convertite, consulta [Utilizzo di date non supportate o personalizzate](using-unsupported-dates.md). ****MISSING\$1SAGEMAKER\$1OUTPUT\$1FIELD —**** SageMaker Un campo nell'output AI è inaspettatamente vuoto. ****NUMBER\$1BITWIDTH\$1TOO\$1LARGE****: un valore numerico supera la lunghezza supportata in SPICE. Ad esempio, il valore numerico è composto da più di 19 cifre, che corrisponde alla lunghezza di un tipo di dati `bigint`. Per una sequenza numerica lunga che non è un valore matematico, usa un tipo di dati `string`. ****NUMBER\$1PARSE\$1FAILURE****: un valore in un campo numerico non è un numero. Ad esempio, un campo con un tipo di dati di `int` contiene una stringa o un valore a virgola mobile. ****SAGEMAKER\$1OUTPUT\$1COLUMN\$1TYPE\$1MISMATCH — Il tipo di dati definito nello schema AI non corrisponde**** al tipo di dati ricevuto dall'IA. SageMaker SageMaker ****STRING\$1TRUNCATION****: una stringa viene troncata da SPICE. Le stringhe vengono troncate quando la lunghezza della stringa supera la quota SPICE. Per ulteriori informazioni su SPICE, consultare [Importazione dei dati in SPICE](spice.md). Per ulteriori informazioni sulle quote, consulta [Quote di servizio](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html). ****UNDEFINED****: si è verificato un errore sconosciuto durante l'importazione dei dati. ****UNSUPPORTED\$1DATE\$1VALUE****: un campo di data contiene una data in un formato supportato ma non compresa nell'intervallo di date supportato, ad esempio "31/12/1399" o "01/01/10000". Per ulteriori informazioni, consulta [Utilizzo di date non supportate o personalizzate](using-unsupported-dates.md). ## Codici di errore durante l'importazione dei dati Per i processi di importazione e aggiornamento dei dati che non riescono, Quick Sight fornisce un codice di errore che indica la causa dell'errore. L'elenco seguente di codici di errore e descrizioni aiuta a comprendere e risolvere i problemi relativi all'importazione dei dati in SPICE. ****ACCOUNT\$1CAPACITY\$1LIMIT\$1EXCEEDED****: i dati superano la capacità SPICE corrente. Acquista altra capacità SPICE o elimina i dati SPICE esistenti e riprova l'importazione. ****CONNECTION\$1FAILURE —**** Amazon Quick Sight non può connettersi alla tua fonte di dati. Controlla le impostazioni di connessione dell'origine dati e riprova. ****CUSTOMER\$1ERROR****: si è verificato un problema durante l'analisi dei dati. Se il problema persiste, contatta l'assistenza tecnica di Amazon Quick Sight. ****DATA\$1SET\$1DELETED****: l'origine dati o il set di dati è stato eliminato o è diventato non disponibile durante l'acquisizione. ****DATA\$1SET\$1SIZE\$1LIMIT\$1EXCEEDED****: il set di dati supera le dimensioni massime consentite per un set di dati SPICE. Utilizza i filtri per ridurre le dimensioni del set di dati e riprova. Per informazioni sulle quote SPICE, consulta [Quote di origini dati](data-source-limits.md). ****DATA\$1SOURCE\$1AUTH\$1FAILED****: l'autenticazione dell'origine dati non è riuscita. Controlla le credenziali e utilizza l'opzione **Modifica origine dati** per sostituire le credenziali scadute. ****DATA\$1SOURCE\$1CONNECTION\$1FAILED****: la connessione all'origine dati non è riuscita. Controlla l'URL e riprova. Se l'errore persiste, contatta l'amministratore dell'origine dati per assistenza. ****DATA\$1SOURCE\$1NOT\$1FOUND****: non sono state trovate origini dati. Controlla le tue fonti di dati Amazon Quick Sight. ****DATA\$1TOLERANCE\$1EXCEPTION****: numero eccessivo di righe non valide. Amazon Quick Sight ha raggiunto la quota di righe che può saltare e continuare ad importare. Controlla i dati e riprova. ****FAILURE\$1TO\$1ASSUME\$1ROLE — Amazon Quick Sight non è riuscito ad assumere il ruolo**** (IAM) corretto. AWS Identity and Access Management Verifica i criteri per `Amazon Quick Sight-service-role` nella console IAM. ****FAILURE\$1TO\$1PROCESS\$1JSON\$1FILE — Amazon Quick Sight non è riuscito a analizzare un file**** manifest come JSON valido. ****IAM\$1ROLE\$1NOT\$1AVAILABLE**** — Amazon Quick Sight non dispone dell'autorizzazione per accedere all'origine dati. Per gestire le autorizzazioni Amazon Quick Sight sulle AWS risorse, vai alla pagina **Sicurezza e autorizzazioni** nell'opzione Gestisci **Amazon Quick Sight** come amministratore. ****INGESTION\$1CANCELED****: l'acquisizione è stata annullata dall'utente. ****INGESTION\$1SUPERSEDED****: l'acquisizione è stata sostituita da un altro flusso di lavoro. Ciò accade quando viene creata una nuova importazione mentre ne è ancora in corso un'altra. Evita di modificare manualmente il set di dati più volte in un breve periodo, poiché ogni modifica manuale crea una nuova importazione che sostituirà e terminerà l'importazione precedente. ****INTERNAL\$1SERVICE\$1ERROR****: si è verificato un errore di servizio interno. ****INVALID\$1DATA\$1SOURCE\$1CONFIG****: nelle impostazioni di connessione sono apparsi valori non validi. Controlla i dettagli della connessione e riprova. ****INVALID\$1DATAPREP\$1SYNTAX****: l'espressione di campo calcolato contiene una sintassi non valida. Correggi la sintassi e riprova. ****INVALID\$1DATE\$1FORMAT****: è apparso un formato di data non valido. ****IOT\$1DATA\$1SET\$1FILE\$1EMPTY: non è stato trovato**** alcun dato di Analytics. AWS IoT Controlla l'account e riprova. ****IOT\$1FILE\$1NOT\$1FOUND**** — Un file Analytics indicato non è stato trovato. AWS IoT Controlla l'account e riprova. ****OAUTH\$1TOKEN\$1FAILURE****: le credenziali per l'origine dati sono scadute. Rinnova le credenziali e riprova l'acquisizione. ****PASSWORD\$1AUTHENTICATION\$1FAILURE****: sono apparse credenziali non corrette per un'origine dati. Aggiorna le credenziali dell'origine dati e riprova l'acquisizione. ****PERMISSION\$1DENIED****: l'accesso alle risorse richieste è stato rifiutato dall'origine dati. Richiedi le autorizzazioni all'amministratore del tuo database o assicurati che sia stata concessa l'autorizzazione adeguata ad Amazon Quick Sight prima di riprovare. ****QUERY\$1TIMEOUT****: una query all'origine dati è scaduta in attesa di una risposta. Controlla i log delle origini dati e riprova. ****ROW\$1SIZE\$1LIMIT\$1EXCEEDED****: il limite massimo per le dimensioni della riga è stato superato. ****S3\$1FILE\$1INACCESSIBLE****: non è stato possibile connettersi a un bucket S3. Assicurati di concedere ad Amazon Quick Sight e agli utenti le autorizzazioni necessarie prima di connetterti al bucket S3. ****S3\$1MANIFEST\$1ERROR****: non è stato possibile connettersi ai dati S3. Verifica che il file manifesto S3 sia valido. Controlla anche l'accesso ai dati S3. Sia Amazon Quick Sight che l'utente Amazon Quick Sight necessitano delle autorizzazioni per connettersi ai dati S3. ****S3\$1UPLOADED\$1FILE\$1DELETED****: uno o più file per l'importazione sono stati eliminati (tra le importazioni). Controlla il bucket S3 e riprova. ****SOURCE\$1 API\$1LIMIT \$1EXCEEDED\$1FAILURE: questa importazione supera**** la quota API per questa fonte di dati. Contatta l'amministratore dell'origine dati per assistenza. ****SOURCE\$1RESOURCE\$1LIMIT\$1EXCEEDED****: una query SQL supera il limite di risorse dell'origine dati. Le risorse coinvolte possono includere, ad esempio, il limite di query simultanee, il limite di connessione e le risorse del server fisico. Contatta l'amministratore dell'origine dati per assistenza. ****SPICE\$1TABLE\$1NOT\$1FOUND**** — Una fonte di dati o un set di dati Amazon Quick Sight è stato eliminato o non è più disponibile durante l'ingestione. Controlla il tuo set di dati in Amazon Quick Sight e riprova. Per ulteriori informazioni, consulta [Risoluzione degli errori relativi alle righe ignorate](troubleshooting-skipped-rows.md). ****SQL\$1EXCEPTION****: si è verificato un errore SQL generale. Questo errore può essere causato da timeout delle query, limitazioni delle risorse, modifiche impreviste al DDL (Data Definition Language) prima o durante una query e altri errori del database. Controlla le impostazioni del database e la query, quindi riprova. ****SQL\$1INVALID\$1PARAMETER\$1VALUE****: è apparso un parametro SQL non valido. Controlla SQL e riprova. ****SQL\$1NUMERIC\$1OVERFLOW**** — Amazon Quick Sight ha rilevato un'eccezione numerica. out-of-range Controlla i valori associati e le colonne calcolate per gli overflow e riprova. ****SQL\$1SCHEMA\$1MISMATCH\$1ERROR**** — Lo schema dell'origine dati non corrisponde al set di dati Amazon Quick Sight. Aggiorna la definizione del set di dati Amazon Quick Sight. ****SQL\$1TABLE\$1NOT\$1FOUND**** — Amazon Quick Sight non riesce a trovare la tabella nell'origine dati. Verifica la tabella specificata nel set di dati o nell'SQL personalizzato, quindi riprova. ****SSL\$1CERTIFICATE\$1VALIDATION\$1FAILURE**** — Amazon Quick Sight non può convalidare il certificato Secure Sockets Layer (SSL) sul tuo server di database. Controlla lo stato SSL sul server con l'amministratore del database e riprova. ****UNRESOLVABLE\$1HOST**** — Amazon Quick Sight non è in grado di risolvere il nome host dell'origine dati. Verifica il nome host dell'origine dati e riprova. ****UNROUTABLE\$1HOST**** — Amazon Quick Sight non può raggiungere la tua fonte di dati perché si trova all'interno di una rete privata. Assicurati che la tua connessione VPC privata sia configurata correttamente in Enterprise Edition o consenti gli intervalli di indirizzi IP di Amazon Quick Sight per consentire la connettività per Standard Edition. # Aggiornamento dei file in un set di dati Per ottenere la versione più recente dei file, puoi aggiornare i file nel set di dati. Puoi aggiornare questi tipi di file: + File di testo delimitati da virgole (CSV) e delimitati da tabulazioni (TSV) + File in formato di log comuni ed estesi (ELF e CLF) + File di dati semistrutturati o flat (JSON) + File Microsoft Excel (XLSX) Prima di aggiornare un file, assicurati che il nuovo file abbia gli stessi campi nello stesso ordine del file originale attualmente presente nel set di dati. Se ci sono discrepanze nei campi (colonne) tra i due file, si verifica un errore ed è necessario correggere le discrepanze prima di tentare nuovamente l'aggiornamento. È possibile farlo modificando il nuovo file in modo che corrisponda all'originale. Tieni presente che se desideri aggiungere nuovi campi, potrai aggiungerli dopo i campi originali del file. Ad esempio, in un foglio di calcolo di Microsoft Excel, puoi aggiungere nuovi campi a destra dei campi originali. **Aggiornamento di un file in un set di dati** 1. In Quick Sight, scegli **Data** a sinistra. 1. Nella scheda **Set** di dati, scegli il set di dati che desideri aggiornare, quindi scegli **Modifica** set di dati. 1. Nella pagina di preparazione dei dati che si apre, scegli l'elenco a discesa per il file che desideri aggiornare, quindi scegli **Aggiorna file**. 1. Nella pagina **Aggiorna file** che si apre, scegli **Carica file**, quindi accedi a un file. Quick Sight esegue la scansione del file. 1. Se il file è un file di Microsoft Excel, scegli il foglio che desideri nella pagina **Scegli il tuo foglio** che si apre, quindi scegli **Seleziona**. 1. Scegli **Conferma l'aggiornamento del file** nella pagina successiva. A titolo di riferimento, viene mostrata un'anteprima di alcune colonne del foglio. In alto a destra viene visualizzato un messaggio che indica che il file è stato aggiornato correttamente e l'anteprima della tabella si aggiorna per mostrare i nuovi dati del file.