Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Şunlar için geçerlidir:
SQL Server Azure Data Factory'de SSIS Tümleştirme Çalışma Zamanı
SQL Server Integration Services, çalışan paket ve nesneleri hakkında bilgi depolayan bir dizi sistem değişkeni sağlar. Bu değişkenler paketleri, kapsayıcıları, görevleri ve olay işleyicilerini özelleştirmek için ifadelerde ve özellik ifadelerinde kullanılabilir.
Tüm değişkenler-sistem ve kullanıcı tanımlı-, SQL Yürütme görevinin değişkenleri parametrelerle eşlemek için kullandığı parametre bağlamalarında kullanılabilir.
Paketler için Sistem Değişkenleri
Aşağıdaki tabloda Integration Services'ın paketler için sağladığı sistem değişkenleri açıklanmaktadır.
| Sistem değişkeni | Veri türü | Description |
|---|---|---|
| OlayıİptalEt | Int32 | Görevin çalışmayı durdurması gerektiğini belirtmek için işaret edebildiği bir Windows Olay nesnesinin tanıtıcısı. |
| ContainerStartTime | DateTime | Kapsayıcının başlangıç saati. |
| OluşturmaTarihi | DateTime | Paketin oluşturulduğu tarih. |
| CreatorComputerAdı | String | Paketin oluşturulduğu bilgisayar. |
| CreatorName | String | Paketi oluşturan kişinin adı. |
| ExecutionInstanceGUID | String | Bir paketin yürütülen örneğinin benzersiz tanımlayıcısı. |
| BaşarısızYapılandırmalar | String | Başarısız olan paket yapılandırmalarının adları. |
| IgnoreConfigurationsOnLoad | Boolean | Paket yüklenirken paket yapılandırmalarının yoksayılması gerekip gerekmediğini gösterir. |
| InteractiveMode | Boolean | Paketin etkileşimli modda çalıştırılıp çalıştırılmadığını gösterir. SSIS Tasarımcısı'nda bir paket çalışıyorsa, bu özellik True olarak ayarlanır. DTExec komut istemi yardımcı programı kullanılarak bir paket çalışıyorsa, özelliği False olarak ayarlanır. |
| LocaleId | Int32 | Paketin kullandığı yerel ayar. |
| MachineName | String | Paketin üzerinde çalıştığı bilgisayarın adı. |
| Çevrimdışı Modu |
Boolean | Paketin çevrimdışı modda olup olmadığını gösterir. Çevrimdışı mod veri kaynaklarına bağlantı almaz. |
| Packageıd | String | Paketin benzersiz tanımlayıcısı. |
| PackageName | String | Paketin adı. |
| StartTime | DateTime | Paketin çalışmaya başladığı saat. |
| ServerExecutionID | Int64 | Integration Services sunucusunda yürütülen paketin yürütme kimliği. Varsayılan değer sıfırdır. Değer yalnızca paket Integration Services Sunucusu'nda ISServerExec tarafından yürütülürse değiştirilir. Bir alt paket bulunduğunda, değer ebeveyn paketten alt pakete aktarılır. |
| UserName | String | Paketi başlatan kullanıcının hesabı. Kullanıcı adı, etki alanı adına göre nitelenmiş. |
| VersionBuild | Int32 | Paket sürümü. |
| VersionComment | String | Paket sürümüyle ilgili açıklamalar. |
| VersionGUID | String | Sürümün benzersiz tanımlayıcısı. |
| VersionMajor | Int32 | Paketin ana sürümü. |
| VersionMinor | Int32 | Paketin alt sürümü. |
Kapsayıcılar için Sistem Değişkenleri
Aşağıdaki tabloda, Integration Services'ın For Döngüsü, Foreach Döngüsü ve Sıra kapsayıcıları için sağladığı sistem değişkenleri açıklanmaktadır.
| Sistem değişkeni | Veri türü | Description | Container |
|---|---|---|---|
| LocaleId | Int32 | Kapsayıcının kullandığı yerel ayar. | Döngü kapsayıcısı için Foreach Döngüsü kapsayıcısı Sıra kapsayıcısı |
Görevler için Sistem Değişkenleri
Aşağıdaki tabloda Integration Services'ın görevler için sağladığı sistem değişkenleri açıklanmaktadır.
| Sistem değişkeni | Veri türü | Description |
|---|---|---|
| Creationname | String | Görevin adı. |
| LocaleId | Int32 | Görevin kullandığı yerel ayar. |
| Görev Kimliği | String | Görev örneğinin benzersiz tanımlayıcısı. |
| Görev Adı | String | Görev örneğinin adı. |
| TaskTransactionOption | Int32 | Görevin kullandığı işlem seçeneği. |
Olay İşleyicileri için Sistem Değişkenleri
Aşağıdaki tabloda Integration Services'ın olay işleyicileri için sağladığı sistem değişkenleri açıklanmaktadır. Tüm değişkenler tüm olay işleyicileri tarafından kullanılamaz.
| Sistem değişkeni | Veri türü | Description | Olay işleyicisi |
|---|---|---|---|
| İptal | Boolean | Bir hata, uyarı veya sorgu iptali oluştuğunda olay işleyicisinin çalışmayı durdurup durdurmadığı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 |
| HataAçıklama | String | Hatanın 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şleyicisinin kullandığı yerel ayar. | Tüm olay işleyicileri |
| Yüzde Tamamla | Int32 | Tamamlanan çalışmanın yüzdesi. | OnProgress olay işleyicisi |
| ProgressCountHigh | Int32 | OnProgress olayı tarafından işlenen toplam işlem sayısını gösteren 64 bitlik değerin yüksek bölümü. | OnProgress olay işleyicisi |
| ProgressCountLow | Int32 | OnProgress olayı tarafından işlenen toplam işlem sayısını gösteren 64 bitlik değerin düşük bölümü. | OnProgress olay işleyicisi |
| ProgressDescription | String | İlerleme durumunun açıklaması. | OnProgress olay işleyicisi |
| Yaymak | Boolean | Olayın daha üst düzey bir olay işleyicisine yayılıp yayılmadığını gösterir. Not: Yay değişkeninin değeri, paketin doğrulanması sırasında göz ardı edilir. Bir alt pakette PropagateFalse şeklinde ayarlarsanız, bu bir olayın üst pakete yayılmasını engellemez. |
Tüm olay işleyicileri |
| SourceDescription | String | Olayı tetikleyen olay işleyicisinde yer alan yürütülebilir dosyanın açıklaması. | Tüm olay işleyicileri |
| SourceID | String | Olayı tetikleyen olay işleyicisindeki yürütülebilir dosyanın benzersiz tanımlayıcısı. | Tüm olay işleyicileri |
| SourceName | String | Olayı tetikleyen olay işleyicisindeki yürütülebilir dosyanın adı. | Tüm olay işleyicileri |
| VariableDescription | String | Değişken açıklaması. | OnVariableValueChanged olay işleyicisi |
| Variable ID | String | Değişkenin benzersiz tanımlayıcısı. | OnVariableValueChanged olay işleyicisi |
Parametre Bağlamalarında Sistem Değişkenleri
Paket çalıştırıldığında sistem değişkenlerinin değerlerini tablolara kaydetmek sıklıkla yararlıdır. Örneğin, dinamik olarak bir tablo oluşturan ve tabloyu bir tablo sütununda oluşturan paket yürütme örneğinin GUID'sini yazan bir paket.
SQL deyiminde, SQL Yürüt Görevinin kullandığı parametrelerle eşlemek için Sistem Değişkenlerini kullanırsanız, her Parametre Bağlamasının veri türünü Sistem Değişkeninin veri türüne ayarlamanız önemlidir. Aksi takdirde, sistem değişkenlerinin değerleri yanlış çevrilebilir. Örneğin, dize veri türüne sahip olan ve bir paketin yürütülen örneğinin GUID'sini temsil eden bir dize içeren ExecutionInstanceGUID sistem değişkeni GUID veri türüne sahip bir parametre bağlamasında kullanılıyorsa, paket örneğinin GUID'i yanlış çevrilir.
Bu kural, kullanıcı tanımlı değişkenler için de geçerlidir. Ancak, sistem değişkenlerinin veri türleri değiştirilemez ve bu değişkenleri kullanımınızı veri türlerine uyacak şekilde uyarlamanız gerekirken, kullanıcı tanımlı daha esnektir. Parametre bağlamalarında kullanılan kullanıcı tanımlı değişkenler genellikle eşlendikleri parametre veri türleriyle uyumlu veri türleriyle tanımlanır.
İlgili Görevler
Sql Yürütme Görevinde Sorgu Parametrelerini Değişkenlerle Eşleme