Membuat ruang kerja pengembangan Dataform

Dokumen ini menunjukkan cara melakukan hal berikut:

Saat Anda membuat ruang kerja pengembangan di repositori baru untuk pertama kalinya, Dataform akan meminta Anda untuk menginisialisasi ruang kerja pengembangan dengan sekumpulan file konfigurasi yang diperlukan agar Dataform dapat berfungsi.

Ruang kerja pengembangan yang diinisialisasi berisi direktori dan file berikut:

  • definitions/: direktori untuk definisi aset, dalam Dataform core 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 project ID Google Cloud dan skema BigQuery untuk memublikasikan aset. Anda dapat mengganti setelan default untuk menyesuaikannya dengan kebutuhan Anda, tetapi Anda tidak diwajibkan untuk mulai menggunakan Dataform.

  • package.json: file konfigurasi dependensi Dataform default dengan versi terbaru @dataform/core. 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 untuk membuat, menginisialisasi, dan menghapus ruang kerja pengembangan, minta administrator untuk memberi Anda peran IAM Dataform Editor (roles/dataform.editor) pada ruang kerja. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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:

  1. Di konsol Google Cloud, buka halaman Dataform.

    Buka Dataform

  2. Pilih repositori tempat Anda ingin membuat ruang kerja pengembangan baru.

  3. Di halaman repositori Anda, klik Create development workspace.

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

    1. Di kolom ID Workspace, masukkan ID unik untuk ruang kerja pengembangan.

      ID hanya dapat berisi angka, huruf, tanda hubung, dan garis bawah.

    2. Klik Create.

Menginisialisasi ruang kerja pengembangan pertama dalam repositori Dataform

Untuk menginisialisasi ruang kerja pengembangan Dataform, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Dataform.

    Buka Dataform

  2. Pilih repositori tempat Anda ingin menginisialisasi ruang kerja kosong.

  3. Di tab Development workspace, klik nama ruang kerja kosong yang ingin diinisialisasi.

  4. Di halaman ruang kerja pengembangan, klik Initialize workspace.

Menghapus ruang kerja pengembangan Dataform

Pembuatan ruang kerja pengembangan Dataform tidak memerlukan biaya. Namun, jika Anda ingin menghapus ruang kerja pengembangan, ikuti langkah-langkah berikut:

  1. Di halaman Dataform, klik repositori yang berisi ruang kerja yang ingin dihapus.

  2. Untuk menghindari penghapusan perubahan yang tidak di-commit, commit dan kirim perubahan ke repositori Git Anda.

  3. Di tab Development workspace, pilih ruang kerja pengembangan yang ingin dihapus, lalu klik Delete selected workspaces.

    Anda dapat menghapus beberapa ruang kerja sekaligus.

  4. Untuk mengonfirmasi, klik Delete.

Langkah selanjutnya