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à. # Creazione di un set di dati utilizzando file Amazon S3 Per creare un set di dati utilizzando uno o più file di testo (.csv, .tsv, .clf o .elf) da Amazon S3, crea un manifest per Quick Sight. Quick Sight utilizza questo manifesto per identificare i file che desideri utilizzare e per le impostazioni di caricamento necessarie per importarli. Quando crei un set di dati mediante Amazon S3, i dati del file vengono automaticamente importati in [SPICE](spice.md). Devi concedere l'accesso Quick Sight a tutti i bucket Amazon S3 da cui desideri leggere i file. Per informazioni sulla concessione dell'accesso Quick Sight alle AWS risorse, consulta. [Configurazione dell'accesso Amazon Quick Sight alle fonti di AWS dati](access-to-aws-resources.md) **Topics** + [Formati supportati per i file manifesto di Amazon S3](supported-manifest-file-format.md) + [Creazione di set di dati Amazon S3](create-a-data-set-s3-procedure.md) + [Set di dati che utilizzano file S3 in un altro account AWS](using-s3-files-in-another-aws-account.md) # Formati supportati per i file manifesto di Amazon S3 Utilizzi i file manifest JSON per specificare i file in Amazon S3 da importare in Quick Sight. Questi file manifest JSON possono utilizzare il formato Quick Sight descritto di seguito o il formato Amazon Redshift descritto [in Uso di un manifesto per specificare file di dati nella](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html) *Amazon Redshift* Database Developer Guide. Non è necessario utilizzare Amazon Redshift per utilizzare il formato del file manifesto di Amazon Redshift. Se utilizzi un file manifest Quick Sight, deve avere un'estensione.json, ad esempio. `my_manifest.json` Se usi un file manifesto di Amazon Redshift, tale file può avere un'estensione qualsiasi. Se utilizzi un file manifest di Amazon Redshift, Quick Sight elabora l'`mandatory`opzione opzionale come Amazon Redshift. Se il file associato non viene trovato, Quick Sight termina il processo di importazione e restituisce un errore. I file selezionati per l'importazione devono essere file di testo delimitato (ad esempio, .csv o .tsv), file di log (.clf) o file di log esteso (.elf) oppure devono essere in formato JSON (.json). Tutti i file specificati in un file manifest devono utilizzare lo stesso formato di file. Inoltre, devono avere lo stesso numero e tipo di colonne. Quick Sight supporta la codifica dei file UTF-8, ma non UTF-8 con il byte-order mark (BOM). Se stai importando i file JSON, per `globalUploadSettings` è necessario specificare `format`, ma non `delimiter`, `textqualifier` o `containsHeader`. Assicurati che tutti i file che specifichi si trovino nei bucket Amazon S3 a cui hai concesso l'accesso Quick Sight. Per informazioni sulla concessione dell'accesso Quick Sight alle AWS risorse, consulta. [Configurazione dell'accesso Amazon Quick Sight alle fonti di AWS dati](access-to-aws-resources.md) ## Formato di file manifesto per Quick Sight I file manifest Quick Sight utilizzano il seguente formato JSON. ``` { "fileLocations": [ { "URIs": [ "uri1", "uri2", "uri3" ] }, { "URIPrefixes": [ "prefix1", "prefix2", "prefix3" ] } ], "globalUploadSettings": { "format": "JSON", "delimiter": ",", "textqualifier": "'", "containsHeader": "true" } } ``` Utilizza i campi dell'elemento `fileLocations` per specificare i file da importare e i campi nell'elemento `globalUploadSettings` per specificare le impostazioni di importazione per tali file, ad esempio i delimitatori di campo. Gli elementi del file manifest sono descritti di seguito: + **fileLocations**: utilizza questo elemento per specificare i file da importare A tale scopo, puoi usare uno degli array `URIs` e `URIPrefixes` oppure entrambi. Devi specificare almeno un valore in uno dei due array. + **URIs**— Utilizzate questo array URIs per elencare i file specifici da importare. Quick Sight può accedere ai file Amazon S3 presenti in qualsiasi file. Regione AWS Tuttavia, devi utilizzare un formato URI che identifichi la AWS regione del bucket Amazon S3 se è diverso da quello utilizzato dal tuo account Quick. URIs sono supportati nei seguenti formati. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/supported-manifest-file-format.html) + **URIPrefixes**— Usa questo array per elencare i prefissi URI per i bucket e le cartelle S3. Tutti i file contenuti in un bucket o in una cartella specificati vengono importati. Quick Sight recupera in modo ricorsivo i file dalle cartelle secondarie. Quick Sight può accedere a bucket o cartelle Amazon S3 presenti in qualsiasi cartella. Regione AWS Assicurati di utilizzare un formato di prefisso URI che identifichi il bucket S3 Regione AWS se è diverso da quello utilizzato dal tuo account Quick. Sono supportati i prefissi URI nei formati seguenti. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/supported-manifest-file-format.html) + **globalUploadSettings**— (Facoltativo) Utilizza questo elemento per specificare le impostazioni di importazione per i file Amazon S3, come i delimitatori di campo. Se questo elemento non è specificato, Quick Sight utilizza i valori predefiniti per i campi di questa sezione. **Importante** Per i file di log (.clf) e i file di log esteso (.elf), è applicabile solo il campo **format (formato)** in questa sezione. Pertanto puoi ignorare gli altri campi. Se scegli di includerli, i relativi valori vengono ignorati. + **format**: (facoltativo) specifica il formato dei file da importare. I formati validi sono **CSV**, **TSV**, **CLF**, **ELF** e **JSON**. Il valore predefinito è **CSV**. + **delimiter**: (facoltativo) specifica il delimitatore dei campi dei file. Questo valore deve essere mappato al tipo di file specificato nel campo `format`. I formati validi sono virgole (**,**) per i file .csv e le tabulazioni (**\$1t**) per i file .tsv. Il valore predefinito è la virgola (**,**). + **textqualifier**: (facoltativo) specifica il qualificatore del file di testo. I formati validi usano le virgolette singole (**'**) e le virgolette doppie (**\$1"**). La barra rovesciata iniziale è un carattere di escape obbligatorio per la virgoletta doppia in JSON. Il valore predefinito è la virgoletta doppia (**\$1"**). Se il testo non richiede un qualificatore, non includere questa proprietà. + **containsHeader**: (facoltativo) specifica se il file include una riga di intestazione. I formati validi sono **true** o **false**. Il valore predefinito è **true**. ### Esempi di file manifest per Quick Sight Di seguito sono riportati alcuni esempi di file manifest Quick Sight completati. L'esempio seguente mostra un file manifest che identifica due file .csv specifici per l'importazione. Questi file usano le doppie virgolette come qualificatori del testo. I campi `format`, `delimiter` e `containsHeader` vengono ignorati perché i valori predefiniti sono accettabili. ``` { "fileLocations": [ { "URIs": [ "https://yourBucket.s3.amazonaws.com/data-file.csv", "https://yourBucket.s3.amazonaws.com/data-file-2.csv" ] } ], "globalUploadSettings": { "textqualifier": "\"" } } ``` L'esempio seguente mostra un file manifest che identifica due file .tsv specifici per l'importazione. Questo file include anche un bucket in un'altra regione AWS che contiene ulteriori file .tsv per l'importazione. I campi `textqualifier` e `containsHeader` vengono ignorati perché i valori predefiniti sono accettabili. ``` { "fileLocations": [ { "URIs": [ "https://s3.amazonaws.com/amzn-s3-demo-bucket/data.tsv" ] }, { "URIPrefixes": [ "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/" ] } ], "globalUploadSettings": { "format": "TSV", "delimiter": "\t" } } ``` L'esempio seguente identifica due bucket contenenti file .clf per l'importazione. Uno è Regione AWS uguale all'account Quick e l'altro è diverso Regione AWS. I campi `delimiter`, `textqualifier` e `containsHeader` vengono ignorati perché non sono validi per i file di log. ``` { "fileLocations": [ { "URIPrefixes": [ "https://amzn-s3-demo-bucket1.your-s3-url.com", "s3://amzn-s3-demo-bucket2/" ] } ], "globalUploadSettings": { "format": "CLF" } } ``` L'esempio seguente usa il formato Amazon Redshift per identificare un file .csv per l'importazione. ``` { "entries": [ { "url": "https://amzn-s3-demo-bucket.your-s3-url.com/myalias-test/file-to-import.csv", "mandatory": true } ] } ``` L'esempio seguente usa il formato Amazon Redshift per identificare due file JSON per l'importazione. ``` { "fileLocations": [ { "URIs": [ "https://yourBucket.s3.amazonaws.com/data-file.json", "https://yourBucket.s3.amazonaws.com/data-file-2.json" ] } ], "globalUploadSettings": { "format": "JSON" } } ``` # Creazione di set di dati Amazon S3 **Creazione di un set di dati di Amazon S3** 1. Consulta [Quote di origini dati](data-source-limits.md) per assicurarti che il set di file di destinazione non superi i limiti relativi all'origine dati. 1. Creare un file manifest per individuare i file di testo da importare, utilizzando uno dei formati specificati in [Formati supportati per i file manifesto di Amazon S3](supported-manifest-file-format.md). 1. È possibile salvare il file manifesto in una directory locale o caricarlo in Amazon S3. 1. **Nella pagina di avvio rapido, scegli Dati.** 1. Nella pagina **Dati**, scegli **Crea**, quindi **Nuovo set** di dati. 1. **Scegli l'icona Amazon S3, quindi scegli Avanti.** 1. In **Data source name (Nome origine dati)** immettere una descrizione dell'origine dati. Il valore immesso deve essere un nome che aiuti a differenziare l'origine dati associata dalle altre. 1. Per **Upload a manifest file (Carica un file manifest)**, procedere in uno dei seguenti modi: + Per usare un file manifest locale, scegliere **Upload (Carica)**, quindi scegliere **Upload a JSON manifest file (Carica un file manifest JSON)**. Per **Open (Apri)**, scegliere un file, quindi scegliere **Open (Apri)**. + Per usare un file manifesto da Amazon S3, scegli **URL**, quindi immetti l'URL del file manifesto. Per trovare l'URL di un file manifesto preesistente nella console Amazon S3, passa al file appropriato e selezionalo. Nel pannello delle proprietà visualizzato è incluso l'URL del collegamento. Puoi copiare l'URL e incollarlo in Quick Sight. 1. Scegli **Connetti**. 1. Per assicurarsi che la connessione sia stata completata, scegliere **Edit/Preview data (Modifica/Anteprima dati)**. In alternativa, scegliere **Visualize (Visualizza)** per creare un'analisi utilizzando i dati senza modificarli. Se è stata scelta l'opzione **Modifica/Anteprima dati**, sarà possibile specificare un nome per il set di dati durante la preparazione dei dati. In caso contrario, il nome del set di dati corrisponde al nome del file manifesto. Per ulteriori informazioni sulla preparazione dei dati, consulta [Preparazione dei dati in Amazon Quick Sight](preparing-data.md). ## Creazione di set di dati basati su più file Amazon S3 Puoi utilizzare uno dei diversi metodi per unire o combinare file dai bucket Amazon S3 all'interno di Quick Sight: + **Combinazione di file mediante un manifesto**: in questo caso, i file devono avere lo stesso numero di colonne. I tipi di dati devono corrispondere tra i campi nella stessa posizione all'interno del file. Ad esempio, il primo campo deve avere lo stesso tipo di dati in ogni file. Lo stesso vale per il secondo e il terzo campo e così via. Quick Sight prende i nomi dei campi dal primo file. I file devono essere elencati in modo esplicito nel manifest. Tuttavia, non devono necessariamente trovarsi all'interno dello stesso bucket Amazon S3. I file devono inoltre essere conformi alle regole descritte in [Formati supportati per i file manifesto di Amazon S3](supported-manifest-file-format.md). Per ulteriori informazioni sulla combinazione di file utilizzando un manifest, consulta [Creazione di un set di dati utilizzando file Amazon S3](create-a-data-set-s3.md). + **Unione di file senza l'uso di un manifesto**: per unire più file in un unico file senza doverli elencare singolarmente nel manifesto, puoi usare Athena. Grazie a questo metodo, puoi eseguire una query sui file di testo come se fossero inclusi in una tabella di un database. Per ulteriori informazioni, consulta il post [Analisi dei dati in Amazon S3 mediante Athena](https://aws.amazon.com/blogs/big-data/analyzing-data-in-s3-using-amazon-athena/) nel blog sui big data. + **Utilizzo di uno script per aggiungere file prima dell'importazione**: puoi utilizzare uno script sviluppato per combinare i file prima del caricamento. # Set di dati che utilizzano file S3 in un altro account AWS Utilizza questa sezione per scoprire come configurare la sicurezza in modo da poter utilizzare Quick Sight per accedere ai file Amazon S3 in un altro AWS account. Per poter accedere ai file in un altro account, il proprietario dell'altro account deve prima configurare Amazon S3 in modo da concedere agli utenti interessati le autorizzazioni necessarie per leggere i file. Quindi, in Quick Sight, devi configurare l'accesso ai bucket che sono stati condivisi con te. Dopo aver completato entrambi questi passaggi, sarà possibile utilizzare un manifesto per creare un set di dati. **Nota** Per accedere ai file condivisi con il pubblico, non è necessario configurare livelli di sicurezza particolari. Tuttavia, è necessario un file manifest. **Topics** + [Configurazione di Amazon S3 per consentire l'accesso da un altro account Quick](#setup-S3-to-allow-access-from-a-different-quicksight-account) + [Configurazione di Quick Sight per accedere ai file Amazon S3 da un altro account AWS](#setup-quicksight-to-access-S3-in-a-different-account) ## Configurazione di Amazon S3 per consentire l'accesso da un altro account Quick Utilizza questa sezione per scoprire come impostare le autorizzazioni nei file Amazon S3 in modo che Quick Sight possa accedervi da un altro account. AWS Per informazioni sull'accesso ai file Amazon S3 di un altro account dal tuo account Quick Sight, consulta. [Configurazione di Quick Sight per accedere ai file Amazon S3 da un altro account AWS](#setup-quicksight-to-access-S3-in-a-different-account) Per ulteriori informazioni sulle autorizzazioni S3, consulta [Gestione delle autorizzazioni di accesso alle risorse di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html) e [Come impostare le autorizzazioni per un oggetto?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/set-object-permissions.html). Puoi utilizzare la procedura seguente per impostare questo accesso dalla console S3. Oppure puoi concedere le autorizzazioni utilizzando AWS CLI o scrivendo uno script. Se non è presente un gran numero di file da condividere, puoi creare una policy del bucket S3 nell'operazione `s3:GetObject`. Per usare una policy del bucket, aggiungerla alle autorizzazioni del bucket e non alle autorizzazioni per i file. Per informazioni sulle policy dei bucket, consulta [Esempi di policy dei bucket](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) nella *Guida per lo sviluppatore di Amazon S3*. **Per impostare l'accesso da un altro account Quick dalla console S3** 1. Ottieni l'indirizzo e-mail dell' AWS account con cui desideri condividere. In alternativa, è possibile recuperare e utilizzare il normale ID utente. *Per ulteriori informazioni sull'utente canonico IDs, consulta gli [identificatori AWS dell'account nella AWS Guida](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html) generale.* 1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Trova il bucket Amazon S3 che desideri condividere con Quick Sight. Seleziona **Autorizzazioni**. 1. Scegli **Aggiungi account**, quindi inserisci un indirizzo e-mail o incolla un ID utente canonico per l' AWS account con cui desideri condividere. Questo indirizzo e-mail dovrebbe essere quello principale per l'account AWS . 1. Scegliere **Yes (Sì)** sia per **Read bucket permissions (Autorizzazioni lettura bucket)** che per **List objects (Oggetti List)**. Seleziona **Save (Salva)** per confermare. 1. Individuare il file da condividere e aprire le impostazioni relative alle autorizzazioni del file. 1. Inserisci un indirizzo email o l'ID utente canonico per l' AWS account con cui desideri condividere. Questo indirizzo email deve essere quello principale dell' AWS account. 1. Abilita **le autorizzazioni di lettura degli oggetti** per ogni file a cui Quick Sight deve accedere. 1. Notifica all'utente Quick che i file sono ora disponibili per l'uso. ## Configurazione di Quick Sight per accedere ai file Amazon S3 da un altro account AWS Utilizza questa sezione per scoprire come configurare Quick Sight in modo da poter accedere ai file Amazon S3 da un altro AWS account. Per informazioni su come consentire a qualcun altro di accedere ai tuoi file Amazon S3 dal proprio account Quick, consulta. [Configurazione di Amazon S3 per consentire l'accesso da un altro account Quick](#setup-S3-to-allow-access-from-a-different-quicksight-account) Utilizza la seguente procedura per accedere ai file Amazon S3 di un altro account da Quick Sight. Per utilizzare questa procedura, gli utenti nell'altro account AWS devono condividere con te i file nel proprio bucket Amazon S3. **Per accedere ai file Amazon S3 di un altro account da Quick Sight** 1. Verifica che l'utente o gli utenti dell'altro AWS account abbiano concesso al tuo account l'autorizzazione di lettura e scrittura per il bucket S3 in questione. 1. Scegli l'icona del tuo profilo, quindi scegli **Manage Quick** Sight. 1. Scegli **Sicurezza e autorizzazioni**. 1. In **Accesso Quick Sight ai AWS servizi**, scegli **Gestisci**. 1. Scegli **Select S3 bucket**. 1. Nella schermata **Seleziona bucket Amazon S3** scegli la scheda **Bucket S3 accessibili in AWS**. La scheda predefinita è denominata **bucket S3 collegati all'account Quick Sight**. Mostra tutti i bucket a cui ha accesso il tuo account Quick. 1. Esegui una delle seguenti operazioni: + Per aggiungere tutti i bucket autorizzati per l'utilizzo, scegli **Scegli bucket accessibili da altri account AWS **. + Se hai uno o più bucket Amazon S3 da aggiungere, inserisci i loro nomi. Il nome immesso deve corrispondere esattamente al nome univoco del bucket Amazon S3. Se non si dispone delle autorizzazioni appropriate, verrà visualizzato il messaggio di errore "We can't connect to this S3 bucket. Assicurati che tutti i bucket S3 che specifichi siano associati all' AWS account utilizzato per creare questo account Quick». Questo messaggio di errore viene visualizzato se non disponi delle autorizzazioni dell'account o delle autorizzazioni Quick Sight. **Nota** Per utilizzare Amazon Athena, Quick Sight deve accedere ai bucket Amazon S3 utilizzati da Athena. Puoi aggiungerli qui uno per uno o utilizzare l'**opzione Scegli i bucket accessibili** da altri account. AWS 1. Scegliere **Select buckets (Seleziona bucket)** per confermare la selezione. 1. Crea un nuovo set di dati basato su Amazon S3 e carica il file manifesto. Per ulteriori dettagli sui set di dati di Amazon S3, consulta [Creazione di un set di dati utilizzando file Amazon S3](create-a-data-set-s3.md).