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 ap-selatan-1). 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:

• 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.

    Amazon QuickSight dapat mengakses file Amazon S3 yang ada di file apa pun. Wilayah AWSNamun, Anda harus menggunakan format URI yang mengidentifikasi AWS Wilayah bucket Amazon S3 jika berbeda dari yang digunakan oleh akun Amazon QuickSight Anda.

    URI dalam format berikut didukung.

    Format URI	Contoh	Komentar
    https://s3.amazonaws.com/ < nama bucket >/< nama file>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3: //< nama ember >/< nama file>	s3://awsexamplebucket/data.csv
    https: //< nama ember >.s3.amazonaws.com/< nama file>	https://awsexamplebucket .s3.amazonaws.com/ data.csv
    https://s3 -< nama wilayah >.amazonaws.com/< nama bucket >/< nama file>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	Jenis URI ini mengidentifikasi bucket Wilayah AWS Amazon S3.
    https: //< nama ember >.s3-< nama wilayah >.amazonaws.com/< nama file>	https://awsexamplebucket. s3-us-timur-1. amazonaws. com/data.csv	Jenis URI ini mengidentifikasi bucket Wilayah AWS Amazon S3.

  • UriPrefixes - Gunakan array ini untuk daftar awalan URI untuk bucket dan folder S3. Semua file dalam ember atau folder tertentu diimpor. Amazon QuickSight secara rekursif mengambil file dari folder anak.

    QuickSight dapat mengakses bucket Amazon S3 atau folder yang ada di manapun. Wilayah AWSPastikan untuk menggunakan format awalan URI yang mengidentifikasi bucket S3 Wilayah AWS jika berbeda dari yang digunakan oleh akun Anda. QuickSight

    Awalan URI dalam format berikut didukung.

    Format awalan URI	Contoh	Komentar
    https://s3.amazonaws.com/ < nama ember >/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/ < nama bucket >/< nama folder1 >/ (< nama folder2>/etc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3: //< nama ember >	s3://awsexamplebucket/
    s3: //< nama ember >/< nama folder1 >/ (< nama folder2>/etc.)	s3://awsexamplebucket/folder1/
    https: //< nama ember >. s3. amazonaws.com	https://awsexamplebucket. s3. amazonaws.com
    https://s3 -< nama wilayah >.amazonaws.com/< nama ember >/	https://s3 - your-region-for-example-us-timur-2. amazonaws.com/awsexamplebucket/	URIPrefixJenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.
    https://s3 -< nama wilayah >.amazonaws.com/< nama bucket >/< nama folder1 >/ (< nama folder2>/etc.)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	URIPrefixJenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.
    https: //< nama ember >.s3-< nama wilayah >.amazonaws.com	https://awsexamplebucket. s3-us-timur-1.amazonaws. com	URIPrefixJenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.

• globalUploadSettings— (Opsional) Gunakan elemen ini untuk menentukan pengaturan impor untuk file Amazon S3, seperti pembatas bidang. Jika elemen ini tidak ditentukan, Amazon QuickSight 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 adalahCSV,TSV,CLF,ELF, danJSON. 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 (\"). Garis miring terbalik terkemuka adalah karakter pelarian 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 ataufalse. Nilai default-nya adalah true.

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/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "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://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

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

{
    "entries": [
        {
            "url": "https://awsexamplebucket.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"
    }
}