Format yang didukung untuk file manifes Amazon S3 - Amazon QuickSight

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 JSON manifes untuk menentukan file di Amazon S3 untuk diimpor ke Amazon. QuickSight File JSON manifes 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 JSON file, maka untuk globalUploadSettings tentukanformat, tetapi tidakdelimiter,textqualifier, ataucontainsHeader.

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 JSON format 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.

    • URIs— Gunakan array ini untuk daftar file tertentu URIs untuk diimpor.

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

      URIsdalam format berikut didukung.

      URIformat 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

      URIJenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.

      https: //< nama ember >.s3-< nama wilayah >.amazonaws.com/< nama file>

      https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv URIJenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.
    • URIPrefixes— Gunakan array ini untuk daftar URI awalan 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 AWS Pastikan untuk menggunakan format URI awalan yang mengidentifikasi bucket S3 Wilayah AWS jika berbeda dari yang digunakan oleh akun Anda. QuickSight

      URIawalan dalam format berikut didukung.

      URIformat awalan 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: //< bucket name>.s3.amazonaws.com

      https://awsexamplebucket.s3.amazonaws.com
      https://s3 -< nama wilayah >.amazonaws.com/< nama ember >/ https://s3 -your-region-for-example-us-east-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-east-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 JSON file untuk diimpor.

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