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 Amazon QuickSight. Ces fichiers manifestes JSON peuvent utiliser le QuickSight format Amazon 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 QuickSight manifeste Amazon, 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, Amazon QuickSight traite l'mandatoryoption facultative comme le fait Amazon Redshift. Si le fichier associé n'est pas trouvé, Amazon QuickSight 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. Amazon QuickSight prend en charge le codage de fichiers UTF-8, mais pas l'UTF-8 (avec ap-south-1). 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' QuickSight accès à Amazon. Pour plus d'informations sur l'octroi à Amazon de l' QuickSight accès aux AWS ressources, consultezAccès aux sources de données.

Format de fichier manifeste pour Amazon QuickSight

Les fichiers QuickSight manifestes Amazon 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.

• fileLocations – Cet élément permet de spécifier les fichiers à importer. Pour ce faire, vous pouvez utiliser l'un ou l'autre des tableaux URIs et URIPrefixes, ou les deux. Vous devez spécifier au moins une valeur dans une ou l'autre de ces tableaux.

  • URI – Utilisez ce tableau pour répertorier les URI de fichiers spécifiques à importer.

    Amazon QuickSight peut accéder aux fichiers Amazon S3 qui se trouvent dans n'importe quel fichier Région AWS. Toutefois, vous devez utiliser un format d'URI qui identifie la AWS région du compartiment Amazon S3 s'il est différent de celui utilisé par votre QuickSight compte Amazon.

    Les URI aux formats suivants sont pris en charge :

    Format URI	Exemple	Commentaires
    https://s3.amazonaws.com/<nom du compartiment>/<nom du fichier>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<nom du compartiment>/<nom du fichier>	s3://awsexamplebucket/data.csv
    https://<nom du compartiment>.s3.amazonaws.com/<nom du fichier>	https://exemple_compartiment_aws.s3.amazonaws.com/data.csv
    https://s3-<nom de la région>.amazonaws.com/<nom du compartiment>/<nom du fichier>	https://s3-us-east-1.amazonaws.com/exemple_compartiment_aws/data.csv	Ce type d'URI identifie la région Région AWS pour le compartiment Amazon S3.
    https://<nom du compartiment>.s3-<nom de la région>.amazonaws.com/<nom du fichier>	https://exemple_compartiment_aws.s3-us-east-1.amazonaws.com/data.csv	Ce type d'URI identifie le Région AWS compartiment Amazon S3.

  • URIPrefixes – Utilisez ce tableau pour répertorier les préfixes d'URI pour les compartiments et dossiers S3. Tous les fichiers d'un compartiment ou d'un dossier spécifié sont importés. Amazon récupère les fichiers QuickSight de manière récursive à partir de dossiers enfants.

    QuickSight peut accéder aux compartiments ou dossiers Amazon S3 qui se trouvent dans n'importe quel Région AWScompartiment. Assurez-vous d'utiliser un format de préfixe d'URI qui identifie le compartiment S3 Région AWS s'il est différent de celui utilisé par votre QuickSight compte.

    Les préfixes d'URI aux formats suivants sont pris en charge :

    Format du préfixe d'URI	Exemple	Commentaires
    https://s3.amazonaws.com/<nom du compartiment>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<nom du compartiment>/<nom du dossier1>/(<nom du dossier2>/etc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<nom du compartiment>	s3://awsexamplebucket/
    s3://<nom du compartiment>/<nom du dossier1>/(<nom du dossier2>/etc.)	s3://awsexamplebucket/folder1/
    https://<nom du compartiment>.s3.amazonaws.com	https://exemple_compartiment_aws.s3.amazonaws.com
    https://s3-<nom de la région>.amazonaws.com/<nom du compartiment>/	https://s3 - your-region-for-example-us-east-2. amazonaws.com/ awsexamplebucket/	Ce URIPrefix type identifie Région AWS le compartiment Amazon S3.
    https://s3-<nom de la région>.amazonaws.com/<nom du compartiment>/<nom du dossier1>/(<nom du dossier2>/etc.)	https://s3-us-east-1.amazonaws.com/exemple_compartiment_aws/folder1/	Ce URIPrefix type identifie Région AWS le compartiment Amazon S3.
    https://<nom du compartiment>.s3-<nom de la région>.amazonaws.com	https://exemple_compartiment_aws.s3-us-east-1.amazonaws.com	Ce URIPrefix type identifie Région AWS le compartiment Amazon S3.

• globalUploadSettings— (Facultatif) Utilisez cet élément pour spécifier les paramètres d'importation pour les fichiers Amazon S3, tels que les délimiteurs de champs. Si cet élément n'est pas spécifié, Amazon QuickSight utilise les valeurs par défaut pour les champs de cette section.

  Important

  Pour les fichiers journaux (.clf) et les journaux étendus (.elf), seul le champ format dans cette section s'applique, vous pouvez donc ignorer les autres champs. Si vous décidez de les inclure, leurs valeurs sont ignorées.

  • format – (Facultatif) Spécifiez le format des fichiers à importer. Les formats valides sont CSV, TSV, CLF, ELF et JSON. La valeur par défaut est CSV.

  • délimiteur – (Facultatif) Spécifiez le délimiteur de champs du fichier. Celui-ci doit correspondre au type de fichier spécifié dans le champ format. Les formats valides sont les virgules (,) pour les fichiers .csv et les tabulations (\t) pour les fichiers .tsv. La valeur par défaut est la virgule (,).

  • textqualifier – (facultatif) Spécifiez le qualificateur de texte de fichier. Les formats valables sont les guillemets simples ('), les guillemets doubles (\"). La barre oblique inverse de début est un caractère d'échappement obligatoire pour les guillemets dans JSON. La valeur par défaut est guillemets (\"). Si votre texte n'a pas besoin d'un qualificateur de texte, n'incluez pas cette propriété.

  • containsHeader – (facultatif) Spécifiez si le fichier possède une ligne d'en-tête. Les formats valides sont true ou false. La valeur par défaut est true.

Exemples de fichiers manifestes pour Amazon QuickSight

Voici quelques exemples de fichiers QuickSight manifestes Amazon 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/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}

L'exemple suivant identifie deux compartiments qui contiennent des fichiers .clf pour l'importation. L'un est dans le Région AWS même QuickSight compte Amazon 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://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

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

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