Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Format yang didukung untuk file manifes Amazon S3
<a name="supported-manifest-file-format"></a>

Anda menggunakan file manifes JSON untuk menentukan file di Amazon S3 untuk diimpor ke Quick Sight. File manifes JSON ini dapat menggunakan format Quick Sight yang dijelaskan berikut ini atau format Amazon Redshift yang dijelaskan [dalam Menggunakan manifes untuk menentukan file data](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html) dalam Panduan Pengembang Database *Amazon Redshift*. Anda tidak perlu menggunakan Amazon Redshift untuk menggunakan format file manifes Amazon Redshift. 

Jika Anda menggunakan file manifes Quick Sight, itu harus memiliki ekstensi.json, misalnya. `my_manifest.json` Jika Anda menggunakan file manifes Amazon Redshift, file tersebut dapat memiliki ekstensi apa pun. 

Jika Anda menggunakan file manifes Amazon Redshift, Quick Sight akan memproses `mandatory` opsi opsional seperti yang dilakukan Amazon Redshift. Jika file terkait tidak ditemukan, Quick Sight mengakhiri proses impor dan mengembalikan kesalahan. 

File yang Anda pilih untuk diimpor harus berupa teks yang dibatasi (misalnya, .csv atau.tsv), log (.clf), atau format log diperpanjang (.elf), atau JSON (.json). Semua file yang diidentifikasi dalam satu file manifes harus menggunakan format file yang sama. Plus, mereka harus memiliki jumlah dan jenis kolom yang sama. Quick Sight mendukung pengkodean UTF-8 file, tetapi tidak UTF-8 dengan tanda urutan byte (BOM). Jika Anda mengimpor file JSON, maka untuk `globalUploadSettings` tentukan`format`, tetapi tidak, `delimiter``textqualifier`, atau. `containsHeader`

Pastikan file apa pun yang Anda tentukan ada di bucket Amazon S3 yang telah Anda berikan akses Quick Sight. Untuk informasi tentang memberikan akses Quick Sight ke AWS sumber daya, lihat[Mengonfigurasi akses Amazon Quick Sight ke sumber AWS data](access-to-aws-resources.md).

## Format file manifes untuk Quick Sight
<a name="quicksight-manifest-file-format"></a>

File manifes Quick Sight menggunakan format JSON berikut.

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

Gunakan bidang dalam `fileLocations` elemen untuk menentukan file yang akan diimpor, dan bidang dalam `globalUploadSettings` elemen untuk menentukan pengaturan impor untuk file-file tersebut, seperti pembatas bidang. 

Elemen file manifes dijelaskan sebagai berikut:
+ **FileLocations** - Gunakan elemen ini untuk menentukan file yang akan diimpor. Anda dapat menggunakan salah satu atau kedua `URIPrefixes` array `URIs` dan untuk melakukan ini. Anda harus menentukan setidaknya satu nilai dalam satu atau yang lain dari mereka.
  + **URI** — Gunakan array ini untuk daftar URI untuk file tertentu untuk mengimpor.

    Quick Sight dapat mengakses file Amazon S3 yang ada di mana saja. Wilayah AWS Namun, Anda harus menggunakan format URI yang mengidentifikasi AWS Wilayah bucket Amazon S3 jika berbeda dengan yang digunakan oleh akun Cepat Anda.

    URI dalam format berikut didukung.  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/quick/latest/userguide/supported-manifest-file-format.html)
  + **UriPrefixes** - Gunakan array ini untuk daftar awalan URI untuk bucket dan folder S3. Semua file dalam ember atau folder tertentu diimpor. Quick Sight secara rekursif mengambil file dari folder anak.

    Quick Sight dapat mengakses bucket Amazon S3 atau folder yang ada di mana saja. Wilayah AWS Pastikan untuk menggunakan format awalan URI yang mengidentifikasi bucket S3 Wilayah AWS jika berbeda dengan yang digunakan oleh akun Quick Anda.

    Awalan URI dalam format berikut didukung.  
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/quick/latest/userguide/supported-manifest-file-format.html)
+ **global UploadSettings** - (Opsional) Gunakan elemen ini untuk menentukan pengaturan impor untuk file Amazon S3, seperti pembatas bidang. Jika elemen ini tidak ditentukan, Quick Sight menggunakan nilai default untuk bidang di bagian ini.
**penting**  
Untuk file log (.clf) dan log diperpanjang (.elf), hanya bidang **format** di bagian ini yang berlaku, sehingga Anda dapat melewati bidang lainnya. Jika Anda memilih untuk memasukkannya, nilainya diabaikan. 
  + **format** — (Opsional) Tentukan format file yang akan diimpor. Format yang valid adalah**CSV**,**TSV**,**CLF**,**ELF**, dan**JSON**. Nilai default-nya adalah **CSV**.
  + **pembatas** - (Opsional) Tentukan pembatas bidang file. Ini harus dipetakan ke jenis file yang ditentukan di `format` bidang. Format yang valid adalah koma (**,**) untuk file.csv dan tab (**\\t**) untuk file.tsv. Nilai defaultnya adalah koma (**,**).
  + **textqualifier** - (Opsional) Tentukan kualifikasi teks file. Format yang valid adalah kutipan tunggal (**'**), tanda kutip ganda (**\\"**). Backslash terkemuka adalah karakter escape yang diperlukan untuk kutipan ganda di JSON. Nilai default adalah tanda kutip ganda (**\\"**). Jika teks Anda tidak memerlukan kualifikasi teks, jangan sertakan properti ini.
  + **ContainsHeader** - (Opsional) Tentukan apakah file memiliki baris header. Format yang valid adalah **true** atau**false**. Nilai default-nya adalah **true**.

### Contoh file manifes untuk Quick Sight
<a name="quicksight-manifest-file-examples"></a>

Berikut ini adalah beberapa contoh file manifes Quick Sight yang lengkap.

Contoh berikut menunjukkan file manifes yang mengidentifikasi dua file.csv tertentu untuk impor. File-file ini menggunakan tanda kutip ganda untuk kualifikasi teks. `containsHeader`Bidang `format``delimiter`,, dan dilewati karena nilai default dapat diterima.

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

Contoh berikut menunjukkan file manifes yang mengidentifikasi satu file.tsv tertentu untuk impor. File ini juga menyertakan bucket di AWS Wilayah lain yang berisi file.tsv tambahan untuk diimpor. `containsHeader`Bidang `textqualifier` dan dilewati karena nilai default dapat diterima.

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

Contoh berikut mengidentifikasi dua bucket yang berisi file.clf untuk impor. Satu Wilayah AWS sama dengan akun Cepat, dan satu di akun yang berbeda Wilayah AWS. `containsHeader`Bidang `delimiter``textqualifier`,, dan dilewati karena tidak berlaku untuk file log.

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

Contoh berikut menggunakan format Amazon Redshift untuk mengidentifikasi file.csv untuk diimpor.

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

Contoh berikut menggunakan format Amazon Redshift untuk mengidentifikasi dua file JSON untuk diimpor.

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