Menyambungkan ke Sumber Data di Komponen Skrip

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

Pengelola koneksi adalah unit nyaman yang merangkum dan menyimpan informasi yang diperlukan untuk terhubung ke sumber data dari jenis tertentu. Untuk informasi selengkapnya, lihat Koneksi Integration Services (SSIS).

Anda dapat membuat pengelola koneksi yang ada tersedia untuk diakses oleh skrip kustom di komponen sumber atau tujuan dengan mengklik tombol Tambahkan dan Hapus pada halaman Pengelola Koneksidari Editor Transformasi Skrip. Namun, Anda harus menulis kode kustom Anda sendiri untuk memuat atau menyimpan data Anda, dan mungkin untuk membuka dan menutup koneksi ke sumber data. Untuk informasi selengkapnya tentang halaman Pengelola Koneksidari Editor Transformasi Skrip, lihat Mengonfigurasi Komponen Skrip di Editor Komponen Skrip dan Editor Transformasi Skrip (Halaman Pengelola Koneksi).

Komponen Skrip membuat kelas koleksi Koneksi dalam item proyek ComponentWrapper yang berisi aksesor yang diketik dengan kuat untuk setiap manajer koneksi yang memiliki nama yang sama dengan manajer koneksi itu sendiri. Koleksi ini diekspos melalui properti Koneksi dari kelas ScriptMain . Properti aksesor mengembalikan referensi ke manajer koneksi sebagai instans .IDTSConnectionManager100 Misalnya, jika Anda telah menambahkan manajer koneksi bernama MyADONETConnection pada halaman Pengelola Koneksi dari kotak dialog, Anda bisa mendapatkan referensi ke dalam skrip Anda dengan menambahkan kode berikut:

Dim myADONETConnectionManager As IDTSConnectionManager100 = _

Me.Connections.MyADONETConnection

Catatan

Anda harus mengetahui tipe koneksi yang dikembalikan oleh pengelola koneksi sebelum Anda 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.

Selanjutnya, Anda memanggil metode AcquireConnection dari manajer koneksi tertentu untuk mendapatkan koneksi yang mendasar atau informasi yang diperlukan untuk menyambungkan ke sumber data. Misalnya, Anda mendapatkan referensi ke System.Data.SqlConnection yang dibungkus oleh manajer koneksi ADO.NET dengan menggunakan kode berikut:

Dim myADOConnection As SqlConnection = _

CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)

Sebaliknya, panggilan yang sama ke manajer koneksi file datar hanya mengembalikan jalur dan nama file sumber data file.

Dim myFlatFile As String = _

CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)

Anda kemudian harus memberikan jalur dan nama file ini ke System.IO.StreamReader atau Streamwriter untuk membaca atau menulis data dalam file datar.

Penting

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

Jika Anda perlu memanggil metode AcquireConnection dari manajer koneksi yang mengembalikan objek yang tidak dikelola, 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 buku kerja Excel, lalu masukkan Excel 8.0 (untuk Excel 97 dan yang lebih baru) sebagai nilai Properti diperluas pada halaman Semua dari kotak dialog Pengelola Sambungan.

Untuk informasi selengkapnya tentang cara menggunakan pengelola koneksi dengan komponen skrip, lihat Membuat Sumber dengan Komponen Skrip dan Membuat Tujuan dengan Komponen Skrip.

Lihat juga

Koneksi Integration Services (SSIS)
Membuat Pengelola Koneksi