Menggunakan Variabel dalam Komponen Skrip

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

Variabel menyimpan nilai yang dapat digunakan paket dan kontainer, tugas, dan penanganan aktivitasnya pada waktu proses. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS).

Anda dapat membuat variabel yang ada tersedia untuk akses baca-saja atau baca/tulis oleh skrip kustom Anda dengan memasukkan daftar variabel yang dibatasi koma di bidang ReadOnlyVariables dan ReadWriteVariables di halaman Skrip Editor Transformasi Skrip. Perlu diingat bahwa nama variabel peka huruf besar/kecil. Gunakan properti Nilai untuk membaca dari dan menulis ke variabel individual. Komponen Skrip menangani penguncian yang diperlukan di belakang layar saat skrip Anda memanipulasi variabel pada waktu proses.

Penting

Kumpulan ReadWriteVariables hanya tersedia dalam metode PostExecute untuk memaksimalkan performa dan meminimalkan risiko konflik penguncian. Oleh karena itu Anda tidak dapat langsung menaikkan nilai variabel paket saat Anda memproses setiap baris data. Tambahkan nilai variabel lokal sebagai gantinya, dan atur nilai variabel paket ke nilai variabel lokal dalam metode PostExecute setelah semua data diproses. Anda juga dapat menggunakan VariableDispenser properti untuk mengatasi batasan ini, seperti yang dijelaskan nanti dalam topik ini. Namun, menulis langsung ke variabel paket karena setiap baris diproses akan berdampak negatif pada performa dan meningkatkan risiko konflik penguncian.

Untuk informasi selengkapnya tentang halaman Skrip Editor Transformasi Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip dan Editor Transformasi Skrip (Halaman Skrip).

Komponen Skrip membuat kelas koleksi Variabel dalam item proyek ComponentWrapper dengan properti aksesor yang sangat ditik untuk nilai setiap variabel yang telah dikonfigurasi sebelumnya di mana properti memiliki nama yang sama dengan variabel itu sendiri. Koleksi ini diekspos melalui properti Variabel dari kelas ScriptMain . Properti aksesor menyediakan izin baca-saja atau baca/tulis ke nilai variabel yang sesuai. Misalnya, jika Anda telah menambahkan variabel bilangan bulat bernama MyIntegerVariable ke daftar ReadOnlyVariables , Anda dapat mengambil nilainya dalam skrip Anda dengan menggunakan kode berikut:

Dim myIntegerVariableValue As Integer = Me.Variables.MyIntegerVariable

Anda juga dapat menggunakan VariableDispenser properti , diakses dengan memanggil Me.VariableDispenser, untuk bekerja dengan variabel dalam komponen Skrip. Dalam hal ini Anda tidak menggunakan properti aksesor yang ditik dan bernama untuk variabel, tetapi mengakses variabel secara langsung. Saat menggunakan VariableDispenser, Anda harus menangani semantik penguncian dan transmisi jenis data untuk nilai variabel dalam kode Anda sendiri. Anda harus menggunakan VariableDispenser properti alih-alih properti aksesor bernama dan ditik jika Anda ingin bekerja dengan variabel yang tidak tersedia pada waktu desain tetapi dibuat secara terprogram pada waktu proses.

Lihat Juga

Variabel Integration Services (SSIS)
Gunakan Variabel dalam Paket