Membuat notebook
Dokumen ini menjelaskan cara membuat notebook Colab Enterprise di BigQuery. Notebook adalah aset kode BigQuery Studio yang didukung oleh Dataform.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API BigQuery.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API BigQuery.
Mengaktifkan BigQuery Studio
Ikuti petunjuk di artikel Mengaktifkan BigQuery Studio untuk pengelolaan aset guna menyimpan, membagikan, dan mengelola versi aset kode seperti notebook.
Izin yang diperlukan
Tetapkan izin yang sesuai untuk membuat, mengedit, atau melihat notebook.
Semua pengguna dengan
peran Admin Dataform (roles/dataform.admin
)
memiliki akses pemilik ke semua notebook yang dibuat dalam project.
Untuk mengetahui informasi selengkapnya tentang Identity and Access Management (IAM) BigQuery, lihat Kontrol akses dengan IAM.
Izin untuk membuat notebook
Untuk membuat dan menjalankan notebook, Anda memerlukan izin IAM berikut:
resourcemanager.projects.get
resourcemanager.projects.list
bigquery.config.get
bigquery.jobs.create
bigquery.readsessions.create
bigquery.readsessions.getData
bigquery.readsessions.update
resourcemanager.projects.get
resourcemanager.projects.list
dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
dataform.collections.create
dataform.collections.list
aiplatform.notebookRuntimeTemplates.apply
aiplatform.notebookRuntimeTemplates.get
aiplatform.notebookRuntimeTemplates.list
aiplatform.notebookRuntimeTemplates.getIamPolicy
aiplatform.notebookRuntimes.assign
aiplatform.notebookRuntimes.get
aiplatform.notebookRuntimes.list
aiplatform.operations.list
Anda bisa mendapatkan izin ini dari peran IAM berikut:
- Pengguna Sesi Baca BigQuery (
roles/bigquery.readSessionUser
) Pengguna BigQuery Studio (
roles/bigquery.studioUser
)Peran BigQuery Studio User menggabungkan peran IAM berikut:
Izin untuk mengedit notebook
Untuk mengedit dan menjalankan notebook, Anda memerlukan peran IAM berikut:
- BigQuery Job User (
roles/bigquery.jobUser
) - Pengguna Sesi Baca BigQuery (
roles/bigquery.readSessionUser
) - Pengguna Runtime Notebook (
roles/aiplatform.notebookRuntimeUser
) - Code Editor (
roles/dataform.codeEditor
)
Izin untuk melihat notebook
Untuk melihat dan menjalankan notebook, Anda memerlukan peran IAM berikut:
- BigQuery Job User (
roles/bigquery.jobUser
) - Pengguna Sesi Baca BigQuery (
roles/bigquery.readSessionUser
) - Pengguna Runtime Notebook (
roles/aiplatform.notebookRuntimeUser
) - Code Viewer (
roles/dataform.codeViewer
)
Membuat notebook
Gunakan bagian berikut untuk mempelajari cara membuat notebook.
Menetapkan region default untuk aset kode
Jika ini adalah kali pertama Anda membuat aset kode, tetapkan region default untuk aset kode. Anda tidak dapat mengubah region untuk aset kode setelah dibuat.
Membuat notebook dari editor BigQuery
Untuk membuat notebook yang berisi kueri default untuk tabel tertentu, ikuti langkah-langkah berikut:
Buka halaman BigQuery.
Di panel tab panel editor, klik drop-down
di samping tanda +, lalu klik Compose new Python notebook.Notebook baru ini akan terbuka, yang berisi sel yang menunjukkan contoh kueri terhadap set data publik
bigquery-public-data.ml_datasets.penguins
.
Membuat notebook dari tabel
Untuk membuat notebook yang berisi kueri default untuk tabel tertentu, ikuti langkah-langkah berikut:
Buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan temukan tabel yang ingin dikueri.
Klik > Python notebook.
View actions di samping tabel, klik Query inNotebook baru akan terbuka, yang berisi sel yang menampilkan contoh kueri pada tabel yang dipilih.
Buat {i>notebook<i} untuk menjelajahi kumpulan hasil kueri
Untuk membuat {i>notebook<i} guna menjelajahi kumpulan hasil kueri, ikuti langkah-langkah berikut:
Buka halaman BigQuery.
Di panel editor, jalankan kueri yang menghasilkan hasil kueri.
Di panel Query results, klik Explore Data, lalu klik Explore with Python notebook.
Notebook baru akan terbuka, yang berisi sel dengan kode untuk menampilkan SQL kueri dan hasil kueri.
Membuat notebook dari notebook lama
Untuk membuka versi notebook lama sebagai notebook baru, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Pilih notebook.
Pilih panel Activity.
Klik
View actions di samping versi notebook, lalu klik Open as new Python notebook.Salinan notebook akan dibuka sebagai notebook baru.
Mengupload notebook
Anda dapat mengupload notebook lokal untuk menggunakannya di BigQuery Studio. Notebook yang diupload kemudian terlihat di halaman BigQuery pada Konsol Google Cloud.
Untuk mengupload notebook, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda, lalu lakukan salah satu hal berikut:
- Di samping Notebooks, klik > Upload to Notebooks. View actions
- Di samping nama project Google Cloud, klik > Upload to project > Python notebook. View actions
Pada dialog Upload Notebook, di kolom Notebook, klik Browse, lalu pilih notebook yang ingin diupload.
Opsional: Di kolom Nama notebook, edit nama notebook.
Di kolom Wilayah, pilih wilayah tempat Anda ingin mengupload notebook.
Klik Upload.
Notebook Anda akan muncul di panel Explorer.
Menghubungkan ke runtime
Gunakan bagian berikut untuk mempelajari cara menghubungkan notebook ke runtime Vertex AI. Runtime adalah resource komputasi yang menjalankan kode di notebook Anda.
Menghubungkan ke runtime default
Runtime default adalah runtime preset yang memerlukan penyiapan minimal.
Untuk terhubung ke runtime default, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook untuk membukanya.
Di notebook, klik Connect, atau jalankan sel apa pun di notebook.
Mungkin perlu waktu beberapa menit untuk terhubung ke runtime default jika Anda belum memiliki runtime aktif.
Menghubungkan ke runtime non-default
Jika ingin menggunakan runtime selain runtime default, Anda harus membuat runtime tambahan tersebut di Vertex AI terlebih dahulu.
Untuk terhubung ke runtime non-default, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook untuk membukanya.
Di notebook, klik drop-down
di samping Hubungkan, lalu klik Hubungkan ke runtime.Klik Connect to an existing runtime.
Di bagian Runtime, pilih runtime yang akan digunakan.
Klik Connect.
Menghubungkan ke runtime baru
Untuk terhubung ke runtime baru, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Klik nama notebook untuk membukanya.
Di notebook, klik drop-down
di samping Hubungkan, lalu klik Hubungkan ke runtime.Klik Create new runtime.
Di bagian Runtime Template, pilih template runtime Vertex AI yang akan digunakan.
Di bagian Runtime name, ketik nama runtime.
Klik Connect.
Memberikan akses ke notebook
Untuk memberi pengguna lain akses ke notebook, tambahkan pengguna tersebut ke peran IAM yang sesuai.
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Temukan notebook yang ingin Anda beri akses.
Klik > Kelola Izin.
Lihat tindakan di samping notebook, lalu klik BagikanDi panel Manage permissions, klik Add user/group.
Di kolom New principals, masukkan akun utama.
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.
Opsional: Untuk melihat daftar lengkap peran dan setelan berbagi lanjutan, klik Berbagi lanjutan.
Klik Save.
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.
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, luaskan folder Shared notebooks. Temukan notebook yang ingin Anda bagikan.
Klik > Copy link.
View actions di samping notebook, lalu klik ShareBagikan link kepada pengguna lain.
Nonaktifkan penyimpanan output notebook
Anda dapat mencegah berbagi output notebook tersimpan kepada pengguna lain yang memiliki akses ke file notebook dengan menonaktifkan penyimpanan output notebook.
Jika Anda menonaktifkan penyimpanan output untuk notebook yang dipilih, BigQuery akan menghapus semua output yang disimpan di file notebook tersebut dan tidak menyimpan output untuk operasi berikutnya.
Namun, pengguna yang memiliki akses ke notebook masih dapat melihat outputnya dengan cara berikut:
- Jalankan notebook untuk melihat outputnya saat ini. Output ini tidak disimpan.
- Lihat versi arsip notebook dan output-nya di histori revisi.
Guna menonaktifkan penyimpanan output untuk notebook yang dipilih, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, lalu pilih notebook yang ingin Anda nonaktifkan penyimpanan output-nya.
Klik > Edit > Setelan notebook.
Aktifkan/nonaktifkan visibilitas headerDi jendela Notebook settings, pilih Hilangkan output sel kode saat menyimpan notebook ini.
Klik Save.
Klik Muat ulang.
Selesaikan konflik
Jika Anda dan pengguna lain membuat perubahan yang bertentangan di notebook, layanan ini akan memunculkan error Automatic saving failed. This file was updated remotely or
in another tab.
dan menyediakan link Show diff
. Untuk menyelesaikan konflik tersebut,
ikuti langkah-langkah berikut:
- Klik link
Show diff
. Dialog Tinjau perubahan jarak jauh akan terbuka. - Opsional: Untuk membandingkan kode sumber notebook, centang kotak Sumber mentah.
- Opsional: Untuk membandingkan versi secara inline, bukan di panel terpisah, centang kotak Inline diff.
- Tinjau perubahan dan putuskan perubahan yang akan dipertahankan, revisi input Anda jika perlu.
- Klik Simpan perubahan.
Mengganti nama notebook
Untuk mengganti nama notebook, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman BigQuery.
Di panel Explorer, luaskan project Anda dan folder Notebooks, dan jika perlu, folder Shared notebooks. Temukan notebook yang ingin diganti namanya.
Klik
View actions di samping notebook, lalu klik Rename.Ketik nama untuk notebook, lalu klik Rename.
Pemecahan masalah
Untuk mengetahui informasi selengkapnya, lihat Memecahkan Masalah Colab Enterprise.
Langkah selanjutnya
- Pelajari cara mengelola notebook.