Sistem değişkenleri

Makale
10/29/2012

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ı

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.