Tümleştirme Hizmetleri (SSIS) parametreleri
Integration Services(SSIS) parametreleri paketi yürütme zaman içinde paketler özellikleri değerleri atamak sağlar. Sen-ebilmek yaratmak Proje parametreleri proje düzeyinde ve paket parametreleri paket düzeyinde. Proje parametrelerinde herhangi bir dış giriş için bir veya daha fazla paket projedeki proje alır sağlamak için kullanılır. Paket parametreleri düzenleyin ve paketi yeniden dağıtma gerek kalmadan paketi yürütme değiştirmenize izin verir.
Parametreler yalnızca proje dağıtım modeli için geliştirilen projeleri için kullanılabilir. Proje dağıtım modeli kullanırken, Proje parametreleri ve paketler için sağladıkları hazır bilgi değerleri yönetmek için görünümler ve saklı yordamlar kapsamlı bir dizi nerede kullanılabilir SSISDB Kataloğu, dağıtılır. SQL Server Veri Akışı Araçlarıve sql Server Management Studio (ssms) da parametrelerini destekler.
SQL Server Veri Akışı Araçlarıoluşturma, değiştirme veya proje parametreleri kullanarak silme destekler parametreleri çift tıklatarak açabileceğiniz penceresinde, Project.params içinde Solution Explorer. O da çekmek oluşturma, değiştirme ve paket parametreleri kullanarak silme parametreleri sekmesini Package Designer, hangi tarafından çift tıklatarak paket içinde başlatabilirsiniz Solution Explorer. Daha fazla bilgi için bkz: Parametreleri Oluşturma.
The following sections describe Integration Servicesdaha fazla ayrıntı parametrelerinde.
Parametre değerleri
Parametreleri özellikler sizin paketleri içindeki değerleri atamak sağlar. Birden çok paket özellikleri için bir değer atamak üzere tek bir parametre kullanabilirsiniz, ancak bir tek paket özelliği yalnızca bir değer--dan tek bir parametre atanabilir. Proje Proje dağıtım döngüsünde nerede olmasına bağlı olarak, her parametre için üç farklı değerler atayabilirsiniz. Üç tip burada hangi-ebilmek var olmak tatbiki onlar için parametre sırada listelenir:
Tasarım varsayılan değer: proje oluşturulduğunda veya düzenlenebilir atanan varsayılan değeri SQL Server Veri Akışı Araçları. Bu değer, proje ile devam ediyor.
Sunucu varsayılan değer: Proje Kataloğu'nda bulunduğu sırada proje dağıtımı sırasında veya sonrasında, atanan varsayılan değer. Bu değer tasarım varsayılan geçersiz kılar.
Yürütme değeri: , belirli bir paketi yürütme örneğini referans olarak atanan değer. Bu atama, diğer tüm değerleri geçersiz kılar, ancak yalnızca tek bir örnek paketi yürütme geçerlidir.
Ne zaman parametre olarak işaretlenmemiş gerekli, sadece bir tanesi bu değerleri paketi yürütme belirtilmesi gerekiyor. Birden çok değer varsa, bir öncelik sırası, hangi değerlerin kullanılacağını belirler. Aşağıdaki tablo parametre değeri öncelik sırasını gösterir.
Öncelik sırası |
Değer adı |
Tür |
|---|---|---|
1 |
Yürütme parametre değeri |
Hazır bilgi |
2 |
Sunucu varsayılan |
Hazır bilgi ya da çevre değişken başvurusu |
3 |
Tasarım varsayılan |
Hazır bilgi |
Bir yürütme parametre değeri açıkça ayarlanmış olduğunda, bu değer sunucu varsayılan veya Tasarım varsayılan değer yerine yürütme sırasında kullanılacaktır. Yalnızca sunucu varsayılan ve tasarım varsayılan parametre belirtilmiş olan sunucu varsayılan değer kullanılacak.
[!NOT]
Bir parametre olarak, bir sunucu gerekli işaretlenmişse yürütmek karşılık gelen paket Bu parametre için varsayılan değer veya yürütme parametre değeri belirtilmelidir. Gerekli parametreler tasarım varsayılan olabilir, ancak bunlar paketi yürütme için yeterli değildir.
İnfaz ve yürütme parametre değerleri
Yürütme tek bir paket yürütme örneğini temsil eden bir nesne olduğunu. Yürütmesini oluşturduğunuzda, tüm bir paketi çalıştırmak için gerekli ayrıntıları gibi ilk başladı (girdi noktası paket) proje adını ve olması gereken paketin adını belirtmeniz. Ortam değişkenleri parametreleri kullanmak, uygun ortam değişkeni değerlerini ilgili parametreleri bağlanabilir böylece bir çevre referans da belirtmeniz gerekir.
Tüm parametreler bir yürütme başladı, son değişmez değerlerine çözümlenir. Bir parametreyi bir ortam değişkenine başvuruyorsa, bu değişken edebi değeri belirtilen çevre referans çözülmesi ve parametresi uygulanır. Son edebi parametre değeri paketi yürütme için kullanılan yürütme parametre değeri olarak adlandırılır.
Önce yürütme oluşturulduktan sonra yürütme başladı da açıkça bir yürütme parametre değeri ayarlayabilirsiniz. Yürütme parametresi değer ayarladığınızda, bu değer varsayılan parametre değerleri geçersiz kılar ve paketi yürütme için kullanılır.
Yürütme parametre değerlerini belirleme
Paketi yürütme başlayana kadar parametre değerleri bağlı değildir. Yürütme sırasında yürütme parametre değeri, kullanılan son edebi değeri ilgili yürütme yapılandırması tarafından belirlenir. Yürütme parametre değerleri, Sunucu varsayılanlarını ve tasarım Varsayılanları görmek için katalog karşı Transact-sql sorgularını çalıştırabilirsiniz. sql Server Management Studio'yu, yürütme parametre değerlerini görmek için de kullanabilirsiniz.
Aşağıdaki Transact-sql görünümler ve saklı yordam parametre değerlerini görüntülemek için kullanılır.
catalog.execution_parameter_values(Görünüm)
Belirli bir yürütme tarafından kullanılacak gerçek parametre değerlerini gösterircatalog.get_parameter_values(saklı yordam)
Çözümler ve belirtilen paket ve çevre referans fiili değerlerini gösterircatalog.object_parameters(Görünüm)
Sunucu ve tasarım varsayılan varsayılanlar (varsa) ilişkili tüm parametreleri ile gösterir
Yürütme örneğini parametre değeri açıkça ayarlanmış olduğunda, bu değer yalnızca belirli örneklerini yürütme için geçerlidir. Transact-sql ile bir yürütme parametre değeri ayarlamak için kullanın catalog.set_execution_parameter_valuesaklı yordamını. Geçerli yürütme parametre değerlerini görüntülemek için catalog.execution_parameter_valuesgörünümü.
[!NOT]
Yürütme parametre değerleri, yalnızca Transact-sql ile ayarlanabilir.
Proje dağıtım ve Sunucu varsayılanlarını ayarla
Ne zaman dağıtım projeleri ile kataloğa Integration ServicesDağıtım Sihirbazı, atayabileceğiniz varsayılan parametre değerleri yalnızca proje Kataloğu'nda bulunduğu sırada uygulanan. Bu değerler için sunucu varsayılan olarak adlandırılır ve tasarım varsayılan ayarları geçersiz kılar. Tasarım Varsayılanları proje ile kalıcı ve her zaman görüntülenebilir, ancak sunucu varsayılan varsa, tasarım varsayılan yerine kullanılacak.
[!NOT]
Sunucu varsayılanlarını eklendi, düzenlenemez veya proje dağıtıldıktan sonra herhangi bir zamanda temizlenir.
Hazır bilgi değerleri ve çevre değişken başvuruları
Sunucu varsayılan değerlerini hazır bilgi değerleri veya çevre değişken başvurular olabilir. O yürütüldüğünde paket tarafından kullanılacak istediğiniz bitiş değeri bir hazır bilgi değeridir. Bir ortam değişkeni başvuru katalog bir ortamda bulunduğu ortam değişkeninin adıdır. Paket çalıştırıldığında, ilgili çevre değişken değeri (bir hazır bilgi değeri) parametresi tarafından başvurulan ve paketle ilgili özelliğine atanır.
Parametre tasarım özellikleri
Parametre oluşturduğunuzda SQL Server Veri Akışı Araçları, belirtmek için çeşitli özellikler vardır.
Ad
Parametrenin adı.Veri türü
Parametre veri türü.Varsayılan değer
Tasarım sırasında atanan parametresi için varsayılan değer. Bu da Tasarım varsayılandır.Hassas
Hassas parametre değerleri katalogda şifrelenir ve Transact-sql veya sql Server Management Studio'yu ile görüntülendiğinde null değeri olarak görünür.Gerekli
Paketi çalıştırmak önce tasarım varsayılan dışında bir değer belirtilmesini gerektirir.Açıklama
Teknikleri için parametre açıklaması. De SQL Server Veri Akışı Araçları (SSDT), parametre geçerli Parametreler penceresinde seçili olduğunda parametre açıklaması Visual Studio Özellikler penceresinde ayarlayın.[!NOT]
Katalog için bir proje dağıttığınızda, birkaç daha fazla özellikler projeyle ilişkili olmak. Katalogdaki tüm parametreler için tüm özelliklerini görmek için catalog.object_parametersgörünümü.
Parametre doğrulama
Parametre değerleri çözümlenemeyen, karşılık gelen paketi yürütme başarısız olur. Hataları önlemek için projeler ve paketleri doğrulayabilirsiniz. Doğrulama tüm parametreler gerekli değerleri veya gerekli değerleri ile belirli ortam başvuruları çözümlemek için onaylamanızı sağlar. Doğrulama da diğer ortak paket sorunlar için kontrol eder.
Parametre örnek
Bu örnek adında bir parametreyi tanımlar pkgOptions bulunduğu paket seçeneklerini belirtmek için kullanılır.
Zaman parametre oluşturulduğu, tasarım zamanı sırasında SQL Server Veri Akışı Araçları, parametre varsayılan değeri 1 atandı. Bu varsayılan değer tasarım varsayılan olarak adlandırılır. Proje Kataloğu konuşlandırıldı ve diğer değer bu parametre, karşılık gelen paket özelliği ayrıldı pkgOptions parametre değeri 1 paketi yürütme sırasında atanmış. Tasarım varsayılan onun ömrü boyunca proje ile devam ediyor.
Proje ile dağıtımı sırasında Integration ServicesDağıtım Sihirbazı, 3 değeri için atanmış pkgOptions parametresi. Yalnızca karşılık gelen proje Kataloğu'nda bulunduğu sırada ilgili olduğu için bu yeni varsayılan değer, sunucu varsayılan olarak verilir. Başka bir değer bu parametre, karşılık gelen paket özelliği ayrıldı, pkgOptions parametre değeri 3 paketi yürütme sırasında atanmış.
[!NOT]
Sunucu varsayılan değerlerini de belirtilen veya proje kataloğa dağıtıldıktan sonra temizlenir.
Belirli bir paket yürütme örneğini hazırlanırken, 5 değeri atanır pkgOptions parametresi. Parametresi yalnızca yürütme belirli örneklerini uygulandığı çünkü bu değer yürütme değeri olarak adlandırılır. Yürütme parametre değerleri varsayılan tasarım ve Sunucu varsayılanlarını geçersiz kılar. Yürütme başladığında, paket özelliği ilgili pkgOptions parametre değeri 5 atanır.
Parameterizing görev özellikleri
İletişim kutusu Parameterize , yeni veya varolan bir parametre görev özelliği ile ilişkilendirmek sağlar. Bu iletişim kutusunda bir görev sağ tıklatarak başlatabilirsiniz SSIS Tasarımcısı pencere ve ile seçerek Parameterize açılan menüsünde seçenek. İletişim kutusu hakkında daha fazla bilgi için bkz: İletişim kutusu parameterize.