Komponen Skrip
Berlaku untuk:
SQL Server SSIS Integration Runtime 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 dalam 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 jumlah ongkos kirim dan melewati rekaman dengan jumlah yang sangat tinggi atau rendah.
Komponen Skrip menyediakan cara 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 untuk memprogram 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 sesuai 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 dihasilkan 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 dikommpilasikan sebelumnya, mesin bahasa tidak dimuat pada waktu proses dan paket berjalan lebih cepat. Namun, file biner yang telah dikommpilasikan mengonsumsi 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:
Untuk informasi selengkapnya tentang cara mengatur properti, klik salah satu topik berikut:
Pilih Jenis Komponen Skrip
Gunakan kotak dialog Pilih Tipe 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 Sambungan)
Gunakan halaman Pengelola Sambungan 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
Manajer koneksi
Lihat daftar koneksi yang tersedia untuk digunakan oleh skrip.
Nama
Ketik nama unik dan deskriptif untuk koneksi.
Pengelola Sambungan
Pilih dari daftar manajer koneksi yang tersedia, atau pilih <Koneksi> baru untuk membuka kotak dialog Tambahkan Pengelola Sambungan SSIS.
Keterangan
Ketik deskripsi untuk koneksi.
Tambahkan
Tambahkan koneksi lain ke daftar Manajer 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 yangTersedia.
Output Alias
Ketik alias untuk setiap kolom output. Defaultnya adalah nama kolom input; namun, Anda dapat memilih nama deskriptif yang unik.
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.
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 dapat mengubah properti berikut:
| Nilai | Deskripsi |
|---|---|
| Keterangan | 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 false menunda validasi 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. |
| ScriptLanguage | 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.