Formatos compatibles con los archivos de manifiesto de Amazon S3

Los archivos de manifiesto JSON se utilizan para especificar los archivos de Amazon S3 que se van a importar a Amazon QuickSight. Estos archivos de manifiesto JSON pueden usar el formato de Amazon que se describe a continuación o el QuickSight formato de Amazon Redshift que se describe en Uso de un manifiesto para especificar archivos de datos de la Guía para desarrolladores de bases de datos de Amazon Redshift. No es necesario utilizar Amazon Redshift para utilizar el formato de archivo de manifiesto de Amazon Redshift.

Si utilizas un archivo de QuickSight manifiesto de Amazon, debe tener la extensión.json, por ejemplomy_manifest.json. Si utiliza un archivo de manifiesto de Amazon Redshift, puede tener cualquier extensión.

Si utiliza un archivo de manifiesto de Amazon Redshift, Amazon QuickSight procesa la mandatory opción opcional igual que Amazon Redshift. Si no se encuentra el archivo asociado, Amazon QuickSight finaliza el proceso de importación y devuelve un error.

Los archivos que seleccione para la importación deben ser de formato de texto delimitado (por ejemplo, .csv o .tsv), de registro (.clf) o de registro ampliado (.elf), o JSON (.json). Todos los archivos identificados en un archivo de manifiesto deben utilizar el mismo formato de archivo. Además, deben tener el mismo número y tipo de columnas. Amazon QuickSight admite la codificación de archivos en UTF-8, pero no en UTF-8 (con ap-south-1). Si va a importar archivos JSON, para globalUploadSettings especifique format, pero no delimiter, textqualifier ni containsHeader.

Asegúrese de que todos los archivos que especifique estén en los buckets de Amazon S3 a los que ha concedido QuickSight acceso a Amazon. Para obtener información sobre cómo conceder QuickSight a Amazon acceso a AWS los recursos, consulteAcceso a orígenes de datos.

Formato de archivo de manifiesto para Amazon QuickSight

Los archivos de QuickSight manifiesto de Amazon utilizan el siguiente formato JSON.

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

Utilice los campos del elemento fileLocations para especificar los archivos que desea importar y los campos del elemento globalUploadSettings para especificar la configuración de importación de dichos archivos, como delimitadores de campo.

A continuación se describen los elementos del archivo de manifiesto.

• fileLocations: utilice este elemento para especificar los archivos que desea importar. Puede utilizar una de las matrices URIs y URIPrefixes o las dos para hacerlo. Debe especificar al menos un valor en una o la otra.

  • URIs: utilice esta matriz para enumerar los URI para los archivos específicos que se van a importar.

    Amazon QuickSight puede acceder a los archivos de Amazon S3 que estén en cualquier archivo Región de AWS. Sin embargo, debe utilizar un formato de URI que identifique la AWS región del bucket de Amazon S3 si es diferente del que utiliza su QuickSight cuenta de Amazon.

    Se admiten URI que tengan los siguientes formatos.

    Formato de URI	Ejemplo	Comentarios
    https://s3.amazonaws.com/<nombre bucket>/<nombre archivo>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<nombre bucket>/<nombre archivo>	s3://awsexamplebucket/data.csv
    https://<nombre bucket>.s3.amazonaws.com/<nombre archivo>	https://awsexamplebucket.s3.amazonaws.com/data.csv
    https://s3-<nombre región>.amazonaws.com/<nombre bucket>/<nombre archivo>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	Este tipo de URI identifica la Región de AWS del bucket de Amazon S3.
    https://<nombre bucket>.s3-<nombre región>.amazonaws.com/<nombre archivo>	https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv	Este tipo de URI identifica Región de AWS el bucket de Amazon S3.

  • URIPrefixes: utilice esta matriz para obtener una lista de prefijos de URI para buckets y carpetas de S3. Se importan todos los archivos de un bucket o carpeta especificados. Amazon recupera de QuickSight forma recursiva los archivos de las carpetas secundarias.

    QuickSight puede acceder a los buckets o carpetas de Amazon S3 que se encuentren en cualquiera Región de AWSde ellos. Asegúrese de usar un formato de prefijo URI que identifique el bucket de S3 Región de AWS si es diferente del que usa su QuickSight cuenta.

    Se admiten los prefijos URI que tengan los siguientes formatos.

    Formato de prefijo de URI	Ejemplo	Comentarios
    https://s3.amazonaws.com/<nombre bucket>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<nombre bucket>/<nombre carpeta1>/(<nombre carpeta2>/etc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<nombre bucket>	s3://awsexamplebucket/
    s3://<nombre bucket>/<nombre carpeta1>/(<nombre carpeta2>/etc.)	s3://awsexamplebucket/folder1/
    https://<nombre bucket>.s3.amazonaws.com	https://awsexamplebucket.s3.amazonaws.com
    https://s3-<nombre región>.amazonaws.com/<nombre bucket>/	https://s3 - your-region-for-example-us-east-2. amazonaws.com/ awsexamplebucket/	Este URIPrefix tipo identifica Región de AWS el bucket de Amazon S3.
    https://s3-<nombre región>.amazonaws.com/<nombre bucket>/<nombre carpeta1>/(<nombre carpeta2>/etc.)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	Este URIPrefix tipo identifica Región de AWS el bucket de Amazon S3.
    https://<nombre bucket>.s3-<nombre región>.amazonaws.com	https://awsexamplebucket.s3-us-east-1.amazonaws.com	Este URIPrefix tipo identifica Región de AWS el bucket de Amazon S3.

• globalUploadSettings— (Opcional) Utilice este elemento para especificar la configuración de importación de los archivos de Amazon S3, como los delimitadores de campo. Si no se especifica este elemento, Amazon QuickSight utilizará los valores predeterminados para los campos de esta sección.

  importante

  Para archivos de registro (.clf) y registro ampliado (.elf), solo se aplica el campo format de esta sección, por lo que puede omitir el resto de los campos. Si decide incluirlos, sus valores se omiten.

  • format: (opcional) especifique el formato de los archivos que se van a importar. Los formatos válidos son CSV, TSV, CLF, ELF y JSON. El valor predeterminado es CSV.

  • delimiter: (opcional) especifique el delimitador de campo del archivo. Este debe asignarse al tipo de archivo especificado en el campo format. Los formatos válidos son comas (,) para los archivos .csv y tabuladores (\t) para los archivos .tsv. El valor predeterminado es coma (,).

  • textqualifier: (opcional) especifique el calificador de texto del archivo. Los formatos válidos son comillas simples (') y comillas dobles (\"). La barra diagonal inversa inicial es un carácter de escape obligatorio para las comillas dobles en JSON. El valor predeterminado es las comillas dobles (\"). Si el texto no necesita un calificador de texto, no incluya esta propiedad.

  • containsHeader: (opcional) especifique si el archivo tiene una fila de encabezado. Los formatos válidos son true o false. El valor predeterminado es true.

Ejemplos de archivos de manifiesto para Amazon QuickSight

A continuación se muestran algunos ejemplos de archivos de QuickSight manifiesto de Amazon completados.

El siguiente ejemplo muestra un archivo de manifiesto que identifica dos archivos .csv específicos para su importación. Estos archivos utilizan comillas dobles como calificadores de texto. Los campos format, delimitery containsHeader se omiten porque los valores predeterminados son aceptables.

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

El siguiente ejemplo muestra un archivo de manifiesto que identifica un archivo .tsv específico para su importación. Este archivo también incluye un bucket en otra región de AWS que contiene archivos .tsv adicionales para la importación. Los campos textqualifier y containsHeader se omiten porque los valores predeterminados son aceptables.

{
    "fileLocations": [
        {
            "URIs": [
                "https://s3.amazonaws.com/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}

El siguiente ejemplo identifica dos buckets que contienen archivos .clf para su importación. Uno está en la Región de AWS misma QuickSight cuenta de Amazon y el otro en una diferente Región de AWS. Los campos delimiter, textqualifier y containsHeader se omiten porque no son aplicables a los archivos de registro.

{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

En el siguiente ejemplo, se utiliza el formato de Amazon Redshift para identificar un archivo .csv que importar.

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

En el siguiente ejemplo, se utiliza el formato de Amazon Redshift para identificar dos archivos JSON que importar.

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