SELECT daftar FROM klausul WHERE klausul LIMIT klausul Akses atribut Sensitivitas huruf besar/kecil pada nama header dan atribut Menggunakan kata kunci terpesan sebagai istilah yang ditetapkan pengguna Ekspresi skalar

SELECT perintah

penting

Amazon S3 Select tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon S3 Select yang sudah ada dapat terus menggunakan fitur seperti biasa. Pelajari selengkapnya

Amazon S3 Select hanya mendukung perintah. SELECT SQL Klausul ANSI standar berikut didukung untuk: SELECT

Daftar SELECT
Klausul FROM
Klausul WHERE
Klausul LIMIT

catatan

Kueri Amazon S3 Select saat ini tidak mendukung subkueri atau penggabungan.

SELECT daftar

Daftar SELECT mencantumkan kolom, fungsi, dan ekspresi yang ingin Anda tampilkan dari kueri. Daftar ini mewakili output kueri.


SELECT *
SELECT projection1 AS column_alias_1, projection2 AS column_alias_2

Bentuk pertama SELECT dengan * (tanda bintang) mengembalikan setiap baris yang melewati klausul WHERE, apa adanya. Bentuk kedua SELECT membuat baris dengan ekspresi skalar output projection1 dan projection2 yang ditentukan pengguna untuk setiap kolom.

FROM klausul

Amazon S3 Select mendukung bentuk klausul FROM berikut:


FROM table_name
FROM table_name alias
FROM table_name AS alias

Dalam setiap bentuk klausul FROM, table_name adalah S3Object yang sedang dikuerikan. Pengguna yang berasal dari basis data relasional tradisional dapat menganggap hal ini sebagai skema basis data yang berisi beberapa tampilan di atas tabel.

Mengikuti standarSQL, FROM klausa membuat baris yang disaring dalam WHERE klausa dan diproyeksikan dalam daftar. SELECT

Untuk JSON objek yang disimpan di Amazon S3 Select, Anda juga dapat menggunakan formulir klausa berikut: FROM


FROM S3Object[*].path
FROM S3Object[*].path alias
FROM S3Object[*].path AS alias

Menggunakan bentuk FROM klausa ini, Anda dapat memilih dari array atau objek dalam objek. JSON Anda dapat menentukan path menggunakan salah satu bentuk berikut:

Berdasarkan nama (dalam objek): .name atau ['name']
Berdasarkan indeks (dalam array): [index]
Berdasarkan karakter wildcard (dalam objek): .*
Berdasarkan karakter wildcard (dalam array): [*]

catatan

Bentuk FROM klausa ini hanya berfungsi dengan JSON objek.
Karakter wildcard selalu mengeluarkan setidaknya satu catatan. Apabila tidak ada catatan yang cocok, Amazon S3 Select mengeluarkan nilai MISSING. Selama serialisasi output (setelah kueri selesai berjalan), Amazon S3 Select menggantikan nilai MISSING dengan catatan kosong.
Fungsi agregat (AVG, COUNT, MAX, MIN, dan SUM) melewati nilai MISSING.
Apabila Anda tidak menyediakan alias saat menggunakan karakter wildcard, Anda dapat merujuk baris menggunakan elemen terakhir di jalur tersebut. Misalnya, Anda dapat memilih semua harga dari daftar pembukuan menggunakan kueri SELECT price FROM S3Object[*].books[*].price. Apabila jalur diakhiri karakter wildcard alih-alih nama, maka Anda dapat menggunakan nilai _1 tersebut untuk merujuk ke baris. Misalnya, alih-alih SELECT price FROM S3Object[*].books[*].price, Anda dapat menggunakan kueri SELECT _1.price FROM S3Object[*].books[*].
Amazon S3 Select selalu memperlakukan JSON dokumen sebagai larik nilai tingkat root. Jadi, bahkan jika JSON objek yang Anda kueri hanya memiliki satu elemen root, FROM klausa harus dimulai dengan. S3Object[*] Namun, karena alasan kompatibilitas, Amazon S3 Select memungkinkan Anda menghilangkan karakter wildcard jika Anda tidak menyertakan jalur. Dengan demikian, klausul lengkap FROM S3Object setara dengan FROM S3Object[*] as S3Object. Apabila Anda menyertakan jalur, Anda juga harus menggunakan karakter wildcard. Jadi, FROM S3Object dan FROM S3Object[*].path keduanya adalah klausul yang valid, tetapi tidak dengan FROM S3Object.path.

Contoh:

Contoh 1

Contoh ini menampilkan hasil menggunakan set data dan kueri berikut:


{ "Rules": [ {"id": "1"}, {"expr": "y > x"}, {"id": "2", "expr": "z = DEBUG"} ]}
{ "created": "June 27", "modified": "July 6" }


SELECT id FROM S3Object[*].Rules[*].id


{"id":"1"}
{}
{"id":"2"}
{}

Amazon S3 Select menghasilkan setiap hasil karena alasan berikut:

{"id":"id-1"}–S3Object[0].Rules[0].id menghasilkan kecocokan.
{}–S3Object[0].Rules[1].id tidak cocok dengan catatan, jadi Amazon S3 Select mengeluarkan MISSING, yang kemudian diubah menjadi catatan kosong selama serialisasi output dan dikembalikan.
{"id":"id-2"}–S3Object[0].Rules[2].id menghasilkan kecocokan.
{}–S3Object[1] tidak cocok dengan Rules, jadi Amazon S3 Select mengeluarkan MISSING, yang kemudian diubah menjadi catatan kosong selama serialisasi output dan dikembalikan.

Apabila Anda tidak ingin Amazon S3 Select mengembalikan catatan kosong saat tidak menemukan kecocokan, Anda dapat menguji nilai MISSING. Kueri berikut mengembalikan hasil yang sama seperti kueri sebelumnya, tetapi nilai yang kosong dihilangkan:


SELECT id FROM S3Object[*].Rules[*].id WHERE id IS NOT MISSING


{"id":"1"}
{"id":"2"}

Contoh 2

Contoh ini menampilkan hasil menggunakan set data dan kueri berikut:


{ "created": "936864000", "dir_name": "important_docs", "files": [ { "name": "." }, { "name": ".." }, { "name": ".aws" }, { "name": "downloads" } ], "owner": "Amazon S3" }
{ "created": "936864000", "dir_name": "other_docs", "files": [ { "name": "." }, { "name": ".." }, { "name": "my stuff" }, { "name": "backup" } ], "owner": "User" }


SELECT d.dir_name, d.files FROM S3Object[*] d


{"dir_name":"important_docs","files":[{"name":"."},{"name":".."},{"name":".aws"},{"name":"downloads"}]}
{"dir_name":"other_docs","files":[{"name":"."},{"name":".."},{"name":"my stuff"},{"name":"backup"}]}


SELECT _1.dir_name, _1.owner FROM S3Object[*]


{"dir_name":"important_docs","owner":"Amazon S3"}
{"dir_name":"other_docs","owner":"User"}

WHERE klausul

Klausul WHERE mengikuti sintaks ini:


WHERE condition

Klausul WHERE memfilter baris berdasarkan condition. Ketentuan adalah ekspresi yang memiliki hasil Boolean. Hanya baris yang syaratnya dievaluasi sebagai TRUE yang dikembalikan di hasilnya.

LIMIT klausul

Klausul LIMIT mengikuti sintaks ini:


LIMIT number

Klausul LIMIT membatasi jumlah catatan yang Anda ingin kuerinya dikembalikan berdasarkan number.

Akses atribut

WHEREKlausa SELECT dan dapat merujuk ke data rekaman dengan menggunakan salah satu metode di bagian berikut, tergantung pada apakah file yang sedang ditanyakan dalam CSV atau format. JSON

CSV

Nomor Kolom - Anda dapat merujuk ke kolom ke-N dari baris dengan nama kolom_N, di mana T adalah posisi kolom. Hitungan posisi dimulai pada 1. Misalnya, kolom pertama diberi nama _1 dan kolom kedua diberi nama _2.

Anda dapat merujuk ke kolom sebagai _N atau alias._N. Misalnya, _2 dan myAlias._2 adalah cara yang valid untuk merujuk ke kolom dalam daftar SELECT dan klausul WHERE.
Header Kolom - Untuk objek dalam CSV format yang memiliki baris header, header tersedia untuk SELECT daftar dan WHERE klausa. Secara khusus, seperti dalam ekspresi tradisionalSQL, dalam SELECT dan WHERE klausa, Anda dapat merujuk ke kolom oleh alias.column_name ataucolumn_name.

JSON

Dokumen — Anda dapat mengakses bidang JSON dokumen sebagaialias.name. Anda juga dapat mengakses bidang bersarang, misalnya, alias.name1.name2.name3.
Daftar - Anda dapat mengakses elemen dalam JSON daftar dengan menggunakan indeks berbasis nol dengan operator. [] Misalnya, Anda dapat mengakses elemen kedua dari daftar sebagai alias[1]. Anda dapat menggabungkan elemen daftar yang diakses dengan bidang, misalnya, alias.name1.name2[1].name3.

Contoh: Pertimbangkan JSON objek ini sebagai kumpulan data sampel:


{"name": "Susan Smith",
"org": "engineering",
"projects":
    [
     {"project_name":"project1", "completed":false},
     {"project_name":"project2", "completed":true}
    ]
}

Contoh 1

Kueri berikut mengembalikan hasil ini:


Select s.name from S3Object s


{"name":"Susan Smith"}

Contoh 2

Kueri berikut mengembalikan hasil ini:


Select s.projects[0].project_name from S3Object s


{"project_name":"project1"}

Sensitivitas huruf besar/kecil pada nama header dan atribut

Dengan Amazon S3 Select, Anda dapat menggunakan tanda kutip ganda untuk menunjukkan bahwa header kolom (untuk CSV objek) dan atribut (untuk JSON objek) peka huruf besar/kecil. Tanpa tanda petik dua, header dan atribut objek tidak sensitif terhadap huruf besar/kecil. Kesalahan akan muncul dalam kasus ambiguitas.

Contoh berikut adalah 1) objek Amazon S3 dalam CSV format dengan header kolom yang ditentukan, dan dengan FileHeaderInfo disetel ke "Use" untuk permintaan kueri; atau 2) Objek Amazon S3 dalam JSON format dengan atribut yang ditentukan.

Contoh 1: Objek yang dikuerikan memiliki header atau atribut NAME.

Ekspresi berikut berhasil mengembalikan nilai dari objek. Karena tidak ada tanda petik, kueri tidak peka huruf besar/kecil.
```
SELECT s.name from S3Object s
```
Ekspresi berikut menghasilkan kesalahan 400 MissingHeaderName. Karena terdapat tanda petik, kueri peka huruf besar/kecil.
```
SELECT s."name" from S3Object s
```

Contoh 2: Objek Amazon S3 yang dikuerikan memiliki satu header atau atribut dengan NAME header atau atribut lainnya dengan name.

Ekspresi berikut menghasilkan kesalahan 400 AmbiguousFieldName. Karena tidak ada tanda petik, kueri tidak sensitif terhadap huruf besar/kecil, tetapi terdapat dua kecocokan, jadi kesalahan dilemparkan.
```
SELECT s.name from S3Object s
```
Ekspresi berikut berhasil mengembalikan nilai dari objek. Karena terdapat tanda petik, kueri peka huruf besar/kecil, sehingga tidak ada ambiguitas.
```
SELECT s."NAME" from S3Object s
```

Menggunakan kata kunci terpesan sebagai istilah yang ditetapkan pengguna

Amazon S3 Select memiliki sekumpulan kata kunci cadangan yang diperlukan untuk menjalankan SQL ekspresi yang digunakan untuk menanyakan konten objek. Kata kunci terpesan meliputi nama fungsi, jenis data, operator, dan sebagainya. Dalam beberapa kasus, istilah yang ditentukan pengguna, seperti header kolom (untuk CSV file) atau atribut (untuk JSON objek), mungkin berbenturan dengan kata kunci yang dicadangkan. Pada saat hal ini terjadi, Anda harus menggunakan tanda petik dua untuk menunjukkan bahwa Anda sengaja menggunakan istilah khusus pengguna yang bertentangan dengan kata kunci terpesan. Apabila tidak, kesalahan penguraian 400 akan terjadi.

Untuk mengetahui daftar lengkap kata kunci terpesan, lihat Kata kunci terpesan.

Contoh berikut adalah 1) objek Amazon S3 dalam CSV format dengan header kolom yang ditentukan, dengan FileHeaderInfo disetel ke "Use" untuk permintaan kueri, atau 2) objek Amazon S3 dalam JSON format dengan atribut yang ditentukan.

Contoh: Objek yang dikuerikan memiliki header atau atribut bernama CAST, yang merupakan kata kunci terpesan.

Ekspresi berikut berhasil mengembalikan nilai dari objek. Karena tanda petik digunakan dalam kueri, S3 Select menggunakan header atau atribut yang ditentukan pengguna.
```
SELECT s."CAST" from S3Object s
```
Ekspresi berikut menghasilkan kesalahan penguraian 400. Karena tidak ada tanda petik yang digunakan dalam kueri, CAST bertentangan dengan kata kunci terpesan.
```
SELECT s.CAST from S3Object s
```

Ekspresi skalar

Dalam WHERE klausa dan SELECT daftar, Anda dapat memiliki ekspresi SQL skalar, yang merupakan ekspresi yang mengembalikan nilai skalar. Memiliki bentuk sebagai berikut:

literal

SQLSecara harfiah.
column_reference

Referensi ke kolom berupa column_name atau alias.column_name.
unary_op expression

Dalam hal ini, unary_opadalah operator SQL unary.
expression binary_op expression

Dalam hal ini, binary_op adalah operator SQL biner.
func_name

Dalam hal ini, func_name adalah nama fungsi skalar yang diminta.
expression [ NOT ] BETWEEN ekspresi AND ekspresi
expression LIKE ekspresi [ ESCAPE expression ]

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

SQLReferensi

Jenis data