Untuk membuat paket yang dapat digunakan kembali di beberapa repositori Dataform, Anda perlu membuat repositori Dataform khusus untuk paket dan menghubungkannya ke repositori Git pihak ketiga agar tersedia untuk repositori Dataform lainnya.
Selanjutnya, Anda harus membuat file index.js
level atas dan menambahkan konten paket
yang dapat diekspor, seperti fungsi dan konstanta, ke file tersebut. Untuk contoh
paket yang dibuat dalam Dataform, lihat
dataform-package-base
di GitHub.
Setelah membuat paket, Anda dapat menginstal paket ke repositori Dataform lain dan menggunakan konten yang dapat diekspor pada paket, seperti konstanta dan fungsi, untuk mengembangkan alur kerja SQL.
Selain membuat paket, Anda dapat menggunakan kembali fungsi dan konstanta JavaScript di satu repositori Dataform dengan penyertaan. Untuk informasi selengkapnya, lihat Menggunakan kembali variabel dan fungsi dengan penyertaan dalam Dataform.
Sebelum memulai
Di konsol Google Cloud, buka halaman Dataform.
Buat repositori Dataform yang khusus untuk paket Anda. Cocokkan nama repositori dengan nama paket Anda.
Hubungkan repositori ke repositori Git pihak ketiga yang akan menghosting paket Anda.
Buat dan inisialisasi ruang kerja di repositori Dataform.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk membuat paket,
minta administrator untuk memberi Anda
peran IAM Admin Dataform (roles/dataform.admin
) di repositori.
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 paket dalam Dataform
Untuk membuat paket Anda sendiri dengan kode JavaScript yang dapat digunakan kembali di Dataform, ikuti langkah-langkah berikut di ruang kerja Anda:
Di panel Files, klik menu
More.Klik Create file.
Di panel Create new file, lakukan langkah berikut:
Di kolom Add a file path, masukkan
index.js
.Klik Create file.
Dalam file
index.js
, masukkan kode JavaScript yang ingin diekspor paket Anda.Buat konstanta dalam format berikut:
const CONSTANT_NAME = CONSTANT_VALUE; module.exports = { CONSTANT_NAME };
Ganti kode berikut:
CONSTANT_NAME
: nama konstanta AndaCONSTANT_VALUE
: nilai konstanta Anda
Buat fungsi dalam format berikut:
function FUNCTION_NAME(PARAMETERS) { FUNCTION_BODY } module.exports = { FUNCTION_NAME }
Ganti kode berikut:
FUNCTION_NAME
: nama fungsi AndaPARAMETERS
: parameter fungsi AndaFUNCTION_BODY
: kode yang Anda inginkan untuk dijalankan oleh fungsi
Opsional: Klik Format.
Opsional: Dalam direktori
definitions
, tambahkan kode paket yang tidak akan diekspor.
Contoh kode paket berikut menunjukkan file index.js
dari
paket postoffice
yang mengekspor fungsi getDomain
:
// filename index.js
// package name postoffice
const GENERIC_DOMAINS = "('samplemail.com','samplemail.co.uk','examplemailbox.com'";
function getDomain(email) {
let cleanEmail = `trim(${email})`
const domain = `substr(${cleanEmail}, strpos(${cleanEmail}, '@') + 1)`;
return `case
when ${domain} in ${common.GENERIC_DOMAINS} then ${cleanEmail}
when ${domain} = "othermailbox.com" then "other.com"
when ${domain} = "mailbox.com" then "mailbox.global"
when ${domain} = "support.postman.com" then "postman.com"
else ${domain}
end`;
}
module.exports = { getDomain }
Langkah selanjutnya
- Untuk mempelajari cara menginstal paket Anda dalam repositori dan mengimpor kontennya dalam file JavaScript atau SQLX, lihat Menginstal paket ke Dataform.
- Untuk mempelajari lebih lanjut paket dalam Dataform, lihat Menggunakan kembali kode di beberapa repositori dengan paket.
- Untuk mempelajari cara menulis variabel dan fungsi JavaScript yang dapat Anda gunakan kembali di Dataform, lihat Menggunakan kembali variabel dan fungsi dengan penyertaan dalam Dataform.