Membuat repositori

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

  • Membuat repositori
  • Menghapus repositori
  • Membagikan repositori
  • Menghubungkan repositori BigQuery ke repositori pihak ketiga secara opsional

Sebelum memulai

  1. 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.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery and Dataform APIs.

    Enable the APIs

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the BigQuery and Dataform APIs.

    Enable the APIs

    8.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan repositori dan ruang kerja, minta administrator untuk memberi Anda peran IAM berikut di repositori dan ruang kerja:

  • Membuat dan mengelola repositori bersama: Pemilik Kode (roles/dataform.codeOwner)
  • Membuat dan menghapus ruang kerja di repositori bersama: Editor Kode (roles/dataform.codeEditor)
  • Membuat, mengubah, dan mengontrol versi file di ruang kerja dalam repositori bersama: Code Editor (roles/dataform.codeEditor)
  • Melihat ruang kerja dan filenya di repositori bersama: Code Viewer (roles/dataform.codeViewer)
  • Membuat dan mengelola repositori pribadi, termasuk semua tindakan dengan ruang kerja dan file di repositori pribadi: Pembuat Kode (roles/dataform.codeCreator)

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

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Akun utama yang memiliki peran Editor Kode di repositori dapat mengedit semua ruang kerja di repositori.

Repositori pribadi yang Anda buat masih dapat dilihat oleh akun utama yang diberi peran BigQuery Admin atau BigQuery Studio Admin di tingkat project. Akun utama ini dapat membagikan repositori pribadi Anda kepada pengguna lain.

Membuat repositori

Untuk membuat repositori BigQuery, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, klik folder Repositori.

  3. Di editor, klik Tambahkan Repositori.

  4. Di panel Create repository, di kolom Repository ID, ketik ID unik.

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

  5. Di menu drop-down Region, pilih region BigQuery untuk menyimpan repositori dan kontennya. Pilih region BigQuery yang paling dekat dengan lokasi Anda.

    Untuk mengetahui daftar region BigQuery yang tersedia, lihat artikel Lokasi BigQuery Studio. Region repositori tidak harus cocok dengan lokasi set data BigQuery Anda.

  6. Klik Buat.

Menghubungkan ke repositori pihak ketiga

Bagian ini menunjukkan cara menghubungkan repositori BigQuery ke repositori jarak jauh. Setelah menghubungkan repositori, Anda dapat melakukan tindakan Git pada file di ruang kerja yang terdapat dalam repositori. Misalnya, mengambil update dari repositori jarak jauh dan mendorong perubahan ke repositori jarak jauh.

Sebaiknya buat repositori BigQuery khusus untuk setiap repositori jarak jauh yang Anda hubungkan. Beri repositori BigQuery nama yang mirip dengan repositori jarak jauh untuk membantu memperjelas pemetaan.

Anda dapat menghubungkan repositori jarak jauh melalui HTTPS atau SSH. Tabel berikut mencantumkan penyedia Git yang didukung dan metode koneksi yang tersedia untuk repositorinya:

Penyedia Git Metode koneksi
Layanan Azure DevOps SSH
Bitbucket SSH
GitHub SSH atau HTTPS
GitLab SSH atau HTTPS

Menghubungkan repositori jarak jauh melalui SSH

Untuk menghubungkan repositori jarak jauh melalui SSH, Anda harus membuat kunci SSH dan secret Secret Manager. Kunci SSH terdiri dari kunci SSH publik dan kunci SSH pribadi. Anda harus membagikan kunci SSH publik kepada penyedia Git, dan membuat secret Secret Manager dengan kunci SSH pribadi. Kemudian, bagikan secret dengan akun layanan BigQuery default Anda.

BigQuery menggunakan secret dengan kunci SSH pribadi untuk login ke penyedia Git Anda guna melakukan perubahan atas nama pengguna. BigQuery membuat commit ini menggunakan alamat email Google Cloud pengguna sehingga Anda dapat mengetahui siapa yang membuat setiap commit.

Untuk menghubungkan repositori jarak jauh ke repositori BigQuery melalui SSH, ikuti langkah-langkah berikut:

  1. Di penyedia Git Anda, lakukan hal berikut:

    Layanan Azure DevOps

    1. Di Azure DevOps Services, buat kunci SSH pribadi.
    2. Upload kunci SSH publik ke repositori Layanan Azure DevOps Anda.

    Bitbucket

    1. Di Bitbucket, buat kunci SSH pribadi.
    2. Upload kunci SSH publik ke repositori Bitbucket Anda.

    GitHub

    1. Di GitHub, periksa kunci SSH yang ada.
    2. Jika Anda tidak memiliki kunci SSH, atau ingin menggunakan kunci baru, buat kunci SSH pribadi.
    3. Upload kunci SSH publik GitHub ke repositori GitHub Anda.

    GitLab

    1. Di GitLab, buat kunci SSH pribadi.
    2. Upload kunci SSH publik GitLab ke repositori GitLab Anda.

  2. Di Secret Manager, buat secret dan tempelkan kunci SSH pribadi Anda sebagai nilai secret. Kunci SSH pribadi Anda harus disimpan dalam file yang mirip dengan ~/.ssh/id_ed25519. Beri nama secret agar Anda dapat menemukannya di masa mendatang.

  3. Berikan akses ke secret ke akun layanan Dataform default Anda.

    Akun layanan Dataform default Anda memiliki format berikut:

    service-PROJECT_NUMBER@gcp-sa-dataform.iam.gserviceaccount.com

  4. Berikan peran roles/secretmanager.secretAccessor ke akun layanan.

  5. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  6. Di panel Penjelajah, luaskan folder Repositori.

  7. Pilih repositori BigQuery yang ingin Anda hubungkan ke repositori jarak jauh.

  8. Di editor, pilih tab Configuration.

  9. Klik Hubungkan dengan Git.

  10. Di panel Connect to remote repository, pilih tombol pilihan SSH.

  11. Di kolom Remote Git repository URL, ketik URL repositori Git jarak jauh, yang diakhiri dengan .git.

    URL repositori Git jarak jauh harus dalam salah satu format berikut:

    • URL absolut: ssh://git@{host_name}[:{port}]/{repository_path}, port bersifat opsional.
    • URL seperti SCP: git@{host_name}:{repository_path}.

  12. Di kolom Default remote branch name, ketik nama cabang utama repositori Git jarak jauh.

  13. Di menu drop-down Secret, pilih secret yang Anda buat yang berisi kunci pribadi SSH.

  14. Di kolom SSH public host key value, ketik kunci host publik penyedia GitHub Anda.

    Layanan Azure DevOps

    Nilai kunci host publik SSH harus dalam format file known_hosts. Nilai harus berisi algoritma dan kunci publik yang dienkode dalam format base64, tetapi tanpa nama host atau IP, dalam format berikut:

    ALGORITHM BASE64_KEY_VALUE

    Untuk mengambil kunci host publik Layanan Azure DevOps, jalankan perintah ssh-keyscan -t rsa ssh.dev.azure.com di terminal.

    Bitbucket

    Nilai kunci host publik SSH harus dalam format file known_hosts. Nilai harus berisi algoritma dan kunci publik yang dienkode dalam format base64, tetapi tanpa nama host atau IP, dalam format berikut:

    ALGORITHM BASE64_KEY_VALUE

    Untuk mengambil kunci host publik Bitbucket, lihat Mengonfigurasi SSH.

    GitHub

    Nilai kunci host publik SSH harus dalam format file known_hosts. Nilai harus berisi algoritma dan kunci publik yang dienkode dalam format base64, tetapi tanpa nama host atau IP, dalam format berikut:

    ALGORITHM BASE64_KEY_VALUE

    Untuk mengambil kunci host publik GitHub, lihat sidik jari kunci SSH GitHub.

    GitLab

    Nilai kunci host publik SSH harus dalam format file known_hosts. Nilai harus berisi algoritma dan kunci publik yang dienkode dalam format base64, tetapi tanpa nama host atau IP, dalam format berikut:

    ALGORITHM BASE64_KEY_VALUE

    Untuk mengambil kunci host publik GitLab, lihat entri known_hosts SSH.

  15. Klik Connect.

Menghubungkan repositori jarak jauh melalui HTTPS

Untuk menghubungkan repositori jarak jauh melalui HTTPS, Anda harus membuat secret Secret Manager dengan token akses pribadi, dan membagikan secret tersebut dengan akun layanan BigQuery default Anda.

BigQuery kemudian menggunakan token akses untuk login ke penyedia GitHub Anda untuk melakukan perubahan atas nama pengguna. BigQuery membuat commit ini menggunakan alamat email Google Cloud pengguna sehingga Anda dapat mengetahui siapa yang membuat setiap commit.

Untuk menghubungkan repositori jarak jauh ke repositori BigQuery melalui HTTPS, ikuti langkah-langkah berikut:

  1. Di penyedia Git Anda, lakukan hal berikut:

    GitHub

    1. Di GitHub, buat token akses pribadi terperinci atau token akses pribadi klasik.

      • Untuk token akses pribadi GitHub yang terperinci, lakukan hal berikut:

      1. Pilih akses repositori hanya ke repositori yang dipilih, lalu pilih repositori yang ingin Anda hubungkan.

      2. Memberikan akses baca dan tulis pada konten repositori.

      3. Tetapkan waktu habis masa berlaku token yang sesuai dengan kebutuhan Anda.

      • Untuk token akses pribadi GitHub klasik, lakukan hal berikut:

      1. Berikan izin repo ke BigQuery.

      2. Tetapkan waktu habis masa berlaku token yang sesuai dengan kebutuhan Anda.

    2. Jika organisasi Anda menggunakan single sign-on (SSO) SAML, izinkan token.

    GitLab

    1. Di GitLab, buat token akses pribadi GitLab.

    2. Beri nama token dataform; ini wajib diisi.

    3. Berikan izin api, read_repository, dan write_repository ke BigQuery.

    4. Tetapkan waktu habis masa berlaku token yang sesuai dengan kebutuhan Anda.

  2. Di Secret Manager, buat secret yang berisi token akses pribadi repositori jarak jauh Anda.

  3. Berikan akses ke secret ke akun layanan Dataform default Anda.

    Akun layanan Dataform default Anda memiliki format berikut:

    service-PROJECT_NUMBER@gcp-sa-dataform.iam.gserviceaccount.com

  4. Berikan peran roles/secretmanager.secretAccessor ke akun layanan.

  5. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  6. Di panel Penjelajah, luaskan folder Repositori.

  7. Pilih repositori BigQuery yang ingin Anda hubungkan ke repositori jarak jauh.

  8. Di editor, pilih tab Configuration.

  9. Klik Hubungkan dengan Git.

  10. Di panel Connect to remote repository, pilih tombol pilihan HTTPS.

  11. Di kolom Remote Git repository URL, ketik URL repositori Git jarak jauh yang diakhiri dengan .git.

    URL repositori Git jarak jauh tidak boleh berisi nama pengguna atau sandi.

  12. Di kolom Default remote branch name, ketik nama cabang utama repositori Git jarak jauh.

  13. Di menu drop-down Secret, pilih secret yang Anda buat yang berisi token akses pribadi.

  14. Klik Connect.

Mengedit koneksi repositori jarak jauh

Untuk mengedit koneksi antara repositori BigQuery dan repositori Git jarak jauh, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman BigQuery.

    Buka BigQuery

  2. Di panel Penjelajah, luaskan folder Repositori.

  3. Pilih repositori BigQuery yang koneksinya ingin Anda edit.

  4. Di editor, pilih tab Configuration.

  5. Di halaman repositori, klik Edit koneksi Git.

  6. Edit setelan koneksi.

  7. Klik Perbarui.

Membagikan repositori

Untuk membagikan repositori, 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 repositori yang ingin Anda bagikan.

  4. Klik opsi Actions, lalu klik Share.

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

  6. Di panel Add User/Group, di kolom New Principals, ketik satu atau beberapa nama pengguna atau grup, yang dipisahkan koma.

  7. Di kolom Peran, pilih peran yang akan ditetapkan ke akun utama baru.

  8. Klik Simpan.

Menghapus repositori

Untuk menghapus repositori 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 repositori yang ingin Anda hapus.

  4. Klik opsi Actions, lalu klik Delete.

  5. Klik Hapus.

Langkah berikutnya