Sistem değişkenleri
SQL Server Integration Servicesçalışan paketi ve onun nesneler hakkında bilgi depolayan sistem değişkenleri kümesi sağlar. Bu değişkenleri ifadeler ve özellik ifadeler paketleri, konteynerler, görevleri ve olay işleyicileri özelleştirmek için kullanılır.
Tüm değişkenleri — sistem ve kullanıcı tanımlı — değişkenleri parametreleri eşleştirmek için sql Yürüt görev kullanır parametresi bağlamaları kullanılabilir.
Paketler için Sistem değişkenleri
Sistem değişkenleri aşağıdaki tabloda açıklanmaktadır ki Integration Servicespaketleri sağlar.
Sistem değişkeni |
Veri türü |
Açıklama |
---|---|---|
CancelEvent |
Int32 |
Görevin görev çalıştıran durması gerektiğini belirten sinyal bir Windows olay nesnesi için tanıtıcı. |
CreationDate |
DateTime |
Paket oluşturulduğu tarih. |
CreatorComputerName |
Dize |
Paket oluşturulduğu bilgisayarın. |
CreatorName |
Dize |
Paket inşa kişinin adı. |
ExecutionInstanceGUID |
Dize |
Paket yürütme örneğini benzersiz tanıtıcısı. |
InteractiveMode |
Boolean |
Paketi etkileşimli modda çalıştırılıp çalıştırılmayacağını belirtir. Bir paket çalışıyorsa SSIStasarımcı, bu özelliği ayarlamak True. Bir paket kullanarak çalışıyorsa, DTExec komut istemi yardımcı programını özelliği ayarlanır False. |
LocaleId |
Int32 |
Paketi kullanan yerel ayarı. |
MachineName |
Dize |
Paket üzerinde çalıştığı bilgisayarın adı. |
OfflineMode |
Boolean |
Paketin çevrimdışı modda olup olmadığını gösterir. Çevrimdışı mod veri kaynaklarına bağlantılar elde etmez. |
PackageID |
Dize |
Paket benzersiz tanıtıcısı. |
PackageName |
Dize |
Paket adı. |
StartTime |
DateTime |
Paketi çalıştırmak için başladığı saat. |
ServerExecutionID |
Int64 |
Üzerinde yürütülen paketi yürütme Kımlığı Integration Servicessunucu. Varsayılan değer sıfırdır. Yalnızca paketi tarafından ISServerExec üzerinde yürütülen değiştirilir Integration Servicessunucu. Bir alt paketi olduğunda değeri alt paketi üst paketi aktarılır. |
UserName |
Dize |
Paket başlatan kullanıcının hesabı. Kullanıcı adı etki alanı adına göre nitelikli. |
VersionBuild |
Int32 |
Paket sürümü. |
VersionComment |
Dize |
Paket sürümü hakkında yorum. |
VersionGUID |
Dize |
Sürüm benzersiz tanıtıcısı. |
VersionMajor |
Int32 |
Ana sürüm paketi. |
VersionMinor |
Int32 |
Alt sürüm paketi. |
Kapsayıcılar için Sistem değişkenleri
Sistem değişkenleri aşağıdaki tabloda açıklanmaktadır ki Integration Servicesiçin döngü, Foreach döngü ve sıra kapsayıcıları sağlar.
Sistem değişkeni |
Veri türü |
Açıklama |
Konteyner |
---|---|---|---|
LocaleId |
Int32 |
Kapsayıcı kullanan yerel ayarı. |
Döngü kapsayıcı için Foreach döngü kapsayıcı Sıra kapsayıcı |
Görevler için Sistem değişkenleri
Sistem değişkenleri aşağıdaki tabloda açıklanmaktadır ki Integration Servicesgörevler için sağlar.
Sistem değişkeni |
Veri türü |
Açıklama |
---|---|---|
CreationName |
Dize |
Görev adı. |
LocaleId |
Int32 |
Görev kullanan yerel ayarı. |
TaskID |
Dize |
Görev örneğinin benzersiz tanıtıcısı. |
TaskName |
Dize |
Görev örneğinin adı. |
TaskTransactionOption |
Int32 |
Görev kullanır hareket seçeneği. |
Olay işleyicileri için Sistem değişkenleri
Sistem değişkenleri aşağıdaki tabloda açıklanmaktadır ki Integration Servicesiçin olay işleyicileri sağlar. Tüm değişkenler tüm olay işleyicileri için kullanılabilir.
Sistem değişkeni |
Veri türü |
Açıklama |
Olay işleyicisi |
---|---|---|---|
Cancel |
Boolean |
Olay işleyicisi hata, uyarı veya sorgu iptali oluşur çalışmasını durdurur olup olmadığını gösterir. |
OnError olay işleyicisi OnWarning olay işleyicisi OnQueryCancel olay işleyicisi |
ErrorCode |
Int32 |
Hata tanımlayıcısı. |
OnError olay işleyicisi OnInformation olay işleyicisi OnWarning olay işleyicisi |
ErrorDescription |
Dize |
Hata açıklaması. |
OnError olay işleyicisi OnInformation olay işleyicisi OnWarning olay işleyicisi |
ExecutionStatus |
Boolean |
Geçerli yürütme durumu. |
OnExecStatusChanged olay işleyicisi |
ExecutionValue |
DBNull |
Yürütme değeri. |
OnTaskFailed olay işleyicisi |
LocaleId |
Int32 |
Olay işleyicisi kullanan yerel ayarı. |
Tüm olay işleyicileri |
PercentComplete |
Int32 |
Tamamlanan çalışma yüzdesi. |
OnProgress olay işleyicisi |
ProgressCountHigh |
Int32 |
Yüksek bölümü bir 64-bit değerinin işlemleri OnProgress olayı tarafından işlenen toplam sayısını gösterir. |
OnProgress olay işleyicisi |
ProgressCountLow |
Int32 |
Düşük bölümü bir 64-bit değerinin işlemleri OnProgress olayı tarafından işlenen toplam sayısını gösterir. |
OnProgress olay işleyicisi |
ProgressDescription |
Dize |
İlerleme açıklaması. |
OnProgress olay işleyicisi |
Propagate |
Boolean |
Olay daha yüksek bir düzey olay işleyicisi yayılma olup olmadığını gösterir.
Not
Değeri Propagatedeğişken gözardı sırasında doğrulama paketi. Eğer Propagateiçin Falsealt Paketi'nde, bu olay üst pakete kadar yayılmasını engellemez.Üst paketi olay işleme önlemek için ayarlayın DisableEventHandlersiçin yürütme paketi görev özelliği True.
|
Tüm olay işleyicileri |
SourceDescription |
Dize |
Olay harekete geçirilen olay işleyicisi yürütülebilir açıklaması. |
Tüm olay işleyicileri |
SourceID |
Dize |
Olay harekete geçirilen olay işleyicisi yürütülebilir benzersiz tanıtıcısı. |
Tüm olay işleyicileri |
SourceName |
Dize |
Olay harekete geçirilen olay işleyicisi yürütülebilir adı. |
Tüm olay işleyicileri |
VariableDescription |
Dize |
Değişken açıklaması. |
OnVariableValueChanged olay işleyicisi |
VariableID |
Dize |
Değişkenin benzersiz tanımlayıcısı. |
OnVariableValueChanged olay işleyicisi |
Parameter Bindings Sistem değişkenleri
Paketi çalıştırdığınızda, sistem değişkenlerinin değerleri tabloları kaydetmek sık sık yararlıdır. Örneğin, dinamik bir tablo oluşturur ve oluşturulan tablonun tablo sütununda Paket yürütme örnek GUID yazan bir paket.
sql Yürüt görev kullanır sql deyimi parametreler eşleştirmek için Sistem değişkenleri kullanırsanız, sistem değişkeni veri türü için her parametre bağlama veri türünü ayarlamak önemlidir. Aksi takdirde, sistem değişkenlerinin değerleri yanlış tercüme edilebilir. Örneğin, eğer ExecutionInstanceGUIDdize verileri yazın ve bir paket yürütme örneğini GUID değeri temsil eden bir dize içerir vardır, sistem değişkeni, GUID veri türüne sahip bir parametre bağlama kullanıldığında, paketi örnek GUID yanlış tercüme edilecektir.
Bu kural hem de kullanıcı tanımlı değişkenleri için geçerlidir. Ancak, kullanıcı tanımlı veri türleri, daha esnek olmasına karşın, Sistem değişkenleri veri türleri değiştirilemez ve sen-si olmak-e sığdırmak için bu değişkenlerin kullanımını terzi. Parametresi bağlamaları içinde kullanılan kullanıcı tanımlı değişkenler genellikle hangi eşleştirildikleri parametreleri veri türleriyle uyumlu veri türleriyle tanımlanır.
ilişkili Görevler
Sorgu parametreleri içinde değişkenleri göster bir sql görev Yürüt
İlişkili İçerik
|