Bekerja dengan Pengelola Koneksi Secara Terprogram

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

Di Integration Services, metode AcquireConnection dari kelas pengelola koneksi terkait adalah metode yang paling sering Anda panggil ketika Anda bekerja dengan manajer koneksi dalam kode terkelola. Saat Anda menulis kode terkelola, Anda harus memanggil metode AcquireConnection untuk menggunakan fungsionalitas manajer koneksi. Anda harus memanggil metode ini terlepas dari apakah Anda menulis kode terkelola dalam tugas Skrip, komponen Skrip, objek kustom, atau aplikasi kustom.

Untuk berhasil memanggil metode AcquireConnection, Anda harus mengetahui jawaban atas pertanyaan berikut:

• Manajer koneksi mana yang mengembalikan objek terkelola dari metode AcquireConnection?

  Banyak manajer koneksi mengembalikan objek COM yang tidak dikelola (System.__ComObject) dan objek ini tidak dapat dengan mudah digunakan dari kode terkelola. Daftar manajer koneksi ini mencakup manajer koneksi OLE DB yang sering digunakan.

• Untuk manajer koneksi yang mengembalikan objek terkelola, objek apa yang dikembalikan metode AcquireConnection mereka?

  Untuk melemparkan nilai pengembalian ke jenis yang sesuai, Anda harus mengetahui jenis objek apa yang dikembalikan metode AcquireConnection. Misalnya, metode AcquireConnection untuk manajer koneksi ADO.NET mengembalikan objek SqlConnection terbuka saat Anda menggunakan penyedia SqlClient. Namun, metode AcquireConnection untuk manajer koneksi File hanya mengembalikan string.

Topik ini menjawab pertanyaan-pertanyaan ini untuk manajer koneksi yang disertakan dengan Layanan Integrasi.

Pengelola Sambungan yang Tidak Mengembalikan Objek Terkelola

Tabel berikut mencantumkan manajer koneksi yang mengembalikan objek COM asli (System.__ComObject) dari metode AcquireConnection. Objek yang tidak dikelola ini tidak dapat dengan mudah digunakan dari kode terkelola.

Jenis Pengelola Sambungan	Nama Pengelola Sambungan
ADO	Pengelola Koneksi ADO
MSOLAP90	Pengelola Koneksi Layanan Analisis
EXCEL	Pengelola Koneksi Excel
FTP	Pengelola Koneksi FTP
HTTP	Pengelola Koneksi HTTP
ODBC	Pengelola Koneksi ODBC
OLEDB	Pengelola Sambungan OLE DB

Biasanya, Anda dapat menggunakan pengelola koneksi ADO.NET dari kode terkelola untuk menyambungkan ke sumber data ADO, Excel, ODBC, atau OLE DB.

Mengembalikan Nilai dari Metode AcquireConnection

Tabel berikut mencantumkan manajer koneksi yang mengembalikan objek terkelola dari metode AcquireConnection. Objek terkelola ini dapat dengan mudah digunakan dari kode terkelola.

Jenis Pengelola Sambungan	Nama Pengelola Sambungan	Jenis Nilai Yang Dikembalikan	Informasi Tambahan
ADO.NET	Pengelola Koneksi ADO.NET	System.Data.SqlClient.SqlConnection
FILE	Pengelola Koneksi File	System.String	Jalur ke file.
FLATFILE	Pengelola Koneksi File Datar	System.String	Jalur ke file.
MSMQ	Pengelola Koneksi MSMQ	System.Messaging.MessageQueue
MULTIFILE	Pengelola Koneksi Beberapa File	System.String	Jalur ke salah satu file.
MULTIFLATFILE	Pengelola Koneksi Beberapa File Datar	System.String	Jalur ke salah satu file.
SMOServer	Pengelola Koneksi SMO	Microsoft.SqlServer.Management.Smo.Server
SMTP	Pengelola Koneksi SMTP	System.String	Misalnya: SmtpServer=<server name>;UseWindowsAuthentication=True;EnableSsl=False;
WMI	Pengelola Koneksi WMI	System.Management.ManagementScope
SQLMOBILE	Pengelola Sambungan Ringkas SQL Server	System.Data.SqlServerCe.SqlCeConnection

Lihat Juga

Menyambungkan ke Sumber Data di Tugas Skrip
Menyambungkan ke Sumber Data di Komponen Skrip
Menyambungkan ke Sumber Data dalam Tugas Kustom