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

Utilizzi i file manifest JSON per specificare i file in Amazon S3 da importare in Amazon. QuickSight Questi file manifest JSON possono utilizzare il QuickSight formato Amazon descritto di seguito o il formato Amazon Redshift descritto in Uso di un manifesto per specificare file di dati nella Amazon Redshift Database Developer Guide. Non è necessario utilizzare Amazon Redshift per utilizzare il formato del file manifesto di Amazon Redshift.

Se utilizzi un file QuickSight manifest Amazon, 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, Amazon QuickSight elabora l'mandatoryopzione opzionale come Amazon Redshift. Se il file associato non viene trovato, Amazon QuickSight 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. Amazon QuickSight supporta la codifica di file UTF-8, ma non UTF-8 con 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 ad Amazon QuickSight . Per informazioni su come concedere QuickSight ad Amazon l'accesso alle AWS risorse, consultaAccesso alle origini dati.

Formato di file manifesto per Amazon QuickSight

I file QuickSight manifest di Amazon 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:

Esempi di file manifest per Amazon QuickSight

Di seguito sono riportati alcuni esempi di file QuickSight manifest Amazon 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' QuickSight account Amazon 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"
    }
}