Kueri data—Kueri SQL dan konfigurasi tabel

Ekspor Data memungkinkan Anda untuk menulis kueri SQL (pemilihan kolom, pemfilteran baris, aliasing kolom) yang dijalankan terhadap tabel yang disediakan—CUR 2.0, misalnya. Setiap tabel mungkin juga memiliki konfigurasi tabel yang mengubah data yang terkandung dalam tabel. Misalnya, dengan CUR 2.0, Anda dapat menentukan konfigurasi untuk memilih perincian waktu per jam, harian, atau bulanan, atau konfigurasi untuk menambahkan data biaya dan penggunaan pada perincian tingkat sumber daya.

Agar kueri data ekspor sepenuhnya didefinisikan, Anda harus menentukan dua atribut berikut:

• SQL query: Pernyataan SQL dijalankan terhadap tabel dan menentukan data apa yang dikembalikan oleh ekspor.

• Konfigurasi tabel: Pengaturan konfigurasi tabel mengubah data apa yang terkandung dalam tabel sebelum kueri SQL dijalankan terhadapnya.

Di halaman konsol Ekspor Data, Anda dapat menggunakan alur kerja yang membangun pernyataan SQL dan konfigurasi tabel berdasarkan pilihan Anda. Dalam Data Exports SDK/CLI, Anda dapat menulis pernyataan SQL dan konfigurasi tabel Anda sendiri.

Data Exports SQL statement (QueryStatement) menggunakan sintaks berikut:

SELECT <column_name_a>, <column_name_b>.<attribute_name> AS <new_name>, ... 
FROM <TABLE_NAME>
[ WHERE <column_name> OPERATOR <value> AND|OR ... ]
[ LIMIT number ]

Data Exports tabel konfigurasi (TableConfigurations) menggunakan sintaks berikut:

{"<TABLE_NAME>":
    {"<CONFIGURATION_NAME_A>": "<value>",
     "<CONFIGURATION_NAME_B>": "<value>", 
     ...}
            }

Kueri SQL

Query SQL dijalankan terhadap tabel dan menentukan data apa yang dikembalikan dalam ekspor. Pernyataan SQL dapat diubah setelah ekspor dibuat, tetapi tabel yang dipilih tidak dapat diubah.

Pernyataan SQL (di QueryStatement lapangan) dapat memiliki maksimal 36.000 karakter.

Kata kunci yang mungkin dalam kueri Data Exports SQL adalah sebagai berikut.

catatan

Kata kunci tidak peka huruf besar/kecil. Nama kolom dan nama tabel peka huruf besar/kecil.

PILIH

Wajib.

Menentukan kolom mana yang akan dipilih dari tabel. Hanya ada satu pernyataan SELECT per kueri.

Gunakan operator titik . untuk menentukan memilih atribut kolom MAP atau STRUCT sebagai kolom terpisah. Nama kolom yang dihasilkan dalam output SQL adalah nama atribut secara default.

Misalnya, Anda dapat memilih atribut dari kolom MAP produk.

SELECT product.from_location FROM COST_AND_USAGE_REPORT

Ini memilih from_location atribut dari product kolom dan membuat kolom baru dengan data atribut. Secara default, dalam output, nama kolom ini akan menjadifrom_location. Namun, itu dapat diganti namanya denganAS.

Untuk informasi selengkapnya tentang kolom MAP dan STRUCT yang tersedia di setiap tabel, dan atribut yang dimiliki kolom ini, lihat kamus tabel Ekspor Data.

SEBAGAI

Opsional.

Mengaktifkan penggantian nama kolom yang dipilih. Nama kolom baru tidak dapat memiliki spasi atau karakter selain karakter alfanumerik (a-z, A-Z, dan 0-9) dan garis bawah (_). Anda tidak dapat menggunakan tanda kutip saat mendefinisikan alias kolom untuk menggunakan karakter lain.

Aliasing dapat berguna saat memilih atribut kolom MAP atau STRUCT untuk mengganti nama kolom yang dihasilkan agar sesuai dengan skema CUR. Misalnya, untuk mencocokkan bagaimana CUR menampilkan product_from_location kolom, tulis kueri berikut di Ekspor Data dengan tabel CUR 2.0.

SELECT product.from_location AS product_from_location FROM COST_AND_USAGE_REPORT

Ini menciptakan ekspor dengan kolom bernamaproduct_from_location.

DARI

Wajib.

Menentukan tabel yang akan ditanyakan. Hanya ada satu pernyataan FROM per kueri.

DIMANA

Opsional.

Memfilter baris hanya ke baris yang cocok dengan klausa yang Anda tentukan.

Klausa WHERE mendukung operator berikut:

• = Nilai harus cocok dengan string atau angka.

• ! = dan <> Nilai tidak boleh cocok dengan string atau angka yang ditentukan.

• <, <=, >, dan >= Nilai harus kurang dari, kurang dari atau sama dengan, lebih besar dari, atau lebih besar dari atau sama dengan angka.

• AND Kedua kondisi yang ditentukan harus benar agar cocok. Anda dapat menggunakan beberapa kata kunci AND untuk menentukan dua atau lebih kondisi.

• ATAU Salah satu kondisi yang ditentukan harus benar agar cocok. Anda dapat menggunakan beberapa kata kunci OR untuk menentukan dua atau lebih kondisi.

• TIDAK Kondisi yang ditentukan tidak boleh benar untuk dicocokkan.

• DI Salah satu nilai yang ditentukan dalam tanda kurung setelah kata kunci harus benar agar cocok.

• Tanda kurung dapat digunakan untuk membangun klausa WHERE multi-kondisional

catatan

Saat mengekspresikan string sebagai nilai mengikuti operator, gunakan tanda kutip tunggal ' alih-alih tanda kutip ganda. Anda tidak perlu melarikan diri dari tanda kutip tunggal. Misalnya Anda dapat menulis pernyataan WHERE berikut:

WHERE line_item_type = 'Discount' OR line_item_type = 'Usage'

MEMBATASI

Opsional.

Membatasi jumlah baris yang dikembalikan oleh kueri ke nilai yang Anda tentukan.

Konfigurasi tabel

Konfigurasi tabel adalah properti yang dikendalikan pengguna yang dapat diatur pengguna untuk mengubah data atau skema tabel sebelum ditanyakan di Ekspor Data. Konfigurasi tabel disimpan sebagai pernyataan JSON dan ditentukan melalui input pengguna di AWS SDK/CLI atau pilihan pengguna di konsol.

Misalnya, CUR 2.0 memiliki konfigurasi tabel untuk mengubah perincian data (per jam, harian, bulanan), apakah data granular tingkat sumber daya disertakan, dan apakah data alokasi biaya terpisah disertakan. Tidak semua tabel memiliki konfigurasi. Untuk informasi selengkapnya tentang konfigurasi yang tersedia untuk setiap tabel, lihat kamus tabel Ekspor Data.

Setiap parameter konfigurasi tabel memiliki nilai default yang diasumsikan jika konfigurasi tabel tidak ditentukan oleh pengguna. Konfigurasi tabel tidak dapat diubah setelah ekspor dibuat.