Menyambungkan ke Sumber Data dalam Tugas Skrip

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Pengelola koneksi menyediakan akses ke sumber data yang telah dikonfigurasi dalam paket. Untuk informasi selengkapnya, lihat Koneksi Integration Services (SSIS).

Tugas Skrip dapat mengakses manajer koneksi ini melalui Connections properti objek Dts . Setiap manajer koneksi di Connections koleksi menyimpan informasi tentang cara menyambungkan ke sumber data yang mendasar.

Saat Anda memanggil AcquireConnection metode pengelola koneksi, manajer koneksi tersambung ke sumber data, jika belum tersambung, dan mengembalikan informasi koneksi atau koneksi yang sesuai untuk Anda gunakan dalam kode tugas Skrip Anda.

Catatan

Anda harus mengetahui jenis koneksi yang dikembalikan oleh pengelola koneksi sebelum memanggil AcquireConnection. Karena tugas Skrip mengaktifkan Opsi Ketat , Anda harus mentransmisikan koneksi, yang dikembalikan sebagai tipe Objek, ke jenis koneksi yang sesuai sebelum Anda dapat menggunakannya.

Anda dapat menggunakan Contains metode koleksi yang Connections dikembalikan oleh Connections properti untuk mencari koneksi yang ada sebelum menggunakan koneksi dalam kode Anda.

Penting

Anda tidak dapat memanggil metode AcquireConnection manajer koneksi yang mengembalikan objek yang tidak dikelola, seperti manajer koneksi OLE DB dan manajer koneksi Excel, dalam kode terkelola tugas Skrip. Namun, Anda dapat membaca properti ConnectionString dari manajer koneksi ini, dan menyambungkan ke sumber data langsung dalam kode Anda dengan menggunakan string koneksi dengan OledbConnection dari namespace System.Data.OleDb .

Jika Anda harus memanggil metode AcquireConnection dari manajer koneksi yang mengembalikan objek yang tidak terkelola, gunakan manajer koneksi ADO.NET. Saat Anda mengonfigurasi pengelola koneksi ADO.NET untuk menggunakan penyedia OLE DB, ia terhubung dengan menggunakan Penyedia Data .NET Framework untuk OLE DB. Dalam hal ini, metode AcquireConnection mengembalikan System.Data.OleDb.OleDbConnection alih-alih objek yang tidak dikelola. Untuk mengonfigurasi pengelola koneksi ADO.NET untuk digunakan dengan sumber data Excel, pilih Penyedia Microsoft OLE DB untuk Jet, tentukan file Excel, dan masukkan Excel 8.0 (untuk Excel 97 dan yang lebih baru) sebagai nilai Properti diperluas pada halaman Semua kotak dialog Pengelola Sambungan.

Contoh Koneksi

Contoh berikut menunjukkan cara mengakses manajer koneksi dari dalam tugas Skrip. Sampel mengasumsikan bahwa Anda telah membuat dan mengonfigurasi manajer koneksi ADO.NET bernama Uji Koneksi ADO.NET dan manajer koneksi File Datar bernama Uji Koneksi File Datar. Perhatikan bahwa pengelola koneksi ADO.NET mengembalikan objek SqlConnection yang dapat Anda gunakan segera untuk menyambungkan ke sumber data. Manajer koneksi File Datar, di sisi lain, hanya mengembalikan string yang berisi jalur dan nama file. Anda harus menggunakan metode dari namespace System.IO untuk membuka dan bekerja dengan file datar.

    Public Sub Main()

        Dim myADONETConnection As SqlClient.SqlConnection =
            DirectCast(Dts.Connections("Test ADO.NET Connection").AcquireConnection(Dts.Transaction),
                SqlClient.SqlConnection)
        MsgBox(myADONETConnection.ConnectionString,
            MsgBoxStyle.Information, "ADO.NET Connection")

        Dim myFlatFileConnection As String =
            DirectCast(Dts.Connections("Test Flat File Connection").AcquireConnection(Dts.Transaction),
                String)
        MsgBox(myFlatFileConnection, MsgBoxStyle.Information, "Flat File Connection")

        Dts.TaskResult = ScriptResults.Success

    End Sub

		public void Main()
		{
            SqlConnection myADONETConnection = 
                Dts.Connections["Test ADO.NET Connection"].AcquireConnection(Dts.Transaction)
                as SqlConnection;
            MessageBox.Show(myADONETConnection.ConnectionString, "ADO.NET Connection");

            string myFlatFileConnection = 
                Dts.Connections["Test Flat File Connection"].AcquireConnection(Dts.Transaction) 
                as string;
            MessageBox.Show(myFlatFileConnection, "Flat File Connection");

            Dts.TaskResult = (int)ScriptResults.Success;
		}

Lihat juga

Koneksi Integration Services (SSIS)
Membuat Pengelola Koneksi