Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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 Quick Sight. Estos archivos de manifiesto JSON pueden utilizar el formato Quick Sight que se describe a continuación o el formato 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 utiliza un archivo de manifiesto de Quick Sight, debe tener la extensión.json, por ejemplo. my_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, Quick Sight procesa la mandatory opción opcional como lo hace Amazon Redshift. Si no encuentra el archivo asociado, Quick Sight 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. Quick Sight admite la codificación de archivos en UTF-8, pero no en UTF-8 con marca de orden de bytes (BOM). 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 acceso a Quick Sight. Para obtener información sobre cómo conceder a Quick Sight acceso a AWS los recursos, consulteConfiguración del acceso de Amazon Quick Sight a las fuentes AWS de datos.

Formato de archivo de manifiesto para Quick Sight

Los archivos de manifiesto de Quick Sight 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.

Ejemplos de archivos de manifiesto para Quick Sight

A continuación se muestran algunos ejemplos de archivos de manifiesto de Quick Sight 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/amzn-s3-demo-bucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/"
            ]
        }
    ],
    "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 cuenta de Quick Suite 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://amzn-s3-demo-bucket1.your-s3-url.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

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

{
    "entries": [
        {
            "url": "https://amzn-s3-demo-bucket.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"
    }
}