Aracılığıyla paylaş

Betik Görevi

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

Betik görevi, SQL Server Integration Services'ın sağladığı yerleşik görevlerde ve dönüştürmelerde bulunmayan işlevleri gerçekleştirmek için kod sağlar. Betik görevi, birden çok görev ve dönüştürme kullanmak yerine işlevleri tek bir betikte birleştirmeyi sağlayabilir. Betik görevini, veri satırı başına bir kez yerine bir pakette (veya numaralandırılmış nesne başına bir kez) yapılması gereken işler için kullanırsınız.

Betik görevini aşağıdaki amaçlarla kullanabilirsiniz:

  • Yerleşik bağlantı türleri tarafından desteklenmeyen diğer teknolojileri kullanarak verilere erişin. Örneğin, bir betik Active Directory'den kullanıcı adlarına erişmek ve bunları ayıklamak için Active Directory Hizmet Arabirimleri'ni (ADSI) kullanabilir.

  • Pakete özgü bir performans sayacı oluşturun. Örneğin, bir betik, karmaşık veya kötü performans gösteren bir görev çalıştırılırken güncellenen bir performans sayacı oluşturabilir.

  • Belirtilen dosyaların boş mu yoksa kaç satır içerdiğini belirleyin ve bu bilgilere dayanarak paketteki denetim akışını etkiler. Örneğin, bir dosya sıfır satır içeriyorsa, değişkenin değeri 0 olarak ayarlanır ve değeri değerlendiren bir öncelik kısıtlaması Dosya Sistemi görevinin dosyayı kopyalamasını engeller.

Bir kümedeki her veri satırı için aynı işi yapmak için betiği kullanmanız gerekiyorsa, Betik görevi yerine Betik bileşenini kullanmanız gerekir. Örneğin, bir posta tutarının makullüğünü değerlendirmek ve çok yüksek veya düşük tutarlara sahip veri satırlarını atlamak istiyorsanız, bir Betik komponenti kullanırsınız. Daha fazla bilgi için bkz Betik Bileşeni.

Birden fazla paket bir betik kullanıyorsa, Betik Görevi'ni kullanmak yerine özel bir görev oluşturmayı değerlendirin. Daha fazla bilgi için bkz. Özel Görev geliştirme.

Betik görevinin paketiniz için uygun seçim olduğuna karar verdikten sonra, hem görevin kullandığı betiği geliştirmeniz hem de görevin kendisini yapılandırmanız gerekir.

Görevin Kullandığı Betiği Yazma ve Çalıştırma

Betik görevi, betikleri yazdığınız ortam ve bu betikleri çalıştıran motor olarak Microsoft Visual Studio Uygulamalar için Araçlar'ı (VSTA) kullanır.

VSTA, renk kodlu Visual Studio düzenleyicisi, IntelliSense ve Nesne Gezgini gibi Visual Studio ortamının tüm standart özelliklerini sağlar. VSTA, diğer Microsoft geliştirme araçlarının kullandığı hata ayıklayıcıyı da kullanır. Betikteki hata ayıklama noktaları, Integration Services görevleri ve kapsayıcılarındaki hata ayıklama noktalarıyla sorunsuz çalışır. VSTA hem Microsoft Visual Basic hem de Microsoft Visual C# programlama dillerini destekler.

Betiği çalıştırmak için paketin çalıştığı bilgisayarda VSTA yüklü olmalıdır. Paket çalıştırıldığında, görev betik altyapısını yükler ve betiği çalıştırır. Projedeki derlemelere başvuru ekleyerek betiklerdeki dış .NET derlemelerine erişebilirsiniz. Şu anda .NET Core ve .NET standart derleme başvurularını desteklemiyoruz.

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 Görevini Yapılandırma

"Betik görevini şu şekillerde yapılandırabilirsiniz:"

  • Görevin çalıştıracağı özel betiği sağlayın.

  • VSTA projesinde, Integration Services çalışma zamanının Betik görev koduna giriş noktası olarak çağırdığı yöntemi belirtin.

  • Betik dilini belirtin.

  • İsteğe bağlı olarak, betikte kullanmak üzere salt okunur ve okuma/yazma değişkenlerinin listesini sağlayın.

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

Tasarım Aracında Komut Dosyası Görevini Yapılandırma

Aşağıdaki tabloda Script görevi için günlüğe kaydedilebilen ScriptTaskLogEntry olayı açıklanmıştır. ScriptTaskLogEntry olayı, SSIS Günlüklerini Yapılandır iletişim kutusunun Ayrıntılar sekmesinde günlüğe kaydetmek için seçilir. Daha fazla bilgi için bkz. Integration Services (SSIS) – Günlüğe Alma.

Kayıt girişi Açıklama
ScriptTaskLogEntry Betikte loglamanın sonuçlarını rapor eder. Görev, Dts nesnesinin Log yöntemine yapılan her çağrı için bir günlük girdisi yazar. Kod çalıştırıldığında görev bu girişleri yazar. Daha fazla bilgi için bkz. Betik Görevinde Günlüğe Kaydetme.

SSIS Designer'da ayarlayabileceğiniz özellikler hakkında daha fazla bilgi için aşağıdaki konulara bakın:

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

Betik Görevini Program Aracılığıyla Yapılandırma

Bu özellikleri program aracılığıyla ayarlama hakkında daha fazla bilgi için aşağıdaki konuya bakın:

Betik Görev Düzenleyicisi (Genel Sayfa)

Betik görevini adlandırmak ve açıklamak için Betik Görev Düzenleyicisi iletişim kutusunun Genel sayfasını kullanın.

Betik görevi hakkında daha fazla bilgi edinmek için, Betik GöreviDüzenleyicisi'nde Betik Görevi ve Betik Görevini Yapılandırma konularına bakın. Betik görevini programlama hakkında bilgi edinmek için bakınız Betik Görevi ile Paketi Genişletme.

Seçenekler

İsim
Betik görevi için benzersiz bir ad sağlayın. Bu ad, görev simgesinde etiket olarak kullanılır.

Uyarı

Görev adları bir paket içinde benzersiz olmalıdır.

Açıklama
Betik görevinin açıklamasını yazın.

Betik Görev Düzenleyicisi (Betik Sayfası)

Betik özelliklerini ayarlamak ve betik tarafından erişilebilen değişkenleri belirtmek için Betik Görev Düzenleyicisi iletişim kutusunun Betik sayfasını kullanın.

Uyarı

SQL Server 2008 Integration Services (SSIS) ve sonraki sürümlerinde, tüm betikler önceden derlenir. Önceki sürümlerde, betiğin önceden derlendiğini belirtmek için precompileScriptIntoBinaryCode özelliğini ayarlamıştınız.

Betik görevi hakkında daha fazla bilgi edinmek için, Betik GöreviDüzenleyicisi'nde Betik Görevi ve Betik Görevini Yapılandırma konularına bakın. Betik görevini programlama hakkında bilgi edinmek için bakınız Betik Görevi ile Paketi Genişletme.

Seçenekler

ScriptLanguage
Görevin betik dilini (Microsoft Visual Basic veya Microsoft Visual C# ) seçin.

Görev için bir betik oluşturduktan sonra ScriptLanguage özelliğinin değerini değiştiremezsiniz.

Betik görevi için varsayılan betik dilini ayarlamak için Seçenekler iletişim kutusunun Genel sayfasındaki Betik dili seçeneğini kullanın. .

EntryPoint
Integration Services çalışma zamanının Betik görevinin koduna giriş noktası olarak çağıran yöntemini belirtin. Belirtilen yöntem, Microsoft Visual Studio Tools for Applications (VSTA) projesinin ScriptMain sınıfında olmalıdır. ScriptMain sınıfı, betik şablonları tarafından oluşturulan varsayılan sınıftır.

VSTA projesindeki yöntemin adını değiştirirseniz EntryPoint özelliğinin değerini değiştirmeniz gerekir.

ReadOnlyVariables
Betikte kullanılabilen salt okunur değişkenlerin virgülle ayrılmış bir listesini yazın veya üç nokta (...) düğmesine tıklayıp Değişkenleri seç iletişim kutusunda değişkenleri seçin.

Uyarı

Değişken adları harf büyüklüğüne duyarlıdır.

ReadWriteVariables
Betikte kullanılabilen okuma/yazma değişkenlerinin virgülle ayrılmış bir listesini yazın veya üç nokta (...) düğmesine tıklayıp Değişkenleri seç iletişim kutusunda değişkenleri seçin.

Uyarı

Değişken adları harf büyüklüğüne duyarlıdır.

Komut Dosyasını Düzenle
VSTA IDE'yi açar, burada script oluşturabilir veya değiştirebilirsiniz.

İlgili İçerik

  • Last updated on