Membuat lingkungan pengembangan

Membuat lingkungan pengembangan

Panduan memulai ini akan memandu Anda melalui langkah-langkah untuk membuat lingkungan pengembangan individual di Dataform, sehingga setiap developer dapat bekerja di lingkungan pengembangannya sendiri:

• Buat repositori Dataform.

• Memberikan akses Dataform ke BigQuery.

  • Mengonfigurasi penggantian kompilasi ruang kerja.

  Konfigurasi penggantian kompilasi yang akan diterapkan Dataform ke semua ruang kerja di repositori Anda, yang mengubah ruang kerja menjadi lingkungan pengembangan yang terisolasi.

• Hapus aset yang dibuat.

Sebelum memulai

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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the BigQuery and Dataform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melakukan semua tugas dalam tutorial ini, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

• Admin Dataform (roles/dataform.admin) - repositori
• Editor Dataform (roles/dataform.editor) - ruang kerja dan pemanggilan alur kerja

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

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran kustom atau peran yang telah ditentukan lainnya.

Membuat repositori Dataform

1. Di konsol Google Cloud , buka halaman Dataform.

   Buka Dataform

2. Klik Buat repositori.

3. Di halaman Create repository, lakukan hal berikut:

   1. Di kolom Repository ID, masukkan quickstart-dev.

   2. Dalam daftar Region, pilih europe-west4.

   3. Klik Buat.

4. Klik Selesai.

Memberikan akses Dataform ke BigQuery

Untuk menjalankan alur kerja di BigQuery, akun layanan Dataform atau Akun Google Anda (Pratinjau) harus memiliki peran wajib berikut:

• BigQuery Data Editor di project yang memerlukan akses baca dan tulis Dataform. Biasanya mencakup project yang menghosting repositori Dataform Anda.
• BigQuery Data Viewer di project yang memerlukan akses hanya baca Dataform.
• BigQuery Job User di project yang menghosting repositori Dataform Anda.

Untuk memberikan peran ini, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman IAM.

   Buka halaman IAM

2. Klik Tambahkan.

3. Di kolom New principals, masukkan ID akun layanan Dataform Anda atau email Akun Google Anda (Pratinjau).

4. Di menu Select a role, pilih peran BigQuery Job User.

5. Klik Add another role, lalu di menu Select a role, pilih peran BigQuery Data Editor.

6. Klik Add another role, lalu di menu Select a role, pilih peran BigQuery Data Viewer.

7. Klik Simpan.

Mengonfigurasi penggantian kompilasi ruang kerja

Untuk membuat lingkungan pengembangan terisolasi dengan penggantian kompilasi ruang kerja Dataform, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Dataform.

   Buka Dataform

2. Klik quickstart-dev.

3. Klik Setelan, lalu klik Edit.

4. Di panel Penggantian kompilasi ruang kerja, di kolom Sufiks skema, masukkan ${workspaceName}.

   Saat Anda memicu eksekusi di ruang kerja, Dataform akan menambahkan nama ruang kerja sebagai akhiran ke set skema default yang ditetapkan di setelan alur kerja. Panduan memulai ini menggunakan setelan Dataform default dengan skema default dataform.

5. Klik Simpan.

Dataform menerapkan penggantian kompilasi ruang kerja ke semua ruang kerja di repositori Anda.

Dengan konfigurasi ini, saat Anda menjalankan alur kerja secara manual di ruang kerja, Dataform akan menjalankannya dengan penggantian kompilasi ruang kerja. Akibatnya, Dataform menjalankan alur kerja dalam skema dataform_workspaceName di BigQuery, mengubah ruang kerja menjadi lingkungan pengembangan yang terisolasi.

Misalnya, saat Anda memicu eksekusi secara manual di ruang kerja sasha, Dataform menjalankan alur kerja Anda dalam skema dataform_sasha di BigQuery.

Untuk menjalankan alur kerja tanpa penggantian kompilasi ruang kerja, tetapi tetap mempertahankan penggantian kompilasi ruang kerja untuk lingkungan pengembangan, Anda dapat membuat konfigurasi rilis untuk mengonfigurasi lingkungan eksekusi lainnya, misalnya, staging dan production.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Menghapus set data yang dibuat di BigQuery

Untuk menghindari biaya aset BigQuery, hapus set data dengan nama yang diawali dengan dataform, misalnya, dataform-sasha.

1. Di konsol Google Cloud , buka halaman BigQuery.

   Buka BigQuery

2. Di panel Explorer, luaskan project Anda dan pilih set data.

3. Klik menu Tindakan , lalu pilih Hapus.

4. Pada dialog Delete dataset, masukkan delete ke dalam kolom, lalu klik Delete.

Menghapus repositori Dataform

Tidak ada biaya yang terkait dengan pembuatan repositori Dataform. Namun, jika Anda ingin menghapus repositori dan semua isinya, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Dataform.

   Buka Dataform

2. Pada quickstart-dev, klik menu Lainnya , lalu pilih Hapus.

   1. Di jendela Hapus repositori, masukkan nama repositori untuk mengonfirmasi penghapusan.

3. Untuk mengonfirmasi, klik Hapus.

Langkah berikutnya

• Untuk mempelajari lebih lanjut siklus proses kode di Dataform, lihat Pengantar siklus proses kode di Dataform.

• Untuk mempelajari lebih lanjut praktik terbaik untuk siklus proses alur kerja di Dataform, lihat Praktik terbaik untuk siklus proses alur kerja.

• Untuk mempelajari lebih lanjut penggantian kompilasi ruang kerja di Dataform, lihat Membuat penggantian kompilasi ruang kerja.

• Untuk mempelajari cara menjadwalkan eksekusi produksi di Dataform, lihat Menjadwalkan eksekusi produksi.