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
arrayURIs
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
/URIPrefix
Jenis 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
/URIPrefix
Jenis ini mengidentifikasi Wilayah AWS untuk bucket Amazon S3.https: //< nama ember >.s3-< nama wilayah >.amazonaws.com https://
awsexamplebucket
.s3-us-east-1.amazonaws
.com
URIPrefix
Jenis 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 adalah
CSV
,TSV
,CLF
,ELF
, danJSON
. Nilai default-nya adalahCSV
. -
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 adalahtrue
.
-
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. 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/
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. containsHeader
Bidang delimiter
textqualifier
,, 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" } }