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 dei file UTF-8, ma non UTF-8 (con ap-south-1). 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:

• 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: utilizza questo array per elencare gli URI per i file da importare.

    Amazon QuickSight può accedere ai file Amazon S3 presenti in qualsiasi file. Regione AWSTuttavia, devi utilizzare un formato URI che identifichi la AWS regione del bucket Amazon S3 se è diverso da quello utilizzato dal tuo account Amazon. QuickSight

    Sono supportati gli URI nei formati seguenti.

    Formato URI	Esempio	Commenti
    https://s3.amazonaws.com/<nome bucket>/<nome file>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<nome bucket>/<nome file>	s3://awsexamplebucket/data.csv
    https://<nome bucket>.s3.amazonaws.com/<nome file>	https://awsexamplebucket.s3.amazonaws.com/data.csv
    https://s3-<nome regione>.amazonaws.com/<nome bucket>/<nome file>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	Questo tipo di URI identifica la Regione AWS per il bucket Amazon S3.
    https://<nome bucket>.s3-<nome regione>.amazonaws.com/<nome file>	https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv	Questo tipo di URI identifica Regione AWS il bucket Amazon S3.

  • URIPrefixes: Utilizza questo array per elencare i prefissi URI per bucket e cartelle S3. Tutti i file contenuti in un bucket o in una cartella specificati vengono importati. Amazon QuickSight recupera in modo ricorsivo i file dalle cartelle secondarie.

    QuickSight può accedere a bucket o cartelle Amazon S3 presenti in qualsiasi cartella. Regione AWSAssicurati di utilizzare un formato di prefisso URI che identifichi il bucket S3 Regione AWS se è diverso da quello utilizzato dal tuo account. QuickSight

    Sono supportati i prefissi URI nei formati seguenti.

    Formato del prefisso URI	Esempio	Commenti
    https://s3.amazonaws.com/<nome bucket>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<nome bucket>/<nome cartella 1>/(<nome cartella 2>/ecc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<nome bucket>	s3://awsexamplebucket/
    s3://<nome bucket>/<nome cartella 1>/(<nome cartella 2>/ecc.)	s3://awsexamplebucket/folder1/
    https://<bucket name>.s3.amazonaws.com	https://awsexamplebucket.s3.amazonaws.com
    https://s3-<nome regione>.amazonaws.com/<nome bucket>/	https://s3 - -us-east-2. your-region-for-example amazonaws.com/awsexamplebucket/	Questo URIPrefix tipo identifica Regione AWS il bucket Amazon S3.
    https://s3-<nome regione>.amazonaws.com/<nome bucket>/<nome cartella 1>/(<nome cartella 2>/ecc.)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	Questo URIPrefix tipo identifica Regione AWS il bucket Amazon S3.
    https://<nome bucket>.s3-<nome regione>.amazonaws.com	https://awsexamplebucket.s3-us-east-1.amazonaws.com	Questo URIPrefix tipo identifica Regione AWS il bucket Amazon S3.

• 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, Amazon QuickSight 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 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/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "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://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

L'esempio seguente usa il formato Amazon Redshift per identificare un file .csv per l'importazione.

{
    "entries": [
        {
            "url": "https://awsexamplebucket.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"
    }
}