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

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 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 file UTF-8, tetapi tidak UTF-8 dengan tanda urutan byte (BOM). Jika Anda mengimpor file JSON, maka untuk globalUploadSettings tentukanformat, tetapi tidak, delimitertextqualifier, 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, lihatMengonfigurasi akses Amazon Quick Sight ke sumber AWS data.

Format file manifes untuk Quick Sight

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:

Contoh file manifes untuk Quick Sight

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. containsHeaderBidang formatdelimiter,, 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. containsHeaderBidang 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 Quick Suite, dan satu di akun yang berbeda Wilayah AWS. containsHeaderBidang delimitertextqualifier,, 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"
    }
}