Variabel Sistem

  • Artikel

Berlaku untuk: Integration Runtime SSIS SQL Server 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-sistem dan yang ditentukan pengguna- dapat digunakan dalam pengikatan parameter yang digunakan tugas Execute SQL untuk memetakan variabel ke parameter.

Variabel Sistem untuk Paket

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

Variabel Sistem Jenis data Deskripsi
CancelEvent Int32 Handel ke objek Peristiwa Windows yang dapat disinyalkan tugas untuk menunjukkan bahwa tugas harus berhenti berjalan.
ContainerStartTime DateTime Waktu mulai kontainer.
CreationDate DateTime Tanggal paket dibuat.
CreatorComputerName Untai Komputer tempat paket dibuat.
CreatorName Untai Nama orang yang membangun paket.
ExecutionInstanceGUID Untai Pengidentifikasi unik dari instans eksekusi paket.
FailedConfigurations Untai 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 Untai Nama komputer tempat paket dijalankan.
OfflineMode Boolean Menunjukkan apakah paket dalam mode offline. Mode offline tidak memperoleh koneksi ke sumber data.
PackageID Untai Pengidentifikasi unik paket.
PackageName Untai Nama paket.
StartTime DateTime Waktu paket mulai berjalan.
ServerExecutionID Int64 ID Eksekusi untuk paket yang dijalankan di server Integration Services.

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 Untai Akun pengguna yang memulai paket. Nama pengguna memenuhi syarat dengan nama domain.
VersionBuild Int32 Versi paket.
VersionComment Untai Komentar tentang versi paket.
VersionGUID Untai 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 Layanan Integrasi untuk tugas.

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

Variabel Sistem untuk Penanganan Aktivitas

Tabel berikut ini 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 Untai 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 Untai 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 Untai Deskripsi executable di penanganan aktivitas yang memunculkan peristiwa. Semua penanganan aktivitas
SourceID Untai Pengidentifikasi unik dari executable di penanganan aktivitas yang memunculkan peristiwa. Semua penanganan aktivitas
SourceName Untai Nama yang dapat dieksekusi di penanganan aktivitas yang memunculkan peristiwa. Semua penanganan aktivitas
VariableDescription Untai Deskripsi variabel. Penanganan aktivitas OnVariableValueChanged
VariableID Untai 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 di 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 dapat diterjemahkan dengan tidak benar. Misalnya, jika variabel sistem ExecutionInstanceGUID , yang memiliki jenis data string dan berisi string yang mewakili GUID dari instans eksekusi paket, digunakan dalam parameter yang mengikat dengan jenis data GUID, GUID instans paket akan diterjemahkan secara salah.

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 ditentukan dengan jenis data yang kompatibel dengan jenis data parameter yang dipetakan.

Memetakan Parameter Kueri ke Variabel dalam Tugas Jalankan SQL