CREATE EXTERNAL TABLE

Nama tabel yang akan dibuat, memenuhi syarat dengan nama skema eksternal. Tabel eksternal harus dibuat dalam skema eksternal. Untuk informasi selengkapnya, lihat BUAT SKEMA EKSTERNAL.

Panjang maksimum untuk nama tabel adalah 127 byte; nama yang lebih panjang dipotong menjadi 127 byte. Anda dapat menggunakan karakter UTF-8 multibyte hingga maksimal empat byte. Amazon Redshift memberlakukan batas 9.900 tabel per cluster, termasuk tabel sementara yang ditentukan pengguna dan tabel sementara yang dibuat oleh Amazon Redshift selama pemrosesan kueri atau pemeliharaan sistem. Secara opsional, Anda dapat memenuhi syarat nama tabel dengan nama database. Dalam contoh berikut, nama database adalahspectrum_db, nama skema eksternal adalahspectrum_schema, dan nama tabel adalahtest.

create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';

Jika database atau skema yang ditentukan tidak ada, tabel tidak dibuat, dan pernyataan mengembalikan kesalahan. Anda tidak dapat membuat tabel atau tampilan di database sistemtemplate0,template1,padb_harvest, atausys:internal.

Nama tabel harus berupa nama unik untuk skema yang ditentukan.

Untuk informasi selengkapnya tentang nama yang valid, lihatNama dan pengenal.

Nama dan tipe data dari setiap kolom yang dibuat.

Panjang maksimum untuk nama kolom adalah 127 byte; nama yang lebih panjang dipotong menjadi 127 byte. Anda dapat menggunakan karakter UTF-8 multibyte hingga maksimal empat byte. Anda tidak dapat menentukan nama kolom "$path" atau"$size". Untuk informasi selengkapnya tentang nama yang valid, lihatNama dan pengenal.

Secara default, Amazon Redshift membuat tabel eksternal dengan pseudocolumn dan$path. $size Anda dapat menonaktifkan pembuatan pseudocolumn untuk sesi dengan menyetel parameter spectrum_enable_pseudo_columns konfigurasi kefalse. Untuk informasi selengkapnya, lihat Pseudokolom.

Jika pseudocolumn diaktifkan, jumlah maksimum kolom yang dapat Anda tentukan dalam satu tabel adalah 1.598. Jika pseudocolumn tidak diaktifkan, jumlah maksimum kolom yang dapat Anda tentukan dalam satu tabel adalah 1.600.

Jika Anda membuat “tabel lebar”, pastikan daftar kolom Anda tidak melebihi batas lebar baris untuk hasil perantara selama pemuatan dan pemrosesan kueri. Untuk informasi selengkapnya, lihat Catatan penggunaan.

Untuk perintah CREATE EXTERNAL TABLE AS, daftar kolom tidak diperlukan, karena kolom diturunkan dari query.

Jenis Data berikut didukung:

Untuk DATE, Anda dapat menggunakan format seperti yang dijelaskan berikut. Untuk nilai bulan yang diwakili menggunakan digit, format berikut didukung:

Untuk nilai bulan yang diwakili menggunakan singkatan tiga huruf, format berikut didukung:

Untuk nilai tahun yang secara konsisten kurang dari 100, tahun dihitung dengan cara berikut:

Nilai stempel waktu dalam file teks harus dalam formatyyyy-mm-dd HH:mm:ss.SSSSSS, seperti yang ditunjukkan nilai stempel waktu berikut:. 2017-05-01 11:30:59.000000

Panjang kolom VARCHAR didefinisikan dalam byte, bukan karakter. Misalnya, kolom VARCHAR (12) dapat berisi 12 karakter byte tunggal atau 6 karakter dua byte. Saat Anda menanyakan tabel eksternal, hasil dipotong agar sesuai dengan ukuran kolom yang ditentukan tanpa mengembalikan kesalahan. Untuk informasi selengkapnya, lihat Penyimpanan dan rentang.

Untuk kinerja terbaik, sebaiknya tentukan ukuran kolom terkecil yang sesuai dengan data Anda. Untuk menemukan ukuran maksimum dalam byte untuk nilai dalam kolom, gunakan fungsi OCTET_ LENGTH. Contoh berikut mengembalikan ukuran maksimum nilai di kolom email.

select max(octet_length(email)) from users;

max
---
 62

Klausa yang mendefinisikan tabel yang dipartisi dengan satu atau lebih kolom partisi. Direktori data terpisah digunakan untuk setiap kombinasi yang ditentukan, yang dapat meningkatkan kinerja kueri dalam beberapa keadaan. Kolom yang dipartisi tidak ada dalam data tabel itu sendiri. Jika Anda menggunakan nilai untuk col_name yang sama dengan kolom tabel, Anda mendapatkan kesalahan.

Setelah membuat tabel yang dipartisi, ubah tabel menggunakan pernyataanALTER TABLE... ADD PARTITION untuk mendaftarkan partisi baru ke katalog eksternal. Saat menambahkan partisi, Anda menentukan lokasi subfolder di Amazon S3 yang berisi data partisi.

Misalnya, jika tabel spectrum.lineitem_part didefinisikan denganPARTITIONED BY (l_shipdate date), jalankan perintah ALTER TABLE berikut untuk menambahkan partisi.

ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';

Jika Anda menggunakan CREATE EXTERNAL TABLE AS, Anda tidak perlu menjalankan ALTER TABLE... ADD PARTITION. Amazon Redshift secara otomatis mendaftarkan partisi baru di katalog eksternal. Amazon Redshift juga secara otomatis menulis data yang sesuai ke partisi di Amazon S3 berdasarkan kunci partisi atau kunci yang ditentukan dalam tabel.

Untuk melihat partisi, kueri SVV_EXTERNAL_PARTITIONS tampilan sistem.

Sebuah klausa yang menentukan format data yang mendasarinya. Nilai yang mungkin untuk rowformat adalah sebagai berikut:

Tentukan karakter ASCII tunggal untuk 'pembatas'. Anda dapat menentukan karakter ASCII yang tidak dicetak menggunakan oktal, dalam format di '\ ddd ' mana d adalah digit oktal (0—7) hingga '\ 177'. Contoh berikut menentukan karakter BEL (bel) menggunakan oktal.

ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'

Jika ROW FORMAT dihilangkan, format defaultnya adalah DELIMITED FIELDS TERMINATED BY '\ A' (awal judul) dan GARIS YANG DIAKHIRI OLEH'\ n '(baris baru).

Klausa yang menentukan format SERDE untuk data yang mendasarinya.

Jika ROW FORMAT dihilangkan, format defaultnya adalah DELIMITED FIELDS TERMINATED BY '\ A' (awal judul) dan GARIS YANG DIAKHIRI OLEH'\ n '(baris baru).

Format file untuk file data.

Format yang valid adalah sebagai berikut:

Perintah CREATE EXTERNAL TABLE AS hanya mendukung dua format file, TEXTFILE dan PARQUET.

Untuk INPUTFORMAT dan OUTPUTFORMAT, tentukan nama kelas, seperti yang ditunjukkan contoh berikut.

'org.apache.hadoop.mapred.TextInputFormat'

Jalur ke bucket atau folder Amazon S3 yang berisi file data atau file manifes yang berisi daftar jalur objek Amazon S3. Bucket harus berada di Wil AWS ayah yang sama dengan cluster Amazon Redshift. Untuk daftar Wilayah AWS yang didukung, lihat Batasan Amazon Redshift Spectrum.

Jika jalur menentukan bucket atau folder, misalnya's3://amzn-s3-demo-bucket/custdata/', Redshift Spectrum memindai file di bucket atau folder yang ditentukan dan subfolder apa pun. Redshift Spectrum mengabaikan file tersembunyi dan file yang dimulai dengan titik atau garis bawah.

Jika path menentukan file manifes, 's3://bucket/manifest_file' argumen harus secara eksplisit mereferensikan satu file tunggal—misalnya,. 's3://amzn-s3-demo-bucket/manifest.txt' Itu tidak dapat mereferensikan awalan kunci.

Manifes adalah file teks dalam format JSON yang mencantumkan URL setiap file yang akan dimuat dari Amazon S3 dan ukuran file, dalam byte. URL menyertakan nama bucket dan jalur objek lengkap untuk file. File yang ditentukan dalam manifes dapat berada di bucket yang berbeda, tetapi semua bucket harus berada di Wilayah yang sama AWS dengan cluster Amazon Redshift. Jika file terdaftar dua kali, file dimuat dua kali. Contoh berikut menunjukkan JSON untuk manifes yang memuat tiga file.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

Anda dapat membuat penyertaan file tertentu wajib. Untuk melakukan ini, sertakan mandatory opsi di tingkat file dalam manifes. Saat Anda menanyakan tabel eksternal dengan file wajib yang hilang, pernyataan SELECT gagal. Pastikan bahwa semua file yang termasuk dalam definisi tabel eksternal hadir. Jika tidak semuanya ada, kesalahan muncul yang menunjukkan file wajib pertama yang tidak ditemukan. Contoh berikut menunjukkan JSON untuk manifes dengan mandatory opsi disetel ketrue.

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

Untuk referensi file yang dibuat menggunakan UNLOAD, Anda dapat menggunakan manifes yang dibuat menggunakan MEMBONGKAR dengan parameter MANIFEST. File manifes kompatibel dengan file manifes untukSALIN dari Amazon S3, tetapi menggunakan kunci yang berbeda. Kunci yang tidak digunakan diabaikan.

Klausa yang menetapkan definisi tabel untuk properti tabel.