Bağlantıları Programatik Olarak Ekle

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

Sınıf, ConnectionManager harici veri kaynaklarına fiziksel bağlantıları temsil eder. Sınıf, ConnectionManager bağlantının uygulama detaylarını çalışma zamanından izole eder. Bu, çalışma zamanının her bağlantı yöneticisiyle tutarlı ve öngörülebilir şekilde etkileşime girmesini sağlar. Bağlantı yöneticileri, tüm bağlantıların ortak noktası olan stok özellikleri içerir; örneğin Name, ID, Description, ve ConnectionString. Ancak, ConnectionString ve Name özellikleri genellikle bir bağlantı yöneticisini yapılandırmak için gereken tek özelliklerdir. Diğer programlama paradigmalarının aksine, bağlantı sınıfları Open veyaConnect gibi yöntemleri kullanarak veri kaynağına fiziksel olarak bağlantı kurarken, çalışma zamanı motoru paket çalışırken tüm bağlantıları yönetir.

Sınıf, Connections o pakete eklenen ve çalışma zamanında kullanılabilen bağlantı yöneticilerinin bir koleksiyonudur. Koleksiyonun yöntemini kullanarak ve bağlantı yöneticisi tipini gösteren bir diziyi sağlayarak koleksiyona Add daha fazla bağlantı yöneticisi ekleyebilirsiniz. Metod, Add pakete eklenen örneği döndürür ConnectionManager .

İçsel Özellikler

Sınıf, ConnectionManager tüm bağlantılar için ortak bir özellik kümesini ortaya çıkarır. Ancak bazen belirli bağlantı türüne özgü özelliklere erişim gerekir. Sınıf ConnectionManager koleksiyonu Properties bu özelliklere erişim sağlar. Özellikler, indeksleyici veya özellik adı ile GetValue yöntemi kullanılarak koleksiyondan alınabilir ve değerler SetValue yöntemiyle ayarlanır. Temel bağlantı nesnesinin özellikleri, nesnenin gerçek bir örneğini edinip doğrudan özelliklerini ayarlayarak da ayarlanabilir. Temel bağlantıyı almak için bağlantı yöneticisinin özelliğini kullanın InnerObject . Aşağıdaki kod satırı, altta yatan sınıf ile bir ADO.NET bağlantı yöneticisi oluşturan bir C# satırını gösterir. ConnectionManagerAdoNetClass

ConnectionManagerAdoNetClass cmado = cm.InnerObject as ConnectionManagerAdoNet;

Bu, yönetilen bağlantı yöneticisi nesnesini altta yatan bağlantı nesnesine gönderir. C++ kullanıyorsanız, nesnenin ConnectionManagerQueryInterface yöntemi çağrılı ve altta yatan bağlantı nesnesinin arayüzü istenir.

Aşağıdaki tablo, Entegrasyon Hizmetleri ile birlikte yer alan bağlantı yöneticilerini ve ifadede package.Connections.Add("xxx") kullanılan diziyi listeler. Tüm bağlantı yöneticilerinin listesi için Entegrasyon Hizmetleri (SSIS) Bağlantıları bölümünü inceleyebilirsiniz.

String Bağlantı yöneticisi
"OLEDB" OLE veritabanı bağlantıları için bağlantı yöneticisi.
"ODBC" ODBC bağlantıları için bağlantı yöneticisi.
"ADO" ADO bağlantıları için bağlantı yöneticisi.
"ADO.NET:SQL" ADO.NET (SQL veri sağlayıcısı) bağlantıları için bağlantı yöneticisi.
"ADO.NET:OLEDB" ADO.NET (OLE DB veri sağlayıcısı) bağlantıları için bağlantı yöneticisi.
"FLATFILE" Düz dosya bağlantıları için bağlantı yöneticisi.
"DOSYA" Dosya bağlantıları için bağlantı yöneticisi.
"ÇOKLU FLATFILE" Birden fazla düz dosya bağlantısı için bağlantı yöneticisi.
"ÇOK DOSYA" Birden fazla dosya bağlantısı için bağlantı yöneticisi.
"SQLMOBILE" SQL Server Compact bağlantıları için bağlantı yöneticisi.
"MSOLAP100" Analiz Hizmetleri bağlantıları için bağlantı yöneticisi.
"FTP" FTP bağlantıları için bağlantı yöneticisi.
HTTP HTTP bağlantıları için bağlantı yöneticisi.
"MSMQ" Mesaj Kuyruğu (MSMQ olarak da bilinir) bağlantıları için bağlantı yöneticisi.
"SMTP" SMTP bağlantıları için bağlantı yöneticisi.
"WMI" Microsoft Windows Yönetim Enstrümantasyonu (WMI) bağlantıları için bağlantı yöneticisi.

Aşağıdaki kod örneği, bir Packagekoleksiyona bir OLE DB ve FILE bağlantısı Connections eklenmesini göstermektedir. Örnek daha sonra , Name, ve Description özelliklerini belirlerConnectionString.

using System;
using Microsoft.SqlServer.Dts.Runtime;
  
namespace Microsoft.SqlServer.Dts.Samples
{
  class Program
  {
    static void Main(string[] args)
    {
      // Create a package, and retrieve its connections.
      Package pkg = new Package();
      Connections pkgConns = pkg.Connections;
  
      // Add an OLE DB connection to the package, using the
      // method defined in the AddConnection class.
      CreateConnection myOLEDBConn = new CreateConnection();
      myOLEDBConn.CreateOLEDBConnection(pkg);
  
      // View the new connection in the package.
      Console.WriteLine("Connection description: {0}",
         pkg.Connections["SSIS Connection Manager for OLE DB"].Description);
  
      // Add a second connection to the package.
      CreateConnection myFileConn = new CreateConnection();
      myFileConn.CreateFileConnection(pkg);
  
      // View the second connection in the package.
      Console.WriteLine("Connection description: {0}",
        pkg.Connections["SSIS Connection Manager for Files"].Description);
  
      Console.WriteLine();
      Console.WriteLine("Number of connections in package: {0}", pkg.Connections.Count);
  
      Console.Read();
    }
  }
  // <summary>
  // This class contains the definitions for multiple
  // connection managers.
  // </summary>
  public class CreateConnection
  {
    // Private data.
    private ConnectionManager ConMgr;
  
    // Class definition for OLE DB Provider.
    public void CreateOLEDBConnection(Package p)
    {
      ConMgr = p.Connections.Add("OLEDB");
      ConMgr.ConnectionString = "Provider=SQLOLEDB.1;" +
        "Integrated Security=SSPI;Initial Catalog=AdventureWorks;" +
        "Data Source=(local);";
      ConMgr.Name = "SSIS Connection Manager for OLE DB";
      ConMgr.Description = "OLE DB connection to the AdventureWorks database.";
    }
    public void CreateFileConnection(Package p)
    {
      ConMgr = p.Connections.Add("File");
      ConMgr.ConnectionString = @"\\<yourserver>\<yourfolder>\books.xml";
      ConMgr.Name = "SSIS Connection Manager for Files";
      ConMgr.Description = "Flat File connection";
    }
  }
  
}

Imports Microsoft.SqlServer.Dts.Runtime
  
Module Module1
  
  Sub Main()
  
    ' Create a package, and retrieve its connections.
    Dim pkg As New Package()
    Dim pkgConns As Connections = pkg.Connections
  
    ' Add an OLE DB connection to the package, using the
    ' method defined in the AddConnection class.
    Dim myOLEDBConn As New CreateConnection()
    myOLEDBConn.CreateOLEDBConnection(pkg)
  
    ' View the new connection in the package.
    Console.WriteLine("Connection description: {0}", _
      pkg.Connections("SSIS Connection Manager for OLE DB").Description)
  
    ' Add a second connection to the package.
    Dim myFileConn As New CreateConnection()
    myFileConn.CreateFileConnection(pkg)
  
    ' View the second connection in the package.
    Console.WriteLine("Connection description: {0}", _
      pkg.Connections("SSIS Connection Manager for Files").Description)
  
    Console.WriteLine()
    Console.WriteLine("Number of connections in package: {0}", pkg.Connections.Count)
  
    Console.Read()
  
  End Sub
  
End Module
  
' This class contains the definitions for multiple
' connection managers.
  
Public Class CreateConnection
  ' Private data.
  Private ConMgr As ConnectionManager
  
  ' Class definition for OLE DB provider.
  Public Sub CreateOLEDBConnection(ByVal p As Package)
    ConMgr = p.Connections.Add("OLEDB")
    ConMgr.ConnectionString = "Provider=SQLOLEDB.1;" & _
      "Integrated Security=SSPI;Initial Catalog=AdventureWorks;" & _
      "Data Source=(local);"
    ConMgr.Name = "SSIS Connection Manager for OLE DB"
    ConMgr.Description = "OLE DB connection to the AdventureWorks database."
  End Sub
  
  Public Sub CreateFileConnection(ByVal p As Package)
    ConMgr = p.Connections.Add("File")
    ConMgr.ConnectionString = "\\<yourserver>\<yourfolder>\books.xml"
    ConMgr.Name = "SSIS Connection Manager for Files"
    ConMgr.Description = "Flat File connection"
  End Sub
  
End Class

Örnek Çıkış:

Connection description: OLE DB connection to the AdventureWorks database.

Connection description: Flat File connection.

Number of connections in package: 2

İlgili içerik

  • Last updated on