Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Formats pris en charge pour les fichiers manifestes Amazon S3

Vous utilisez des fichiers manifestes JSON pour spécifier les fichiers dans Amazon S3 à importer dans Quick Sight. Ces fichiers manifestes JSON peuvent utiliser le format Quick Sight décrit ci-dessous ou le format Amazon Redshift décrit dans Utilisation d'un manifeste pour spécifier des fichiers de données dans le manuel Amazon Redshift Database Developer Guide. Il n’est pas nécessaire de faire appel à Amazon Redshift pour utiliser le format de fichier manifeste Amazon Redshift.

Si vous utilisez un fichier manifeste Quick Sight, il doit avoir une extension .json, par exemplemy_manifest.json. Si vous utilisez un fichier manifeste Amazon Redshift il peut avoir n’importe quelle extension.

Si vous utilisez un fichier manifeste Amazon Redshift, Quick Sight traite l'mandatoryoption facultative comme le fait Amazon Redshift. Si le fichier associé n'est pas trouvé, Quick Sight met fin au processus d'importation et renvoie un message d'erreur.

Les fichiers que vous sélectionnez pour l’importation doivent être au format texte délimité (par exemple, .csv ou .tsv), au format de fichier journal (.clf) ou journal étendu (.elf), ou au format JSON (.json). Tous les fichiers identifiés dans un fichier manifeste doivent utiliser le même format de fichier. Ils doivent également avoir le même nombre et le même type de colonnes. Quick Sight prend en charge le codage de fichiers UTF-8, mais pas l'UTF-8 avec marque d'ordre d'octet (BOM). Si vous importez des fichiers JSON, pour globalUploadSettings vous devez spécifier format, mais pas delimiter, textqualifier ou containsHeader.

Assurez-vous que tous les fichiers que vous spécifiez se trouvent dans des compartiments Amazon S3 auxquels vous avez accordé l'accès à Quick Sight. Pour plus d'informations sur l'octroi à Quick Sight de l'accès aux AWS ressources, consultezConfiguration de l'accès aux sources de AWS données par Amazon Quick Sight.

Format de fichier manifeste pour Quick Sight

Les fichiers manifestes Quick Sight utilisent le format JSON suivant.

{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
                            

Utilisez les champs dans l’élément fileLocations pour spécifier les fichiers à importer et les champs dans l’élément globalUploadSettings pour spécifier les paramètres d’importation pour ces fichiers, tels que les délimiteurs de champs.

Les éléments du fichier manifeste sont décrits ci-après.

Exemples de fichiers manifestes pour Quick Sight

Voici quelques exemples de fichiers manifestes Quick Sight terminés.

L’exemple suivant montre un fichier manifeste qui identifie deux fichiers .csv spécifiques pour l’importation. Ces fichiers utilisent des guillemets comme qualificateurs de texte. Les champs format, delimiter et containsHeader sont ignorés, car les valeurs par défaut sont acceptables.

{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.csv",
                "https://yourBucket.s3.amazonaws.com/data-file-2.csv"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}

L’exemple suivant montre un fichier manifeste qui identifie un fichier .csv spécifique pour l’importation. Ce fichier inclut également un compartiment d’une autre région AWS contenant les fichiers .tsv supplémentaires à importer. Les champs textqualifier et containsHeader sont ignorés, car les valeurs par défaut sont acceptables.

{
    "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’exemple suivant identifie deux compartiments qui contiennent des fichiers .clf pour l’importation. L'un est Région AWS identique au compte Quick Suite et l'autre dans un compte différent Région AWS. Les champs delimiter, textqualifier et containsHeader sont ignorés, car ils ne concernent pas les fichiers journaux.

{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://amzn-s3-demo-bucket1.your-s3-url.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

L’exemple suivant utilise le format Amazon Redshift pour identifier un fichier .csv pour l’importation.

{
    "entries": [
        {
            "url": "https://amzn-s3-demo-bucket.your-s3-url.com/myalias-test/file-to-import.csv",
            "mandatory": true
        }
    ]
}

L’exemple suivant utilise le format Amazon Redshift pour identifier deux fichiers JSON pour l’importation.

{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.json",
                "https://yourBucket.s3.amazonaws.com/data-file-2.json"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}