Share via

Komponen Skrip

  • Artikel

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Komponen Skrip menghosting skrip dan memungkinkan paket untuk menyertakan dan menjalankan kode skrip kustom. Anda dapat menggunakan komponen Skrip dalam paket untuk tujuan berikut:

  • Terapkan beberapa transformasi ke data alih-alih menggunakan beberapa transformasi dalam aliran data. Misalnya, skrip dapat menambahkan nilai dalam dua kolom lalu menghitung rata-rata jumlah.

  • Mengakses aturan bisnis di rakitan .NET yang ada. Misalnya, skrip dapat menerapkan aturan bisnis yang menentukan rentang nilai yang valid di kolom Pendapatan .

  • Gunakan rumus dan fungsi kustom selain fungsi dan operator yang disediakan tata bahasa ekspresi Layanan Integrasi. Misalnya, validasi nomor kartu kredit yang menggunakan rumus LUHN.

  • Validasi data kolom dan lewati rekaman yang berisi data yang tidak valid. Misalnya, skrip dapat menilai kewajaran dari jumlah kiriman dan melewati rekaman dengan jumlah yang sangat tinggi atau rendah.

Komponen Skrip menyediakan cara yang mudah dan cepat untuk menyertakan fungsi kustom dalam aliran data. Namun, jika Anda berencana untuk menggunakan kembali kode skrip dalam beberapa paket, Anda harus mempertimbangkan pemrograman komponen kustom alih-alih menggunakan komponen Skrip. Untuk informasi selengkapnya, lihat Mengembangkan Komponen Aliran Data Kustom.

Catatan

Jika komponen Skrip berisi skrip yang mencoba membaca nilai kolom yang NULL, komponen Skrip gagal saat Anda menjalankan paket. Kami menyarankan agar skrip Anda menggunakan IsNull metode untuk menentukan apakah kolom adalah NULL sebelum mencoba membaca nilai kolom.

Komponen Skrip dapat digunakan sebagai sumber, transformasi, atau tujuan. Komponen ini mendukung satu input dan beberapa output. Tergantung pada bagaimana komponen digunakan, komponen mendukung input atau output atau keduanya. Skrip dipanggil oleh setiap baris dalam input atau output.

  • Jika digunakan sebagai sumber, komponen Skrip mendukung beberapa output.

  • Jika digunakan sebagai transformasi, komponen Skrip mendukung satu input dan beberapa output.

  • Jika digunakan sebagai tujuan, komponen Skrip mendukung satu input.

Komponen Skrip tidak mendukung output kesalahan.

Setelah Anda memutuskan bahwa komponen Skrip adalah pilihan yang tepat untuk paket Anda, Anda harus mengonfigurasi input dan output, mengembangkan skrip yang digunakan komponen, dan mengonfigurasi komponen itu sendiri.

Memahami Mode Komponen Skrip

Dalam Perancang SSIS, komponen Skrip memiliki dua mode: mode desain metadata dan mode desain kode. Dalam mode desain metadata, Anda dapat menambahkan dan memodifikasi input dan output komponen Skrip, tetapi Anda tidak dapat menulis kode. Setelah semua input dan output dikonfigurasi, Anda beralih ke mode desain kode untuk menulis skrip. Komponen Skrip secara otomatis menghasilkan kode dasar dari metadata input dan output. Jika Anda mengubah metadata setelah komponen Skrip menghasilkan kode dasar, kode Anda mungkin tidak lagi dikompilasi karena kode dasar yang diperbarui mungkin tidak kompatibel dengan kode Anda.

Menulis Skrip yang Digunakan Komponen

Komponen Skrip menggunakan Microsoft® Visual Studio® Tools for Applications (VSTA) sebagai lingkungan tempat Anda menulis skrip. Anda mengakses VSTA dari Editor Transformasi Skrip. Untuk informasi selengkapnya, lihat Editor Transformasi Skrip (Halaman Skrip).

Komponen Skrip menyediakan proyek VSTA yang menyertakan kelas yang dibuat secara otomatis, bernama ScriptMain, yang mewakili metadata komponen. Misalnya, jika komponen Skrip digunakan sebagai transformasi yang memiliki tiga output, ScriptMain menyertakan metode untuk setiap output. ScriptMain adalah titik masuk ke skrip.

VSTA mencakup semua fitur standar lingkungan Visual Studio, seperti editor Visual Studio berkode warna, IntelliSense, dan Browser Objek. Skrip yang digunakan komponen Skrip disimpan dalam definisi paket. Saat Anda merancang paket, kode skrip untuk sementara ditulis ke file proyek.

VSTA mendukung bahasa pemrograman Microsoft Visual C# dan Microsoft Visual Basic.

Untuk informasi tentang cara memprogram komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip. Untuk informasi lebih spesifik tentang cara mengonfigurasi komponen Skrip sebagai sumber, transformasi, atau tujuan, lihat Mengembangkan Jenis Komponen Skrip Tertentu. Untuk contoh tambahan seperti tujuan ODBC yang menunjukkan penggunaan komponen Skrip, lihat Contoh Komponen Skrip Tambahan.

Catatan

Tidak seperti versi sebelumnya di mana Anda dapat menunjukkan apakah skrip telah dikommpilasikan sebelumnya, semua skrip telah dikommpilasikan sebelumnya di SQL Server 2008 Integration Services (SSIS) dan versi yang lebih baru. Ketika skrip telah dikompresi sebelumnya, mesin bahasa tidak dimuat pada durasi dan paket berjalan lebih cepat. Namun, file biner yang telah dikommpilasikan sebelumnya menggunakan ruang disk yang signifikan.

Mengonfigurasi Komponen Skrip

Anda dapat mengonfigurasi komponen Skrip dengan cara berikut:

  • Pilih kolom input untuk dirujuk.

    Catatan

    Anda hanya dapat mengonfigurasi satu input saat menggunakan SSIS Designer.

  • Berikan skrip yang dijalankan komponen.

  • Tentukan bahasa skrip.

  • Berikan daftar variabel baca-saja dan baca/tulis yang dipisahkan koma.

  • Tambahkan lebih banyak output, dan tambahkan kolom output yang ditetapkan skrip.

Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.

Mengonfigurasi Komponen Skrip di Perancang

Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, klik topik berikut:

Mengonfigurasi Komponen Skrip Secara Terprogram

Untuk informasi selengkapnya tentang properti yang bisa Anda atur di jendela Properti atau secara terprogram, klik salah satu topik berikut ini:

Untuk informasi selengkapnya tentang cara mengatur properti, klik salah satu topik berikut:

Pilih Jenis Komponen Skrip

Gunakan kotak dialog Pilih Jenis Komponen Skrip untuk menentukan apakah akan membuat Transformasi Skrip yang telah dikonfigurasi sebelumnya untuk digunakan sebagai sumber, transformasi, atau tujuan.

Untuk mempelajari selengkapnya tentang komponen Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip. Untuk mempelajari tentang pemrograman komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip.

Opsi

Pilihan Sumber, Tujuan, atau Transformasi Anda memengaruhi konfigurasi Transformasi Skrip dan halaman Editor Transformasi Skrip.

Editor Transformasi Skrip (Halaman Pengelola Koneksi)

Gunakan halaman Pengelola Koneksi dari Editor Transformasi Skrip untuk menentukan koneksi apa pun yang akan digunakan oleh skrip.

Untuk mempelajari selengkapnya tentang komponen Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip. Untuk mempelajari tentang pemrograman komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip.

Opsi

Pengelola koneksi
Lihat daftar koneksi yang tersedia untuk digunakan oleh skrip.

Nama
Ketik nama yang unik dan deskriptif untuk koneksi.

Pengelola Sambungan
Pilih dari daftar pengelola koneksi yang tersedia, atau pilih <Koneksi> baru untuk membuka kotak dialog Tambahkan Pengelola Sambungan SSIS.

Deskripsi
Ketik deskripsi untuk koneksi.

Tambahkan
Tambahkan koneksi lain ke daftar Pengelola koneksi .

Hapus
Hapus koneksi terpilih dari daftar Pengelola koneksi .

Editor Transformasi Skrip (Halaman Kolom Input)

Gunakan halaman Kolom Input dari kotak dialog Editor Transformasi Skrip untuk mengatur properti pada kolom input.

Catatan

Halaman Kolom Input tidak ditampilkan untuk komponen Sumber, yang memiliki output tetapi tidak ada input.

Untuk mempelajari selengkapnya tentang komponen Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip. Untuk mempelajari tentang pemrograman komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip.

Opsi

Nama input
Pilih dari daftar input yang tersedia.

Kolom Input yang Tersedia
Menggunakan kotak centang, tentukan kolom yang akan digunakan transformasi skrip.

Kolom Input
Pilih dari daftar kolom input yang tersedia untuk setiap baris. Pilihan Anda tercermin dalam pilihan kotak centang dalam tabel Kolom Input yang Tersedia.

Output Alias
Ketik alias untuk setiap kolom output. Defaultnya adalah nama kolom input; namun, Anda dapat memilih nama yang unik dan deskriptif.

Jenis Penggunaan
Tentukan apakah Transformasi Skrip akan memperlakukan setiap kolom sebagai ReadOnly atau ReadWrite.

Editor Transformasi Skrip (Halaman Input dan Output)

Gunakan halaman Input dan Output dari kotak dialog Editor Transformasi Skrip untuk menambahkan, menghapus, dan mengonfigurasi input dan output untuk Transformasi Skrip.

Catatan

Komponen sumber memiliki output dan tidak ada input, sementara komponen tujuan memiliki input tetapi tidak ada output. Transformasi memiliki input dan output.

Untuk mempelajari selengkapnya tentang komponen Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip. Untuk mempelajari tentang pemrograman komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip.

Opsi

Input dan output
Pilih input atau output di sebelah kiri untuk melihat propertinya dalam tabel di sebelah kanan. Properti yang tersedia untuk pengeditan bervariasi sesuai dengan pilihan. Banyak properti yang ditampilkan bersifat baca-saja. Untuk informasi selengkapnya tentang properti individual, lihat topik berikut ini.

Properti Umum

Properti Kustom Transformasi

Tambahkan Output
Tambahkan output tambahan ke daftar.

Tambahkan Kolom
Pilih folder untuk menempatkan kolom output baru, lalu tambahkan kolom dengan mengklik Tambahkan Kolom.

Hapus Output
Pilih output, lalu hapus dengan mengklik Hapus Output.

Hapus Kolom
Pilih kolom, lalu hapus dengan mengklik Hapus Kolom.

Editor Transformasi Skrip (Halaman Skrip)

Gunakan tab Skrip dari kotak dialog Editor Transformasi Skrip untuk menentukan skrip dan properti terkait.

Untuk mempelajari selengkapnya tentang komponen Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip. Untuk mempelajari tentang pemrograman komponen Skrip, lihat Memperluas Aliran Data dengan Komponen Skrip.

Opsi

Properti
Lihat dan ubah properti transformasi Skrip. Banyak properti yang ditampilkan bersifat baca-saja. Anda bisa mengubah properti berikut:

Nilai Deskripsi
Deskripsi Jelaskan transformasi skrip dalam hal tujuannya.
LocaleID Tentukan lokal untuk memberikan informasi khusus wilayah untuk pemesanan, dan untuk konversi tanggal dan waktu.
Nama Ketik nama deskriptif untuk komponen.
ValidateExternalMetadata Menunjukkan apakah transformasi Skrip memvalidasi metadata kolom terhadap sumber data eksternal pada waktu desain. Nilai validasi penundaan palsu hingga waktu eksekusi.
ReadOnlyVariables Ketik daftar variabel yang dipisahkan koma untuk akses baca-saja oleh transformasi Skrip.

Catatan: Nama variabel peka huruf besar/kecil.
ReadWriteVariables Ketik daftar variabel yang dipisahkan koma untuk akses baca/tulis oleh transformasi Skrip.

Catatan: Nama variabel peka huruf besar/kecil.
Bahasa Skrip Pilih bahasa skrip yang akan digunakan oleh komponen Skrip.

Untuk mengatur bahasa skrip default untuk komponen Skrip dan tugas Skrip, gunakan opsi Bahasa pembuatan skrip pada halaman Umum kotak dialog Opsi .
UserComponentTypeName ScriptComponentHost Menentukan kelas dan rakitan Microsoft.SqlServer.TxScript yang mendukung infrastruktur SQL Server.

Edit Skrip
Gunakan Microsoft® Visual Studio® Tools for Applications (VSTA) untuk membuat atau mengubah skrip.

Konten terkait

Transformasi Layanan Integrasi

Memperluas Aliran Data dengan Komponen Skrip