Dokumen ini membantu Anda memahami konsep ruang kerja dalam Dataform dan kemampuannya.
Di Dataform, Anda berinteraksi dengan kode alur kerja SQL di ruang kerja pengembangan. Ruang kerja pengembangan adalah salinan repositori yang dapat Anda edit. Di ruang kerja, Anda membuat, mengedit, atau menghapus konten repositori tanpa memengaruhi orang lain yang bekerja di repositori yang sama, lalu meng-commit dan mengirim perubahan ke repositori.
Anda dapat mengembangkan alur kerja SQL dengan Dataform core atau JavaScript. Dataform mengompilasi kode Anda ke dalam kueri SQL secara {i>real time<i}.
Di ruang kerja pengembangan, Anda dapat melakukan tugas-tugas berikut:
- Mengonfigurasi setelan Dataform
- Buat tabel dari semua jenis yang didukung
- Tabel Dokumen
- Tabel partisi
- Menambahkan label BigQuery dan tag kebijakan ke tabel
- Mengonfigurasi setelan tabel tambahan
- Mendeklarasikan sumber data untuk alur kerja SQL Anda
- Menambahkan operasi SQL kustom dan tag ke alur kerja SQL Anda
- Memicu eksekusi alur kerja SQL Anda atau tindakan yang dipilihnya
- Memeriksa log eksekusi
Komponen ruang kerja pengembangan
Ruang kerja pengembangan Dataform terdiri dari tab berikut:
- Kode
- Berisi lingkungan pengembangan tempat Anda dapat menjelajahi file, mengembangkan kueri, mengontrol versi perubahan, dan memicu eksekusi ke BigQuery.
- Grafik yang dikompilasi
- Menampilkan alur kerja SQL terkompilasi yang ditentukan di ruang kerja Anda sebagai DAG yang interaktif. Jika ada error kompilasi dalam alur kerja SQL Anda, tab akan menampilkan pesan error, bukan grafik.
- Eksekusi
- Menampilkan log semua eksekusi yang dipicu di ruang kerja. Anda juga dapat melihat tindakan dan detailnya untuk eksekusi yang dipilih. Untuk mengetahui informasi selengkapnya, lihat Memeriksa log eksekusi ruang kerja.
Komponen tab Code
Tab Kode ruang kerja pengembangan berisi komponen berikut yang memungkinkan Anda mengembangkan alur kerja SQL:
- Panel file
- Menampilkan struktur file ruang kerja Anda. Menyimpan hasil edit Anda secara otomatis ke struktur file. File yang dipilih akan terbuka di tab di panel pengembangan. Di kolom Type to search, Anda dapat menelusuri file atau direktori di ruang kerja berdasarkan jalurnya.
- Panel kontrol versi
- Menampilkan status kontrol versi ruang kerja Anda dan opsi kontrol versi.
- Panel pengembangan
- Menampilkan file yang terbuka di tab. Menyimpan perubahan Anda secara otomatis ke file yang diedit.
- Tombol Run
- Menjalankan pratinjau kueri SQL yang dikompilasi.
- Tombol format
- Memformat inti Dataform atau kode JavaScript.
- Status kompilasi
- Menampilkan status kompilasi kode di ruang kerja Anda.
- Panel metadata
- Menampilkan metadata file yang sedang diedit.
- Panel kueri yang dikompilasi
- Mengompilasi kueri dalam file yang sedang diedit ke SQL. Jika kompilasi kueri gagal, error kompilasi akan ditampilkan. Jika kompilasi kueri berhasil, kueri yang dikompilasi akan ditampilkan dan divalidasi melalui uji coba terhadap BigQuery. Jika validasi kueri gagal, error validasi akan ditampilkan. Jika validasi kueri berhasil, jumlah byte yang akan digunakan oleh eksekusi kueri ke BigQuery akan ditampilkan.
- Drop-down Mulai eksekusi
- Menampilkan opsi untuk memicu eksekusi seluruh alur kerja di ruang kerja Anda atau elemen yang dipilih.
Komponen tab Grafik yang dikompilasi
Tab grafik yang Dikompilasi menampilkan grafik interaktif dari alur kerja SQL yang Anda kompilasi. Grafik ini menunjukkan semua tindakan dalam alur kerja SQL Anda dan hubungan di antara tindakan tersebut.
Anda dapat memperbesar dan memperkecil, serta menggunakan tarik untuk membuka grafik.
Anda dapat memfilter grafik menurut properti berikut:
- Nama
- Tag
- Jenis
- Pernyataan
- Pernyataan
- Tabel Inkremental
- Tampilan terwujud
- Operasi
- Tabel
- Tidak diketahui
- Lihat
Anda dapat memilih beberapa filter sekaligus.
Formulir data akan menerapkannya dengan kondisi OR
.
Anda dapat mengklik tindakan dalam grafik untuk melihat detailnya di panel berikut:
- Panel metadata
- Menampilkan nama lengkap, jenis, dependensi, dan dependen dari tindakan yang dipilih.
- Panel kueri
- Menampilkan kueri SQL yang dikompilasi dari tindakan yang dipilih.
Kontrol versi di ruang kerja
Di ruang kerja, Anda berinteraksi dengan repositori melalui kontrol versi berbasis Git. Pengeditan yang Anda buat pada file di ruang kerja dimulai sebagai perubahan lokal tanpa komitmen yang dapat Anda lakukan, lalu dikirim ke repositori Anda agar tersedia untuk semua pengguna repositori.
Jika repositori Anda terhubung ke penyedia Git jarak jauh, Anda akan mengirim perubahan dari ruang kerja ke cabang pengembangan utama Anda. Anda memilih cabang utama saat menghubungkan repositori ke penyedia Git jarak jauh. Di repositori Dataform yang tidak terhubung, Anda mengirim perubahan ke cabang default.
Anda juga dapat menarik perubahan apa pun dari repositori Dataform atau repositori jarak jauh dan menggabungkannya dengan perubahan lokal di ruang kerja pengembangan Anda. Untuk informasi selengkapnya tentang kontrol versi di Dataform, lihat Kontrol versi kode Anda.
Langkah selanjutnya
- Untuk mempelajari cara membuat dan menginisialisasi ruang kerja, lihat Membuat ruang kerja.
- Untuk mempelajari cara mengontrol versi kode Dataform, lihat Versi mengontrol kode Anda.
- Untuk mempelajari cara menjalankan pratinjau guna menguji kueri SQL, lihat Melihat pratinjau kueri SQL.