Betik Bileşeni

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

Betik bileşeni betiği barındırıyor ve bir paketin özel betik kodunu dahil edip çalıştırmasını sağlar. Betik bileşenini paketlerde aşağıdaki amaçlarla kullanabilirsiniz:

• Veri akışında birden çok dönüştürme kullanmak yerine verilere birden çok dönüştürme uygulayın. Örneğin, bir betik iki sütundaki değerleri ekleyebilir ve ardından toplamın ortalamasını hesaplayabilir.

• Mevcut bir .NET derlemesindeki iş kurallarına erişin. Örneğin, bir betik bir Gelir sütununda geçerli olan değer aralığını belirten bir iş kuralı uygulayabilir.

• Integration Services ifade dil bilgisinin sağladığı işlevlere ve işleçlere ek olarak özel formüller ve işlevler kullanın. Örneğin, LUHN formülünü kullanan kredi kartı numaralarını doğrulayın.

• Sütun verilerini doğrulayın ve geçersiz veri içeren kayıtları atlayın. Örneğin, bir komut dosyası, bir posta ücretinin makullüğünü değerlendirebilir ve son derece yüksek veya düşük tutarlara sahip kayıtları atlayarak geçebilir.

Betik bileşeni, veri akışına özel işlevler eklemek için kolay ve hızlı bir yol sağlar. Ancak, betik kodunu birden çok pakette yeniden kullanmayı planlıyorsanız, Betik bileşenini kullanmak yerine özel bir bileşen programlamayı göz önünde bulundurmanız gerekir. Daha fazla bilgi için bkz. Özel Veri Akışı Bileşeni Geliştirme.

Uyarı

Betik bileşeni NULL olan bir sütunun değerini okumaya çalışan bir betik içeriyorsa, betik bileşeni paketi çalıştırdığınızda başarısız olur. Sütun değerini okumaya çalışmadan önce sütunun NULL olup olmadığını belirlemek için IsNull yöntemini betiğinizde kullanmanızı öneririz.

Betik bileşeni kaynak, dönüştürme veya hedef olarak kullanılabilir. Bu bileşen bir girişi ve birden çok çıkışı destekler. Bileşenin nasıl kullanıldığına bağlı olarak, bir girişi veya çıkışı ya da her ikisini destekler. Betik, giriş ve çıkıştaki her satır tarafından başlatılır.

• Kaynak olarak kullanıldığında, Komut Dosyası bileşeni birden fazla çıktıyı destekler.

• Dönüştürme olarak kullanılırsa, Betik bileşeni bir girdi ve birden çok çıktıyı sağlar.

• Hedef olarak kullanıldığında, betik bileşeni bir girdiyi desteklemektedir.

Betik bileşeni hata çıktıları vermeyi desteklemiyor.

Betik bileşeninin paketiniz için uygun seçim olduğuna karar verdikten sonra, girişleri ve çıkışları yapılandırmanız, bileşenin kullandığı betiği geliştirmeniz ve bileşenin kendisini yapılandırmanız gerekir.

Betik Bileşeni Modlarını Anlama

SSIS Tasarımcısı'nda Betik bileşeninin iki modu vardır: meta veri tasarım modu ve kod tasarımı modu. Meta veri tasarımı modunda, Betik bileşeni girişlerini ve çıkışlarını ekleyebilir ve değiştirebilirsiniz, ancak kod yazamazsınız. Tüm girişler ve çıkışlar yapılandırıldıktan sonra, betiği yazmak için kod tasarımı moduna geçersiniz. Betik bileşeni, giriş ve çıkışların meta verilerinden otomatik olarak temel kod oluşturur. Betik bileşeni temel kodu oluşturduktan sonra meta verileri değiştirirseniz, güncelleştirilmiş temel kod kodunuzla uyumsuz olabileceğinden kodunuz artık derlenmeyebilir.

Bileşenin Kullandığı Betiği Yazma

Betik bileşeni, betikleri yazdığınız ortam olarak Microsoft Visual Studio Uygulamalar için Araçlar'ı (VSTA) kullanır. VSTA'ya Betik Dönüştürme Düzenleyicisi'nden erişebilirsiniz.

Betik bileşeni, bileşen meta verilerini temsil eden ScriptMain adlı otomatik olarak oluşturulan bir sınıf içeren bir VSTA projesi sunar. Örneğin, Betik bileşeni üç çıkışı olan bir dönüştürme şeklinde kullanılıyorsa, ScriptMain her çıkış için bir yöntem içerir. ScriptMain, betiğin giriş noktasıdır.

VSTA, renk kodlu Visual Studio düzenleyicisi, IntelliSense ve Nesne Tarayıcısı gibi Visual Studio ortamının tüm standart özelliklerini içerir. Betik Bileşeni'nin kullandığı betik, paket tanımında depolanır. Paketi tasarlarken betik kodu geçici olarak bir proje dosyasına yazılır.

VSTA, Microsoft Visual C# ve Microsoft Visual Basic programlama dillerini destekler.

Betik bileşenini programlama hakkında bilgi için bkz. Betik Bileşeni ile Veri Akışını Genişletme. Betik bileşenini kaynak, dönüştürme veya hedef olarak yapılandırma hakkında daha ayrıntılı bilgi için bkz. Belirli Betik Bileşeni Türleri Geliştirme. Betik bileşeninin kullanımını gösteren ODBC hedefi gibi ek örnekler için bkz. Ek Betik Bileşeni Örnekleri.

Uyarı

Betiklerin önceden derlenip derlenmediğini belirtebileceğiniz önceki sürümlerden farklı olarak, tüm betikler SQL Server 2008 Integration Services (SSIS) ve sonraki sürümlerde önceden derlenir. Bir betik önceden derlendiğinde, dil altyapısı çalışma zamanında yüklenmez ve paket daha hızlı çalışır. Ancak, önceden derlenmiş ikili dosyalar önemli disk alanı kullanır.

Betik Bileşeninin Yapılandırılması

Betik bileşenini aşağıdaki yollarla yapılandırabilirsiniz:

• Referans alınacak giriş sütunlarını seçiniz.

  Uyarı

  SSIS Tasarımcısı'nı kullanırken yalnızca bir giriş yapılandırabilirsiniz.

• Bileşenin çalıştıracağı betiği sağlayın.

• Betik dilini belirtin.

• Salt okunur ve okuma/yazma değişkenlerinin virgülle ayrılmış listelerini sağlayın.

• Daha fazla çıkış ekleyin ve betiğin atadığı çıkış sütunlarını ekleyin.

SSIS Tasarımcısı aracılığıyla veya program aracılığıyla özellikleri ayarlayabilirsiniz.

Tasarımcıda Betik Bileşenini Yapılandırma

SSIS Designer'da bu özellikleri ayarlama hakkında daha fazla bilgi için aşağıdaki konuya tıklayın:

• Veri Akışı Bileşeni özelliklerini ayarlama

Betik Bileşenini Programatik Olarak Yapılandırma

Özellikler penceresinde veya program aracılığıyla ayarlayabileceğiniz özellikler hakkında daha fazla bilgi için aşağıdaki konulardan birine tıklayın:

• Ortak Özellikler

• Dönüşüm Özel Nitelikleri

Özellikleri ayarlama hakkında daha fazla bilgi için aşağıdaki konulardan birine tıklayın:

• Veri Akışı Bileşeni özelliklerini ayarlama

Betik Bileşen Türünü Seçin

Kaynak, dönüştürme veya hedef olarak kullanılmak üzere önceden yapılandırılmış bir Betik Dönüşümü oluşturulup oluşturulmayacağını belirtmek için Betik Bileşeni Türünü Seç iletişim kutusunu kullanın.

Betik bileşeni hakkında daha fazla bilgi edinmek için bkz. Betik Bileşeni Düzenleyicisi'nde Betik Bileşenini Yapılandırma. Betik bileşenini programlama hakkında bilgi edinmek için bkz. Betik Bileşeni ile Veri Akışını Genişletme.

Seçenekler

Kaynak, Hedef veya Dönüşüm seçiminiz, Betik Dönüşümü yapılandırmasını ve Betik Dönüştürme Düzenleyicisi sayfalarını etkiler.

Komut Dosyası Dönüştürme Düzenleyicisi (Bağlantı Yöneticileri Sayfası)

Betik tarafından kullanılacak bağlantıları belirtmek için Betik Dönüştürme Düzenleyicisi'ninBağlantı Yöneticileri sayfasını kullanın.

Betik bileşeni hakkında daha fazla bilgi edinmek için bkz. Betik Bileşeni Düzenleyicisi'nde Betik Bileşenini Yapılandırma. Betik bileşenini programlama hakkında bilgi edinmek için bkz. Betik Bileşeni ile Veri Akışını Genişletme.

Seçenekler

Bağlantı yöneticileri
Betiğin kullanabileceği bağlantıların listesini görüntüleyin.

İsim
Bağlantı için benzersiz ve açıklayıcı bir ad yazın.

Bağlantı Yöneticisi
Kullanılabilir bağlantı yöneticileri listesinden seçin veya Yeni bağlantı'yı< seçerek>SSIS Bağlantı Yöneticisi Ekle iletişim kutusunu açın.

Açıklama
Bağlantı için bir açıklama yazın.

Ekle
Bağlantı yöneticileri listesine başka bir bağlantı ekleyin.

Kaldır
Seçili bağlantıyı Bağlantı yöneticileri listesinden kaldırın.

Betik Dönüştürme Düzenleyicisi (Giriş Sütunları Sayfası)

Giriş sütunlarında özellikleri ayarlamak için Betik Dönüştürme Düzenleyicisi iletişim kutusunun Giriş Sütunları sayfasını kullanın.

Uyarı

Çıkışları olan ancak girişi olmayan Kaynak bileşenler için Giriş Sütunları sayfası görüntülenmez.

Betik bileşeni hakkında daha fazla bilgi edinmek için bkz. Betik Bileşeni Düzenleyicisi'nde Betik Bileşenini Yapılandırma. Betik bileşenini programlama hakkında bilgi edinmek için bkz. Betik Bileşeni ile Veri Akışını Genişletme.

Seçenekler

Giriş adı
Kullanılabilir girişler listesinden öğesini seçin.

Kullanılabilir Giriş Sütunları
Onay kutularını kullanarak betik dönüştürmenin kullanacağı sütunları belirtin.

Giriş Sütunu
Her satır için kullanılabilir giriş sütunları listesinden seçim yapın. Seçimleriniz Kullanılabilir Giriş Sütunları tablosundaki onay kutusu seçimlerine yansıtılır.

Çıktı Diğer Adı
Her çıkış sütunu için bir diğer ad yazın. Varsayılan değer, giriş sütununun adıdır; ancak, herhangi bir benzersiz, açıklayıcı ad seçebilirsiniz.

Kullanım Türü
Betik Dönüştürme'nin her sütunu Salt Okunur olarak mı yoksa ReadWrite olarak mı işleneceğini belirtin.

Betik Dönüştürme Düzenleyicisi (Girişler ve Çıkışlar Sayfası)

Betik Dönüştürme iletişim kutusunun Girişler ve Çıkışlar sayfasını kullanarak Betik Dönüşümü için giriş ve çıkışlar ekleyin, kaldırın ve yapılandırın.

Uyarı

Kaynak bileşenlerin çıkışları vardır ve giriş yoktur, hedef bileşenlerde ise girişler vardır ancak çıkış yoktur. Dönüştürmelerin hem girişleri hem de çıkışları vardır.

Betik bileşeni hakkında daha fazla bilgi edinmek için bkz. Betik Bileşeni Düzenleyicisi'nde Betik Bileşenini Yapılandırma. Betik bileşenini programlama hakkında bilgi edinmek için bkz. Betik Bileşeni ile Veri Akışını Genişletme.

Seçenekler

Girişler ve çıkışlar
Sağ taraftaki tabloda özelliklerini görüntülemek için soldan bir giriş veya çıkış seçin. Düzenleme için kullanılabilen özellikler seçime göre değişir. Görüntülenen özelliklerin çoğu salt okunur. Tek tek özellikler hakkında daha fazla bilgi için aşağıdaki konulara bakın.

Ortak Özellikler

Dönüşüm Özel Nitelikleri

Çıkış Ekle
Listeye ek bir çıkış ekleyin.

Sütun Ekle
Yeni çıkış sütununun yerleştirildiği klasörü seçin ve Sütun Ekle'ye tıklayarak sütunu ekleyin.

Çıktıyı Kaldır
Bir çıktı seçin ve ardından Çıkışı Kaldır'a tıklayarak çıktıyı kaldırın.

Sütunu Kaldır
Bir sütun seçin ve ardından Sütunu Kaldır'a tıklayarak sütunu kaldırın.

Betik Dönüştürme Düzenleyicisi (Betik Sayfası)

Betik ve ilgili özellikleri belirtmek için Betik Dönüştürme Düzenleyicisi iletişim kutusunun Betik sekmesini kullanın.

Betik bileşeni hakkında daha fazla bilgi edinmek için bkz. Betik Bileşeni Düzenleyicisi'nde Betik Bileşenini Yapılandırma. Betik bileşenini programlama hakkında bilgi edinmek için bkz. Betik Bileşeni ile Veri Akışını Genişletme.

Seçenekler

Özellikleri
Betik dönüştürme özelliklerini görüntüleyin ve değiştirin. Görüntülenen özelliklerin çoğu salt okunur. Aşağıdaki özellikleri değiştirebilirsiniz:

Değer	Açıklama
Açıklama	Senaryo dönüşümünü amacına göre tanımlayın.
YerelKimlik	Sipariş için bölgeye özgü bilgiler sağlamak ve tarih ve saat dönüştürme için yerel ayarı belirtin.
İsim	Bileşen için açıklayıcı bir ad yazın.
ValidateExternalMetadata	Betik dönüştürmesinin tasarım zamanında dış veri kaynaklarına karşı sütun meta verilerini doğrulayıp doğrulamadığını belirtin. False değeri, yürütme zamanına kadar doğrulamayı geciktirer.
ReadOnlyVariables	Betik dönüşümü ile salt okunur erişim için değişkenlerin virgülle ayrılmış bir listesini yazın. Not: Değişken adları büyük/küçük harfe duyarlıdır.
ReadWriteVariables	Betik dönüşümü tarafından okuma ve yazma erişimi için virgülle ayrılmış bir değişken listesi yazın. Not: Değişken adları büyük/küçük harfe duyarlıdır.
ScriptLanguage	Betik bileşeni tarafından kullanılacak betik dilini seçin. Betik bileşenleri ve Betik görevleri için varsayılan betik dilini ayarlamak için, Seçenekler iletişim kutusunun Genel sayfasındaki Betik dili seçeneğini kullanın.
UserComponentTypeName	SQL Server altyapısını ScriptComponentHost destekleyen sınıfını ve Microsoft.SqlServer.TxScript derlemesini belirtir.

Komut Dosyasını Düzenle
Bir betik oluşturmak veya değiştirmek için Microsoft Visual Studio Uygulamalar Araçları'nı (VSTA) kullanın.

İlgili İçerik

Entegrasyon Hizmetleri Dönüşümleri

Betik Bileşeni ile Veri Akışını Genişletme