SSIS paketi değişkenleri

Değişkenleri mağaza değerlerini bir SQL Server  Integration Servicespaket konteynerler, görev ve olay işleyicileri kullanarak çalışma zamanında. Script görev ve Script bileşeni komut değişkenleri de kullanabilirsiniz. Onların kısıtlaması tanımları ifadelerde eklediğinizde görevler ve containers iş akışı sıra önceliği kısıtlamaları değişkenlerini kullanabilirsiniz.

Sen-ebilmek kullanma değişkenleri Integration Servicespaketleri aşağıdaki amaçlar için:

• Zamanında paket elemanlarının özellikleri güncelleştiriliyor. Örneğin, bir Foreach döngü kapsayıcı sağlayan eşzamanlı yürütülebilir dosyaları sayısını dinamik olarak ayarlayabilirsiniz.

• Bir bellek içi arama tablosu dahil. Örneğin, bir paketi değişken veri değerleri ile yüklenen sql Yürüt görev çalıştırabilirsiniz.

• Değişken veri değerleri ile yükleme ve sonra bunları kullanarak bir arama koşulu where yan tümcesinde belirtin. Örneğin, komut dosyasında bir komut dosyası görevi bir Transact-sql deyimi sql Yürüt görev tarafından kullanılan bir değişkenin değerini güncelleştirebilirsiniz.

• Bir değişken, tamsayı ve bir paket akış denetimi döngü denetim değerini kullanarak yükleniyor. Örneğin, yineleme kontrol etmek için döngü kapsayıcı değerlendirme ifadesinde değişken kullanabilirsiniz.

• Transact-sql deyimleri için parametre değerlerini çalıştırma sırasında doldurma. Örneğin, bir paket sql Yürüt görev çalıştırın ve ardından dinamik bir Transact-sql deyiminde parametreleri ayarlamak için değişkenler kullanmak.

• Değişken değerlerini içeren bina ifadeler. Örneğin, sütun Derived dönüşümü sütun sütun değeri değişken değeriyle çarpılmasıyla elde edilen sonuç ile doldurabilirsiniz.

Integration Servicesdeğişkenleri için iki tür destekler: kullanıcı tanımlı değişkenleri ve Sistem değişkenleri. Paket geliştiriciler tarafından tanımlanan kullanıcı tanımlı değişkenleri ve Sistem değişkenleri tarafından tanımlanan Integration Services. Bir paketi gerektirir, ancak ek sistem değişkenleri oluşturamazsınız birçok kullanıcı tanımlı değişkenleri oluşturabilirsiniz.

Tüm değişkenleri — sistem ve kullanıcı tanımlı — değişkenleri parametreleri sql deyimlerinin eşleştirmek için sql Yürüt görev kullanır parametresi bağlamaları kullanılabilir. Daha fazla bilgi için sql görev Yürütve Parametreleri ve dönüş kodları'çalışan sql görev Yürüt.

[!NOT]

Kullanıcı tanımlı adlarını ve Sistem değişkenleri büyük/küçük harf duyarlıdır.

Tüm kullanıcı tanımlı değişkenleri oluşturabilirsiniz Integration Serviceskapsayıcı türleri: paketleri, Foreach döngü konteynerler, döngü için konteynerler, sıra konteynerler, görevleri ve olay işleyicileri. Kullanıcı tanımlı değişkenleri, kapsayıcı değişkenleri koleksiyonu bir üyesidir.

Paketi kullanarak oluşturursanız, SSIStasarımcı, değişkenleri Koleksiyonlar üyelerini görebilirsiniz değişkenleri klasörleri Paketi Explorer sekmesini SSIStasarımcı. Klasörleri, kullanıcı tanımlı değişkenleri ve Sistem değişkenleri listeler.

Kullanıcı tanımlı değişkenleri aşağıdaki şekillerde yapılandırabilirsiniz:

• Bir adı ve değişken için açıklama girin.

• Değişken için bir ad belirtin.

• Değişken değeri değiştiğinde bir olay yükseltir olup olmadığını gösterir.

• Değişken salt okunur olup olmadığını belirtin veya okuma/yazma.

• Bir ifade değerlendirme sonucunu, değişken değeri ayarlamak için kullanın.

• Değişken paket veya görev gibi bir paketi nesne kapsamı oluşturun.

• Değişken değer ve veri türünü belirtin.

Sistem değişkenlerini yalnızca yapılandırılabilir seçenek değerini değiştirirken Olay zam olmadığını belirtme.

Sistem değişkenleri farklı bir dizi farklı kapsayıcı türleri için kullanılabilir. Paketleri ve kendi elemanları tarafından kullanılan sistem değişkenleri hakkında daha fazla bilgi için bkz: Sistem değişkenleri.

Değişkenler için gerçek hayatta kullanım senaryoları hakkında daha fazla bilgi için bkz: Paketlerinde değişkenleri kullanma.

Ad alanı

Integration Servicesiki ad sağlar Userve System. Varsayılan olarak, özel değişkenler olan Userad alanını ve Sistem değişkenleri olan Systemnamespace. Kullanıcı tanımlı değişkenleri için ek ad boşlukları oluşturmak ve değiştirmek Userad, ama adını değiştiremez Systemad değişkenler ekleme Systemad veya Sistem değişkenleri için farklı bir ad atayın.

Kapsam

Bir değişken, bir paket kapsamında ya da konteyner, görev veya olay işleyicisi paketi kapsamında oluşturulur. Paketi kapsayıcıyı kapsayıcı hiyerarşisinin en üstünde olduğundan, değişkenleri paketi kapsam işlevine sahip ve global değişkenler gibi tüm paket kaplarında tarafından kullanılabilir. Benzer şekilde, bir döngü için kapsayıcı gibi bir kap kapsamında tanımlanan değişkenleri tüm görevler veya konteynerler içinde döngü için kapsayıcı olarak kullanılır.

Bir paketi yürütme paketi görev kullanarak diğer paketleri çalışırsa, arama paketi veya yürütme paketi görev kapsamında tanımlanmış değişkenleri üst paketi değişken yapılandırma türü kullanılarak çağrılan Paket için kullanılabilir yapılabilir. Daha fazla bilgi için, bkz. Paketi yapılandırmaları.

Değer

Kullanıcı tanımlı bir değişken değeri sabit bir değer veya deyim olabilir. Bir değişken değişken değeri ve değeri veri türünü ayarlamak için seçenekler içerir. İki özellik uyumlu olmalıdır: Örneğin, bir dize değeri bir tamsayı veri türü ile birlikte kullanımı geçerli değil.

Değişken bir ifade olarak değerlendirmek için yapılandırılmışsa, bir ifade sağlamanız gerekir. Çalışma zamanında ifade değerlendirilir ve değerlendirme sonucu değişkeni ayarlanır. Örneğin, bir değişken ifade kullanıyorsa, DATEPART("month", GETDATE()) değişkeninin değerini geçerli tarih ay numarası eşdeğerdir. İfade kullanan geçerli bir ifade olmalıdır SSISifade dilbilgisi sözdizimi. İfadede değişkenler kullanıldığında, ifade rakamları ve operatörler ve ifade dilbilgisi sağlar işlevleri kullanabilirsiniz, ancak ifade paketi veri akışı sütunları başvuru yapamazsınız. Deyim uzunluğu en fazla 4000 karakter olabilir. Daha fazla bilgi için, bkz. Integration Services Expression Reference.

Değişkenleri yapılandırma

Aracılığıyla özelliklerini ayarlayabilirsiniz SSISTasarımcısı veya programlı olarak.

Sen-ebilmek koymak içinde özellikleri hakkında daha fazla bilgi için SSIStasarımcı, bakın Değişkenleri penceresinde.

Program aracılığıyla bu özellikleri ayarlama hakkında daha fazla bilgi ve değişken özellikleri hakkında daha fazla bilgi için bkz: Variable.

ilişkili Görevler

Eklemek veya kullanıcı tanımlı bir değişken bir paketi silmek

Kullanıcı tanımlı bir değişken özelliklerini ayarlama

Bir alt paketi değişkenleri ve parametre değerlerini kullanmak

Harita sorgu parametreleri değişkenleri veri akışı bileşen

İlişkili İçerik

Integration Services Objects and Concepts