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

# Formati supportati per i file manifesto di Amazon S3
<a name="supported-manifest-file-format"></a>

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
<a name="quicksight-manifest-file-format"></a>

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 (**\\t**) 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 (**\\"**). La barra rovesciata iniziale è un carattere di escape obbligatorio per la virgoletta doppia in JSON. Il valore predefinito è la virgoletta doppia (**\\"**). 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
<a name="quicksight-manifest-file-examples"></a>

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"
    }
}
```