Membuat dan menggunakan ruang kerja

Dokumen ini menunjukkan cara menggunakan ruang kerja di BigQuery, termasuk tugas berikut:

  • Membuat ruang kerja
  • Menghapus ruang kerja
  • Bekerja dengan file di ruang kerja
  • Melakukan kontrol versi pada file di ruang kerja

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 mengetahui 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 Penjelajah, luaskan folder Repositori.

  3. Pilih repositori tempat Anda ingin membuat ruang kerja.

  4. Di editor, klik Tambahkan Ruang Kerja.

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

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

  6. Klik Buat.

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 Penjelajah, luaskan folder Repositori.

  3. Pilih repositori tempat Anda ingin membuat ruang kerja.

  4. Di editor, klik Tambahkan Ruang Kerja. Tindakan ini akan membuka panel Create workspace.

  5. Pilih tombol pilihan Cabang jarak jauh yang ada atau Cabang baru, 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 Buat.

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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Klik opsi Tambahkan.

  6. Klik Create in repository > Directory.

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

  8. Klik Create Directory.

Menggunakan file di ruang kerja

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

Anda dapat membuat atau mengupload jenis file berikut ke repositori:

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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, cari ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Lakukan salah satu hal berikut:

    • Klik opsi Tambahkan.
    • Pilih direktori yang ada, lalu klik opsi Actions.

  6. Klik Buat di repositori, lalu klik jenis file yang ingin Anda buat.

  7. Di kolom Name, ketik nama file.

  8. Opsional: Di kolom Parent directory, ketik jalur direktori tempat file akan dibuat.

  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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, cari ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Lakukan salah satu hal berikut:

    • Klik opsi Tambahkan.
    • Pilih direktori yang ada, lalu klik opsi Actions.

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

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

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

  8. Opsional: di kolom Parent directory, ketik jalur direktori tempat file akan dibuat.

  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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, cari ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Pilih file yang ingin Anda hapus, klik opsi Tindakan, lalu klik Hapus.

  6. Klik Hapus.

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 konfigurasikan saat menghubungkan repositori.

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

BigQuery menampilkan opsi kontrol versi berikut:

Melakukan commit perubahan X
Commit jumlah perubahan lokal X di ruang kerja Anda atau file yang diubah yang dipilih. BigQuery 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.
Menarik dari cabang default
Memperbarui ruang kerja dengan perubahan terbaru dari cabang default Anda. Opsi ini tersedia di repositori jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.
Menarik 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.

Menarik perubahan

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

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

  1. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  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 hal berikut:

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

Melakukan commit perubahan

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

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

  1. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

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

  6. Di panel Commit changes, lakukan hal berikut:

    1. Pilih file yang diubah yang ingin Anda commit.

      Jika Anda tidak memilih file apa pun, BigQuery akan melakukan commit terhadap semua perubahan lokal. Anda dapat memfilter file yang diubah menurut status file, nama file, dan jalur.

    2. Di kolom Tambahkan pesan commit, ketik deskripsi untuk commit Anda.

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

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

Mendorong perubahan

BigQuery menampilkan opsi Push setelah Anda melakukan 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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  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 hal berikut:

      1. Klik Push to default branch untuk melakukan push ke cabang default repositori pihak ketiga.
      2. Klik Push to your-branch-name untuk melakukan push 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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Di panel ruang kerja, klik drop-down panah di tombol kontrol versi, lalu klik Kembalikan ke commit terakhir.

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 menarik dari cabang setelah pengguna lain telah mendorong perubahan yang bertentangan ke cabang yang sama. Anda perlu 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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

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

  6. Commit perubahan.

  7. Opsional: Tekan 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 Penjelajah, luaskan folder Repositori.

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

  4. Di editor, temukan ruang kerja, lalu klik Buka.

    Tindakan ini akan membuka panel ruang kerja:

    Panel ruang kerja.

  5. Di panel ruang kerja, klik drop-down panah di 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 Penjelajah, klik folder Repositori.

  3. Di panel Git Repositories, pilih ruang kerja yang ingin Anda hapus.

  4. Klik opsi Actions, lalu klik Delete.

  5. Klik Hapus.

Langkah berikutnya