Variabel Sistem

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

SQL Server Integration Services menyediakan sekumpulan variabel sistem yang menyimpan informasi tentang paket yang sedang berjalan dan objeknya. Variabel ini dapat digunakan dalam ekspresi dan ekspresi properti untuk menyesuaikan paket, kontainer, tugas, dan penanganan aktivitas.

Semua variabel-system dan user-defined- dapat digunakan dalam pengikatan parameter yang digunakan tugas Execute SQL untuk memetakan variabel ke parameter.

Variabel Sistem untuk Paket

Tabel berikut menjelaskan variabel sistem yang disediakan Integration Services untuk paket.

Variabel Sistem	Jenis data	Deskripsi
CancelEvent	Int32	Handel ke objek Peristiwa Windows yang dapat disinyalir tugas untuk menunjukkan bahwa tugas harus berhenti berjalan.
ContainerStartTime	DateTime	Waktu mulai kontainer.
CreationDate	DateTime	Tanggal paket dibuat.
CreatorComputerName	String	Komputer tempat paket dibuat.
CreatorName	String	Nama orang yang membangun paket.
ExecutionInstanceGUID	String	Pengidentifikasi unik dari instans eksekusi paket.
FailedConfigurations	String	Nama konfigurasi paket yang gagal.
IgnoreConfigurationsOnLoad	Boolean	Menunjukkan apakah konfigurasi paket diabaikan saat memuat paket.
InteractiveMode	Boolean	Menunjukkan apakah paket dijalankan dalam mode interaktif. Jika paket berjalan di SSIS Designer, properti ini diatur ke True. Jika paket berjalan menggunakan utilitas prompt perintah DTExec , properti diatur ke False.
LocaleId	Int32	Lokal yang digunakan paket.
MachineName	String	Nama komputer tempat paket dijalankan.
OfflineMode	Boolean	Menunjukkan apakah paket dalam mode offline. Mode offline tidak memperoleh koneksi ke sumber data.
PackageID	String	Pengidentifikasi unik paket.
PackageName	String	Nama paket.
StartTime	DateTime	Waktu paket mulai berjalan.
ServerExecutionID	Int64	ID eksekusi untuk paket yang dijalankan di server Layanan Integrasi. Nilai defaultnya adalah nol. Nilai diubah hanya jika paket dijalankan oleh ISServerExec di Server Layanan Integrasi. Ketika ada paket anak, nilai diteruskan dari paket induk ke paket anak.
UserName	String	Akun pengguna yang memulai paket. Nama pengguna memenuhi syarat dengan nama domain.
VersionBuild	Int32	Versi paket.
VersionComment	String	Komentar tentang versi paket.
VersionGUID	String	Pengidentifikasi unik versi.
VersionMajor	Int32	Versi utama paket.
VersionMinor	Int32	Versi minor paket.

Variabel Sistem untuk Kontainer

Tabel berikut menjelaskan variabel sistem yang disediakan Integration Services untuk kontainer For Loop, Foreach Loop, dan Sequence.

Variabel Sistem	Jenis data	Deskripsi	Kontainer
LocaleId	Int32	Lokal yang digunakan kontainer.	Untuk kontainer Loop Kontainer Foreach Loop Kontainer urutan

Variabel Sistem untuk Tugas

Tabel berikut ini menjelaskan variabel sistem yang disediakan Integration Services untuk tugas.

Variabel Sistem	Jenis data	Deskripsi
CreationName	String	Nama tugas.
LocaleId	Int32	Lokal yang digunakan tugas.
TaskID	String	Pengidentifikasi unik instans tugas.
TaskName	String	Nama instans tugas.
TaskTransactionOption	Int32	Opsi transaksi yang digunakan tugas.

Variabel Sistem untuk Penanganan Aktivitas

Tabel berikut menjelaskan variabel sistem yang disediakan Integration Services untuk penanganan aktivitas. Tidak semua variabel tersedia untuk semua penanganan aktivitas.

Variabel Sistem	Jenis data	Deskripsi	Handler acara
Batalkan	Boolean	Menunjukkan apakah penanganan aktivitas berhenti berjalan saat terjadi kesalahan, peringatan, atau pembatalan kueri.	Penanganan aktivitas OnError Penanganan aktivitas OnWarning Penanganan aktivitas OnQueryCancel
ErrorCode	Int32	Pengidentifikasi kesalahan.	Penanganan aktivitas OnError Penanganan aktivitas OnInformation Penanganan aktivitas OnWarning
ErrorDescription	String	Deskripsi kesalahan.	Penanganan aktivitas OnError Penanganan aktivitas OnInformation Penanganan aktivitas OnWarning
ExecutionStatus	Boolean	Status eksekusi saat ini.	Penanganan aktivitas OnExecStatusChanged
ExecutionValue	DBNull	Nilai eksekusi.	Penanganan aktivitas OnTaskFailed
LocaleId	Int32	Lokal yang digunakan penanganan aktivitas.	Semua penanganan aktivitas
PercentComplete	Int32	Persentase pekerjaan yang selesai.	Penanganan aktivitas OnProgress
ProgressCountHigh	Int32	Bagian tinggi dari nilai 64-bit yang menunjukkan jumlah total operasi yang diproses oleh peristiwa OnProgress.	Penanganan aktivitas OnProgress
ProgressCountLow	Int32	Bagian rendah dari nilai 64-bit yang menunjukkan jumlah total operasi yang diproses oleh peristiwa OnProgress.	Penanganan aktivitas OnProgress
ProgressDescription	String	Deskripsi kemajuan.	Penanganan aktivitas OnProgress
Menyebarkan	Boolean	Menunjukkan apakah peristiwa disebarluaskan ke penanganan aktivitas tingkat yang lebih tinggi. Catatan: Nilai variabel Propagate diabaikan selama validasi paket. Jika Anda mengatur Sebarkan ke False dalam paket anak, ini tidak mencegah peristiwa menyebar ke paket induk.	Semua penanganan aktivitas
SourceDescription	String	Deskripsi executable di penanganan aktivitas yang menaikkan peristiwa.	Semua penanganan aktivitas
SourceID	String	Pengidentifikasi unik dari executable di penanganan aktivitas yang menaikkan peristiwa.	Semua penanganan aktivitas
SourceName	String	Nama yang dapat dieksekusi di penanganan aktivitas yang menaikkan peristiwa.	Semua penanganan aktivitas
VariableDescription	String	Deskripsi variabel.	Penanganan aktivitas OnVariableValueChanged
VariableID	String	Pengidentifikasi unik variabel.	Penanganan aktivitas OnVariableValueChanged

Variabel Sistem dalam Pengikatan Parameter

Sering kali berguna untuk menyimpan nilai variabel sistem dalam tabel saat paket dijalankan. Misalnya, paket yang secara dinamis membuat tabel dan menulis GUID instans eksekusi paket yang membuat tabel dalam kolom tabel.

Jika Anda menggunakan variabel sistem untuk memetakan ke parameter dalam pernyataan SQL yang digunakan tugas Execute SQL, penting bagi Anda untuk mengatur jenis data setiap parameter yang mengikat ke jenis data variabel sistem. Jika tidak, nilai variabel sistem mungkin salah diterjemahkan. Misalnya, jika variabel sistem ExecutionInstanceGUID , yang memiliki jenis data string dan berisi string yang mewakili GUID instans eksekusi paket, digunakan dalam pengikatan parameter dengan jenis data GUID, GUID instans paket akan salah diterjemahkan.

Aturan ini juga berlaku untuk variabel yang ditentukan pengguna. Tetapi, sedangkan jenis data variabel sistem tidak dapat diubah dan Anda harus menyesuaikan penggunaan variabel ini agar sesuai dengan jenis data, yang ditentukan pengguna lebih fleksibel. Variabel yang ditentukan pengguna yang digunakan dalam pengikatan parameter biasanya didefinisikan dengan jenis data yang kompatibel dengan jenis data parameter yang dipetakan.

Tugas Terkait

Memetakan Parameter Kueri ke Variabel dalam Tugas Jalankan SQL