Paketlerinde özellik ifadeleri kullanma

Özellik çalışma sırasında dinamik güncelleştirmeyi etkinleştirmek için bir özelliğine atanan ifade BIR özellik ifadesidir saat.Örneğin, bir özellik ifade bir deðiþkene depolanan e-posta adresi ekleyerek posta Gönder görev kullanan Kime satırına güncelleştirebilirsiniz.

Ifade, bir paket, görev, Foreach döngü, için döngü, sıra, Foreach numaralayıcı, olay işleyicisi, Bağlantı Yöneticisi veya günlük sağlayıcısı için 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şkenleri ve Öncelik kısıtlamaları özellik ifadeleri destekler, ancak bunlar deyimler kullanabileceğiniz özel özellikler içerir.

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

  • Kullanıcı tanımlı değişkenleri paket konfigürasyonlara dahil ve olması paket dağıtıldıktan sonra güncelleştirilir.Çalışma sırasında saat, güncelleştirilmiş değişken değeri'ni kullanarak, özellik ifade değerlendirilir.

  • Sistem değişkenleri, deyimlerde içerdiği özellik değerlendirme sonuçlarını değişiklikleri çalışma zamanında güncelleştirilir.

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

  • Ifadelerde değişkenler, komut dosyası görev ve komut dosyası bileşeni çalışan komut dosyaları tarafından güncelleştirilebilir.

The expressions are built using the Microsoft Integration Services expression language.Ifadeler ifade dil sağlayan yayınları yazın ve sistem veya kullanıcı tanımlı değişkenleri, işleçleri, işlevleri, birlikte kullanabilirsiniz.

Not

Sistem değişkenlerini ve kullanıcı tanımlı adları büyük/küçük durum duyarlıdır.

Daha fazla bilgi için bkz:Tümleştirme Hizmetleri ifade başvurusu.

Bir önemli özellik ifadelerin yapılandırmaları için dağıtılan her bir paket örnek özelleştirmek için kullanılır.Bu paket özellikleri farklı ortamlar için dinamik olarak güncelleştirmeye olanak sağlar.Örneğin, bir değişken için bir Bağlantı Yöneticisi bağlantı dizesi atar özellik bir ifade oluşturun ve güncelleştirebilirsiniz paket dağıtıldığında, daha sonra değişken çalışma sırasında bağlantı dizesi doğruluğundan emin olduktan saat.Paket yapılandırmalarını özellik ifadeler değerlendirildiği için önce yüklenir.

Bir özellik, yalnızca bir özellik ifade kullanabilirsiniz ve bir özellik ifade yalnızca bir özellik için geçerli olabilir.Ancak, birden fazla aynı özellik ifadeler oluşturmak ve bunları için farklı özellikler atayabilirsiniz.

Bazı özellikler sıralayıcısını değerler kullanılarak küme.Bir özellik ifadesinde numaralayıcı üye başvuru yaptığınızda, kolay adı numaralayıcı üye olarak eşdeğer olan sayısal bir değer kullanmalısınız.Örneğin bir özellik ifade ayarlar, LoggingMode bir değeri kullanan özelliği DTSLoggingMode numaralandırma, özellik ifade 0, 1 veya 2 yerine kolay adlarını kullanmanız gerekir Enabled, Disabled, veya UseParentSetting. Daha fazla bilgi için bkz:Özellik deyimler içinde numaralandýrýlmýþ sabitleri kullanma.

Özellik ifade kullanıcı arabirim

Integration Services sağlayan bir küme oluşturmak ve özellik ifadeler yönetmek için kullanabileceğiniz araçlar.

  • The Expressions sayfa, found in the custom editors for tasks, the For Loop kapsayıcı, and the Foreach containers.The Expressions sayfa lets you edit expressions and view a list of the özellik expressions that a task, Foreach Loop, or For Loop uses.

  • The Properties window, for editing expressions and viewing a list of the özellik expressions that a paket or paket objects use.

  • The özellik Expressions Editor dialog box, for creating, updating, and deleting özellik expressions.

  • The ifade Builder dialog box, for building an ifade using graphical tools.The ifade Builder dialog box can evaluate expressions for your review without assigning the evaluation result to the özellik.

Aşağıdaki şemada, ekleme, değiştirme ve özellik ifadeler kaldırmak için kullandığınız kullanıcı arabirimleri gösterir.

The user interface for property expressions

Içinde Özellikleri penceresi ve Ifadeler sayfasında, Gözat düğmesi tıklatın.(…) at the Ifadeler açmak için koleksiyon düzeyÖzellik deyimler Düzenleyici iletişim kutusu.Özellik Düzenleyici deyimler bir ifadeye bir özellik eşleme ve bir özellik ifade yazın sağlar.Oluşturup sonra da ifade doğrulamak için grafik ifade Araçları'nı kullanmak isterseniz, gözat düğmesi... (…) açmak için ifadeyi düzeyindeDeyim Oluşturucusu iletişim kutusunda, daha sonra oluşturmak veya değiştirmek ve isteğe bağlı olarak deyim doğrulamak.

Ayrıca açabilirsiniz ifade Oluşturucusu iletişim kutusuÖzellik deyimler Düzenleyici iletişim kutusu.

Özellik deyimlerle çalışmak için

Bileşenleri ayarı özellik deyimler veri akışı

Yapılandırma, bir paket içinde Business Intelligence Development Studio, özellik ifadeler destekleyen bir veri akışı bileşenleri özelliklerini, ait oldukları veri akışı görevdeki sunulur. Ekleme, değiştirme ve veri akışı bileşenlerinin özellik ifadeler kaldırmak için veri akışı görevi için veri akışının veri akışı bileşenleri ait olan ve'ı tıklatın, sağ Özellikleri.Özellikler penceresi özellik deyimler kullanabileceğiniz veri akışı bileşenleri özelliklerini listeler.Örneğin, oluşturmak veya bir özellik ifade değiştirmek için SamplingValue veri akışı görevi satır örnekleme dönüştürme ait olduğundan tıklatın veri akışı için bir satır örnekleme dönüşümünün SampleCustomer, adlı bir veri akışında özelliği sağ tıklatın Özellikleri.The SamplingValue özellik is listed in the Properties window, and has the format [SampleCustomer].[SamplingValue].

Properties penceresinde, ekleyin, değiştirin ve diğer özellik ifadeler aynı şekilde veri akışı bileşenleri için özellik ifadeler kaldırma Integration Services nesne türleri. Özellikler penceresini ayrıca, çeşitli iletişim kutularında erişim sağlar ve eklemek için , kullandığınız oluşturucuların 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üştürme için özel özellikler, ve Hedef özel özellikleri.

Özellik deyimler yükleniyor

Belirtin ya da özellik ifadeler ne zaman yükleneceğini denetlemek değiştiremezsiniz.Özellik ifade değerlendirilecek ve paketi ve paket nesneleri doğrulandığı yüklenir.Paket kaydettiğinizde doğrulama oluşur, paket içinde açın. SSIS Tasarımcı ve Çalıştır paketi.

Bu nedenle güncelleştirilmiş değerlerini özellik ifadelerinde kullanan paket nesnelerin özelliklerini göremez SSIS Tasarımcı paket kaydedin, paket çalıştırmak veya özellik ifadeler ekledikten sonra paket yeniden kadar.

Farklı nesne türlerini ile ilişkili özellik ifadeler — Bağlantı Yöneticisi günlüğü sağlayıcılarını ve sıralayıcısını — o nesne türü için belirli bir yöntem çağrıldığında da yüklenir.Örneğin, önce Bağlantı Yöneticisi özelliklerinin yüklenir Integration Services oluşturur bir örnek bağlantı.

Paket yapılandırmalarını yüklemiş sonra özellik ifadeler yüklenir.Örneğin, değişkenleri önce kendi yapılandırma tarafından güncelleştirilir ve sonra değişkenleri kullanan özellik ifade değerlendirilecek yüklenen ve.Bu özellik ifade her zaman değişkenler değerleri kullan anlamına gelir küme yapılandırmaları tarafından.

Not

Kullanamazsınız Set seçeneği dtexecbir özellik ifade doldurmak için yardımcı programı.

Aşağıdaki tablo, özetler, özellik ifadeler Integration Services değerlendirilen ve yükledi.

Nesne türü

Yükleyin ve değerlendirin

Paket, Foreach döngü için döngü, sıra, görevleri ve veri akışı bileşenleri

Yapılandırmaları yüklemeden sonra

Önce doğrulama

Önce yürütme

Bağlantı Yöneticisi

Yapılandırmaları yüklemeden sonra

Önce doğrulama

Önce yürütme

Bir bağlantı örneğini oluşturmadan önce

Günlüğü sağlayıcıları

Yapılandırmaları yüklemeden sonra

Önce doğrulama

Önce yürütme

Önce açma günlükleri

Foreach sıralayıcısını

Yapılandırmaları yüklemeden sonra

Önce doğrulama

Önce yürütme

Döngünün her numaralandırılmasına önce

Foreach döngü içinde özellik ifadeleri kullanma

Bir özellik ifadeye uygulamak genellikle yararlıdır küme değerinin ConnectionString Foreach döngü kapsayıcı içinde kullanılan bir bağlantı yöneticileri özelliği. Numaralayıcı geçerli değerini, her döngü tekrarında değişken eşleştiren sonra özellik ifade bu değişkenin değeri değerini güncelleştirmek için kullanabilirsiniz ConnectionString özelliği dinamik olarak.

Özellik deyimlerle kullanmak istiyorsanız ConnectionString Dosya, birden çok dosya, düz dosyalar ve birden çok düz dosya bağlantısı yöneticileri bir Foreach durdurulana dön özelliğini kullanır, göz önüne alınması gereken bazı şeyler vardır. Paket ayarlayarak birden çok yürütülebilir dosyaları aynı anda çalışacak şekilde yapılandırılabilir MaxConcurrentExecutables özellik değeri 1'den büyük veya -1 değeri. -1 Değeri, aynı anda iki ek bir işlemci sayısı eşit için yürütülebilir dosyaları çalıştırmanın en yüksek sayıyı verir.Negatif sonuçlar gelen yürütülebilir dosyalar, değeri paralel olarak yürütülmesini engellemek için MaxConcurrentExecutables olması gereken küme 1. If MaxConcurrentExecutables değil küme 1 ve değeri için ConnectionString özellik garanti edilemez ve sonuçlar tahmin edilemez.

Örneğin, bir klasördeki dosyaları sıralar, dosya adlarını alır ve her dosya adının içine eklemek için bir SQL Yürüt) görevi kullanır bir Foreach döngü göz önünde bulundurun bir tablo.If MaxConcurrentExecutables SQL Yürüt görev'in iki örneği aynı anda tabloya yazma girişiminde bulundu, yazma çakışması oluşabilir sonra 1 olarak küme.

Örnek için özellik deyimler

Aşağıdaki örnek ifadeler Sistem değişkenleri, işleçleri, işlevleri ve dize hazır bilgi özellik ifadelerinde nasıl gösterir.

Bir paketin LoggingMode özellik için özellik ifade

Aşağıdaki özellik ifade için kullanılan LoggingMode Paket özelliği. Ifade, bir tarihin gün datepart gösteren bir tamsayı elde etmek için GÜN ve GETDATE işlevlerini kullanır.Gün ise, 1 veya 15, günlüğe kaydedilmesi işlevi etkindir; aksi halde, günlüğe kaydetme devre dışı bırakılır.1 Değeri tamsayı eşdeğeridir LoggingMode Numaralayıcı üye Enabled, ve 2 değerini tamsayıdır üyenin eşdeğeri Disabled. Numaralayıcı üye adı yerine sayısal bir değer 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 ifade için kullanılan olabilir küme Subject Posta Gönder özelliği görev ve kullanışlı bir e-posta konu sağlar. Ifade bir dize hazır bilgi, Sistem değişkenleri, birleştirme (+) ve atama işleçler ve DATEDIFF ve GETDATE işlevleri birleşimini kullanır.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, 3/4/2005'te çalışacak olan ve çalışma süresi 9 saniye olan, ifade şu şekilde değerlendirir dize.

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

Özellik ifade iletinin bir e-posta iletisi

Aşağıdaki özellik ifade için kullanılan olabilir küme MessageSource Posta Gönder, görevin özellik. Ifade bir dize hazır bilgi, kullanıcı tanımlı değişkenleri ve birleştirme (+) işleç birleşimini kullanır.Kullanıcı tanımlı değişkenler olarak adlandırılan nasdaqrawrows, nyserawrows, ve amexrawrows. dize "\N" bir satır gösterir.

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

If nasdaqrawrows 7058, olur. nyserawrows 3528, olduğunu ve amexrawrows 1102, olduğu için aşağıdaki dize ifade değerlendirir.

Işlenen satır:

nasdaq: 7058

nyse: 3528

amex: 1102

Özellik ifade yürütülebilir özelliği için bir işlem görev yürütmek

Aşağıdaki özellik ifade için kullanılan olabilir küme Executable bir işlem yürütmek görevin özellik. Ifade bir dize hazır bilgi, işleç ve işlevleri birleşimini kullanır.Ifade DATEPART ve GETDATE işlevleri ve koşullu işlecini kullanır.

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

Ikinci haftanın günü ise, yürütmek işlem görev notepad.exe, görev çalışır mspaint.exe aksi durumda çalışır.

ConnectionString özelliği düz dosya Bağlantı Yöneticisi'nin özellik ifade

Aşağıdaki özellik ifade için kullanılan olabilir küme ConnectionString Düz dosya bir Bağlantı Yöneticisi özelliği. Ifade bir tek kullanıcı tanımlı değişken, kullanır. myfilenamefull, menzilli yol bir metin dosyasına.

@[User::myfilenamefull]

Not

Özellik ifadeler için Bağlantı Yöneticisi, yalnızca Özellikler penceresini kullanarak erişilebilir.Bir Bağlantı Yöneticisi özelliklerini görüntülemek için , bağlantı yöneticisinde seçin Bağlantı Yöneticisi area of SSIS Özellikler penceresi olduğunda tasarımcısını açın, veya Bağlantı Yöneticisi sağ tıklatıp Özellikleri.

Özellik ifade YapılandırmaDizesi özelliği bir metin dosyası oturum sağlayıcı

Aşağıdaki özellik ifade için kullanılan olabilir küme ConfigString bir metin dosyası günlük sağlayıcısı özelliği. Ifade bir tek kullanıcı tanımlı değişken, kullanır. varConfigString, hangi kullanmak için dosya bağlantı yöneticisinin adını içerir. Dosya Bağlantı Yöneticisi günlük girdilerinin yazılan metin dosyasının yolunu belirtir.

@[User::varConfigString]

Not

Günlüğü sağlayıcıları için özellik deyimler yalnızca Özellikler penceresi kullanılarak erişilebilir.günlük sağlayıcısı özelliklerini görüntülemek için günlük sağlayıcısı üzerinde seçmelisiniz Paket Explorer tab of SSIS Özellikler penceresi açıkken tasarımcısına veya sağ tıklatın ve paket Explorer günlük sağlayıcısında Özellikleri.

Dış Kaynaklar

Integration Services icon (small) Tümleştirme Hizmetleri ile güncel kalın

Karşıdan yüklemeler, makaleleri, örnekler ve en son Microsoft video yanı sıra, seçili topluluğun çözümleri için ziyaret Integration Services sayfa MSDN veya TechNet:

Bu güncelleştirmelerin otomatik bildirim için kullanılabilir RSS akışlarına abone olmak sayfa.