Pertimbangan saat berinteraksi dengan SQL generatif Menggunakan SQL generatif Memperbarui pengaturan SQL generatif sebagai administrator Contoh menggunakan kemampuan SQL generatif Amazon Q dengan data TICKIT

Berinteraksi dengan editor kueri v2 generatif SQL (pratinjau)

Ini adalah dokumentasi prarilis untuk query editor v2 generatif SQL, yang dalam rilis pratinjau. Dokumentasi dan fitur dapat berubah. Sebaiknya gunakan fitur ini hanya dalam lingkungan pengujian, bukan dalam lingkungan produksi. Untuk syarat dan ketentuan pratinjau, lihat Partisipasi Layanan Beta dalam Ketentuan AWS Layanan.

catatan

Saat ini, dukungan SQL generatif hanya tersedia dalam hal berikut: Wilayah AWS

Wilayah AS Timur (Virginia N.) (us-east-1)
Wilayah AS Barat (Oregon) (us-west-2)
Wilayah Eropa (Frankfurt) (eu-central-1)

Anda dapat berinteraksi dengan kemampuan SQL generatif Amazon Q di editor kueri Amazon Redshift v2. Ini adalah asisten pengkodean yang menghasilkan pernyataan SQL berdasarkan prompt dan skema database Anda. Asisten pengkodean ini tersedia saat Anda membuat buku catatan di editor kueri v2.

Saat berinteraksi dengan SQL generatif, ajukan pertanyaan spesifik, ulangi ketika Anda memiliki permintaan yang kompleks, dan verifikasi jawaban untuk akurasi.

Saat memberikan permintaan analisis dalam bahasa alami, sespesifik mungkin untuk membantu asisten pengkodean memahami dengan tepat apa yang Anda butuhkan. Alih-alih bertanya “temukan tempat teratas yang menjual tiket terbanyak,” berikan detail lebih lanjut seperti “temukan nama/id dari tiga tempat teratas yang menjual tiket terbanyak pada tahun 2008.” Gunakan nama objek yang konsisten dalam database Anda, seperti skema, tabel, dan nama kolom seperti yang didefinisikan dalam database Anda alih-alih merujuk ke objek yang sama dengan cara yang berbeda, yang dapat membingungkan asisten.

Memecah permintaan kompleks menjadi beberapa pernyataan sederhana yang lebih mudah bagi asisten untuk menafsirkan. Ajukan pertanyaan tindak lanjut secara berulang untuk mendapatkan analisis yang lebih rinci dari asisten. Misalnya, tanyakan dulu “negara bagian mana yang memiliki tempat paling banyak?” Kemudian berdasarkan tanggapan, tanyakan “tempat mana yang paling populer dari negara bagian ini?”.

Tinjau SQL yang dihasilkan sebelum menjalankannya untuk memastikan akurasi. Jika kueri SQL yang dihasilkan memiliki kesalahan atau tidak cocok dengan maksud Anda, berikan instruksi kepada asisten tentang cara memperbaikinya alih-alih mengulangi seluruh permintaan. Misalnya, jika kueri tidak memiliki klausa predikat pada tahun, tanyakan “Sediakan tempat dari tahun 2008.”

Pertimbangan saat berinteraksi dengan SQL generatif

Pertimbangkan hal berikut saat bekerja di panel obrolan.

Administrator editor kueri v2 untuk akun Anda harus mengaktifkan kemampuan obrolan di halaman pengaturan SQL Generatif.
Untuk menggunakan SQL generatif editor kueri v2, Anda memerlukan izin sqlworkbench:GetQSqlRecommendations dalam kebijakan IAM Anda, selain izin lain yang ditentukan dalam kebijakan AWS terkelola untuk editor kueri v2. Untuk informasi selengkapnya tentang kebijakan AWS terkelola, lihatMengakses editor kueri v2.
Pertanyaan Anda harus ditulis dalam bahasa Inggris.
Pertanyaan Anda harus mengacu pada database yang terhubung di cluster atau workgroup Anda. Untuk menghindari kesalahan status kosong, harus ada setidaknya satu tabel dan beberapa data dalam database.
Pertanyaan Anda harus mengacu pada data yang disimpan dalam database yang terhubung. Itu tidak dapat merujuk skema eksternal. Untuk informasi selengkapnya tentang skema yang didukung, lihat Membuat skema di Panduan Pengembang Database Amazon Redshift.
Setiap pertanyaan yang menghasilkan SQL yang mengubah database yang terhubung dapat menghasilkan peringatan.
Teknologi AI generatif adalah hal baru dan mungkin ada kesalahan, kadang-kadang disebut halusinasi, dalam tanggapannya. Uji dan tinjau semua kode untuk kesalahan dan kerentanan sebelum menggunakannya di lingkungan atau beban kerja Anda.
Anda dapat meningkatkan rekomendasi dengan membagikan kueri SQL yang dijalankan oleh pengguna lain di akun Anda. Administrator akun Anda dapat menjalankan perintah SQL berikut untuk memungkinkan akses ke riwayat kueri akun.
```
GRANT ROLE SYS:MONITOR to "IAMR:role-name";
GRANT ROLE SYS:MONITOR to "IAM:user-name";
GRANT ROLE SYS:MONITOR to "database-username";
```
Untuk informasi selengkapnyaSYS:MONITOR, lihat peran yang ditentukan sistem Amazon Redshift di Panduan Pengembang Database Amazon Redshift.
Data Anda aman dan pribadi. Data Anda tidak dibagikan di seluruh akun. Kueri, data, dan skema basis data Anda tidak digunakan untuk melatih model fondasi AI generatif (FM). Masukan Anda digunakan sebagai petunjuk kontekstual ke FM untuk menjawab hanya pertanyaan Anda.

Menggunakan SQL generatif

Setelah izin yang benar dikonfigurasi, saat bekerja dengan buku catatan di editor kueri v2, Anda dapat memilih ikon untuk memulai percakapan.

Untuk berinteraksi dengan editor kueri v2 obrolan SQL generatif untuk menghasilkan SQL

Di tab Editor dari editor kueri v2, buka buku catatan.
Pilih ikon Generative SQL, lalu ikuti petunjuk untuk mengajukan pertanyaan Anda tentang SQL generatif Amazon Redshift editor v2 generatif di panel obrolan.

Anda memberikan pertanyaan di bidang prompt dan editor kueri v2 merespons dengan SQL yang disarankan. Setiap kesalahan yang ditemui dikembalikan kepada Anda di panel obrolan.
Pilih Tambahkan ke buku catatan untuk menambahkan sel Markdown dengan prompt Anda dan sel SQL dengan SQL yang disarankan ke buku catatan Anda.
(Opsional) Pilih Regenerate SQL untuk menghasilkan respons lain untuk prompt yang sama. Anda dapat memilih untuk Regenerasi SQL satu kali untuk prompt saat ini.
(Opsional) Di panel obrolan SQL generatif, pilih ikon Lainnya, lalu pilih Refresh database untuk menyegarkan metadata yang menjelaskan database Anda yang terhubung. Metadata ini mencakup definisi skema, tabel, dan kolom dalam database Anda.

Memperbarui pengaturan SQL generatif sebagai administrator

Seorang pengguna dengan izin IAM yang tepat dapat melihat dan mengubah pengaturan SQL Generatif untuk pengguna lain dalam hal yang sama. Akun AWS Administrator ini harus memiliki izin sqlworkbench:UpdateAccountQSqlSettings dalam kebijakan IAM mereka, selain izin lain yang ditentukan dalam kebijakan AWS terkelola untuk editor kueri v2. Untuk informasi selengkapnya tentang kebijakan terkelola, lihat Izin yang diperlukan untuk menggunakan editor kueri v2 .

Agar administrator mengaktifkan obrolan SQL generatif untuk semua pengguna di akun

Pilih ikon Pengaturan untuk menampilkan menu layar pengaturan yang berbeda.
Kemudian pilih ikon Generative SQL settings untuk menampilkan halaman Generative SQL settings.
Pilih Generative SQL untuk mengaktifkan kemampuan SQL generatif bagi pengguna di akun.

Contoh menggunakan kemampuan SQL generatif Amazon Q dengan data TICKIT

Untuk membuat prompt yang efisien untuk menghasilkan SQL, Anda harus belajar tentang skema database dan data Anda. Data TICKIT terdiri dari tujuh tabel: dua tabel fakta dan lima dimensi. Data sampel berisi catatan tentang penjualan kepada petugas acara hiburan yang terjadi pada tahun 2008. Untuk informasi selengkapnya tentang skema data TICKIT, lihat Contoh database di Panduan Pengembang Database Amazon Redshift. Anda dapat memuat data TICKIT ke dalam database dengan berbagai metode di konsol Amazon Redshift dan editor kueri v2. Query editor v2 menyediakan metode untuk memuat data TICKIT ke dalam databasesample_data_dev. Untuk informasi, lihat Memuat data sampel. Editor kueri v2 juga menyediakan contoh prompt untuk data TICKIT. Skenario berikut menjelaskan percakapan dengan SQL generatif untuk menghasilkan SQL tentang data sampel TICKIT. Dalam skenario ini, data sampel TICKIT sudah dibuat dalam dev database di cluster Amazon Redshift.

catatan

Contoh ini adalah untuk menggambarkan percakapan. Respons dari SQL generatif mungkin tidak cocok dengan hasil Anda menggunakan prompt yang sama.

Contoh percakapan dengan editor kueri v2 generatif SQL

Di Editor, sambungkan ke cluster atau workgroup yang berisi data sampel TICKIT.
Buat buku catatan kosong dan pilih ikon Generative SQL untuk membuka panel obrolan.
Masukkan prompt berikut untuk menghasilkan SQL untuk memverifikasi jumlah catatan dalam VENUE tabel:
```
How many venues are there?
```
```
SELECT
  COUNT(*) AS num_venues
FROM
  tickit.venue
```
Pilih Tambahkan ke buku catatan untuk menambahkan dua sel ke buku catatan yang terbuka. Satu sel Markdown “Ada berapa tempat?” dan satu berisi SQL yang dihasilkan.

Di sel SQL, pilih Jalankan untuk menerima hasilnya:
```
count
------
202	
```
Untuk meminta versi SQL lain, pilih Regenerate SQL dan terima jawaban berikut:
```
SELECT
  venuestate,
  COUNT(*) AS num_venues
FROM
  tickit.venue
GROUP BY
  venuestate
```
Pilih Tambahkan ke buku catatan untuk menambahkan dua sel lagi ke buku catatan yang terbuka. Satu sel Markdown “Ada berapa tempat?” dan satu berisi SQL yang dihasilkan.

Di sel SQL, pilih Jalankan untuk menerima status tempat daftar hasil berdasarkan nomor:
```
venuestate num_venues
----------------------
MA         4	
OH         8	
MI         5	
...
```
Asisten SQL generatif dapat membuat asumsi tentang apa yang Anda tanyakan. Meskipun tidak ada widget dalam database, Anda masih bisa bertanya. Dalam hal ini, ini memberi Anda pesan bahwa itu tidak dapat menghasilkan SQL.
```
How many widgets are there?
```
```
I was not able to generate any SQL
```
Saat Anda mempelajari lebih lanjut tentang database Anda, Anda dapat mengajukan pertanyaan yang lebih spesifik untuk menghasilkan SQL. Misalnya, Anda menyadari bahwa database berisi data penjualan selama beberapa bulan di tahun 2008. Masukkan prompt berikut untuk menghasilkan SQL untuk menemukan jumlah penjualan pada bulan November 2008:
```
How many sales were there in November 2008?
```
```
SELECT
  COUNT(*) AS num_sales
FROM
  tickit.sales s
  JOIN tickit.date d ON s.dateid = d.dateid
WHERE
  d.month = 'November'
  AND d.year = 2008
```
Pilih Tambahkan ke buku catatan untuk menambahkan dua sel ke buku catatan yang terbuka. Satu sel penurunan harga “Berapa banyak penjualan yang ada pada November 2008?” dan satu berisi SQL yang dihasilkan.

Di sel SQL, pilih Jalankan untuk menerima hasilnya:
```
num_sales
-----
0	
```
Anda menyadari ini bukan hasil yang Anda harapkan.
Anda melihat bahwa predikat date.month='November' mengharapkan bulan dalam tabel DATE diwakili oleh singkatan dari nama bulan. Anda mengubah predikat ke d.month='NOV' dan menjalankan kembali SQL.
```
SELECT
  COUNT(*)
FROM
  sales
  JOIN date ON sales.dateid = date.dateid
WHERE
  date.month = 'NOV'
  AND date.year = 2008
```
Di sel SQL, pilih Jalankan untuk mendapatkan hasil baru.
```
count
-----
14261	
```

Jika Anda mengajukan pertanyaan yang mencoba mengubah database yang terhubung, pesan peringatan dikembalikan bersama dengan SQL yang direkomendasikan. Masukkan prompt berikut untuk menghasilkan SQL untuk memasukkan data ke dalam tabel:


Insert 1 into the venue table.

INSERT
,
UPDATE
  OR delete data
FROM
  the database AS that could potentially change the data.Please provide a query that ONLY selects data


I was not able to generate the correct SQL code. I generated SQL, but you'll have to edit it to work with your database.

Jika Anda memilih Tambahkan ke notebook untuk menambahkan dua sel ke notebook yang terbuka dan menjalankan SQL, maka SQL gagal.



ERROR: syntax error at or near "," Position: 132 [ErrorId: 1-6546764a-011df2691778846219ce6ec2]

Skenario ini hanya menggambarkan beberapa cara dasar untuk berinteraksi dengan query editor v2 generatif SQL. Anda dapat bereksperimen lebih banyak lagi dengan teknologi AI generatif ini untuk membantu Anda mulai membuat SQL untuk menanyakan database Anda.

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

Bekerja dengan editor kueri v2

Memuat data ke dalam database