Membuat penggantian kompilasi Workspace

Dokumen ini menunjukkan cara membuat penggantian kompilasi ruang kerja untuk memisahkan tabel dan tampilan yang dibuat dari ruang kerja Dataform Anda di BigQuery. Anda dapat menggunakan penggantian kompilasi ruang kerja untuk membuat lingkungan pengembangan Formulir data yang terisolasi.

Tentang penggantian kompilasi Workspace

Saat Anda mengembangkan kode alur kerja SQL di ruang kerja Dataform, Dataform mengompilasi kode di ruang kerja Anda secara real time untuk membuat hasil kompilasi ruang kerja. Formulir data menggunakan setelan yang ditentukan dalam file dataform.json untuk membuat hasil kompilasi ruang kerja. Kemudian, saat Anda memicu eksekusi di ruang kerja, Dataform akan mengeksekusi hasil kompilasi ruang kerja di BigQuery.

Untuk mengganti setelan default yang ditetapkan di dataform.json bagi semua ruang kerja di repositori, Anda dapat membuat penggantian kompilasi ruang kerja.

Dengan penggantian kompilasi Workspace, Anda dapat mengganti setelan berikut untuk semua ruang kerja di repositori Anda:

Project
Project Google Cloud tempat Dataform menjalankan hasil kompilasi workspace, yang ditetapkan di dataform.json sebagai defaultDatabase.
Awalan tabel
Awalan kustom ditambahkan ke semua nama tabel di semua ruang kerja dalam repositori.
Akhiran skema
Akhiran kustom ditambahkan ke skema tabel yang ditentukan dalam defaultSchema di dataform.json atau di parameter schema dalam blok config tabel.

Untuk membuat lingkungan pengembangan yang terisolasi, Anda dapat mengisolasi ruang kerja dengan penggantian kompilasi yang unik. Anda dapat mengubah penggantian awalan tabel dan kompilasi akhiran skema secara dinamis dengan variabel ${workspaceName}.

Saat Anda memicu eksekusi secara manual di ruang kerja, variabel ${workspaceName} akan memasukkan nama ruang kerja ke penggantian kompilasi ruang kerja.

Jika Anda menetapkan ${workspaceName} sebagai awalan tabel, Dataform akan menambahkan nama ruang kerja ke nama semua tabel di ruang kerja. Setelah eksekusi, di BigQuery, Anda dapat mengidentifikasi ruang kerja asal tabel.

Saat Anda menetapkan ${workspaceName} sebagai akhiran skema, Dataform akan menambahkan nama ruang kerja ke defaultSchema, sehingga membuat skema kustom yang didedikasikan untuk ruang kerja. Setelah eksekusi, di BigQuery, Anda dapat menemukan semua tabel yang dieksekusi dari ruang kerja tertentu dalam skema khusus.

Contoh penggantian kompilasi ruang kerja dinamis

Contoh berikut menampilkan penggantian kompilasi ruang kerja dinamis yang diterapkan ke repositori yang berisi ruang kerja yang diberi nama berdasarkan developer yang bekerja di repositori: Sasha dan Kai.

Tujuan dari penggantian kompilasi ruang kerja dalam contoh ini adalah untuk membuat lingkungan pengembangan terisolasi untuk Sasha dan Kai.

Setelan default berikut ditetapkan di dataform.json:

  • defaultDatabase : analytics
  • defaultSchema: dataform

Penggantian kompilasi ruang kerja berikut membuat awalan tabel dinamis dan akhiran skema untuk setiap ruang kerja di repositori:

  • ID Project Google Cloud : analytics_dev
  • Awalan tabel: ${workspaceName}
  • Akhiran skema: ${workspaceName}

Saat Sasha memicu eksekusi secara manual di ruang kerja Sasha, Dataform menjalankan kontennya dengan setelan berikut:

  • Project Google Cloud: analytics_dev
  • skema: dataform_sasha
  • nama tabel: sasha_name, misalnya sasha_orders.

Saat Kai memicu eksekusi secara manual di ruang kerja Kai, Dataform menjalankan kontennya dengan setelan berikut:

  • Project Google Cloud: analytics_dev
  • skema: dataform_kai
  • nama tabel: kai_name, misalnya, kai_orders

Sebelum memulai

  1. Di konsol Google Cloud, buka halaman Dataform.

    Buka halaman Dataform

  2. Pilih atau buat repositori.

  3. Opsional: Untuk mengganti project Google Cloud default, beri akun layanan Dataform Anda akses ke project Google Cloud yang akan digunakan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan dalam membuat penggantian kompilasi ruang kerja, minta administrator untuk memberi Anda peran IAM Admin Dataform (roles/dataform.admin) pada repositori. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Membuat penggantian kompilasi Workspace

Untuk membuat penggantian kompilasi Ruang kerja Dataform, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Settings.
  2. Klik Edit.
  3. Di panel Penggantian kompilasi Workspace, di kolom ID Project Google Cloud, masukkan ID project Google Cloud.
  4. Di kolom Awalan tabel, masukkan awalan untuk semua nama tabel.
    1. Opsional: Untuk membuat awalan tabel dinamis yang unik bagi setiap ruang kerja, masukkan ${workspaceName} sebagai awalan tabel.
  5. Di kolom Schema suffix, masukkan akhiran untuk ditambahkan ke skema tabel atau tampilan yang dibuat.
    1. Opsional: Untuk membuat akhiran skema dinamis yang unik untuk setiap ruang kerja, masukkan ${workspaceName} sebagai akhiran tabel.
  6. Klik Simpan.

Formulir data menerapkan penggantian kompilasi ruang kerja ke semua ruang kerja di repositori Anda.

Edit penggantian kompilasi ruang kerja

Untuk mengedit penggantian kompilasi Ruang kerja Dataform, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Settings.
  2. Klik Edit.
  3. Edit penggantian kompilasi ruang kerja, lalu klik Simpan.

Hapus penggantian kompilasi ruang kerja

Untuk menghapus penggantian kompilasi Ruang kerja Dataform, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Settings.
  2. Klik Edit.
  3. Di panel Penggantian kompilasi Workspace, klik Clear all, lalu klik Save.

Langkah selanjutnya

  • Untuk mempelajari cara memicu eksekusi secara manual, lihat Memicu eksekusi.