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. 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 diperlukan untuk menggunakan repositori dan ruang kerja, minta administrator Anda 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 tetap terlihat oleh prinsipal yang diberi peran Admin BigQuery atau Admin BigQuery Studio 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 Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    2. Di panel Explorer, klik folder Repositories.

    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 isinya. Pilih region BigQuery yang terdekat dengan lokasi Anda.

      Untuk mengetahui daftar wilayah BigQuery yang tersedia, lihat 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 ada dalam repositori. Misalnya, menarik update dari repositori jarak jauh dan mengirim 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. Menghubungkan repositori BigQuery ke repositori jarak jauh dapat gagal jika repositori jarak jauh tidak terbuka untuk internet publik, misalnya, jika repositori tersebut berada di balik firewall. Tabel berikut mencantumkan penyedia Git yang didukung dan metode koneksi yang tersedia untuk repositori mereka:

    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 Anda, dan membuat rahasia Secret Manager dengan kunci SSH pribadi. Kemudian, bagikan secret dengan akun layanan BigQuery default Anda.

    BigQuery menggunakan rahasia dengan kunci SSH pribadi untuk login ke penyedia Git Anda guna melakukan perubahan atas nama pengguna. BigQuery melakukan commit ini menggunakan alamat email Google Cloud pengguna sehingga Anda dapat mengetahui siapa yang melakukan 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 Azure DevOps Services 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 yang ada, 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 rahasia agar Anda dapat menemukannya di masa mendatang.

    3. Berikan akses ke secret untuk 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 Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    6. Di panel Explorer, luaskan folder Repositories.

    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 URL repositori Git jarak jauh, 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 Nilai kunci host publik SSH, ketik kunci host publik penyedia Git 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 Azure DevOps Services, 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 SSH known_hosts.

    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 ke akun layanan BigQuery default Anda.

    Kemudian, BigQuery menggunakan token akses untuk login ke penyedia Git Anda guna melakukan perubahan atas nama pengguna. BigQuery membuat commit ini menggunakan alamat email pengguna Google Cloud 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. Beri BigQuery izin repo.

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

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

      GitLab

      1. Di GitLab, buat token akses pribadi GitLab.

      2. Beri nama token dataform; ini wajib dilakukan.

      3. Beri BigQuery izin api, read_repository, dan write_repository.

      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 untuk 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 Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    6. Di panel Explorer, luaskan folder Repositories.

    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 URL repositori Git jarak jauh, 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 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 Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    2. Di panel Explorer, luaskan folder Repositories.

    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 Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    2. Di panel Explorer, klik folder Repositories.

    3. Di panel Git Repositories, pilih repositori yang ingin Anda bagikan.

    4. Klik opsi Tindakan, lalu klik Bagikan.

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

    6. Di panel Tambahkan Pengguna/Grup, di kolom Principal Baru, ketik satu atau beberapa nama pengguna atau grup, yang dipisahkan dengan koma.

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

    8. Klik Simpan.

    Menghapus repositori

    Untuk menghapus repositori dan semua isinya, ikuti langkah-langkah berikut:

    1. Di Google Cloud konsol, buka halaman BigQuery.

      Buka BigQuery

    2. Di panel Explorer, klik folder Repositories.

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

    4. Klik opsi Tindakan, lalu klik Hapus.

    5. Klik Hapus.

    Langkah berikutnya