Integration Services (SSIS) Paket ve Proje Parametreleri

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Tümleştirme Çalışma Zamanı

Integration Services (SSIS) parametreleri, paket yürütme sırasında paketler içindeki özelliklere değer atamanıza olanak sağlar. Proje düzeyinde proje parametreleri ve paket düzeyinde paket parametreleri oluşturabilirsiniz. Proje parametreleri, projenin projedeki bir veya daha fazla pakete aldığı tüm dış girişleri sağlamak için kullanılır. Paket parametreleri, paketi düzenlemek ve yeniden dağıtmak zorunda kalmadan paket yürütmeyi değiştirmenize olanak sağlar.

SQL Server Veri Araçları'nda Project.params penceresini kullanarak proje parametrelerini oluşturur, değiştirir veya silersiniz. SSIS Tasarımcısı'ndaki Parametreler sekmesini kullanarak paket parametreleri oluşturur, değiştirir ve silersiniz. Parametreleştir iletişim kutusunu kullanarak yeni veya mevcut bir parametreyi bir görev özelliğiyle ilişkilendirirsiniz.

Parametreler ve Paket Dağıtım Modeli

Genel olarak, paket dağıtım modelini kullanarak bir paket dağıtıyorsanız, parametreler yerine yapılandırmaları kullanmanız gerekir.

Paket dağıtım modelini kullanarak parametreleri içeren bir paket dağıtıp sonra paketi yürütürken, yürütme sırasında parametreler çağrılmaz. Paket içinde paket parametreleri ve ifadeleri varsa, parametreleri kullanır, sonuçta elde edilen değerler çalışma zamanında uygulanır. Paket proje parametreleri içeriyorsa, paket yürütme başarısız olabilir.

Parametreler ve Proje Dağıtım Modeli

Integration Services (SSIS) sunucusuna bir proje dağıttığınızda, proje ve paket parametrelerini yönetmek için görünümleri, saklı yordamları ve SQL Server Management Studio kullanıcı arabirimini kullanırsınız. Daha fazla bilgi için aşağıdaki konulara bakın.

• Görünümler (Integration Services Kataloğu)

• Saklı Yordamlar (Integration Services Kataloğu)

• Yapılandır İletişim Kutusu

• Paketi Yürüt İletişim Kutusu

Parametre Değerleri

Bir parametreye en çok üç farklı tür değer atayabilirsiniz. Paket yürütme başlatıldığında, parametre için tek bir değer kullanılır ve parametre son değişmez değere çözümlenir.

Aşağıdaki tabloda değer türleri listelenmiştir.

Değer Adı	Description	Değer türü
Yürütme Değeri	Paket yürütmenin belirli bir örneğine atanan değer. Bu atama diğer tüm değerleri geçersiz kılar, ancak yalnızca tek bir paket yürütme örneği için geçerlidir.	Literal
Sunucu Değeri	Proje Integration Services sunucusuna dağıtıldıktan sonra proje kapsamında parametresine atanan değer. Bu değer tasarım varsayılanını geçersiz kılar.	Değişmez Değer veya Ortam Değişkeni Başvurusu
Tasarım Değeri	Proje SQL Server Veri Araçları'nda oluşturulduğunda veya düzenlendiğinde parametresine atanan değer. Bu değer projede kalır.	Literal

Birden çok paket özelliğine değer atamak için tek bir parametre kullanabilirsiniz. Tek bir paket özelliğine yalnızca tek bir parametreden bir değer atanabilir.

Yürütmeler ve Parametre Değerleri

Yürütme, paket yürütmenin tek bir örneğini temsil eden bir nesnedir. Yürütme oluşturduğunuzda, yürütme parametresi değerleri gibi bir paketi çalıştırmak için gereken tüm ayrıntıları belirtirsiniz. Ayrıca, var olan yürütmeler için parametre değerlerini de değiştirebilirsiniz.

Bir yürütme parametresi değerini açıkça ayarladığınızda, değer yalnızca belirli bir yürütme örneği için geçerlidir. Yürütme değeri, sunucu değeri veya tasarım değeri yerine kullanılır. Açıkça bir yürütme değeri ayarlamazsanız ve bir sunucu değeri belirtilmişse, sunucu değeri kullanılır.

Bir parametre gerekli olarak işaretlendiğinde, bu parametre için bir sunucu değeri veya yürütme değeri belirtilmelidir. Aksi takdirde, karşılık gelen paket yürütülmüyor. Parametre tasarım zamanında varsayılan bir değere sahip olsa da, proje dağıtıldıktan sonra hiçbir zaman kullanılmaz.

Ortam Değişkenleri

Bir parametre bir ortam değişkenine başvuruda bulunursa, bu değişkendeki değişmez değer belirtilen ortam başvurusu aracılığıyla çözümlenir ve parametreye uygulanır. Paket yürütme için kullanılan son değişmez değer parametre değeri, yürütme parametresi değeri olarak adlandırılır. Yürüt iletişim kutusunu kullanarak yürütme için ortam başvurusu belirtirsiniz

Proje parametresi bir ortam değişkenine başvuruda bulunursa ve değişkenden sabit değer yürütme sırasında çözümlenemiyorsa, tasarım değeri kullanılır. Sunucu değeri kullanılmaz.

Parametre değerlerine atanan ortam değişkenlerini görüntülemek için catalog.object_parameters görünümünü sorgulayın. Daha fazla bilgi için bkz. catalog.object_parameters (SSISDB Veritabanı).

Yürütme Parametresi Değerlerini Belirleme

Parametre değerlerini görüntülemek ve ayarlamak için aşağıdaki Transact-SQL görünümleri ve saklı yordam kullanılabilir.

catalog.execution_parameter_values (SSISDB Veritabanı)(görünüm)
Belirli bir yürütmedeki gerçek parametre değerlerini gösterir.

catalog.get_parameter_values (SSISDB Veritabanı) (saklı yordam)
Belirtilen paket ve ortam başvurusu için gerçek değerleri çözümler ve gösterir.

catalog.object_parameters (SSISDB Veritabanı) (görünüm)
Tümleştirme Hizmetleri kataloğundaki tüm paketler ve projeler için tasarım varsayılan ve sunucu varsayılan değerleri dahil olmak üzere parametreleri ve özellikleri görüntüler.

catalog.set_execution_parameter_value (SSISDB Veritabanı)
Integration Services kataloğundaki bir yürütme örneği için parametrenin değerini ayarlar.

SQL Server Veri Araçları'nda (SSDT) parametre değerini değiştirmek için Paketi Yürüt iletişim kutusunu da kullanabilirsiniz. Daha fazla bilgi için bkz. Paket Yürütme İletişim Kutusu.

Bir parametre değerini değiştirmek için dtexec /Parameter seçeneğini de kullanabilirsiniz. Daha fazla bilgi için bkz. dtexec Yardımcı Programı.

Parametre Doğrulama

Parametre değerleri çözümlenemiyorsa, karşılık gelen paket yürütme başarısız olur. Hataları önlemeye yardımcı olmak için SQL Server Veri Araçları'ndaki (SSDT) Doğrula iletişim kutusunu kullanarak projeleri ve paketleri doğrulayabilirsiniz. Doğrulama, tüm parametrelerin gerekli değerlere sahip olduğunu veya gerekli değerleri belirli ortam başvuruları ile çözümleyebildiğini onaylamanıza olanak tanır. Doğrulama, diğer yaygın paket sorunlarını da denetler.

Daha fazla bilgi için bkz . Doğrulama İletişim Kutusu.

Parametre Örneği

Bu örnekte, içinde bulunduğu paket için seçenekleri belirtmek için kullanılan pkgOptions adlı bir parametre açıklanmaktadır.

Tasarım sırasında, parametre SQL Server Veri Araçları'nda oluşturulduğunda, parametreye varsayılan değer olan 1 atanmıştır. Bu varsayılan değer, tasarım varsayılanı olarak adlandırılır. Proje SSISDB kataloğuna dağıtıldıysa ve bu parametreye başka değer atanmadıysa, paket yürütme sırasında pkgOptions parametresine karşılık gelen paket özelliğine 1 değeri atanır. Tasarım varsayılanı, yaşam döngüsü boyunca projede kalır.

Paket yürütmenin belirli bir örneği hazırlanırken pkgOptions parametresine 5 değeri atanır. Bu değer, yalnızca belirli bir yürütme örneği için parametresine uygulandığından yürütme değeri olarak adlandırılır. Yürütme başladığında , pkgOptions parametresine karşılık gelen paket özelliğine 5 değeri atanır.

Parametre oluşturma

Proje parametreleri ve paket parametreleri oluşturmak için SQL Server Veri Araçları'nı (SSDT) kullanırsınız. Aşağıdaki yordamlar, paket/proje parametreleri oluşturmaya yönelik adım adım yönergeler sağlar.

Uyarı

Integration Services'in önceki bir sürümünü kullanarak oluşturduğunuz bir projeyi proje dağıtım modeline dönüştürüyorsanız, yapılandırmaları temel alan parametreler oluşturmak için Integration Services Proje Dönüştürme Sihirbazı'nı kullanabilirsiniz. Daha fazla bilgi için bkz. Integration Services (SSIS) Projelerini ve Paketlerini Dağıtma.

Paket parametreleri oluşturma

1. Paketi SQL Server Veri Araçları'nda açın ve ardından SSIS Tasarımcısı'nda Parametreler sekmesine tıklayın.

   

2. Araç çubuğunda Parametre Ekle düğmesine tıklayın.

   

3. Ad, Veri Türü, Değer, Hassas ve Gerekli özelliklerin değerlerini listenin kendisine veya Özellikler penceresine girin. Aşağıdaki tabloda bu özellikler açıklanmaktadır.

   Mülkiyet	Description
   İsim	Parametresinin adı.
   Veri türü	Parametresinin veri türü.
   Varsayılan değer	Tasarım zamanında atanan parametre için varsayılan değer. Bu, tasarım varsayılanı olarak da bilinir.
   Duyarlı	Hassas parametre değerleri katalogda şifrelenir ve Transact-SQL veya SQL Server Management Studio ile görüntülendiğinde NULL değer olarak görünür.
   Gerekli	Paketin yürütülebilmesi için tasarım varsayılanı dışında bir değerin belirtilmelidir.
   Description	Bakım için parametresinin açıklaması. SQL Server Veri Araçları'nda (SSDT), ilgili parametreler penceresinde parametre seçildiğinde Visual Studio Özellikleri penceresinde parametre açıklamasını ayarlayın.

   Uyarı

   Bir projeyi kataloğa dağıttığınızda, projeyle birkaç özellik daha ilişkilendirildi. Katalogdaki tüm parametrelerin tüm özelliklerini görmek için catalog.object_parameters (SSISDB Veritabanı) görünümünü kullanın.

4. Parametrelerdeki değişiklikleri kaydetmek için projeyi kaydedin. Parametre değerleri proje dosyasında depolanır.

   Uyarı

   Listede yerinde düzenleme yapabilir veya Parametre özelliklerinin değerlerini değiştirmek için Özellikler penceresini kullanabilirsiniz. Sil (X) araç çubuğu düğmesini kullanarak parametreyi silebilirsiniz. Son araç çubuğu düğmesini kullanarak, yalnızca paketi SQL Server Veri Araçları'nda yürütürken kullanılan bir parametre için bir değer belirtebilirsiniz.

   Uyarı

   Projeyi SQL Server Veri Araçları'nda açmadan paket dosyasını yeniden açarsanız , Parametreler sekmesi boş ve devre dışı bırakılır.

Proje parametreleri oluşturma

1. Projeyi SQL Server Veri Araçları'nda açın.

2. Çözüm Gezgini'nde Project.params'a sağ tıklayın ve ardından Aç 'a (VEYA) tıklayarak Project.params'a çift tıklayarak açın.

   

3. Araç çubuğunda Parametre Ekle düğmesine tıklayın.

   

4. Ad, Veri Türü, Değer, Hassas ve Gerekli özellikleri için değerleri girin.

   Mülkiyet	Description
   İsim	Parametresinin adı.
   Veri türü	Parametresinin veri türü.
   Varsayılan değer	Tasarım zamanında atanan parametre için varsayılan değer. Bu, tasarım varsayılanı olarak da bilinir.
   Duyarlı	Hassas parametre değerleri katalogda şifrelenir ve Transact-SQL veya SQL Server Management Studio ile görüntülendiğinde NULL değer olarak görünür.
   Gerekli	Paketin yürütülebilmesi için tasarım varsayılanı dışında bir değerin belirtilmelidir.
   Description	Bakım için parametresinin açıklaması. SQL Server Veri Araçları'nda, ilgili parametreler penceresinde parametre seçildiğinde Visual Studio Özellikleri penceresinde parametre açıklamasını ayarlayın.

5. Parametrelerdeki değişiklikleri kaydetmek için projeyi kaydedin. Parametre değerleri proje dosyasındaki yapılandırmalarda depolanır. Parametre değerlerindeki değişiklikleri diske kaydetmek için proje dosyasını kaydedin.

   Uyarı

   Listede yerinde düzenleme yapabilir veya Parametre özelliklerinin değerlerini değiştirmek için Özellikler penceresini kullanabilirsiniz. Sil (X) araç çubuğu düğmesini kullanarak parametreyi silebilirsiniz. Parametre Değerlerini Yönet iletişim kutusunu açmak için son araç çubuğu düğmesini kullanarak, yalnızca paketi SQL Server Veri Araçları'nda yürütürken kullanılan bir parametre için bir değer belirtebilirsiniz.

Parametreleştir İletişim Kutusu

Parametreleştir iletişim kutusu, yeni veya var olan bir parametreyi görevin özelliğiyle ilişkilendirmenize olanak tanır. SSIS Tasarımcısı'nda bir göreve veya Denetim Akışı sekmesine sağ tıklayıp Parametreleştir'e tıklayarak iletişim kutusunu açarsınız. Aşağıdaki listede iletişim kutusundaki kullanıcı arabirimi öğeleri açıklanmaktadır.

Options

Property
Bir parametreyle ilişkilendirmek istediğiniz görevin özelliğini seçin. Bu liste parametreleştirilebilen tüm özelliklerle doldurulur.

Mevcut parametreyi kullan
Görevin özelliğini mevcut bir parametreyle ilişkilendirmek için bu seçeneği belirleyin ve ardından açılan listeden parametresini seçin.

Parametre kullanmayın
Parametre başvurularını kaldırmak için bu seçeneği belirleyin. Parametresi silinmez.

Yeni parametre oluşturma
Görevin özelliğiyle ilişkilendirmek istediğiniz yeni bir parametre oluşturmak için bu seçeneği belirleyin.

İsim
Oluşturmak istediğiniz parametrenin adını belirtin.

Açıklama
Parametresinin açıklamasını belirtin.

Değer
parametresi için varsayılan değeri belirtin. Bu, daha sonra dağıtım zamanında geçersiz kılınabilen tasarım varsayılanı olarak da bilinir.

Scope
Proje veya Paket seçeneğini belirleyerek parametrenin kapsamını belirtin. Proje parametreleri, projenin projedeki bir veya daha fazla pakete aldığı tüm dış girişleri sağlamak için kullanılır. Paket parametreleri, paketi düzenlemek ve yeniden dağıtmak zorunda kalmadan paket yürütmeyi değiştirmenize olanak sağlar.

Duyarlı
Onay kutusunu işaretleyerek veya temizleyerek parametrenin hassas olup olmadığını belirtin. Hassas parametre değerleri katalogda şifrelenir ve Transact-SQL veya SQL Server Management Studio ile görüntülendiğinde NULL değer olarak görünür.

Required
Parametresinin, paket yürütülmeden önce tasarım varsayılanı dışında bir değerin belirtilip belirtileceğini belirtin.

Proje dağıtıldıktan sonra parametre değerlerini ayarlama

Dağıtım Sihirbazı, projenizi kataloğa dağıtırken sunucu varsayılan parametre değerlerini ayarlamanıza olanak tanır. Projeniz katalogda olduktan sonra, sunucu varsayılan değerlerini ayarlamak için SQL Server Management Studio (SSMS) Nesne Gezgini'ni veya Transact-SQL kullanabilirsiniz.

SSMS Nesne Gezgini ile sunucu varsayılanlarını ayarlama

1. Integration Services düğümü altında projeyi seçin ve sağ tıklayın.

2. Proje Özellikleri iletişim penceresini açmak için Özellikler'e tıklayın.

3. Bir sayfa seçin altında Parametreler'e tıklayarak parametreler sayfasını açın.

4. Parametreler listesinden istediğiniz parametreyi seçin. Not: Kapsayıcı sütunu, proje parametrelerini paket parametrelerinden ayırmaya yardımcı olur.

5. Değer sütununda, istenen sunucu varsayılan parametre değerini belirtin.

Transact-SQL ile sunucu varsayılanlarını ayarlama

Transact-SQL ile sunucu varsayılanlarını ayarlamak için catalog.set_object_parameter_value (SSISDB Veritabanı) saklı yordamını kullanın. Geçerli sunucu varsayılanlarını görüntülemek için catalog.object_parameters (SSISDB Veritabanı) görünümünü sorgula. Sunucu varsayılan değerini temizlemek için catalog.clear_object_parameter_value (SSISDB Veritabanı) saklı yordamını kullanın.