Membuat dan mengelola folder

Dokumen berikut menjelaskan cara membuat dan mengelola folder di BigQuery. Anda dapat menggunakan folder untuk mengatur dan mengontrol akses ke aset kode file tunggal, seperti notebook, kueri tersimpan, kanvas data, dan file persiapan data. BigQuery menawarkan folder pengguna bagi individu untuk mengelola aset kode mereka sendiri, dan folder tim untuk mengelola aset kode tim.

Folder BigQuery didukung oleh Dataform.

Sebelum membuat folder, pelajari cara kerja folder BigQuery dengan membaca Mengatur aset kode dengan folder.

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan tugas dalam dokumen ini, minta administrator untuk memberi Anda peran IAM yang sesuai pada project, folder, atau resource.

Untuk mendapatkan izin yang diperlukan untuk menggunakan file browser BigQuery, minta administrator untuk memberi Anda peran BigQuery User (roles/bigquery.user) atau BigQuery Studio User (roles/bigquery.studioUser) pada project.

Izin yang diberikan pada folder akan diterapkan ke semua file dan folder yang ada di dalamnya.

Hal berikut berlaku untuk file dan folder yang berisi file tersebut:

Peran	Diberikan pada	Izin dan kasus penggunaan
Pemilik Kode (roles/dataform.codeOwner)	File atau folder	Memberikan kontrol penuh atas resource dalam sistem file dan folder. Pengguna dengan peran ini dapat melakukan semua tindakan, termasuk menghapus resource, menetapkan kebijakan IAM-nya, dan memindahkannya.
Editor Kode (roles/dataform.codeEditor)	File atau folder	Memungkinkan pengeditan dan pengelolaan konten. Pengguna dengan peran ini dapat menambahkan konten ke folder, mengedit file, dan mendapatkan kebijakan IAM untuk file atau folder. Peran ini juga diperlukan di folder tujuan saat memindahkan resource.
Code Commenter (roles/dataform.codeCommenter)	File atau folder	Memungkinkan pemberian komentar pada aset atau folder kode.
Code Viewer (roles/dataform.codeViewer)	File atau folder	Memberikan akses hanya baca. Pengguna dengan peran ini dapat mengkueri konten file dan folder.
Code Creator (roles/dataform.codeCreator)	Project	Memberikan izin untuk membuat file dan folder baru dalam project.

Peran berikut khusus untuk mengelola folder tim:

Peran	Diberikan pada	Izin dan kasus penggunaan
Pemilik Folder Tim (roles/dataform.teamFolderOwner)	Folder tim	Memberikan kontrol penuh atas folder tim dalam sistem file dan folder. Pengguna dengan peran ini dapat menghapus folder tim dan menetapkan kebijakan IAM-nya.
Kontributor Folder Tim (roles/dataform.teamFolderContributor)	Folder tim	Memungkinkan pengelolaan konten dalam folder tim. Pengguna dengan peran ini dapat memperbarui folder tim.
Team Folder Commenter (roles/dataform.teamFolderCommenter)	Folder tim	Memungkinkan pemberian komentar pada folder tim dan aset kode yang ada di dalamnya.
Team Folder Viewer (roles/dataform.teamFolderViewer)	Folder tim	Memberikan akses hanya baca ke folder tim dan kontennya. Pengguna dengan peran ini dapat melihat folder tim dan mendapatkan kebijakan IAM-nya.
Team Folder Creator (roles/dataform.teamFolderCreator)	Project	Memberikan izin untuk membuat folder tim baru dalam project.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menyelesaikan tugas dalam dokumen ini. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

• Buat folder:
  • folders.create di folder pengguna induk, folder tim, atau project
  • folders.addContents di folder induk atau folder tim
• Mengambil properti folder: folders.get pada folder
• Membuat kueri konten folder atau folder tim: folders.queryContents di folder
• Memperbarui folder: folders.update pada folder
• Menghapus folder: folders.delete pada folder
• Mendapatkan kebijakan IAM untuk folder: folders.getIamPolicy di folder tersebut
• Menetapkan kebijakan IAM untuk folder: folders.setIamPolicy di folder tersebut
• Memindahkan folder:
  • folders.move pada folder yang dipindahkan
  • folders.addContents di folder tujuan atau folder tim (tidak diperlukan jika dipindahkan ke folder root)
• Membuat folder tim: teamFolders.create di project
• Menghapus folder tim: teamFolders.delete di folder tim
• Mendapatkan kebijakan IAM untuk folder tim: teamFolders.getIamPolicy di folder tim
• Menetapkan kebijakan IAM untuk folder tim: teamFolders.setIamPolicy di folder tim
• Mengambil properti folder tim: teamFolders.get di folder tim
• Memperbarui folder tim: teamFolders.update di folder tim

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan lainnya.

Untuk mendapatkan akses penuh ke semua folder dan file dalam project Anda, minta administrator untuk memberi Anda peran IAM berikut pada project:

• Dataform Admin (roles/dataform.admin)
• Dataform Editor (roles/dataform.editor)
• Dataform Viewer (roles/dataform.viewer)

Lihat referensi

Ikuti langkah-langkah berikut untuk melihat folder dan aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

   Jika Anda tidak melihat panel kiri, klik Luaskan panel kiri untuk membuka panel.

3. Lakukan salah satu langkah berikut untuk melihat folder dan aset kode di project dan region kode yang dipilih:

   • Luaskan node User (alamat email Anda) untuk melihat folder dan file yang telah Anda buat.
   • Luaskan node Team folders untuk melihat semua folder tim yang dapat Anda akses.
   • Luaskan node Dibagikan kepada saya untuk melihat semua folder dan file yang telah dibagikan pengguna lain kepada Anda.

Catatan: Saat Anda membuka folder, breadcrumb di bagian atas tampilan folder akan menampilkan jalur lengkap ke lokasi Anda saat ini. Jalur ini terlihat hingga tingkat folder yang izinnya Anda miliki.

Menetapkan region default untuk aset kode

Anda dapat memiliki folder dan aset kode di region kode yang berbeda.

Semua aset kode baru di project Google Cloud Anda menggunakan region default. Setelah aset dibuat, Anda tidak dapat mengubah regionnya.

Penting: Jika Anda mengubah region saat membuat aset kode, region tersebut akan menjadi default untuk semua aset kode berikutnya. Aset kode yang ada tidak terpengaruh.

Untuk menetapkan region default bagi aset kode baru, lakukan hal berikut:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Di samping nama project, klik View files panel actions > Switch code region.

4. Pilih region kode yang ingin Anda gunakan sebagai default.

5. Klik Simpan.

Untuk mengetahui daftar region yang didukung, lihat Lokasi BigQuery Studio.

Memuat ulang konten folder

Untuk memastikan bahwa perubahan terbaru yang Anda buat atau yang dibagikan oleh orang lain terlihat di file browser, lakukan hal berikut:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih folder yang ingin Anda muat ulang, seperti node root pengguna, root folder tim, atau folder individual.

4. Klik View actions > Refresh contents.

Membuat aset folder atau kode

Gunakan prosedur ini untuk membuat salah satu resource berikut:

• Folder pengguna atau aset kode di tingkat mana pun.
• Subfolder di folder tim.
• Aset kode di subfolder dari folder tim.

Untuk mengetahui informasi tentang cara membuat folder tim, lihat Membuat folder tim.

Ikuti langkah-langkah berikut untuk membuat folder atau aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih node root pengguna atau folder tempat Anda ingin membuat resource.

4. Klik View actions > Create, lalu pilih jenis resource yang ingin Anda buat.

5. Di panel buat resource, ketik nama untuk resource baru.

6. Klik Simpan.

Membuat folder tim

Ikuti langkah-langkah berikut untuk membuat folder tim di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih node root folder tim.

4. Klik View actions > Create team folder.

5. Di dialog Create team folder, ketik nama untuk folder tim.

6. Klik Create.

Mengupload aset kode

Ikuti langkah-langkah berikut untuk mengupload aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih folder tempat Anda ingin mengupload aset kode.

4. Klik View actions > Upload, lalu pilih jenis aset kode yang ingin Anda upload.

5. Di panel upload resource, lakukan salah satu tindakan berikut:

   • Klik tombol pilihan File upload, lalu cari dan pilih file lokal.
   • Klik tombol pilihan URL, lalu ketik URL untuk file aset kode yang berada di repositori GitHub.

6. Ketik nama untuk aset kode.

7. Opsional: Pilih region untuk menyimpan aset kode.

   Catatan: Jika Anda memilih region yang berbeda dengan nilai default, region yang Anda pilih akan menjadi region default tempat semua aset kode baru dibuat ke depannya.

8. Klik Simpan.

Mendownload aset kode

Ikuti langkah-langkah berikut untuk mendownload aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih aset kode yang ingin Anda download.

4. Klik View actions > Download.

Mengganti nama folder atau aset kode

Ikuti langkah-langkah berikut untuk mengganti nama folder atau aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih folder atau aset kode yang ingin Anda ganti namanya.

4. Klik View actions > Rename.

5. Dalam dialog penggantian nama resource, ketik nama baru untuk resource.

6. Klik Ganti nama.

Membagikan folder atau aset kode

Ikuti langkah-langkah berikut untuk membagikan folder atau aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih folder atau aset kode yang ingin Anda bagikan.

4. Di panel Share permissions, klik Add User/Group.

5. Di kolom New principals, masukkan akun utama.

6. Lakukan salah satu hal berikut:

   • Di daftar Role, pilih salah satu peran berikut untuk membagikan aset kode, termasuk folder pengguna:

     • roles/dataform.codeOwner: Dapat melakukan tindakan apa pun pada aset kode, termasuk menghapus atau membagikannya.
     • roles/dataform.codeEditor: Dapat melakukan tindakan apa pun pada aset kode, kecuali menghapus atau membagikannya.
     • roles/dataform.codeCommenter: Dapat melihat dan mengomentari aset kode.
     • roles/dataform.codeViewer: Dapat melihat aset kode.

   • Di daftar Role, pilih salah satu peran berikut untuk membagikan folder tim:

     • roles/dataform.teamFolderOwner: Dapat melakukan tindakan apa pun pada folder tim, termasuk menghapus atau membagikannya.
     • roles/dataform.teamFolderContributor: Dapat melakukan tindakan apa pun pada folder tim, kecuali menghapus atau membagikannya.
     • roles/dataform.teamFolderCommenter: Dapat melihat dan mengomentari folder tim dan aset kode yang ada di dalamnya.
     • roles/dataform.teamFolderViewer: Dapat melihat folder tim dan aset kode yang ada di dalamnya.

7. Klik Simpan.

8. Untuk kembali ke halaman informasi notebook, klik Close.

Memindahkan folder atau aset kode

Ikuti langkah-langkah berikut untuk memindahkan folder atau aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Bergantung pada jumlah resource yang ingin Anda pindahkan, lakukan salah satu hal berikut:

   • Memindahkan satu resource: Di browser file, pilih folder atau aset kode yang ingin Anda pindahkan, lalu klik Lihat tindakan > Pindahkan.
   • Memindahkan beberapa resource: Di tampilan folder, centang kotak di samping setiap resource yang ingin Anda pindahkan, lalu klik Move.

4. Dalam dialog pindahkan resource, pilih folder pengguna atau folder tim tempat Anda ingin memindahkan resource.

5. Klik Pindahkan.

Catatan: Operasi pemindahan massal bersifat independen. Jika satu resource gagal dipindahkan, operasi akan tetap mencoba menyelesaikan pemindahan untuk semua resource terpilih lainnya.

Menyalin aset kode

Ikuti langkah-langkah berikut untuk menyalin aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Pilih aset kode yang ingin Anda salin.

4. Klik Lihat tindakan > Salin.

5. Dalam dialog salin resource, pilih folder pengguna atau tim tempat Anda ingin menyalin resource.

6. Klik Copy.

Menghapus folder atau aset kode

Ikuti langkah-langkah berikut untuk menghapus folder atau aset kode di BigQuery:

1. Buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Files untuk membuka file browser:

   

3. Bergantung pada jumlah resource yang ingin Anda hapus, lakukan salah satu hal berikut:

   • Menghapus satu resource: Di file browser, pilih folder atau aset kode yang ingin Anda hapus, lalu klik View actions > Delete.
   • Menghapus beberapa resource: Di tampilan folder, centang kotak di samping setiap resource yang ingin Anda hapus, lalu klik Delete.

4. Pada dialog hapus resource, klik Delete.

Catatan: Saat menghapus beberapa resource, folder yang dipilih harus kosong agar operasi berhasil. Operasi penghapusan massal bersifat independen; jika satu resource gagal dihapus, operasi akan tetap mencoba menyelesaikan penghapusan untuk semua resource lain yang dipilih.

Langkah berikutnya

• Mengatur aset kode dengan folder
• Membuat notebook
• Membuat kueri tersimpan
• Membuat kanvas data
• Membuat persiapan data