Membuat dan mengelola ruang kerja

Pratinjau

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

Catatan: Untuk memberikan masukan atau mengajukan pertanyaan terkait fitur Pratinjau ini, hubungi [e-mail].

Saat menggunakan repositori BigQuery untuk mengontrol versi file, Anda menggunakan workspace untuk mengedit kode dalam repositori tersebut. Dokumen ini menunjukkan cara membuat, menghapus, dan mengelola file di ruang kerja.

Untuk pengalaman kontrol versi berbasis folder, sebaiknya gunakan repositori Git BigQuery Studio. Integrasi ini memungkinkan Anda menggunakan cabang Git secara langsung di browser file BigQuery Studio dan meng-clone beberapa repositori sekaligus tanpa mengelola ruang kerja terpisah.

Sebelum memulai

Jika Anda belum melakukannya, buat repositori BigQuery.

Peran yang diperlukan

Akses ke ruang kerja ditentukan oleh peran yang diberikan di repositori induknya. Untuk informasi selengkapnya, lihat Peran yang diperlukan.

Membuat ruang kerja

Pembuatan ruang kerja ditangani secara berbeda berdasarkan apakah Anda menggunakan repositori BigQuery atau repositori pihak ketiga.

Membuat ruang kerja di repositori BigQuery

Untuk membuat ruang kerja baru di repositori BigQuery, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori tempat Anda ingin membuat ruang kerja.

4. Di editor, klik Add Workspace.

5. Di panel Create development workspace, di kolom Workspace ID, masukkan ID unik untuk ruang kerja.

   ID hanya boleh berisi angka, huruf, tanda hubung, dan garis bawah.

6. Klik Create.

Membuat ruang kerja di repositori pihak ketiga

Untuk membuat ruang kerja baru di repositori pihak ketiga, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori tempat Anda ingin membuat ruang kerja.

4. Di editor, klik Add Workspace. Tindakan ini akan membuka panel Create development workspace.

5. Pilih tombol pilihan Existing remote branch atau New branch, bergantung pada apakah Anda ingin menggunakan cabang yang ada atau baru untuk ruang kerja.

6. Tentukan cabang yang akan digunakan:

   1. Jika Anda memilih tombol pilihan Existing remote branch, pilih cabang yang ada di kolom Remote branch.

   2. Jika Anda memilih tombol pilihan Cabang baru, ketik nama cabang di kolom ID Ruang Kerja. Nama cabang yang dibuat di repositori pihak ketiga sama dengan ID ruang kerja BigQuery.

      ID hanya boleh berisi angka, huruf, tanda hubung, dan garis bawah.

7. Klik Create.

Membuat direktori di ruang kerja

Untuk membuat direktori di ruang kerja, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Klik Open creation menu.

6. Klik Create in repository > Directory.

7. Di kolom Tambahkan jalur direktori, ketik jalur direktori.

8. Klik Create directory.

Bekerja dengan file di ruang kerja

Anda dapat membuat file baru di ruang kerja, atau mengupload file yang ada.

Anda dapat membuat atau mengupload jenis file berikut ke repositori:

• Kueri SQL
• Notebook Python
• Data canvases
• Persiapan data
• File jenis lainnya

Membuat file

Untuk membuat file di ruang kerja, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Klik Open creation menu.

6. Klik Create in repository, lalu klik jenis file yang ingin Anda buat.

7. Di kolom Name, ketik nama file.

8. Opsional: Di kolom direktori induk, ketik jalur direktori tempat Anda ingin membuat file.

9. Klik Simpan.

Upload file

Untuk mengupload file ke ruang kerja, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Klik Open creation menu.

6. Klik Upload ke repositori, lalu klik jenis file yang ingin Anda upload.

7. Di panel upload, lakukan salah satu tindakan berikut:

   • Di kolom File upload, klik Browse, pilih file, lalu klik Open.
   • Di kolom URL, ketik URL untuk file.

8. Opsional: di kolom direktori induk, ketik jalur direktori tempat Anda ingin membuat file.

9. Klik Upload.

Menghapus file

Untuk menghapus file dari ruang kerja, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Pilih file yang ingin Anda hapus, klik View actions, lalu klik Delete.

6. Klik Hapus untuk mengonfirmasi.

Menggunakan kontrol versi dengan file

Bagian ini menunjukkan cara menggunakan kontrol versi di BigQuery untuk melacak file di ruang kerja.

BigQuery menggunakan Git untuk melacak setiap perubahan yang dilakukan pada file di dalam repositori. Di repositori BigQuery, Anda berinteraksi langsung dengan repositori Git. Di repositori yang terhubung, Anda berinteraksi dengan cabang default repositori jarak jauh yang Anda konfigurasi saat menghubungkan repositori.

BigQuery menampilkan opsi kontrol versi berdasarkan status perubahan di ruang kerja Anda. Misalnya, BigQuery hanya menampilkan opsi commit jika ada perubahan lokal yang belum di-commit di ruang kerja Anda. Jika file di ruang kerja Anda merupakan salinan persis dari cabang default atau default, BigQuery akan menampilkan status Up to date.

BigQuery menampilkan opsi kontrol versi berikut:

Terapkan X perubahan

Commit X jumlah perubahan lokal di ruang kerja Anda atau file yang diubah yang dipilih. BigQuery akan menampilkan perubahan yang belum di-commit.

Push ke cabang default

Kirim perubahan yang di-commit ke cabang default Anda. Opsi ini tersedia di repositori jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja dan ada commit yang belum di-push.

Kirim ke your-branch-name

Kirim perubahan yang di-commit ke your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja. Nama cabang jarak jauh di repositori pihak ketiga sama dengan ID ruang kerja BigQuery.

Tarik dari cabang default

Perbarui ruang kerja Anda dengan perubahan terbaru dari cabang default Anda. Opsi ini tersedia di repositori jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.

Tarik dari your-branch-name

Perbarui ruang kerja Anda dengan perubahan terbaru dari your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja. Nama cabang jarak jauh di repositori pihak ketiga sama dengan ID ruang kerja BigQuery.

Kembalikan ke commit terakhir

Pulihkan file di ruang kerja Anda ke statusnya dari commit terakhir.

Tarik perubahan

Jika ruang kerja Anda tidak sinkron dengan repositori, BigQuery akan menampilkan opsi Pull.

Untuk mengambil perubahan dari repositori ke ruang kerja, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Di panel ruang kerja, lakukan hal berikut:

   1. Jika Anda berada di repositori BigQuery, klik Pull from default branch.

   2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, lakukan salah satu langkah berikut:

      1. Klik Pull from default branch untuk mengambil dari cabang default repositori pihak ketiga.
      2. Klik Pull from your-branch-name untuk mengambil dari cabang repositori pihak ketiga yang sesuai dengan ruang kerja saat ini.

Commit perubahan

Setelah Anda membuat perubahan di ruang kerja, BigQuery akan menampilkan opsi Commit. Anda dapat meng-commit semua perubahan lokal atau file yang dipilih. File yang telah Anda tambahkan atau ubah diidentifikasi dengan titik biru di sampingnya di panel ruang kerja.

Catatan: BigQuery secara default menggunakan alamat email pengguna yang diautentikasi Google Cloud untuk penulis commit, tetapi Dataform API memungkinkan penetapan alamat email kustom untuk penulis commit. Perilaku ini mirip dengan perintah git commit --author dan hanya memengaruhi histori commit Git. Identitas penulis commit tidak diverifikasi secara kriptografis.

Untuk meng-commit perubahan dari ruang kerja ke repositori, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Di panel ruang kerja, klik Commit X changes.

6. Di panel Commit changes, lakukan tindakan berikut:

   1. Pilih file yang diubah yang ingin Anda commit.

      Jika Anda tidak memilih file apa pun, BigQuery akan meng-commit semua perubahan lokal. Anda dapat memfilter file yang diubah berdasarkan status file, nama file, dan jalur.

   2. Di kolom Add a commit message, ketik deskripsi untuk commit Anda.

   3. Klik Commit All changes, atau Commit X changes.

      Nama tombol bergantung pada pilihan file yang akan di-commit.

Terapkan perubahan

BigQuery menampilkan opsi Push setelah Anda meng-commit perubahan.

Untuk mengirim perubahan dari ruang kerja ke repositori, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Di panel ruang kerja, lakukan hal berikut:

   1. Jika Anda berada di repositori BigQuery, klik Push to default branch.

   2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, lakukan salah satu langkah berikut:

      1. Klik Push to default branch untuk mengirim ke cabang default repositori pihak ketiga.
      2. Klik Push to your-branch-name untuk mengirim ke cabang repositori pihak ketiga yang sesuai dengan ruang kerja saat ini.

Mengembalikan perubahan yang belum di-commit

Untuk mengembalikan perubahan yang belum di-commit, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Di panel ruang kerja, klik drop-down panah pada tombol kontrol versi, lalu klik Revert to last commit.

Menyelesaikan konflik penggabungan

Konflik penggabungan dapat terjadi jika perubahan lokal di ruang kerja Anda tidak kompatibel dengan perubahan yang telah dilakukan pada cabang default repositori Anda. Konflik penggabungan biasanya terjadi saat beberapa pengguna mengedit file yang sama secara bersamaan.

Anda biasanya mengalami konflik penggabungan saat mengambil dari cabang setelah pengguna lain mengirim perubahan yang bertentangan ke cabang yang sama. Anda harus menyelesaikan konflik penggabungan secara manual dengan mengedit file yang terpengaruh.

Contoh kode berikut menunjukkan konflik penggabungan yang ditampilkan dalam file SQL:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Untuk menyelesaikan konflik penggabungan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Pilih file yang terpengaruh dan edit dengan perubahan yang Anda pilih.

6. Commit perubahan.

7. Opsional: Kirim perubahan.

Melihat histori commit

Untuk melihat histori commit, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda gunakan.

4. Temukan ruang kerja, lalu klik Open.

   Tindakan ini akan membuka ruang kerja di panel Source control.

5. Di panel ruang kerja, klik panah drop-down pada tombol kontrol versi, lalu klik Lihat histori commit.

Menghapus ruang kerja

Untuk menghapus ruang kerja dan semua kontennya, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel kiri, klik Source control.

   

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

3. Pilih repositori yang berisi ruang kerja yang ingin Anda hapus.

4. Temukan ruang kerja Anda, lalu klik Open actions > Delete.

5. Klik Hapus.

Langkah berikutnya

• Pelajari cara mengelola kode dengan repositori Git BigQuery Studio.
• Pelajari cara membuat repositori.