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