Mengelola notebook

Catatan: Notebook BigQuery Studio akan mulai ditagih di Ketersediaan Umum setelah 11 April 2024. Anda akan mulai melihat tagihan berbasis penggunaan untuk notebook BigQuery Studio di invoice.

Dokumen ini menjelaskan cara mengelola notebook Colab Enterprise di BigQuery. Notebook adalah aset kode BigQuery Studio yang didukung oleh Dataform.

Untuk menggunakan notebook, Anda harus terlebih dahulu Mengaktifkan BigQuery Studio untuk pengelolaan aset.

Penting: Pada Maret 2024, API yang mendukung kemampuan BigQuery Studio akan otomatis diaktifkan untuk semua project BigQuery. Untuk mengetahui informasi selengkapnya, lihat Pengaktifan otomatis API BigQuery Studio.

Izin yang diperlukan

Untuk membagikan notebook, Anda memerlukan peran Identity and Access Management (IAM) berikut:

• Pengguna Pekerjaan BigQuery (roles/bigquery.jobUser)
• Pengguna Sesi Bacaan BigQuery (roles/bigquery.readSessionUser)
• Pemilik Kode (roles/dataform.codeOwner) di level resource.

Untuk menyimpan dan menghapus notebook, Anda memerlukan peran IAM berikut:

• Pengguna Pekerjaan BigQuery (roles/bigquery.jobUser)
• Pengguna Sesi Bacaan BigQuery (roles/bigquery.readSessionUser)
• Pemilik Kode (roles/dataform.codeOwner) atau Editor Kode (roles/dataform.codeEditor)

Untuk menggunakan revisi notebook, Anda memerlukan peran IAM berikut:

• Pengguna Pekerjaan BigQuery (roles/bigquery.jobUser)
• Pengguna Sesi Bacaan BigQuery (roles/bigquery.readSessionUser)

• Salah satu dari peran berikut:

  • Pemilik Kode (roles/dataform.codeOwner)
  • Editor Kode (roles/dataform.codeEditor)
  • Pelihat Kode (roles/dataform.codeViewer)

Untuk mengetahui informasi selengkapnya tentang IAM BigQuery, lihat Kontrol akses dengan IAM.

Memberikan akses ke notebook

Untuk memberi pengguna lain akses ke notebook, tambahkan pengguna tersebut ke peran IAM yang sesuai.

Penting: Pengguna yang memiliki akses ke notebook dapat melihat semua output yang dihasilkan oleh kode di notebook, meskipun output ini berisi data dari tabel yang tidak dapat mereka akses. Agar output yang disimpan tidak dibagikan, nonaktifkan penyimpanan output notebook.

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Temukan notebook yang ingin Anda beri akses.

3. Klik Lihat tindakan di samping notebook, lalu klik Bagikan > Kelola Izin.

4. Di panel Manage permissions, klik Add user/group.

5. Di kolom New principals, masukkan akun utama.

6. Dalam daftar Peran, pilih salah satu peran berikut:

   • Code Owner: Dapat melakukan tindakan apa pun pada notebook, termasuk menghapus atau membagikannya.
   • Code Editor: Dapat mengedit notebook.
   • Code Viewer: Dapat melihat notebook.
   Catatan: Akun utama juga harus memiliki peran Notebook Runtime User (roles/aiplatform.notebookRuntimeUser ) dan BigQuery User (roles/bigquery.user ) yang diperlukan untuk menjalankan notebook.

7. Opsional: Untuk melihat daftar lengkap peran dan setelan berbagi lanjutan, klik Berbagi lanjutan.

8. Klik Save.

9. Untuk kembali ke halaman informasi notebook, klik Tutup.

Membagikan notebook

Untuk membagikan notebook kepada pengguna lain, Anda dapat membuat dan membagikan link ke notebook. Agar pengguna lain dapat melihat notebook yang Anda bagikan, Anda harus memberikan akses ke notebook tersebut terlebih dahulu.

Untuk menjalankan notebook, pengguna harus memiliki akses ke data yang diakses notebook. Untuk mengetahui informasi selengkapnya, lihat Memberikan akses ke set data.

Penting: Pengguna yang memiliki akses ke notebook dapat melihat semua output yang dihasilkan oleh kode di notebook, meskipun output ini berisi data dari tabel yang tidak dapat mereka akses. Agar output yang disimpan tidak dibagikan, nonaktifkan penyimpanan output notebook.

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, luaskan folder Shared notebooks. Temukan notebook yang ingin Anda bagikan.

3. Klik View actions di samping notebook, lalu klik Share > Copy link.

4. Bagikan link kepada pengguna lain.

Lihat semua notebook

Untuk melihat daftar semua notebook di project Anda, lakukan langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, klik View actions di samping Notebooks, lalu lakukan salah satu tindakan berikut:

• Untuk membuka daftar di tab saat ini, klik Tampilkan semua.
• Untuk membuka daftar di tab baru, klik Tampilkan semua di > Tab baru.
• Untuk membuka daftar di tab terpisah, klik Tampilkan semua di > Tab terpisah.

Melihat metadata notebook

Untuk melihat metadata notebook, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook yang metadatanya ingin Anda lihat.

3. Lihat panel Ringkasan untuk mengetahui informasi tentang notebook, seperti region yang digunakan untuk data dan tanggal notebook terakhir diubah.

Menggunakan versi notebook

Gunakan bagian berikut untuk mempelajari cara melihat, membandingkan, dan memulihkan versi notebook.

Melihat versi notebook

Untuk melihat versi notebook, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook yang ingin Anda lihat aktivitasnya.

3. Klik tab Aktivitas untuk melihat daftar versi notebook dalam urutan yang menurun berdasarkan tanggal.

Membandingkan versi notebook

Untuk membandingkan versi notebook, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook yang informasi versinya ingin Anda bandingkan.

3. Di tab Aktivitas, klik Lihat tindakan di samping versi notebook, lalu klik Bandingkan.

4. Di panel Histori revisi, gunakan drop-down Versi untuk memilih versi yang akan dibandingkan.

5. Opsional: Untuk membandingkan kode sumber notebook, centang kotak Sumber mentah.

6. Opsional: Untuk membandingkan versi secara inline, bukan di panel terpisah, centang kotak Inline diff.

7. Opsional: Untuk menyembunyikan output perintah di notebook, hapus centang dari kotak Tampilkan output.

Memulihkan versi notebook

Gunakan salah satu opsi berikut untuk memulihkan versi notebook. Memulihkan dari panel Histori revisi memungkinkan Anda membandingkan versi notebook saat ini dan sebelumnya sebelum memilih untuk memulihkan versi sebelumnya. Memulihkan notebook akan membuat versi baru dari notebook, bukan menimpa versi saat ini. Tidak ada histori versi yang hilang.

Panel aktivitas

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, luaskan folder Shared notebooks. Klik nama notebook yang ingin Anda pulihkan versi sebelumnya.

3. Pilih panel Activity.

4. Klik Lihat tindakan di samping versi notebook yang ingin Anda pulihkan, lalu klik Pulihkan.

5. Klik Confirm.

Histori revisi

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, luaskan folder Shared notebooks. Klik nama notebook yang ingin Anda pulihkan versi sebelumnya.

3. Pilih panel Activity.

4. Klik Lihat tindakan di samping versi notebook, lalu klik Bandingkan.

5. Di panel Histori revisi, klik Lihat tindakan di samping drop-down Versi, lalu klik Pulihkan revisi.

6. Klik Confirm.

Mendownload notebook

Untuk mendownload notebook, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook yang ingin didownload.

3. Klik Download.

Menghapus notebook

Untuk menghapus notebook, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, luaskan folder Shared notebooks. Temukan notebook yang ingin Anda hapus.

3. Klik Lihat tindakan di samping notebook, lalu klik Hapus.

4. Untuk mengonfirmasi penghapusan, ketik delete pada dialog.

5. Klik Delete.

Pemecahan masalah

Untuk mengetahui informasi selengkapnya, lihat Memecahkan Masalah Colab Enterprise.

Langkah selanjutnya

• Pelajari notebook Colab Enterprise di BigQuery lebih lanjut.
• Pelajari cara membuat notebook.