Paketlerinde özelliği ifadeleri kullanma
Özellik özelliğinin çalışma sırasında dinamik güncelleştirmeyi etkinleştirmek için atanan bir ifade özelliği ifadesidir saat.Örneğin, bir özellik ifade bir değişkende saklanır bir e-posta adresi ekleyerek posta Gönder görev kullanır Kime satırında güncelleştirebilirsiniz.
paket, görev, Foreach döngü, For döngüsü, sıra, Foreach Numaralandırıcı, olay işleyicisi, Bağlantı Yöneticisi'ni veya günlük sağlayıcı için bir ifade eklenebilir.Any property of these objects that is read/write can implement a property expression.Integration Services also supports the use of property expressions in some custom properties of data flow components.Değişkenler ve öncelik kısıtlamaları özellik ifadeler desteklemez, ancak bunlar ifadeleri kullanan özel özellikler içerir.
Özellik ifadeleri farklı şekillerde güncelleştirilebilir:
Kullanıcı tanımlı değişkenleri paket yapılandırmaları dahil ve paket dağıtılırken, daha sonra güncelleştirilen.Çalışma sırasında saat, güncelleştirilmiş değişken değerini kullanarak özellik deyimi değerlendirilir.
İfadelerde dahil Sistem değişkenleri çalışma zamanında güncelleştirilmiş saat, özellik değerlendirme sonuçlarını değiştirir.
Tarih ve saat işlevleri zamanında değerlendirilir ve özellik ifadeler için güncelleştirilmiş değerleri sağlar.
İfadelerde değişkenleri Script görev ve Script bileşeni çalışan komut dosyaları tarafından güncelleştirilebilir.
The expressions are built using the Microsoft Integration Services expression language.İfadeler, sistem veya kullanıcı tanımlı değişkenleri, İşlevler, işleçler ile birlikte kullanın ve ifade dil sağlar yayınları yazın.
Not
Kullanıcı tanımlı adlarını ve Sistem değişkenleri durum duyarlıdır.
Daha fazla bilgi için bkz: Integration Services İfadesi Başvurusu.
Bir önemli özellik ifadeler paket dağıtılan her örnek için yapılandırmalarını özelleştirmek için kullanılır.Bu paket özellikleri farklı ortamlar için dinamik olarak güncelleştirmek olanak sağlar.Örneğin, bir Bağlantı Yöneticisi bağlantı dizesi olarak bir değişkene atar bir özellik deyimi oluşturabilir ve sonra değişken bağlantı dizesini çalışma zamanında doğru olduğundan emin olma güncelleştirme paket dağıtılırken, saat.Paket yapılandırmalarını özellik ifadeler değerlendirilir önce yüklenir.
Bir özellik, yalnızca tek bir özellik kullanabilirsiniz ifade ve bir özellik ifade yalnızca bir özellik için uygulayabilirsiniz.Ancak, birden çok özdeş özellik ifadeler oluşturmak ve bunları için farklı özellikler atayabilirsiniz.
Bazı özellikleri, küme numaralandırıcıları değerleri kullanarak.Numaralandırıcı üye başvuru yaptığınızda bir özellik ifade, numaralayıcı üyenin kolay adı eşdeğeri olan sayısal bir değer yeniden kullanmanız gerekir.Özellik ifade ayarlar, örneğin, LoggingMode arasında bir değer kullanır özelliği, DTSLoggingMode numaralandırma, kolay adları yerine 0, 1 veya 2 özellik ifadesi kullanmanız gerekir Enabled, Disabled, veya UseParentSetting.Daha fazla bilgi için bkz: Özelliği ifadelerde numaralandırılmış sabitleri kullanma.
Özellik ifade kullanıcı arabirimi
Integration Services oluşturma ve yönetme özellik ifadeler araçları küme sağlar.
The Expressions page, found in the custom editors for tasks, the For Loop container, and the Foreach containers.The Expressions page lets you edit expressions and view a list of the property expressions that a task, Foreach Loop, or For Loop uses.
The Properties window, for editing expressions and viewing a list of the property expressions that a package or package objects use.
The Property Expressions Editor dialog box, for creating, updating, and deleting property expressions.
The Expression Builder dialog box, for building an expression using graphical tools.The Expression Builder dialog box can evaluate expressions for your review without assigning the evaluation result to the property.
Aşağıdaki diyagram ekleme, değiştirme ve kaldırma özellik ifadeler kullandığınız kullanıcı arabirimleri gösterir.
.gif "Özellik ifadeleri için kullanıcı arabirimi")
De Özellikler pencere ve ifadeler sayfa, browse düğmesini tıklayın (...) en ifadeler açmak için koleksiyon düzeyini Özellik ifadeleri Düzenleyici iletişim kutusu.Özellik ifades Düzenleyicisi sağlar özelliği ile eşleştirmek, bir ifade ve bir özellik yazmak için ifade.Grafik expression araçları oluşturmak ve sonra ifade doğrulamak için kullanmak isterseniz, gözat düğmesi (...) adresindeki ifade düzey açmak için Deyim Oluşturucusu'nu iletişim kutusunda, daha sonra oluşturmak veya değiştirmek ve isteğe bağlı olarak ifade doğrulamak.
Ayrıca açabilirsiniz Deyim Oluşturucusu'nu iletişim kutusundan Özellik ifadeleri Düzenleyici iletişim kutusu.
Özellik ifadeleri ile çalışmak için
Ayarı özelliği ifadeler veri akışı bileşenleri
Oluşturursanız, bir paket , Business Intelligence Development Studio, ait oldukları bir veri akışı görev özelliklerini özellik ifadeleri destekleyen veri akışı bileşenleri sunulmuştur.Ekleme, değiştirme ve veri akışı bileşenleri, özellik ifadeler kaldırmak için veri akışı görev veri akışının veri akışı bileşenleri ait ve tıklatın sağ Özellikler.Properties penceresinde özelliklerini özellik ifadeleri kullanabileceğiniz veri akışı bileşenleri listeler.Örneğin, oluşturmak veya değiştirmek için özellik ifade SamplingValue özelliği veri akışı, SampleCustomer adlı bir satır örnekleme dönüştürme sağ tıklatın, satır örnekleme dönüştürme aittir ve tıklatın veri akışının veri akışı görev özellikleri.The SamplingValue property is listed in the Properties window, and has the format [SampleCustomer].[SamplingValue].
Properties penceresinde, eklemek, değiştirmek ve diğer özellik ifadeler aynı şekilde özellik ifadeler için veri akışı bileşenleri kaldırma Integration Services nesne türleri.Properties penceresinde de çeşitli iletişim kutuları erişim sağlar ve eklemek için kullandığınız üreticileri değiştirmek veya kaldırmak için veri akışı bileşenleri için özellik ifadeler.özellik ifadeler tarafından güncelleştirilen veri akışı bileşenleri özellikleri hakkında daha fazla bilgi için bkz: Kaynak özel özellikleri, Dönüşümü özel özellikleri, ve Hedef özel özellikleri.
Özellik ifadeleri yükleniyor
Belirtin veya özellik ifadeleri ne zaman yükleneceğini denetlemek.Özellik ifadeleri değerlendirilir ve paketi ve paket nesneleri doğrulandığı yüklenir.Doğrulama oluşuyor paket kaydettiğinizde, pakette açın SSIS , tasarımcı ve Çalıştır paketi.
Bu nedenle güncelleştirilmiş değerleri içinde özellik ifadeleri kullanan paket nesnelerin özelliklerini görmezsiniz SSIS Tasarımcısı kadar paket Kaydet paketini çalıştırın veya yeniden paketinden sonra ekleme özelliği ifadeler.
Farklı nesne türlerini ile ilişkili özellik ifadeler — bağlantı yöneticileri, günlüğü sağlayıcılarını ve numaralandırıcıları — o nesne türü için belirli yöntemlerin çağrılması da yüklenir.Örneğin, Bağlantı Yöneticisi özelliklerinin önce yüklenen Integration Services oluşturur bir örnek bağlantı.
Paket yapılandırmalarını yüklemiş sonra özelliği ifadeler yüklenir.Örneğin, değişkenleri ilk yapılandırmalarına tarafından güncelleştirilir ve değişkenleri kullanan özellik ifadeler sonra değerlendirilir ve yüklü.Bu özellik ifadeleri olan değişkenlerin değerlerini her zaman kullanmak anlamına gelir küme yapılandırmaları tarafından.
Not
Kullanamazsınız Set seçeneği dtexec özellik ifade doldurmak için yardımcı program.
Aşağıdaki tablo ne zaman özetler özellik ifadeler, Integration Services değerlendirilir ve yüklenen.
Nesne türü |
Yükleyin ve değerlendirin |
|---|---|
Paket, Foreach döngü, For döngüsü, sıra, görevleri ve veri akışı bileşenleri |
Sonra yapılandırmaları yükleniyor Önce doğrulama Önce yürütme |
Bağlantı yöneticileri |
Sonra yapılandırmaları yükleniyor Önce doğrulama Önce yürütme Bağlantı oluşturmadan önceörnek |
Günlüğü sağlayıcıları |
Sonra yapılandırmaları yükleniyor Önce doğrulama Önce yürütme Önce açma günlükleri |
Foreach numaralandırıcıları |
Sonra yapılandırmaları yükleniyor Önce doğrulama Önce yürütme Döngünün her numaralandırma önce |
Foreach döngüye özelliği ifadeleri kullanma
Bir özellik deyimi uygulamak sıklıkla yararlı küme değeri ConnectionString içindeki kullanılan bağlantı yöneticileri özelliğiForeach döngü kapsayıcı. Her döngü, özelliği bulunan bir değişken numaralayıcı geçerli değerini eşleştirir sonra ifade bu değişkenin değerini güncelleştirmek için kullanabilirsiniz ConnectionString özellik dinamik olarak.
Özellik ifadeleri ile kullanmak istiyorsanız, ConnectionString özelliği dosya, birden fazla dosyaları, düz dosyalar ve birden çok düz dosyalar bağlantı yöneticileri bir Foreach döngüsü kullanır, göz önünde bulundurmanız bazı noktalar vardır.paket ayarlayarak birden çok yürütülebilir dosyaları aynı anda çalışacak şekilde yapılandırılabilir MaxConcurrentExecutables özellik 1'den büyük bir değer veya değer -1.-1 Değeri en yüksek işlemci artı iki eşit için yürütülebilir dosyaları aynı anda çalışan sayısını verir.Yürütülebilir dosyalar, değer, paralel yürütülmesini olumsuz sonuçları önlemek için MaxConcurrentExecutables olması gereken küme 1.If MaxConcurrentExecutables is not set to 1, then the value of the ConnectionString property cannot be guaranteed and results are unpredictable.
Örneğin, bir klasördeki dosyaları sıralar dosya adlarını alır ve daha sonra her bir dosya adını eklemek için sql Yürüt görev kullanır bir Foreach döngüsü düşünün bir tablo.If MaxConcurrentExecutables is not set to 1, then write conflicts could occur if two instances of the Execute SQL task attempted to write to the table at the same time.
Örnek özelliği ifadeler
Aşağıdaki örnek ifadeleri nasıl Sistem değişkenleri, işleçleri, işlevleri ve dize hazır bilgileri özellik ifadelerde kullanılacağını gösterir.
Bir paketin LoggingMode özelliği için Expression özelliği
Aşağıdaki özellik deyimi kullanılabilir küme LoggingMode özellik paket.ifade Bir tarihin gün datepart gösteren bir tamsayı almak için gün ve getdate işlevlerini kullanır.Gün ise, 1. veya 15, günlüğe kaydedilmesi işlevi etkindir; Aksi takdirde, günlüğü devre dışı bırakıldı.1 Değeri tamsayı eşdeğerdir LoggingMode numaralayıcı üye Enabled, ve 2 tamsayı değeridir, üyenin eşdeğer Disabled.Numaralayıcı üye adı yerine sayısal değeri kullanmak ifade.
DAY((DT_DBTIMESTAMP)GETDATE())==1||DAY((DT_DBTIMESTAMP)GETDATE())==15?1:2
Özellik ifade için bir e-posta iletisinin konusunu
Aşağıdaki özellik deyimi kullanılabilir küme Subject özelliğini posta Gönder görev ve sağlayan bir kullanışlı e-posta konu.ifade bir dize hazır bilgi, Sistem değişkenleri kullanan birleştirme (+) ve atama işleçleri ve DATEDIFF ve getdate işlevleri.Sistem değişkenleri PackageName ve StartTime değişkenleri.
"PExpression-->Package: (" + @[System::PackageName] + ") Started:"+ (DT_WSTR, 30) @[System::StartTime] + " Duration:" + (DT_WSTR,10) (DATEDIFF( "ss", @[System::StartTime] , GETDATE() )) + " seconds"
Paket adı EmailRowCountPP ise, 4/3/2005 tarihinde çalıştırın, ve çalışma süresi 9 saniye şeklindeydi ifade aşağıdaki dize olarak değerlendirir.
PExpression-->paket: (EmailRowCountPP) Başladı: 4/3/2005 11:06:18 am süre: 9 saniye.
E-posta iletisine ileti özelliği ifade
Aşağıdaki özellik deyimi kullanılabilir küme MessageSource özelliği, bir posta Gönder görev.ifade bir dize hazır bilgi, kullanıcı tanımlı değişkenleri, kullanan ve birleştirme (+) işleç.Kullanıcı tanımlı değişkenleri adlı nasdaqrawrows, nyserawrows, ve amexrawrows.dize "\N" başı gösterir.
"Rows Processed: " + "\n" +" NASDAQ: " + (dt_wstr,9)@[nasdaqrawrows] + "\n" + " NYSE: " + (dt_wstr,9)@[nyserawrows] + "\n" + " Amex: " + (dt_wstr,9)@[amexrawrows]
If nasdaqrawrows is 7058, nyserawrows is 3528, and amexrawrows is 1102, the expression evaluates to the following string.
İşlenen satır:
NASDAQ: 7058
NYSE: 3528
AMEX: 1102
Özellik deyimi yürütülebilir özelliği bir işlemin Görev yürütme
Aşağıdaki özellik deyimi kullanılabilir küme Executable özelliği, bir işlemin yürütme görevi.ifade dize hazır bilgileri, işleçleri ve işlevleri bir birleşimini kullanır.datepart ve getdate işlevleri ve koşullu deyim kullanan işleç.
DATEPART("weekday", GETDATE()) ==2?"notepad.exe":"mspaint.exe"
Haftanın ikinci gün ise, yürütme işlemi Görev notepad.exe, görev çalışır mspaint.exe Aksi çalışır.
ConnectionString özelliği bir düz dosya Bağlantı Yöneticisi'nin özellik deyimi
Aşağıdaki özellik deyimi kullanılabilir küme ConnectionString özelliği, bir düz dosya Bağlantı Yöneticisi.Tek bir kullanıcı tanımlı değişken, ifade kullanan myfilenamefull, içeren yol için bir metin dosyası.
@[User::myfilenamefull]
Not
Özellik ifadeleri bağlantı yöneticileri için Properties penceresini kullanarak erişilebilir.Bağlantı Yöneticisi için özelliklerini görüntülemek için Bağlantı Yöneticisi'nde seçin Bağlantı yöneticileri alanı SSIS Tasarımcı, Özellikler penceresini açık, ya da Bağlantı Yöneticisi'ni sağ tıklatın ve seçin Özellikler.
Özellik ifade için bir metin dosyası günlük sağlayıcı YapılandırmaDizesi özelliği
Aşağıdaki özellik deyimi kullanılabilir küme ConfigString özelliği, bir metin dosyası günlük sağlayıcı.Tek bir kullanıcı tanımlı değişken, ifade kullanan varConfigString, adını kullanmak için dosya Bağlantı Yöneticisi'ni içerirDosya Bağlantı Yöneticisi'ni belirtir yol metin dosyası için günlük girdileri yazılır.
@[User::varConfigString]
Not
Özellik ifadeleri günlük sağlayıcıları için Properties penceresini kullanarak erişilebilir.Günlük sağlayıcısının özelliklerini görüntülemek için günlük sağlayıcı seçmelisiniz Paketi Explorer sekmesinde SSIS Tasarımcı, Özellikler penceresini açık, veya günlük sağlayıcı paketi Explorer'ı sağ tıklatın ve tıklatın Özellikler.
Dış Kaynaklar
İfade ve yapılandırma vurgulayıcı için Business Intelligence Development Studio (CodePlex projesi)
|
.gif "Integration Services simgesi (küçük)")
Integration Services ile güncel kalın