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 Amazon. QuickSight File manifes JSON ini dapat menggunakan QuickSight format Amazon 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 QuickSight manifes Amazon, file tersebut 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, Amazon QuickSight memproses mandatory opsi opsional seperti yang dilakukan Amazon Redshift. Jika file terkait tidak ditemukan, Amazon QuickSight 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. Amazon QuickSight 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 Amazon QuickSight . Untuk informasi tentang pemberian Amazon QuickSight akses ke AWS sumber daya, lihatMengakses sumber data.

Format file manifes untuk Amazon QuickSight

File QuickSight manifes Amazon 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 Amazon QuickSight

Berikut ini adalah beberapa contoh file QuickSight manifes Amazon 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 QuickSight akun Amazon, 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"
    }
}