Membuat dan menjalankan alur kerja SQL di Dataform

Membuat dan menjalankan alur kerja SQL di Dataform

Panduan memulai ini memandu Anda melalui proses berikut di Dataform untuk membuat alur kerja SQL dan menjalankannya di BigQuery:

• Buat repositori Dataform.
• Buat dan lakukan inisialisasi ruang kerja pengembangan Dataform.
• Buat tampilan.
• Buat tabel.
• Berikan akses Dataform ke BigQuery.
• Menjalankan alur kerja yang dibuat.
• Lihat log eksekusi di Dataform.
• Bersihkan aset yang dibuat.

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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

4. Aktifkan API BigQuery and Dataform.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

7. Aktifkan API BigQuery and Dataform.

   Mengaktifkan API

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:

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

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

Membuat repositori Dataform

1. Di konsol Google Cloud, buka halaman Dataform.

   Buka Dataform

2. Klik Create repository.

3. Di halaman Create repository, lakukan hal berikut:

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

   2. Dalam daftar Region, pilih europe-west4.

   3. Klik Create.

Membuat dan melakukan inisialisasi ruang kerja pengembangan Dataform

1. Di konsol Google Cloud, buka halaman Dataform.

   Buka Dataform

2. Klik quickstart-repository.

3. Klik Create development workspace.

4. Di jendela Create development workspace, lakukan langkah berikut:

   1. Di kolom ID Ruang Kerja, masukkan quickstart-workspace.

   2. Klik Create.

   Halaman ruang kerja pengembangan akan muncul.

5. Klik Inisialisasi ruang kerja.

Catatan: Dataform menginisialisasi ruang kerja Anda dengan serangkaian file direktori dan konfigurasi yang berisi setelan default untuk men-deploy alur kerja. Anda dapat mengganti setelan default di file dataform.json agar sesuai dengan kebutuhan Anda, tetapi ini bukan persyaratan untuk men-deploy alur kerja SQL ke BigQuery. Panduan memulai ini menggunakan setelan Dataform default.

Membuat tampilan

Di bagian berikut, Anda menentukan tampilan yang nantinya akan digunakan sebagai sumber data untuk tabel.

Membuat file SQLX untuk menentukan tampilan

1. Di panel Files, di samping definitions/, klik menu More.

2. Klik Create file.

3. Di panel Create new file, lakukan langkah berikut:

   1. Di kolom Add a file path, masukkan definitions/quickstart-source.sqlx.

   2. Klik Create file.

Menentukan tampilan

1. Di panel Files, luaskan folder definisi.

2. Klik definitions/quickstart-source.sqlx.

3. Dalam file tersebut, masukkan cuplikan kode berikut:

   config {
     type: "view"
   }
   
   SELECT
     "apples" AS fruit,
     2 AS count
   UNION ALL
   SELECT
     "oranges" AS fruit,
     5 AS count
   UNION ALL
   SELECT
     "pears" AS fruit,
     1 AS count
   UNION ALL
   SELECT
     "bananas" AS fruit,
     0 AS count
   

4. Klik Format.

Membuat tabel

Di bagian berikut, Anda akan menentukan jenis tabel dalam file SQLX, lalu menulis pernyataan SELECT untuk menentukan struktur tabel dalam file yang sama.

Membuat file SQLX untuk definisi tabel

1. Di panel Files, di samping definitions/, klik menu More, lalu pilih Create file.

2. Di kolom Add a file path, masukkan definitions/quickstart-table.sqlx.

3. Klik Create file.

Menentukan jenis tabel, struktur, dan dependensi

1. Di panel Files, luaskan direktori definitions/.

2. Pilih quickstart-table.sqlx, lalu masukkan jenis tabel dan pernyataan SELECT berikut:

   config {
     type: "table"
   }
   
   SELECT
     fruit,
     SUM(count) as count
   FROM ${ref("quickstart-source")}
   GROUP BY 1
   

3. Klik Format.

   Catatan: Dalam cuplikan kode sebelumnya, fungsi ref merujuk pada sumber data. Untuk mengetahui informasi selengkapnya, lihat Menentukan tabel.

Setelah menentukan jenis tabel, Dataform akan menampilkan error validasi kueri karena quickstart-source belum ada di BigQuery. Error ini akan diatasi saat Anda menjalankan alur kerja SQL nanti dalam tutorial ini.

Memberikan akses Dataform ke BigQuery

Untuk menjalankan alur kerja di BigQuery, akun layanan Dataform harus memiliki peran yang diperlukan berikut ini:

• BigQuery Data Editor pada project tempat Dataform memerlukan akses baca dan tulis. File tersebut biasanya mencakup project yang menghosting repositori Dataform Anda.
• BigQuery Data Viewer pada project tempat Dataform memerlukan akses hanya baca.
• 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.

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

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

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

7. Klik Simpan.

Menjalankan alur kerja

1. Di konsol Google Cloud, buka halaman Dataform.

   Buka Dataform

2. Di halaman quickstart-workspace, klik Start execution.

3. Klik Semua tindakan.

4. Di panel Execute, klik Start execution.

   Dataform menggunakan setelan repositori default untuk membuat konten alur kerja Anda dalam set data BigQuery yang disebut dataform.

Lihat log eksekusi di Dataform

1. Di halaman quickstart-repository, klik Workflow Execution Logs.

2. Untuk melihat detail eksekusi Anda, klik eksekusi terbaru.

Pembersihan

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

Menghapus set data yang dibuat di BigQuery

Agar tidak menimbulkan biaya untuk aset BigQuery, hapus set data yang bernama dataform.

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di panel Penjelajah, luaskan project Anda lalu pilih dataform.

3. Klik menu Tindakan, lalu pilih Hapus.

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

Menghapus ruang kerja pengembangan Dataform

Pembuatan ruang kerja pengembangan formulir data tidak dikenai biaya, tetapi untuk menghapus ruang kerja pengembangan, Anda dapat mengikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Dataform.

   Buka Dataform

2. Klik quickstart-repository.

3. Di tab Development workspace, klik menu More oleh quickstart-workspace, lalu pilih Delete.

4. Untuk mengonfirmasi, klik Delete.

Menghapus repositori Dataform

Pembuatan repositori formulir data tidak dikenai biaya, tetapi untuk menghapus repositori, Anda dapat mengikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Dataform.

   Buka Dataform

2. Dengan quickstart-repository, klik menu Lainnya di , lalu pilih Hapus.

3. Di jendela Delete repository, masukkan nama repositori untuk mengonfirmasi penghapusan.

4. Untuk mengonfirmasi, klik Delete.

Langkah selanjutnya

• Untuk mempelajari Dataform lebih lanjut, lihat Ringkasan formulir data.

• Untuk mempelajari fitur Dataform lebih lanjut, lihat Ringkasan fitur Dataform.

• Untuk mempelajari Dataform core lebih lanjut, lihat Ringkasan inti Dataform.

• Untuk mempelajari cara mengganti setelan Dataform default pada repositori Anda, lihat Mengonfigurasi setelan Dataform.

• Untuk mempelajari lebih lanjut cara mengelola set data di BigQuery, lihat Mengelola set data.

• Untuk mempelajari lebih lanjut cara mengelola tabel di BigQuery, lihat Mengelola tabel.