Zaman uyumsuz bir dönüştürme komut dosyası bileşeni ile oluşturma

Bir zaman uyumsuz dönüştürme bileşeni ile çalışmaya başlama

Bir komut dosyası bileşeni eklediğinizde veri akışı sekmesi SSIS Tasarımcı, Komut dosyası bileşeni türünü seçin. Kaynak, dönüştürme veya hedef bileşen önceden isteyen iletişim kutusu görüntülenir. Bu iletişim kutusunda seçin. Dönüştürme.

meta veriler ve Tasarım modunda bir zaman uyumsuz dönüştürme bileşeni'ni yapılandırma

Bir dönüştürme bileşen oluşturmak için bu seçeneği seçtikten sonra bileşen kullanarak yapılandırma Komut dosyası dönüştürme Düzenleyicisi.Daha fazla bilgi için bkz:Bileşen Kod Düzenleyicisi'nde komut dosyası bileşeni'ni yapılandırma.

Komut dosyası bileşeni kullanacağı, komut dosyası dili seçmek için küme ScriptLanguage özellikKomut dosyası sayfaKomut dosyası dönüştürme Düzenleyicisi iletişim kutusu.

Veri akışı dönüştürme bileşeni, bir giriş vardır ve bir veya daha fazla çıkış'ı destekler.Giriş ve çıkışlarını bileşeniniz, yapılandırma adımları kullanarak meta veriler tasarım modunda, tamamlamalısınız biridir Komut dosyası dönüştürme Düzenleyicisiözel komut dosyanızı yazmak için önce.

Giriş sütunlar'ı yapılandırma

Çıktı sütunları giriş ve çıkışlarını yapılandırma

Değişkenleri ekleme

Kod ve Tasarım modunda, bir zaman uyumsuz dönüştürme bileşeni komut dosyası kullanan kullanan dosyası kullanan

Bileşeniniz için tüm meta veriler yapılandırdıktan sonra kendi özel komut dosyası yazabilirsiniz.In the Script Transformation Editor, on the Script page, click Edit Script to open the Microsoft Visual Studio Tools for Applications (VSTA) IDE where you can add your custom script.The scripting language that you use depends on whether you selected Microsoft Visual Basic 2008 or Microsoft Visual C# 2008 as the script language for the ScriptLanguage property on the Script page.

Komut dosyası bileşeni kullanılarak oluşturulmuş bileşenler her tür için geçerli olan önemli bilgi için bkz: Kodlama ve kod bileşen hata ayıklama.

Otomatik oluşturulan kodu anlama

Kendi özel kod yazma

Örnek

Bu örnek, gereken özel kod gösterir ScriptMain bir zaman uyumsuz dönüştürme bileşen oluşturmak için sınıf'ı tıklatın.

Bu örnek, bir zaman uyumsuz dönüştürme bileşeniyle iki çıkışlarını gösterir.Bu dönüştürme geçtiği AddressID and Şehir sütun için bir çıkış adresleri (Redmond, Washington, ABD), belirli bir şehirde bulunan sayar ve ardından ikinci bir çıkış elde edilen değere çıkarır.

Bu örnek kodu uygulamak istiyorsanız, paket ve bileşen şekilde yapılandırmanız gerekir:

1. Yeni bir komut dosyası bileşeni için veri akışı Tasarımcısı yüzey ekleyin ve dönüştürme yapılandırın.

2. Çıktı bir kaynak veya başka bir dönüşümünün tasarımcısında yeni dönüştürme bileşeni bağlanın.Bu çıktı verilerini sağlamalıdır Person.Address tablosuAdventureWorks en az örnek veritabanıAddressID and Şehir sütunlar.

3. Açık Komut dosyası dönüştürme Düzenleyicisi.Üzerinde Giriş bir sütun sayfa, seçin.AddressID and Şehir sütunlar.

4. Üzerinde Giriş ve çıkışlarını sayfa ekleyin ve yapılandırmaAddressID and Şehir ilk çıkış sütunlarda çıktı.Ikinci bir çıktı eklemek ve ikinci çıktı Özet değeri için bir çıkış sütun ekleyin.Bu örnek giriş her satırın ilk çıkış için açıkça kopyaladığı için ilk çıkış SynchronousInputID özelliğini 0 olarak ayarlayın.Yeni oluşturulan çıktının SynchronousInputID özellik, zaten 0 olarak küme.

5. Giriş, çıkışlarını ve bunları daha açıklayıcı bir ad vermek için yeni çıktı sütun yeniden adlandırın.Örnek kullanır. MyAddressInput adı olarak giriş, MyAddressOutput and MySummaryOutput çıktıları için ve MyRedmondCount çıktı için sütun ikinci çıktıyı.

6. Üzerinde Komut dosyası sayfasında, tıklatın.Komut dosyası Düzenle ve aşağıdaki kodu girin.Komut dosyası geliştirme ortamı kapatın ve Komut dosyası dönüştürme Düzenleyicisi.

7. Oluşturma ve bir hedef bileşeni için beklediği ilk çıkış yapılandırma AddressID and Şehir sütunlarSQL Server Hedef veya hedef bileşeni içinde gösterilen örnek Hedef komut dosyası bileşeni ile oluşturma, .Ardından, dönüşümünün tersinin ilk çıkış bağlanın. MyAddressOutput, bileşenin hedef.Aşağıdaki komutu çalıştırarak hedef tablo oluşturabilirsiniz. Transact-SQL komut, AdventureWorks veritabanı:

   CREATE TABLE [Person].[Address2](
       [AddressID] [int] NOT NULL,
       [City] [nvarchar](30) NOT NULL
   )
   

8. Oluşturun ve başka bir hedef bileşen ikinci çıkış için yapılandırın.Sonra dönüştürme çıktısı ikinci bağlanma MySummaryOutput, bileşenin hedef.Ikinci çıkış tek bir değere sahip tek bir satır yazdığından, tek bir sütun içeren yeni bir dosyaya bağlayan düz dosya bir Bağlantı Yöneticisi ile hedef kolayca yapılandırabilirsiniz.Bu örnekte, bu hedef sütunun adlı MyRedmondCount.

9. Örnek çalıştırın.

Public Class ScriptMain
    Inherits UserComponent

    Private myRedmondAddressCount As Integer

    Public Overrides Sub CreateNewOutputRows()

        MySummaryOutputBuffer.AddRow()

    End Sub

    Public Overrides Sub MyAddressInput_ProcessInput(ByVal Buffer As MyAddressInputBuffer)

        While Buffer.NextRow()
            MyAddressInput_ProcessInputRow(Buffer)
        End While

        If Buffer.EndOfRowset Then
            MyAddressOutputBuffer.SetEndOfRowset()
            MySummaryOutputBuffer.MyRedmondCount = myRedmondAddressCount
            MySummaryOutputBuffer.SetEndOfRowset()
        End If

    End Sub

    Public Overrides Sub MyAddressInput_ProcessInputRow(ByVal Row As MyAddressInputBuffer)

        With MyAddressOutputBuffer
            .AddRow()
            .AddressID = Row.AddressID
            .City = Row.City
        End With

        If Row.City.ToUpper = "REDMOND" Then
            myRedmondAddressCount += 1
        End If

    End Sub

End Class

public class ScriptMain:
    UserComponent

{
    private int myRedmondAddressCount;

    public override void CreateNewOutputRows()
    {

        MySummaryOutputBuffer.AddRow();

    }

    public override void MyAddressInput_ProcessInput(MyAddressInputBuffer Buffer)
    {

        while (Buffer.NextRow())
        {
            MyAddressInput_ProcessInputRow(Buffer);
        }

        if (Buffer.EndOfRowset())
        {
            MyAddressOutputBuffer.SetEndOfRowset();
            MySummaryOutputBuffer.MyRedmondCount = myRedmondAddressCount;
            MySummaryOutputBuffer.SetEndOfRowset();
        }

    }

    public override void MyAddressInput_ProcessInputRow(MyAddressInputBuffer Row)
    {

        {
            MyAddressOutputBuffer.AddRow();
            MyAddressOutputBuffer.AddressID = Row.AddressID;
            MyAddressOutputBuffer.City = Row.City;
        }

        if (Row.City.ToUpper() == "REDMOND")
        {
            myRedmondAddressCount += 1;
        }

    }

}

See Also

Concepts