Paketlerinde özelliği ifadeleri kullanma

Özellik ifade için bir özellik çalışma zamanında dinamik güncelleştirme özelliği etkinleştirmek için atanan bir ifadesidir. Örneğin, özellik ifade bir değişken depolanan bir e-posta adresi ekleyerek posta gönder görev kullanır Kime satırında güncelleştirebilirsiniz.

İfade, bir paket, görev için döngü, sıra, Foreach Numaralandırıcı, olay işleyicisi, bir paket ya da proje düzeyinde Bağlantı Yöneticisi, Foreach döngü eklenebilir veya sağlayıcı oturum. Okuma/yazma herhangi bir özellik, bu nesnelerin özellik ifade uygulayabilirsiniz. Integration ServicesAyrıca bazı özel veri akışı bileşenlerini özelliklerinde özelliği ifadeler kullanılmasını destekler. Değişkenler ve öncelik kısıtlamaları özelliği ifadeler desteklemez, ancak onlar ifadelerde kullanabileceğiniz özel özellikler içerir.

Özellik ifadeleri farklı şekillerde güncelleştirilebilir:

• Kullanıcı tanımlı değişkenleri paketi yapılandırmaları içinde bulunan ve paket dağıtıldıktan sonra güncellenmiş. Çalışma zamanında, güncelleştirilmiş değişken değerini kullanarak özellik deyimi değerlendirilir.

• Sistem değişkenleri ifadeler içerdiği özellik değerlendirmenin sonuçları değişen çalışma zamanında güncelleştirilir.

• Tarih ve saat işlevleri zamanında değerlendirilir ve özellik ifadeler için güncelleştirilmiş değerleri sağlar.

• Ifadeleri değişkenleri Script görev ve Script bileşeni çalışacak komut dosyaları tarafından güncelleştirilebilir.

İfadeler kullanılarak yüklenen Microsoft  Integration Servicesifade dili. İfadeler, sistem veya kullanıcı tanımlı değişkenleri, işleçleri, işlevleri, birlikte kullanın ve ifade dil sağlayan atmalarını yazın.

[!NOT]

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

Daha fazla bilgi için, bkz. Integration Services Expression Reference.

Bir önemli özelliği ifadeler yapılandırmaları paketi dağıtılmış her kopyası için özelleştirmek için kullanılır. Bu dinamik güncelleştirme paketi özellikleri farklı ortamlar için olanak sağlar. Örneğin, Bağlantı Yöneticisi bağlantı dizesine bir değişkene atar bir özellik ifade oluşturun ve ardından değişken bağlantı dizesini çalışma zamanında doğru olduğunu garanti güncelleştirme paketi dağıtılırken. Paket yapılandırmalarını özelliği ifadeler değerlendirilen önce yüklenir.

Bir özellik tek bir özellik deyimi kullanabilirsiniz ve expression özelliği yalnızca bir özelliğini uygulayabilirsiniz. Ancak, birden çok özdeş özelliği ifadeler oluşturmak ve bunları farklı özellikleri atayın.

Bazı özellikler numaralandırıcıları değerleri kullanarak ayarlanır. Özellik ifade numaralayıcı üye başvuru yaptığınızda, eşdeğer bir numaralayıcı üye kolay adı için sayısal bir değer kullanmalısınız. Örneğin, özellik ifade ayarlar LoggingModeözelliği, bir değeri kullanır DTSLoggingModenumaralandırma, kolay adlar yerine 0, 1 veya 2 özellik ifade kullanmak gerekir Enabled, Disabled, veya UseParentSetting. Daha fazla bilgi için, bkz. Özellik ifadeleri numaralandırılmış sabitler.

Özellik ifade kullanıcı arabirimi

Integration ServicesBina ve özellik ifadeler yönetmek için araçlar sağlar.

• İfadeleri sayfasında, görevler, döngü için kapsayıcı ve Foreach kaplar için özel düzenleyicileri bulundu. İfadeleri sayfası ifadeleri düzenleyin ve görev, Foreach döngüsü veya döngü için kullandığı özelliği ifadeler listesini görüntülemenize olanak sağlar.

• Özellikler penceresindeki ifadeleri düzenleme ve bir paket veya paket kullanımı nesneleri özelliği ifadeler listesini görüntüleme.

• Özellik ifadeleri Düzenleyici iletişim kutusunda, oluşturma, güncelleştirme ve silme özelliği ifadeler.

• İfade Oluşturucusu'nu iletişim kutusu, grafik araçları kullanarak bir ifade oluşturmak için. İfade Oluşturucusu'nu iletişim kutusunda ifadeleri gözden geçirmeniz için değerlendirme sonucunu özelliğine atamadan değerlendirmek.

Aşağıdaki Diyagram eklemek için kullandığınız kullanıcı arabirimleri değiştirme ve kaldırma özelliği ifadeler gösterir.

İçinde Özellikler pencere ve ifadeleri sayfasında, Gözat düğmesini tıklatın (...) , ifadeleri açmak için koleksiyon düzeyinde Özellik ifadeleri Düzenleyici iletişim kutusu. Özellik ifadeleri Düzenleyici, özellik ifadeyi göster ve özellik ifade yazın sağlar. Grafik ifade araçları oluşturmak ve ifade doğrulamak için kullanmak istiyorsanız, Gözat düğmesini tıklatın (...) açmak için ifade düzeyinde İfade Oluşturucusu'nu iletişim kutusunu ve ardından oluşturun veya değiştirin ve isteğe bağlı olarak ifade doğrulayın.

Ayrıca açabilirsiniz İfade Oluşturucusu'nu iletişim kutusundan Özellik ifadeleri Düzenleyici iletişim kutusu.

Özellik ifadeleri ile çalışmak

• Ekleme veya özellik ifade değiştirme

Ayar özelliği ifadeler veri akışı bileşenleri

Eğer bir paket oluşturmak SQL Server Veri Akışı Araçları (SSDT), ait oldukları veri akışı görev özelliği ifadeleri destekleyen veri akışı bileşenleri özellikleri sunulur. Ekleme, değiştirme ve veri akışı bileşenleri özelliği ifadeler kaldırmak için veri akışı görev için veri akışının veri akışı bileşenlerini ait ve tıklatın sağ Özellikler. Özellikleri penceresinde veri akışı bileşenleri ile hangi sen-ebilmek kullanma özelliği ifadeleri özelliklerini listeler. Örneğin bir özellik ifade değiştirmek veya oluşturmak için SamplingValueSampleCustomer, adlı bir veri akışı Satır örnekleme dönüşümü özelliği sağ Satır örnekleme dönüşümü aittir ve tıklatın veri akışının veri akışı görev özellikleri. SamplingValue Özellik Özellikler penceresinde listelenir ve biçimi [SampleCustomer]. [SamplingValue].

Properties penceresinde, size eklemek, değiştirmek ve özelliği ifadeler diğer aynı şekilde özelliği ifadeler için veri akışı bileşenlerini kaldırmak Integration Servicesnesne türleri. Özellikler penceresi ayrıca çeşitli iletişim kutuları erişim sağlar ve eklemek için kullandığınız üreticileri değiştirme veya özelliği ifadeler için veri akışı bileşenlerini kaldırma. Özelliği ifadeler tarafından güncelleştirilen veri akışı bileşenleri özellikleri hakkında daha fazla bilgi için bkz: Source Custom Properties, Dönüşümü özel özellikleri, ve Destination Custom Properties.

Özellik ifadeleri yükleniyor

Belirleyemez veya özelliği ifadeler ne zaman yükleneceğini denetlemek. Özelliği ifadeler değerlendirilen ve paketi ve paket nesneleri doğrulandığı yüklenir. Doğrulama oluşuyor Paket kaydettiğinizde, paketi açmak SSISTasarımcısı ve Çalıştır paket.

Bu nedenle güncelleştirilmiş değerleri özelliği ifadeleri kullanan paketi nesnelerin özelliklerini görmezsiniz SSISpaketi kaydedin, paketi çalıştırın veya paket özelliği ifadeler ekledikten sonra yeniden kadar tasarımcı.

Nesneleri farklı türleri ile ilişkili özelliği ifadeler — bağlantı yöneticileri, günlük sağlayıcıları ve numaralandırıcıları — o nesne türüne özgü yöntemleri çağrıldığında da yüklenir. Örneğin, Bağlantı Yöneticisi özelliklerini önce yüklenen Integration Servicesbir bağlantı örneğini oluşturur.

Paket yapılandırmalarını yüklemiş sonra özelliği ifadeler yüklenir. Örneğin, değişkenleri ilk yapılandırmalarını tarafından güncelleştirilir ve değişkenleri kullanan özelliği ifadeler sonra değerlendirilir ve yüklü. Bu özelliği ifadeler her zaman yapılandırmaları tarafından ayarlanan değişkenlerin değerlerini kullanmak anlamına gelir.

[!NOT]

Sen cant'kullanma Setseçeneği dtexecözellik ifade doldurmak için yarar.

Ne zaman aşağıdaki tabloda özetlenmektedir özelliği ifadeler Integration Servicesdeğerlendirilmesi ve yüklenen.

Foreach döngü özelliği ifadeleri kullanma

Sık sık değerini ayarlamak için özellik ifade uygulamak yararlıdır ConnectionStringözelliği Foreach döngü kapsayıcı içinde kullanılan bağlantı yöneticileri. Her döngüye yineleme üzerinde bir değişken numaralayıcı geçerli değerini haritalar sonra expression özelliği bu değişkenin değeri değeri güncelleştirmek için kullanabilirsiniz ConnectionStringözelliği dinamik.

Özellik ifadeleri ile kullanmak isterseniz ConnectionStringözelliği bir Foreach döngü dosya, birden fazla dosya, düz dosyalar ve Çoklu düz dosyalar Bağlantı Yöneticisi kullanır, orada bazı şeyler düşünmelisiniz. Bir paket ayarlayarak birden fazla uygulama aynı anda çalıştırmak için yapılandırılabilir MaxConcurrentExecutablesözelliği 1'den büyük bir değer veya değer -1. -1 Değeri, eşzamanlı olarak çalıan yürütülebilirlerin işlemciler artı iki sayısına eşit için maksimum sayısını verir. Yürütülebilir dosyalar, değeri paralel yürütme olumsuz sonuçları önlemek için MaxConcurrentExecutables1'e ayarlanmalıdır. Eğer MaxConcurrentExecutables1, sonra değeri ayarlı değil ConnectionStringözelliği garantili ve sonuçları öngörülemeyen.

Örneğin, bir klasördeki dosyaları sıralar, dosya adlarını alır ve daha sonra her dosya adının bir tabloya eklemek için sql Yürüt görev kullanır bir Foreach döngüsü düşünün. Eğer MaxConcurrentExecutablessonra iki örneğini sql Yürüt görev aynı zamanda tabloya yazma girişiminde yazma çakışması oluşabilir 1 değeri değil.

Örnek özelliği ifadeler

Aşağıdaki örnek ifadeler, Sistem değişkenleri, işleçleri, işlevleri ve dize hazır bilgi özelliği ifadeleri kullanmayı gösterir.

Bir paketin LoggingMode özelliği için Expression özelliği

Aşağıdaki özellik deyimi ayarlamak için kullanılan LoggingModeözellik paketi. İfade, bir tarihin gün datepart gösteren bir tamsayı olsun gün ve getdate işlevini kullanır. Gün ise, 1 ya da 15, günlüğe kaydedilmesi işlevi etkindir; Aksi takdirde, günlüğü devre dışı bırakıldı. 1 Değeri tamsayı eşdeğerdir LoggingModenumaralayıcı üye Enabled, ve tamsayı değeri 2 olan eşdeğer üye Disabled. İfadedeki numaralayıcı üye adı yerine sayısal bir değer kullanmalısınız.

DAY((DT_DBTIMESTAMP)GETDATE())==1||DAY((DT_DBTIMESTAMP)GETDATE())==15?1:2

E-posta iletisinin konu için Expression özelliği

Aşağıdaki özellik deyimi ayarlamak için kullanılan Subjectgöndermek posta özellik görev ve kullanışlı e-posta konu sağlar. İfadeyi dize hazır bilgi, Sistem değişkenleri, birleştirme (+) ve dökme operatörleri ve DATEDIFF ve getdate işlevini bir birleşimini kullanır. Sistem değişkenleri PackageNameve StartTimedeğ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, 3/4/2005, çalıştırın ve süresi 9 saniye olarak, aşağıdaki dize deyimi değerlendirir.

PExpression-->paket: (EmailRowCountPP) başlatıldı: 3/4/2005 11: 06: 18 am süresi: 9 saniye.

E-posta iletisinin ileti için Expression özelliği

Aşağıdaki özellik deyimi ayarlamak için kullanılan MessageSourceözellik posta gönder görev. İfadeyi dize hazır bilgi, kullanıcı tanımlı değişkenleri ve birleştirme (+) işleci bir birleşimini kullanır. Kullanıcı tanımlı değişkenleri adlandırılmış nasdaqrawrows, nyserawrows, ve amexrawrows. "\N" dizesi bir satır başı gösterir.

"Rows Processed: " + "\n" +" NASDAQ: " + (dt_wstr,9)@[nasdaqrawrows] + "\n" + " NYSE: " + (dt_wstr,9)@[nyserawrows] + "\n" + " Amex: " + (dt_wstr,9)@[amexrawrows]

Eğer nasdaqrawrows7058, ise nyserawrows3528, olduğunu ve amexrawrows1102, ise aşağıdaki dize deyimi değerlendirir.

İşlenen satır:

NASDAQ: 7058

NYSE: 3528

AMEX: 1102

Yürütülebilir özelliği için Expression özelliği bir Process görev Yürüt

Aşağıdaki özellik deyimi ayarlamak için kullanılan Executablebir yürütme işlemi görev özelliği. İfadeyi dize hazır bilgi, işleç ve işlevleri bir birleşimini kullanır. İfade datepart ve getdate işlevini ve koşullu işlecini kullanır.

DATEPART("weekday", GETDATE()) ==2?"notepad.exe":"mspaint.exe"

Bu hafta ikinci gün ise, yürütme işlemi görev notepad.exe, görev çalışır mspaint.exe aksi çalışır.

Bir düz dosya Bağlantı Yöneticisi ConnectionString özelliği için Expression özelliği

Aşağıdaki özellik deyimi ayarlamak için kullanılan ConnectionStringbir düz dosya Bağlantı Yöneticisi'nin özellik. Tek bir kullanıcı tanımlı değişken, ifade kullanan myfilenamefull, hangi içeren bir metin dosyası yolu.

@[User::myfilenamefull]

[!NOT]

Bağlantı yöneticileri için özellik ifadeler yalnızca Özellikler penceresini kullanarak erişilebilir. İçin bir bağlantı Yöneticisi özelliklerini görüntülemek için Bağlantı Yöneticisi seçin Bağlantı yöneticileri alan SSISÖzellikler penceresi açık veya Bağlantı Yöneticisi'ni sağ tıklatın ve seçin Tasarımcısı Özellikler.

Bir metin dosyası günlük sağlayıcı YapılandırmaDizesi özelliği için Expression özelliği

Aşağıdaki özellik deyimi ayarlamak için kullanılan ConfigStringözelliği bir metin dosyası günlük sağlayıcı. Tek bir kullanıcı tanımlı değişken, ifade kullanan varConfigString, dosya Bağlantı Yöneticisi'ni kullanmak için adını içeren. Dosya Bağlantı Yöneticisi günlük girişleri için yazılan metin dosyasının yolunu belirtir.

@[User::varConfigString]

[!NOT]

Özellik ifadeleri günlüğü sağlayıcıları için yalnızca Özellikler penceresini kullanarak erişilebilir. Günlük sağlayıcı özelliklerini görüntülemek için günlük sağlayıcı üzerinde seçmelisiniz Paketi Explorer sekmesini SSISÖzellikler penceresi açık veya günlük sağlayıcı Paketi Explorer sağ tıklattığınızda Tasarımcısı Özellikler.

Dış Kaynaklar

• İfade ve yapılandırma vurgulayıcı (CodePlex Projesi)

• Teknik makale, SSIS ifade örnekleri, social.technet.microsoft.com üzerinde

Ayrıca bkz.

Görevler

Paketlerinde değişkenleri kullanma