Membuat dan mengelola folder

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Untuk memberikan masukan atau meminta dukungan terkait fitur ini, kirim email ke [e-mail].

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 penyiapan 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

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Anda untuk memberi Anda peran IAM yang sesuai di project, folder, atau resource.

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

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

Hal berikut berlaku untuk file dan folder yang memuatnya:

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, menyetel 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.
Pemberi Komentar Kode (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 membuat kueri konten file dan folder.
Pembuat Kode (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.
Pengomentar Folder Tim (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 isinya. Pengguna dengan peran ini dapat melihat folder tim dan mendapatkan kebijakan IAM-nya.
Pembuat Folder Tim (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 bawaan 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

• Membuat folder:
  • folders.create di folder pengguna induk, folder tim, atau project
  • folders.addContents di folder induk atau folder tim
• Mengambil properti folder: folders.get di folder
• Mengueri konten folder atau folder tim: folders.queryContents pada folder
• Memperbarui folder: folders.update pada folder
• Menghapus folder: folders.delete pada folder
• Mendapatkan kebijakan IAM untuk folder: folders.getIamPolicy di folder tersebut
• Tetapkan 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 memindahkan ke folder root)
• Membuat folder tim: teamFolders.create pada project
• Menghapus folder tim: teamFolders.delete di folder tim
• Mendapatkan kebijakan IAM untuk folder tim: teamFolders.getIamPolicy di folder tim
• Tetapkan 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 di project Anda, minta administrator Anda untuk memberi Anda peran IAM berikut di project:

• Dataform Admin (roles/dataform.admin)
• Editor Dataform (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 File untuk membuka browser file:

   

   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 Pengguna (alamat email Anda) untuk melihat folder dan file yang telah Anda buat.
   • Luaskan node Folder tim untuk melihat semua folder tim yang dapat Anda akses.
   • Perluas node Dibagikan kepada saya untuk melihat semua folder dan file yang telah dibagikan pengguna lain kepada Anda.

Mengubah wilayah kode

Anda dapat memiliki folder dan aset kode di berbagai region kode. Ikuti langkah-langkah berikut untuk mengubah region kode yang Anda lihat:

1. Buka halaman BigQuery.

   Buka BigQuery

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

   

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

4. Pilih wilayah kode yang ingin Anda lihat.

5. Klik Simpan.

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 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 File untuk membuka browser file:

   

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

4. Klik Lihat tindakan > Buat, 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 File untuk membuka browser file:

   

3. Pilih node root folder tim.

4. Klik View actions > Create team folder.

5. Di dialog Buat folder tim, ketik nama untuk folder tim.

6. Klik Buat.

Mengupload aset kode

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

1. Buka halaman BigQuery.

   Buka BigQuery

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

   

3. Pilih folder tempat Anda ingin mengupload aset kode.

4. Klik Lihat tindakan > Upload, lalu pilih jenis aset kode yang ingin Anda upload.

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

   • Klik tombol pilihan Upload file, lalu telusuri 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 tempat menyimpan aset kode. 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 File untuk membuka browser file:

   

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 File untuk membuka browser file:

   

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

4. Klik Lihat tindakan > Ganti nama.

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 File untuk membuka browser file:

   

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

4. Di panel Izin berbagi, klik Tambahkan Pengguna/Grup.

5. Di kolom New principals, masukkan akun utama.

6. Lakukan salah satu hal berikut:

   • Di daftar Peran, 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 Peran, 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 Tutup.

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 File untuk membuka browser file:

   

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

4. Klik Lihat tindakan > Pindahkan.

5. Pada dialog pindahkan resource, pilih folder pengguna atau tim yang menjadi tujuan pemindahan resource.

6. Klik Pindahkan.

Menyalin folder atau aset kode

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

1. Buka halaman BigQuery.

   Buka BigQuery

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

   

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

4. Klik Lihat tindakan > Salin.

5. Di dialog salin resource, pilih folder pengguna atau tim yang ingin Anda gunakan untuk 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 File untuk membuka browser file:

   

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

4. Klik Lihat tindakan > Hapus.

5. Pada dialog hapus resource, klik Hapus.

Langkah berikutnya

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