Membuat konfigurasi rilis

Dokumen ini menunjukkan cara membuat konfigurasi rilis di Dataform untuk mengonfigurasi template setelan kompilasi, yang dapat Anda jalankan sesuai jadwal. Anda dapat menggunakan konfigurasi rilis untuk mengonfigurasi lingkungan eksekusi, misalnya, staging dan produksi.

Tentang konfigurasi rilis Dataform

Untuk menjalankan alur kerja SQL di BigQuery, Dataform mengompilasi kode alur kerja SQL menjadi hasil kompilasi. Proses ini terjadi secara otomatis saat Anda mengembangkan alur kerja SQL di ruang kerja Dataform.

Konfigurasi rilis memungkinkan Anda menyesuaikan hasil kompilasi. Anda dapat menggunakannya untuk membuat lingkungan eksekusi, misalnya, staging.

Setelan konfigurasi rilis

Dalam konfigurasi rilis, Anda dapat mengonfigurasi penggantian kompilasi setelan alur kerja, menetapkan variabel kompilasi, dan menetapkan frekuensi pembuatan hasil kompilasi.

Konfigurasi rilis Dataform berisi setelan kompilasi berikut:

Setelan rilis
ID rilis, commit git untuk hasil kompilasi, dan frekuensi pembuatan hasil kompilasi. Frekuensi adalah setelan opsional. Jika ditetapkan, frekuensi minimumnya adalah 1 jam.
Penggantian kompilasi
Penggantian project Google Cloud, awalan tabel, akhiran skema, dan variabel kompilasi yang ditentukan di setelan alur kerja.

Cara kerja konfigurasi rilis

Dataform membuat hasil kompilasi dari konfigurasi rilis pada frekuensi yang ditentukan, atau saat Anda memicu kompilasi. Frekuensi adalah setelan opsional dan tidak diperlukan untuk membuat konfigurasi rilis. Jika ditetapkan, frekuensi minimumnya adalah 1 jam. Anda dapat memicu kompilasi secara manual di halaman Detail konfigurasi rilis, atau memicu kompilasi dengan Dataform API releaseConfigs.

Selama kompilasi, Dataform mengambil kode dari commitish Git yang ditentukan dari repositori Anda. Kemudian, Dataform mengompilasi kode dengan penggantian kompilasi yang diterapkan (jika ada), dan membuat hasil kompilasi. Hasil kompilasi terbaru yang dibuat untuk konfigurasi rilis adalah hasil kompilasi live.

Anda dapat menjadwalkan eksekusi hasil kompilasi dari konfigurasi rilis di konfigurasi alur kerja. Anda juga dapat menjalankan konfigurasi rilis yang dipilih di luar jadwal apa pun. Selama eksekusi konfigurasi alur kerja, Dataform akan mengeksekusi hasil kompilasi langsung dari konfigurasi rilis yang dipilih.

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 dalam konfigurasi rilis, berikan akses akun layanan Dataform Anda ke project Google Cloud yang ingin Anda gunakan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat konfigurasi rilis, minta administrator untuk memberi Anda peran IAM Dataform Editor (roles/dataform.editor) di repositori. 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.

Membuat konfigurasi rilis

Untuk membuat konfigurasi rilis Dataform, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Di bagian Release configurations, klik Create.
  3. Di panel Create release configuration, konfigurasikan setelan rilis.

    1. Di kolom Release ID, masukkan ID unik untuk konfigurasi rilis.

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

    2. Di kolom Git commitish, masukkan cabang Git atau SHA commit Git untuk rilis.

    Dalam repositori Dataform yang tidak terhubung ke repositori jarak jauh, nilainya selalu main.

    1. Opsional: Di drop-down Frequency, pilih frekuensi pembuatan hasil kompilasi.

      Jika ditetapkan, frekuensi minimumnya adalah 1 jam.

  4. Opsional: Di bagian Penggantian kompilasi, konfigurasikan setelan kompilasi.

    1. Di kolom Google Cloud Project ID, masukkan ID project Google Cloud tempat Anda ingin menyimpan hasil kompilasi.
    2. Di kolom Schema suffix, masukkan akhiran untuk ditambahkan ke skema yang dikonfigurasi di setelan alur kerja.
    3. Di kolom Table prefix, masukkan awalan untuk semua nama tabel.
  5. Opsional: Di bagian Compilation variables, tetapkan variabel kompilasi.

    1. Klik Tambahkan variabel.
    2. Di kolom Key, masukkan variabel kompilasi.
    3. Di kolom Value, masukkan nilai untuk variabel kompilasi.
    4. Untuk menambahkan variabel kompilasi lain, klik Tambahkan variabel.
  6. Klik Create.

Jika Anda mengganti project Google Cloud default, pastikan akun layanan Dataform Anda memiliki akses ke project Google Cloud yang ditetapkan dalam konfigurasi rilis.



Misalnya, konfigurasi rilis berikut membuat hasil kompilasi production dari cabang main setiap jam, tanpa penggantian kompilasi:

  • ID Rilis: production
  • Git commitish: main
  • Frekuensi: setiap jam
  • tidak ada penggantian kompilasi

Melihat detail konfigurasi rilis

Anda dapat melihat detail konfigurasi rilis berikut:

  • Setelan rilis
    • Git commitish
    • Stempel waktu hasil kompilasi terbaru
    • Jadwal cron
    • Penggantian kompilasi
    • Variabel kompilasi
  • Hasil kompilasi live
    • Stempel waktu pembuatan
    • Git commitish
    • SHA Commit
  • Hasil kompilasi sebelumnya

Untuk melihat detail konfigurasi rilis, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Pilih konfigurasi rilis.
  3. Di halaman Release configuration details, periksa detail konfigurasi rilis.

Tabel Hasil kompilasi terjadwal menampilkan hasil kompilasi sebelumnya yang dibuat secara otomatis oleh konfigurasi rilis.

Tabel Hasil kompilasi Manual/API menampilkan hasil kompilasi yang dibuat secara manual atau melalui panggilan ke Dataform API dari 1.000 hasil kompilasi terbaru di repositori.

Memicu kompilasi secara manual

Untuk membuat hasil kompilasi secara manual dari konfigurasi rilis yang dipilih, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Pilih konfigurasi rilis.
  3. Di halaman Detail konfigurasi rilis, klik Kompilasi baru.

Hasil kompilasi yang baru dibuat menjadi hasil aktif untuk konfigurasi rilis tersebut.

Hasil kompilasi manual ditampilkan dalam tabel Hasil kompilasi manual/API di halaman Detail konfigurasi rilis.

Memicu eksekusi konfigurasi rilis

Untuk memicu eksekusi hasil kompilasi live dalam konfigurasi rilis yang dipilih ke BigQuery, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Di bagian Release configurations, klik Start execution.
  3. Di panel Execute manual workflow, di drop-down Release configuration, pilih konfigurasi rilis.
  4. Pilih tindakan alur kerja SQL yang akan dieksekusi:
    1. Untuk menjalankan seluruh alur kerja SQL, klik All actions.
    2. Untuk menjalankan tindakan yang dipilih dalam alur kerja SQL, klik Pemilihan tindakan, lalu pilih tindakan.
    3. Untuk menjalankan tindakan dengan tag yang dipilih, klik Pemilihan tag, lalu pilih tag.
  5. Opsional: Untuk menjalankan tindakan atau tag yang dipilih dan dependensinya, pilih opsi Sertakan dependensi.
  6. Opsional: Untuk menjalankan tindakan atau tag yang dipilih dan dependensinya, pilih opsi Sertakan dependensi.
  7. Opsional: Untuk mem-build ulang semua tabel dari awal, pilih opsi Run with full refresh.

    Tanpa opsi ini, Dataform akan memperbarui tabel inkremental tanpa membangun ulang dari awal.

  8. Klik Mulai eksekusi.

Mengedit konfigurasi rilis

Untuk mengedit konfigurasi rilis, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Di konfigurasi rilis yang ingin diedit, klik menu Lainnya, lalu klik Edit.
  3. Di panel Edit release configuration, edit setelan konfigurasi rilis, lalu klik Save.

Menghapus konfigurasi rilis

Untuk menghapus konfigurasi rilis, ikuti langkah-langkah berikut:

  1. Di repositori Anda, buka Rilis & Penjadwalan.
  2. Di konfigurasi rilis yang ingin Anda hapus, klik menu Lainnya, lalu klik Hapus.
  3. Pada dialog Hapus konfigurasi rilis, klik Hapus.

Langkah selanjutnya