Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola repositori

Dokumen ini menunjukkan cara melakukan hal berikut di Dataform:

Konfigurasi setelan alur kerja Dataform.
Mengelola paket inti Dataform.
Mengontrol versi kode Anda.

Sebelum memulai

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan tugas dalam dokumen ini, minta administrator Anda untuk memberi Anda peran IAM berikut:

Konfigurasi setelan Dataform dan kelola lokasi paket inti Dataform: Admin Dataform (roles/dataform.admin) di repositori.
Perbarui paket inti Dataform dan gunakan kontrol versi di Dataform: Editor Dataform (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 kustom atau peran yang telah ditentukan lainnya.

Mengonfigurasi setelan alur kerja Dataform

Bagian ini menunjukkan cara mengedit setelan pemrosesan alur kerja Dataform untuk repositori tertentu.

Anda mungkin ingin mengedit file setelan untuk mengganti nama skema atau menambahkan variabel kompilasi kustom ke repositori Anda.

Tentang setelan repositori

Setiap repositori Dataform berisi file setelan alur kerja yang unik. File ini berisi ID project Google Cloud dan skema tempat Dataform memublikasikan aset di BigQuery. Dataform menggunakan setelan default yang dapat Anda ganti untuk menyesuaikan kebutuhan dengan mengedit file setelan.

Mulai dari Dataform core 3.0.0, setelan alur kerja disimpan dalam file workflow_settings.yaml secara default. Pada versi Dataform core sebelumnya, setelan alur kerja disimpan dalam file dataform.json. File workflow_settings.yaml Dataform core 3.0 kompatibel dengan file dataform.json. Anda dapat terus menggunakan file dataform.json untuk menyimpan setelan alur kerja. Sebagai praktik terbaik, Anda harus memigrasikan setelan alur kerja repositori Anda ke format workflow_settings.yaml untuk kompatibilitas di masa mendatang.

Tentang `workflow_settings.yaml`

File workflow_settings.yaml, yang diperkenalkan di Dataform core 3.0, menyimpan setelan alur kerja Dataform dalam format YAML.

Contoh kode berikut menunjukkan contoh file workflow_settings.yaml:

  defaultProject: my-gcp-project-id
  defaultDataset: dataform
  defaultLocation: australia-southeast2
  defaultAssertionDataset: dataform_assertions

Dalam contoh kode sebelumnya, pasangan nilai kunci dijelaskan sebagai berikut:

defaultProject: ID project BigQuery Google Cloud Anda.
defaultDataset: set data BigQuery tempat Dataform membuat aset, yang secara default disebut dataform.
defaultLocation (opsional): lokasi set data BigQuery default Anda. Dataform menggunakan lokasi ini untuk memproses kode Anda dan menyimpan hasilnya. Lokasi pemrosesan ini harus cocok dengan lokasi set data BigQuery Anda. Namun, lokasi ini tidak harus cocok dengan lokasi repositori Dataform.

Jika Anda tidak menetapkan parameter defaultLocation, Dataform akan menentukan lokasi berdasarkan set data yang dirujuk oleh kueri SQL Anda. Cara kerjanya sebagai berikut:
- Jika kueri Anda mereferensikan set data dari lokasi yang sama, Dataform menggunakan lokasi tersebut.
- Jika kueri Anda mereferensikan set data dari dua atau beberapa lokasi yang berbeda, akan terjadi error. Untuk mengetahui detail tentang batasan ini, lihat Replikasi set data lintas-region.
- Jika kueri Anda tidak mereferensikan set data apa pun, lokasi default untuk Dataform adalah multi-region US. Untuk memilih lokasi lain, tetapkan lokasi default. Atau, gunakan variabel sistem @@location dalam kueri Anda. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi.
defaultAssertionDataset: set data BigQuery tempat Dataform membuat tampilan dengan hasil pernyataan, yang secara default disebut dataform_assertions.

Untuk mengetahui informasi selengkapnya tentang properti workflow_settings.yaml, lihat WorkflowSettings di GitHub.

Anda dapat mengakses properti yang ditentukan dalam workflow_settings.yaml di kode Dataform sebagai properti objek dataform.projectConfig.

Pemetaan berikut dari opsi workflow_settings.yaml ke opsi dataform.projectConfig yang dapat diakses kode berlaku:

defaultProject => defaultDatabase
defaultDataset => defaultSchema
defaultAssertionDataset => assertionSchema
projectSuffix => databaseSuffix
datasetSuffix => schemaSuffix
namePrefix => tablePrefix

Contoh kode berikut menunjukkan objek dataform.projectConfig yang dirujuk dalam pernyataan SELECT dalam tampilan:

  config { type: "view" }
  SELECT ${when(
    !dataform.projectConfig.tablePrefix,
    "table prefix is set!",
    "table prefix is not set!"
  )}

Tentang `dataform.json`

File dataform.json menyimpan setelan alur kerja Dataform dalam format JSON.

Contoh kode berikut menunjukkan contoh file dataform.json:

  {
    "warehouse": "bigquery",
    "defaultDatabase": "my-gcp-project-id",
    "defaultSchema": "dataform",
    "defaultLocation": "australia-southeast2",
    "assertionSchema": "dataform_assertions"
  }

Dalam contoh kode sebelumnya, pasangan nilai kunci dijelaskan sebagai berikut:

warehouse: penunjuk ke BigQuery, tempat Dataform membuat aset.
defaultDatabase: ID project BigQuery Google Cloud Anda.
defaultSchema: set data BigQuery tempat Dataform membuat aset.
defaultLocation (opsional): lokasi set data BigQuery default Anda. Dataform menggunakan lokasi ini untuk memproses kode Anda dan menyimpan hasilnya. Lokasi pemrosesan ini harus cocok dengan lokasi set data BigQuery Anda. Namun, lokasi ini tidak harus cocok dengan lokasi repositori Dataform.

Jika Anda tidak menetapkan parameter defaultLocation, Dataform akan menentukan lokasi berdasarkan set data yang dirujuk oleh kueri SQL Anda. Cara kerjanya sebagai berikut:
- Jika kueri Anda mereferensikan set data dari lokasi yang sama, Dataform menggunakan lokasi tersebut.
- Jika kueri Anda mereferensikan set data dari dua atau beberapa lokasi yang berbeda, akan terjadi error. Untuk mengetahui detail tentang batasan ini, lihat Replikasi set data lintas-region.
- Jika kueri Anda tidak mereferensikan set data apa pun, lokasi default untuk Dataform adalah multi-region US. Untuk memilih lokasi lain, tetapkan lokasi default. Atau, gunakan variabel sistem @@location dalam kueri Anda. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi.
assertionSchema: set data BigQuery tempat Dataform membuat tampilan dengan hasil pernyataan, yang secara default disebut dataform_assertions.

Anda dapat mengakses properti yang ditentukan dalam file dataform.json di kode project sebagai properti objek dataform.projectConfig.

Mengonfigurasi nama skema

Untuk mengonfigurasi nama skema, Anda perlu mengedit properti defaultDataset dan defaultAssertionSchema di file workflow_settings.yaml, atau properti defaultSchema dan assertionSchema di file dataform.json.

Untuk mengonfigurasi nama skema, ikuti langkah-langkah berikut:

`workflow_settings.yaml`

Di ruang kerja pengembangan Anda, di panel Files, klik file workflow_settings.yaml.
Edit nilai defaultDataset, defaultAssertionSchema, atau keduanya.

Contoh kode berikut menunjukkan nama defaultDataset kustom yang ditentukan dalam file workflow_settings.yaml:

  ...
  defaultDataset: mytables
  ...

`dataform.json`

Di ruang kerja pengembangan Anda, di panel Files, klik file dataform.json.
Edit nilai defaultSchema, assertionSchema, atau keduanya.

Contoh kode berikut menunjukkan nama defaultSchema kustom yang ditentukan dalam file dataform.json:

{
  ...
  "defaultSchema": "mytables",
  ...
}

Membuat variabel kompilasi kustom

Variabel kompilasi berisi nilai yang dapat Anda ubah dengan penggantian kompilasi dalam konfigurasi rilis atau dalam permintaan Dataform API.

Setelah menentukan variabel kompilasi di workflow_settings.yaml dan menambahkannya ke tabel yang dipilih, Anda dapat mengubah nilainya dalam konfigurasi rilis atau penggantian kompilasi Dataform API untuk menjalankan tabel secara bersyarat.

Untuk mengetahui informasi selengkapnya tentang cara menjalankan tabel secara bersyarat menggunakan variabel kompilasi, lihat Pengantar siklus proses kode di Dataform.

Untuk membuat variabel kompilasi yang dapat Anda gunakan di seluruh repositori, ikuti langkah-langkah berikut:

`workflow_settings.yaml`

Buka ruang kerja pengembangan Dataform Anda.
Di panel Files, pilih file workflow_settings.yaml.
Masukkan cuplikan kode berikut:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Ganti kode berikut:
- VARIABLE: nama untuk variabel
- VALUE: nilai default variabel kompilasi

Contoh kode berikut menunjukkan variabel kompilasi myVariableName yang ditetapkan ke myVariableValue dalam file workflow_settings.yaml:

...
vars:
  myVariableName: myVariableValue
...

Contoh kode berikut menunjukkan file workflow_settings.yaml dengan variabel kompilasi executionSetting yang ditetapkan ke dev:

defaultProject: default_bigquery_database
defaultLocation: us-west1
defaultDataset: dataform_data,
vars:
executionSetting: dev

`dataform.json`

Buka ruang kerja pengembangan Dataform Anda.
Di panel Files, pilih file dataform.json.
Masukkan cuplikan kode berikut:
```
"vars": {
  "VARIABLE":"VALUE"
}
```
Ganti kode berikut:
- VARIABLE: nama untuk variabel
- VALUE: nilai default variabel kompilasi

Contoh kode berikut menunjukkan variabel kompilasi myVariableName yang ditetapkan ke myVariableValue dalam file dataform.json:

{
  ...
  "vars": {
    "myVariableName": "myVariableValue"
  },
  ...
}

Contoh kode berikut menunjukkan file dataform.json dengan variabel kompilasi executionSetting yang ditetapkan ke dev:

{
"warehouse": "bigquery",
"defaultSchema": "dataform_data",
"defaultDatabase": "default_bigquery_database".
"defaultLocation":"us-west-1",
"vars": {
"executionSetting":"dev"
}
}

Menambahkan variabel kompilasi ke tabel

Untuk menambahkan variabel kompilasi ke file definisi tabel SQLX, ikuti langkah-langkah berikut:

Buka ruang kerja pengembangan Dataform Anda.
Di panel Files, pilih file definisi tabel SQLX.
Dalam file, masukkan klausa when dalam format berikut:
```
${when(dataform.projectConfig.vars.VARIABLE === "SET_VALUE", "CONDITION")}
```
Ganti kode berikut:
- VARIABLE: nama variabel Anda—misalnya, executionSetting
- SET_VALUE: nilai untuk variabel—misalnya, staging
- CONDITION: kondisi untuk eksekusi tabel

Contoh kode berikut menunjukkan file SQLX definisi tabel dengan klausa when dan variabel executionSetting yang menjalankan 10% data dalam setelan eksekusi penyiapan:

  select
    *
  from ${ref("data")}
  ${when(
    dataform.projectConfig.vars.executionSetting === "staging",
    "where mod(farm_fingerprint(id) / 10) = 0",
  )}

Contoh kode berikut menunjukkan file SQLX definisi tampilan dengan klausa when dan variabel myVariableName:

  config { type: "view" }
  SELECT ${when(
    dataform.projectConfig.vars.myVariableName === "myVariableValue",
    "myVariableName is set to myVariableValue!",
    "myVariableName is not set to myVariableValue!"
  )}

Memigrasikan setelan alur kerja ke `workflow_settings.yaml`

Untuk memastikan file setelan alur kerja Anda kompatibel dengan versi framework inti Dataform mendatang, Anda harus memigrasikan setelan alur kerja dari file dataform.json ke file workflow_settings.yaml.

File workflow_settings.yaml menggantikan file dataform.json.

Jika paket inti Dataform adalah satu-satunya paket dependensi di repositori Anda, file workflow_settings.yaml juga menggantikan file package.json. Untuk mengetahui informasi selengkapnya tentang mengganti file package.json dengan file workflow_settings.yaml, lihat Mengelola paket inti Dataform.

Tabel berikut menunjukkan pemetaan properti setelan alur kerja dari file dataform.json ke file workflow_settings.yaml:

Properti di `dataform.json`	Properti di `workflow_settings.yaml`	Deskripsi
`assertionSchema`	`defaultAssertionDataset`	Wajib. Set data default untuk pernyataan.
`defaultDatabase`	`defaultProject`	Wajib. Nama project Google Cloud default.
`defaultLocation`	`defaultLocation`	Opsional. Lokasi BigQuery default tempat Dataform membuat tabel. Jika tidak disetel, Dataform akan menentukan lokasi berdasarkan set data yang dirujuk oleh kueri SQL Anda. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi.
`defaultSchema`	`defaultDataset`	Wajib. Set data default.
`databaseSuffix`	`projectSuffix`	Opsional. Sufiks yang akan ditambahkan ke semua referensi project Google Cloud .
`schemaSuffix`	`datasetSuffix`	Opsional. Sufiks yang akan ditambahkan ke semua set data tindakan.
`tablePrefix`	`namePrefix`	Opsional. Awalan yang akan ditambahkan ke semua nama tindakan.
`vars`	`vars`	Opsional. Variabel buatan pengguna yang tersedia untuk kode project selama kompilasi. Objek yang berisi daftar pasangan `key: value`.
`warehouse`	-	Wajib ada di `dataform.json`. Harus ditetapkan ke `bigquery`. Tidak tersedia di `workflow_settings.yaml`.
-	`dataformCoreVersion`	Tidak tersedia di `dataform.json`. Diinstal di `workflow_settings.yaml` secara default untuk repositori baru. Untuk mengetahui informasi selengkapnya, lihat Mengelola paket inti Dataform.

Untuk memigrasikan setelan alur kerja ke workflow_settings.yaml, ikuti langkah-langkah berikut:

Di konsol Google Cloud , buka halaman Dataform.

Buka Dataform
Pilih repositori, lalu pilih ruang kerja.
Di panel Files, klik addAdd, lalu klik Create file.
Di kolom Add a file path, masukkan workflow_settings.yaml.
Klik Create file.
Dalam file workflow_settings.yaml, tambahkan setelan dari file dataform.json Anda, yang dipetakan ke format YAML.
Di panel Files, klik menu More di samping dataform.json, lalu klik Delete.
Untuk mengonfirmasi penghapusan dataform.json, klik Hapus.

Contoh kode berikut menunjukkan setelan alur kerja yang ditentukan dalam file dataform.json:

{
  "warehouse": "bigquery",
  "defaultDatabase": "dataform-demos",
  "defaultLocation": "US",
  "defaultSchema": "dataform",
  "assertionSchema": "dataform_assertions"
  "vars": {
    "environmentName": "development"
  }
}

Contoh kode berikut menunjukkan file dataform.json sebelumnya yang dikonversi menjadi workflow_settings.yaml:

defaultProject: dataform-demos
defaultLocation: US
defaultDataset: dataform
defaultAssertionDataset: dataform_assertions
vars:
    environmentName: "development"

Mengelola paket inti Dataform

Bagian ini menunjukkan cara mengelola paket dependensi framework inti Dataform dan mengupdatenya ke versi terbaru.

Inti Dataform adalah framework Dataform open source untuk mengembangkan alur kerja dengan SQL, SQLX, dan JavaScript. Sebagai praktik terbaik, selalu gunakan framework inti Dataform versi terbaru yang tersedia. Untuk mengetahui informasi tentang rilis framework inti Dataform, lihat rilis Dataform di GitHub.

Mengelola lokasi paket inti Dataform

Saat Anda melakukan inisialisasi ruang kerja pertama di repositori, Dataform akan otomatis menetapkan Dataform core sebagai paket dependensi. Mulai Dataform core 3.0.0, Dataform menginstal paket Dataform core dalam file workflow_settings.yaml secara default. Pada versi Dataform core sebelumnya, Dataform core ditetapkan dalam file package.json.

Di Dataform core 3.0.0 dan yang lebih baru, jika Dataform core adalah satu-satunya paket di repositori Anda, maka Anda harus menyetelnya di file workflow_settings.yaml. Untuk repositori yang dibuat dengan versi core Dataform sebelumnya, pindahkan paket core Dataform ke workflow_settings.yaml.

File package.json diperlukan untuk menginstal paket tambahan di Dataform. Jika repositori Anda menggunakan paket tambahan, tetapkan paket inti Dataform di package.json sehingga semua paket ditetapkan di satu tempat. Jika repositori Anda tidak memiliki file package.json, buat file package.json dan pindahkan paket inti Dataform untuk menginstal paket tambahan.

Memindahkan inti Dataform ke `workflow_settings.yaml`

Untuk repositori yang dibuat dengan versi Dataform core yang lebih lama dari 3.0.0, jika Anda tidak memiliki paket dependensi selain Dataform core, maka Anda harus memindahkan paket Dataform core dari file package.json ke file workflow_settings.yaml, dan menghapus file package.json yang berlebihan.

Untuk memigrasikan paket inti Dataform dari file package.json ke file workflow_settings.yaml, lakukan hal berikut:

Di konsol Google Cloud , buka halaman Dataform.

Buka Dataform
Pilih repositori, lalu pilih ruang kerja.
Di panel Files, pilih file workflow_settings.yaml.
Di file workflow_settings.yaml, tambahkan paket inti Dataform dalam format berikut:
```
dataformCoreVersion: "VERSION"
```
Ganti VERSION dengan Dataform versi terbaru, misalnya, 3.0.0.
Di panel Files, klik menu More di samping file package.json tersebut, lalu klik Delete.
Untuk mengonfirmasi penghapusan file dataform.json, klik Hapus.
Klik Instal paket.

Memindahkan inti Dataform ke `package.json`

File package.json diperlukan untuk menginstal paket tambahan di repositori. Jika repositori Anda menggunakan paket tambahan, Anda harus menyimpan semua paket, termasuk paket inti Dataform, dalam file package.json.

Jika repositori Anda tidak berisi file package.json karena paket inti Dataform ditetapkan dalam file workflow_settings.yaml, Anda harus membuat file package.json untuk menginstal paket tambahan, lalu memindahkan paket inti Dataform dari file workflow_settings.yaml ke file package.json yang baru dibuat.

Untuk membuat file package.json dan memindahkan paket inti Dataform, ikuti langkah-langkah berikut:

Di konsol Google Cloud , buka halaman Dataform.

Buka Dataform
Pilih repositori, lalu pilih ruang kerja.
Di panel Files, klik addTambahkan, lalu klik Buat file.
Di kolom Add a file path, masukkan package.json.
Klik Create file.
Di file package.json, tambahkan paket inti Dataform dalam format berikut:
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Ganti VERSION dengan Dataform versi terbaru, misalnya, 3.0.0.
Klik Instal paket.
Di panel File, pilih workflow_settings.yaml.
Di file workflow_settings.yaml, hapus properti dataformCoreVersion.

Memperbarui inti Dataform

Selalu uji versi paket baru di lingkungan non-produksi sebelum men-deploy di lingkungan produksi Anda.

Untuk memperbarui paket dependensi inti Dataform, ikuti langkah-langkah berikut:

Cari versi terbaru @dataform/core di halaman rilis Dataform di GitHub.
Di konsol Google Cloud , buka halaman Dataform.

Buka Dataform
Pilih repositori, lalu pilih ruang kerja.
Di panel File, pilih file package.json atau file workflow_settings.yaml.

Lokasi tempat paket dependensi inti Dataform ditetapkan bergantung pada versi inti Dataform dan penggunaan paket Anda. Untuk mengetahui informasi selengkapnya, lihat Mengelola lokasi paket inti Dataform.
Perbarui paket dependensi inti Dataform dengan versi terbaru:
package.json
```
{
    "dependencies": {
        "@dataform/core": "VERSION"
    }
}
```
Ganti VERSION dengan Dataform versi terbaru, misalnya, 3.0.0. Untuk mencegah masalah pada penginstalan paket, tentukan versi paket inti Dataform secara eksplisit. Jangan gunakan opsi dependencies lainnya dari file package.json, misalnya, >version.
workflow_settings.yaml
```
dataformCoreVersion: "VERSION"
```
Ganti VERSION dengan Dataform versi terbaru, misalnya, 3.0.0.
Klik Instal paket.
Lakukan commit perubahan.
Kirim perubahan ke repositori Anda.

Contoh kode berikut menunjukkan dependensi @dataform/core yang diupdate ke versi 3.0.0 dalam file package.json:

{
    "dependencies": {
        "@dataform/core": "3.0.0"
    }
}

Mengontrol versi kode Anda

Bagian ini menunjukkan cara menggunakan kontrol versi di Dataform untuk melacak pengembangan.

Dataform menggunakan Git untuk melacak setiap perubahan yang dilakukan pada file di dalam repositori.

Di repositori Dataform, Anda berinteraksi langsung dengan repositori Git.

Di repositori yang terhubung, Anda berinteraksi dengan cabang pelacakan dari repositori jarak jauh yang Anda konfigurasi saat menghubungkan repositori.

Dataform menampilkan opsi kontrol versi berdasarkan status perubahan di ruang kerja pengembangan Anda. Misalnya, Dataform menampilkan opsi penerapan hanya jika ada perubahan lokal yang belum diterapkan di ruang kerja Anda. Jika file di ruang kerja Anda adalah salinan persis dari cabang pelacakan atau default Anda, Dataform akan menampilkan status Ruang kerja sudah terbaru.

Dataform menampilkan opsi kontrol versi berikut:

Lakukan perubahan X: Lakukan commit X jumlah perubahan lokal di ruang kerja atau file yang dipilih dan diubah. Dataform menampilkan perubahan yang belum di-commit.
Mengirim ke cabang default: Kirim perubahan yang di-commit ke cabang default Anda. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.
Kirim ke your-branch-name: Kirim perubahan yang di-commit ke your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit di ruang kerja.
Tarik dari cabang default: Perbarui ruang kerja Anda dengan perubahan terbaru dari cabang default Anda. Opsi ini tersedia di repositori Dataform jika Anda tidak memiliki perubahan yang belum di-commit atau perubahan yang di-commit dan belum di-push di ruang kerja Anda.
Tarik dari your-branch-name: Perbarui ruang kerja Anda dengan perubahan terbaru dari your-branch-name. Opsi ini tersedia di repositori yang terhubung ke repositori Git pihak ketiga jika Anda tidak memiliki perubahan yang belum di-commit atau di-push di ruang kerja.
Mengembalikan ke commit terakhir: Pulihkan file di ruang kerja Anda ke statusnya dari commit terakhir Anda.

Menarik perubahan

Jika ruang kerja pengembangan Anda tidak disinkronkan dengan repositori Anda, Dataform akan menampilkan opsi Tarik. Untuk menarik perubahan dari repositori ke ruang kerja pengembangan, ikuti langkah-langkah berikut:

Di halaman Dataform, pilih repositori.
Di tab Ruang kerja pengembangan, pilih ruang kerja pengembangan.
Di halaman ruang kerja pengembangan, lakukan hal berikut:
1. Jika Anda berada di repositori Dataform, klik Pull from default branch.
2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, klik Tarik dari your-branch-name.

Lakukan perubahan

Setelah Anda membuat perubahan di ruang kerja pengembangan, Dataform akan menampilkan opsi Commit. Anda dapat melakukan semua perubahan lokal atau file yang dipilih.

Dalam dialog New commit, Dataform menampilkan perubahan yang belum di-commit.

Untuk melakukan commit perubahan dari ruang kerja pengembangan ke repositori, ikuti langkah-langkah berikut:

Di halaman Dataform, pilih repositori.
Di halaman repositori, pilih ruang kerja pengembangan.
Di halaman ruang kerja pengembangan, klik Commit.
Di panel New commit, lakukan hal berikut:
1. Di kolom Tambahkan pesan commit, masukkan deskripsi untuk commit Anda.
2. Pilih file yang diubah yang ingin Anda lakukan commit.
  
  Jika Anda tidak memilih file apa pun, Dataform akan melakukan semua perubahan lokal. Anda dapat memfilter file yang diubah menurut status file, nama file, dan jalur.
3. Klik Terapkan Semua perubahan, atau Terapkan X perubahan.
  
  Nama tombol bergantung pada pilihan file yang akan Anda lakukan commit.

Mendorong perubahan

Dataform menampilkan opsi Push setelah Anda melakukan perubahan. Untuk mengirim perubahan dari ruang kerja pengembangan ke repositori, ikuti langkah-langkah berikut:

Di halaman Dataform, pilih repositori.
Di halaman repositori, pilih ruang kerja pengembangan.
Terapkan perubahan.
Di halaman ruang kerja pengembangan, lakukan hal berikut:
1. Jika Anda berada di repositori Dataform, klik Push to default branch.
2. Jika Anda berada di repositori yang terhubung ke repositori Git pihak ketiga, klik Kirim ke your-branch-name.

Mengembalikan perubahan yang belum di-commit

Untuk mengembalikan perubahan yang belum di-commit, ikuti langkah-langkah berikut:

Di halaman Dataform, pilih repositori.
Di halaman repositori, pilih ruang kerja pengembangan.
Di atas panel Files, klik menu More, lalu pilih Revert to last commit.

Menyelesaikan konflik penggabungan

Konflik penggabungan dapat terjadi saat perubahan lokal di ruang kerja pengembangan Anda tidak kompatibel dengan perubahan yang telah dilakukan pada cabang pelacakan default repositori Anda. Konflik penggabungan biasanya terjadi saat beberapa pengguna mengedit file yang sama secara bersamaan.

Anda biasanya mengalami konflik penggabungan saat menarik dari cabang setelah pengguna lain mengirim perubahan yang bertentangan ke cabang yang sama. Anda harus menyelesaikan konflik penggabungan secara manual dengan mengedit file yang terpengaruh.

Contoh kode berikut menunjukkan konflik penggabungan yang ditampilkan dalam file SQLX:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

Untuk menyelesaikan konflik penggabungan, ikuti langkah-langkah berikut:

Di ruang kerja pengembangan Anda, di panel Files, pilih file yang terpengaruh.
Edit file dengan perubahan yang Anda pilih.
Terapkan perubahan.
Opsional: Kirim perubahan.

Langkah berikutnya

Untuk mempelajari setelan project Dataform lebih lanjut, lihat referensi IProjectConfig.
Untuk mempelajari cara menginstal paket tambahan, lihat Menginstal paket di Dataform.
Untuk mempelajari cara membuat tabel, lihat Membuat tabel.

Mengelola repositori Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Peran yang diperlukan

Mengonfigurasi setelan alur kerja Dataform

Tentang setelan repositori

Tentang workflow_settings.yaml

Tentang dataform.json

Mengonfigurasi nama skema

workflow_settings.yaml

dataform.json

Membuat variabel kompilasi kustom

workflow_settings.yaml

dataform.json

Menambahkan variabel kompilasi ke tabel

Memigrasikan setelan alur kerja ke workflow_settings.yaml

Mengelola paket inti Dataform

Mengelola lokasi paket inti Dataform

Memindahkan inti Dataform ke workflow_settings.yaml

Memindahkan inti Dataform ke package.json

Memperbarui inti Dataform

package.json

workflow_settings.yaml

Mengontrol versi kode Anda

Menarik perubahan

Lakukan perubahan

Mendorong perubahan

Mengembalikan perubahan yang belum di-commit

Menyelesaikan konflik penggabungan

Langkah berikutnya

Mengelola repositori

Tentang `workflow_settings.yaml`

Tentang `dataform.json`

`workflow_settings.yaml`

`dataform.json`

`workflow_settings.yaml`

`dataform.json`

Memigrasikan setelan alur kerja ke `workflow_settings.yaml`

Memindahkan inti Dataform ke `workflow_settings.yaml`

Memindahkan inti Dataform ke `package.json`

`package.json`

`workflow_settings.yaml`