As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Formatos compatíveis para arquivos manifesto do Amazon S3
<a name="supported-manifest-file-format"></a>

Você usa arquivos de manifesto JSON para especificar arquivos no Amazon S3 a serem importados para o Quick Sight. Esses arquivos de manifesto JSON podem usar o formato Quick Sight descrito a seguir ou o formato do Amazon Redshift descrito [em Uso de um manifesto para especificar arquivos de dados no Guia do desenvolvedor do banco de dados](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html) do *Amazon Redshift*. Você não precisa usar o Amazon Redshift para utilizar o formato de arquivo manifesto do Amazon Redshift. 

Se você usar um arquivo de manifesto do Quick Sight, ele deverá ter uma extensão.json, por exemplo. `my_manifest.json` Se você usar um arquivo manifesto do Amazon Redshift, ele poderá ter qualquer extensão. 

Se você usa um arquivo de manifesto do Amazon Redshift, o Quick Sight processa a `mandatory` opção opcional da mesma forma que o Amazon Redshift. Se o arquivo associado não for encontrado, o Quick Sight encerrará o processo de importação e retornará um erro. 

Os arquivos selecionados para importação devem estar no formato de texto delimitado (por exemplo, .csv ou .tsv), log (.clf) ou log estendido (.elf), bem como JSON (.json). Todos os arquivos identificados em um arquivo manifesto devem ter o mesmo formato. Além disso, eles devem ter o mesmo número e tipo de colunas. O Quick Sight suporta codificação de arquivo UTF-8, mas não UTF-8 com marca de ordem de bytes (BOM). Se você estiver importando arquivos JSON, em `globalUploadSettings`, é necessário especificar `format`, mas não `delimiter`, `textqualifier` nem `containsHeader`.

Certifique-se de que todos os arquivos que você especificar estejam nos buckets do Amazon S3 aos quais você concedeu acesso ao Quick Sight. Para obter informações sobre como conceder acesso aos AWS recursos do Quick Sight, consulte[Configurando o acesso do Amazon Quick Sight às fontes de AWS dados](access-to-aws-resources.md).

## Formato de arquivo de manifesto para o Quick Sight
<a name="quicksight-manifest-file-format"></a>

Os arquivos de manifesto do Quick Sight usam o seguinte formato JSON.

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

Use os campos no elemento `fileLocations` para especificar os arquivos a serem importados e os campos no elemento `globalUploadSettings` para especificar as configurações de importação para esses arquivos, como delimitadores de campo. 

Os elementos do arquivo manifesto estão descritos a seguir:
+ **fileLocations**: use este elemento para especificar os arquivos a serem importados. Você pode usar um ou dois arrays `URIs` e `URIPrefixes` para fazer isso. Você deve especificar pelo menos um valor em um ou outro.
  + **URIs**— Use essa matriz URIs para listar os arquivos específicos a serem importados.

    O Quick Sight pode acessar arquivos do Amazon S3 que estão em qualquer arquivo. Região da AWS No entanto, você deve usar um formato de URI que identifique a AWS região do bucket do Amazon S3 se ela for diferente daquela usada pela sua conta Quick.

    URIs nos formatos a seguir são suportados.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/supported-manifest-file-format.html)
  + **URIPrefixes**— Use essa matriz para listar prefixos de URI para buckets e pastas do S3. Todos os arquivos em um bucket ou pasta especificados são importados. O Quick Sight recupera recursivamente arquivos de pastas secundárias.

    O Quick Sight pode acessar buckets ou pastas do Amazon S3 que estejam em qualquer um deles. Região da AWS Certifique-se de usar um formato de prefixo de URI que identifique o bucket do S3 Região da AWS se ele for diferente daquele usado pela sua conta Quick.

    São compatíveis os prefixos de URI nos seguintes formatos:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/supported-manifest-file-format.html)
+ **globalUploadSettings**— (Opcional) Use esse elemento para especificar as configurações de importação para os arquivos do Amazon S3, como delimitadores de campo. Se esse elemento não for especificado, o Quick Sight usará os valores padrão para os campos desta seção.
**Importante**  
Para arquivos log (.clf) e log estendido (.elf), apenas o campo **format** dessa seção será aplicável, portanto você pode ignorar os outros campos. Se você optar por incluí-los, os valores serão ignorados. 
  + **formato**: (opcional) especifique o formato dos arquivos a serem importados. Os formatos válidos são **CSV**, **TSV**, **CLF**, **ELF** e **JSON**. O valor padrão é **CSV**.
  + **delimitador**: (opcional) especifique o delimitador de campo do arquivo. Isso deve ser mapeado para o tipo de arquivo especificado no campo `format`. Os formatos válidos são vírgulas (**,**) para arquivos .csv e tabulações (**\$1t**) para arquivos .tsv. O valor padrão é vírgula (**,**).
  + **textqualifier**: (opcional) especifique o qualificador de texto do arquivo. Os formatos válidos são compostos por aspas simples (**'**) e aspas duplas (**\$1"**). A barra invertida inicial é um caractere de escape necessário para aspas duplas em JSON. O valor padrão é aspas duplas (**\$1"**).​ Se o texto não precisar de um qualificador de texto, não inclua essa propriedade.
  + **containsHeader**: (opcional) especifique se o arquivo tem uma linha de cabeçalho. Os formatos válidos são **true** ou **false**. O valor padrão é **true**.

### Exemplos de arquivos de manifesto para o Quick Sight
<a name="quicksight-manifest-file-examples"></a>

A seguir estão alguns exemplos de arquivos de manifesto do Quick Sight concluídos.

O exemplo a seguir mostra um arquivo manifesto que identifica dois arquivos .csv específicos para importação. Esses arquivos usam aspas duplas para qualificadores de texto. Os campos `format`, `delimiter` e `containsHeader` são ignorados, pois os valores padrão são aceitáveis.

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

O exemplo a seguir mostra um arquivo manifesto que identifica um arquivo .tsv específico para importação. Esse arquivo também inclui um bucket em outra região da AWS que contém arquivos .tsv adicionais para importação. Os campos `textqualifier` e `containsHeader` são ignorados, pois os valores padrão são aceitáveis.

```
{
    "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"
    }
}
```

O exemplo a seguir identifica dois buckets que contêm arquivos .clf para importação. Uma está na Região da AWS mesma conta Rápida e a outra em outra Região da AWS. Os campos `delimiter`, `textqualifier` e `containsHeader` são ignorados, pois não são aplicáveis para arquivos de log.

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

O exemplo a seguir usa o formato do Amazon Redshift para identificar um arquivo .csv para importação.

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

O exemplo a seguir usa o formato do Amazon Redshift para identificar dois arquivos JSON para importação.

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