Menulis dan menjalankan notebook

Anda dapat menggunakan buku catatan untuk mengatur, membuat anotasi, dan berbagi beberapa kueri SQL dalam satu dokumen. Anda dapat menambahkan beberapa kueri SQL dan sel Markdown ke buku catatan. Notebook menyediakan cara untuk mengelompokkan kueri dan penjelasan yang terkait dengan analisis data dalam satu dokumen dengan menggunakan beberapa kueri dan sel Markdown. Anda dapat menambahkan teks dan memformat tampilan menggunakan sintaks Markdown untuk memberikan konteks dan informasi tambahan untuk tugas analisis data Anda. Anda dapat membagikan buku catatan Anda dengan anggota tim.

Untuk menggunakan buku catatan, Anda harus menambahkan izin untuk buku catatan ke kepala IAM Anda (pengguna IAM atau peran IAM). Sebagai praktik terbaik, kami merekomendasikan untuk melampirkan kebijakan izin ke peran IAM dan kemudian menetapkannya ke pengguna dan grup sesuai kebutuhan. Untuk informasi selengkapnya, lihat Identitas dan manajemen akses di Amazon Redshift. Anda dapat menambahkan izin ke salah satu kebijakan terkelola editor kueri v2. Untuk informasi selengkapnya, lihat Mengakses editor kueri v2.

Anda bisa Jalankan semua sel notebook secara berurutan. Sel kueri SQL notebook memiliki sebagian besar kemampuan yang sama dengan tab editor kueri. Untuk informasi selengkapnya, lihat Menulis dan menjalankan kueri. Berikut ini adalah perbedaan antara tab query editor dan sel SQL di notebook.

• Tidak ada kontrol untuk dijalankan Explain pada pernyataan SQL di notebook.

• Anda hanya dapat membuat satu bagan per sel SQL di buku catatan.

Anda dapat mengekspor dan mengimpor buku catatan ke file yang dibuat dengan editor kueri v2. Ekstensi file adalah .ipynb dan ukuran file bisa maksimal 5 MB. Sel SQL dan Markdown disimpan dalam file. Cluster atau workgroup dan database tidak disimpan di notebook yang diekspor. Saat Anda membuka buku catatan yang diimpor, Anda memilih cluster atau workgroup dan database tempat menjalankannya. Setelah menjalankan sel SQL, Anda kemudian dapat memilih di tab hasil apakah akan menampilkan halaman hasil saat ini sebagai bagan. Kumpulan hasil kueri tidak disimpan di buku catatan.

Saat Anda menjalankan buku catatan, baik dengan Run all atau Run, maka panel status Run akan tersedia. Pilih ikon untuk membuka panel. Panel ini berisi ringkasan status Run all atau Run terbaru dari sel SQL di buku catatan Anda. Jika Anda menjalankan beberapa sel SQL, Anda dapat melihat sekilas status, waktu yang telah berlalu, dan beberapa detail tentang proses. Anda dapat memfilter sel yang ditampilkan berdasarkan status:All,Succeeded,Error,In progress, atauCanceled. Anda juga dapat menggunakan panel ini untuk menavigasi ke sel SQL di editor.

Untuk membuat buku catatan

1. Dari menu navigator, pilih Editor.

2. Pilih, lalu pilih Notebook.

   Secara default, sel kueri SQL muncul di buku catatan.

3. Di sel kueri SQL, lakukan salah satu hal berikut:

   • Masukkan kueri.

   • Tempelkan kueri yang Anda salin.

4. (Opsional) Pilih ikon, lalu pilih Markdown untuk menambahkan sel Markdown di mana Anda dapat memberikan teks deskriptif atau penjelasan menggunakan sintaks Markdown standar.

5. (Opsional) Pilih ikon, lalu pilih SQL untuk menyisipkan sel SQL.

Anda dapat mengganti nama notebook menggunakan ikon (pensil).

Dari menu (lainnya), Anda juga dapat melakukan operasi berikut pada buku catatan:

• Bagikan dengan tim saya — Untuk berbagi buku catatan dengan tim Anda seperti yang ditentukan oleh tag. Lihat informasi yang lebih lengkap di Berbagi kueri

• Ekspor - Untuk mengekspor buku catatan ke file lokal dengan .ipynb ekstensi.

• Simpan versi — Untuk membuat versi notebook. Untuk melihat versi buku catatan, navigasikan ke buku catatan yang disimpan dan buka Riwayat versi.

• Duplikat — Untuk membuat salinan buku catatan dan membukanya di tab notebook baru.

• Pintasan - Untuk menampilkan pintasan yang tersedia saat membuat buku catatan.

Untuk membuka buku catatan yang disimpan

1. Dari menu navigator, pilih Notebook. Notebook dan folder notebook Anda yang disimpan akan ditampilkan.

2. Pilih buku catatan yang ingin Anda buka dan klik dua kali.

Anda dapat menampilkan buku catatan saya, buku catatan yang Dibagikan oleh saya, dan buku catatan yang Dibagikan ke tim saya dalam tab buku catatan.

Untuk mengimpor buku catatan dari file lokal ke buku catatan saya, pilih Impor, lalu arahkan ke .ipynb file yang berisi buku catatan Anda. Notebook diimpor ke folder notebook yang sedang terbuka. Anda kemudian dapat membuka notebook di editor notebook.

Dari menu konteks (klik kanan) notebook Anda dapat melakukan operasi berikut:

• Buka buku catatan — Untuk membuka buku catatan di editor.

• Simpan versi — Untuk menyimpan versi notebook.

• Riwayat versi — Untuk menampilkan versi notebook. Dari jendela Riwayat versi Anda dapat menghapus dan mengembalikan versi. Anda juga dapat membuat buku catatan dari versi yang dipilih saat ini.

• Edit tag — Untuk membuat dan mengedit tag pada buku catatan.

• Bagikan dengan tim saya — Untuk berbagi buku catatan dengan tim Anda.

  Untuk berbagi buku catatan dengan tim Anda, pastikan bahwa Anda memiliki tag utama yang sqlworkbench-team disetel ke nilai yang sama dengan anggota tim lainnya di akun Anda. Misalnya, administrator mungkin menetapkan nilai accounting-team untuk semua orang di departemen akuntansi. Lihat contohnya di Izin yang diperlukan untuk menggunakan editor kueri v2 .

• Ekspor - Untuk mengekspor buku catatan ke file lokal.

• Ganti nama - Untuk mengganti nama notebook.

• Duplikat — Untuk membuat salinan buku catatan.

• Hapus — Untuk menghapus buku catatan.

Untuk demo notebook, tonton video berikut.