Dokumen ini menunjukkan cara melakukan hal berikut:
Saat Anda membuat ruang kerja pengembangan di repositori baru untuk pertama kalinya, Dataform akan meminta Anda untuk melakukan inisialisasi ruang kerja pengembangan dengan serangkaian file konfigurasi yang diperlukan agar Dataform berfungsi.
Ruang kerja pengembangan yang diinisialisasi berisi direktori dan file berikut:
definitions/
: direktori untuk definisi aset, di inti Dataform atau JavaScript.includes/
: direktori kosong untuk skrip dan variabel yang dapat Anda gunakan kembali di seluruh repositori.dataform.json
: file konfigurasi Dataform default yang berisi ID project Google Cloud dan skema BigQuery untuk memublikasikan aset. Anda dapat mengganti setelan default untuk menyesuaikannya dengan kebutuhan Anda, tetapi hal ini bukan persyaratan untuk mulai menggunakan Dataform.package.json
: file konfigurasi dependensi Dataform default dengan@dataform/core
versi terbaru. Anda dapat menggunakan file ini untuk mengimpor paket.definitions/sample.sqlx
: contoh file SQLX untuk membantu Anda memulai.
Sebelum memulai
Jika Anda belum melakukannya, buat repositori Dataform.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna membuat, melakukan inisialisasi, dan menghapus ruang kerja pengembangan,
minta administrator untuk memberi Anda
peran IAM Dataform Editor (roles/dataform.editor
) di ruang kerja.
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 ruang kerja pengembangan Dataform
Untuk membuat ruang kerja pengembangan Dataform baru, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Dataform.
Pilih repositori tempat Anda ingin membuat ruang kerja pengembangan baru.
Di halaman repositori, klik Create development workspace.
Di jendela Create development workspace, lakukan hal berikut:
Di kolom Workspace ID, masukkan ID unik untuk workspace pengembangan.
ID hanya boleh berisi angka, huruf, tanda hubung, dan garis bawah.
Klik Create.
Melakukan inisialisasi ruang kerja pengembangan pertama di repositori Dataform
Untuk melakukan inisialisasi ruang kerja pengembangan Dataform, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Dataform.
Pilih repositori tempat Anda ingin melakukan inisialisasi ruang kerja kosong.
Di tab Development workspaces, klik nama ruang kerja kosong yang ingin diinisialisasi.
Di halaman ruang kerja pengembangan, klik Initialize workspace.
Menghapus ruang kerja pengembangan Dataform
Tidak ada biaya yang terkait dengan pembuatan ruang kerja pengembangan Dataform. Namun, jika Anda ingin menghapus ruang kerja pengembangan, ikuti langkah-langkah berikut:
Di halaman Dataform, klik repositori yang berisi ruang kerja yang ingin Anda hapus.
Untuk menghindari penghapusan perubahan yang belum di-commit, commit dan kirim perubahan ke repositori Git Anda.
Di tab Development workspaces, pilih ruang kerja pengembangan yang ingin Anda hapus, lalu klik Delete selected workspaces.
Anda dapat menghapus beberapa ruang kerja sekaligus.
Untuk mengonfirmasi, klik Hapus.
Langkah selanjutnya
Untuk mempelajari cara menentukan tabel, lihat Menentukan tabel.
Untuk mempelajari Dataform lebih lanjut, lihat Ringkasan Dataform.