Pengantar pengembangan di ruang kerja

Dokumen ini membantu Anda memahami konsep ruang kerja di Dataform dan kemampuannya.

Di Dataform, Anda berinteraksi dengan kode alur kerja SQL di ruang kerja pengembangan. Ruang kerja pengembangan adalah salinan repositori Anda sendiri yang dapat diedit. Di ruang kerja, Anda membuat, mengedit, atau menghapus konten repositori tanpa memengaruhi orang lain yang bekerja di repositori yang sama, lalu melakukan commit dan mendorong perubahan ke repositori.

Anda dapat mengembangkan alur kerja SQL dengan inti Dataform atau JavaScript. Dataform mengompilasi kode Anda menjadi kueri SQL secara real time.

Di ruang kerja pengembangan, Anda dapat melakukan tugas berikut:

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 yang dikompilasi dan ditentukan di ruang kerja Anda sebagai directed acyclic graph (DAG) interaktif. Jika ada error kompilasi dalam alur kerja SQL, 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 Kode

Tab Code di ruang kerja pengembangan berisi komponen berikut yang memungkinkan Anda mengembangkan alur kerja SQL:

Panel File
Menampilkan struktur file ruang kerja Anda. Menyimpan otomatis hasil edit Anda ke struktur file. File yang dipilih akan terbuka di tab di panel pengembangan. Di kolom Ketik untuk menelusuri, Anda dapat menelusuri file atau direktori di ruang kerja berdasarkan jalurnya.
Panel kontrol versi
Menampilkan status kontrol versi ruang kerja dan opsi kontrol versi.
Panel pengembangan
Menampilkan file yang terbuka di tab. Menyimpan otomatis perubahan pada file yang diedit.
Tombol Run
Menjalankan pratinjau kueri SQL yang dikompilasi.
Tombol Format
Memformat kode JavaScript atau inti Dataform Anda.
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, menampilkan kueri yang dikompilasi dan memvalidasinya melalui uji coba terhadap BigQuery. Jika validasi kueri gagal, akan menampilkan error validasi. Jika validasi kueri berhasil, menampilkan jumlah byte yang akan digunakan eksekusi kueri ke BigQuery.
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 kompilasi menampilkan grafik interaktif alur kerja SQL yang dikompilasi. Grafik menunjukkan semua tindakan dalam alur kerja SQL Anda dan hubungan di antara tindakan tersebut.

Anda dapat memperbesar dan memperkecil, serta menggunakan tarik untuk menavigasi grafik.

Anda dapat memfilter grafik berdasarkan properti berikut:

  • Nama
  • Tag
  • Jenis
    • Pernyataan
    • Pernyataan
    • Tabel Inkremental
    • Tampilan terwujud
    • Operasi
    • Tabel
    • Tidak diketahui
    • Lihat

Anda dapat memilih beberapa filter sekaligus. Dataform akan menerapkannya dengan kondisi OR.

Anda dapat mengklik tindakan di 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 lakukan pada file di ruang kerja dimulai sebagai perubahan lokal yang belum di-commit yang dapat Anda commit, lalu di-push ke repositori sehingga tersedia untuk semua pengguna repositori.

Jika repositori Anda terhubung ke penyedia Git jarak jauh, Anda akan mendorong perubahan dari ruang kerja ke cabang pengembangan utama. Anda memilih cabang utama saat menghubungkan repositori ke penyedia Git jarak jauh. Di repositori Dataform yang tidak terhubung, Anda akan menerapkan perubahan ke cabang default.

Anda juga dapat mengambil 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