Bagikan melalui

Pengelola koneksi OLEDB

  • Artikel

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

Manajer koneksi OLEDB memungkinkan paket untuk terhubung ke sumber data dengan menggunakan penyedia OLEDB. Misalnya, manajer koneksi OLEDB yang tersambung ke SQL Server dapat menggunakan Penyedia OLEDB Microsoft untuk SQL Server.

Catatan

Penyedia OLEDB SQL Server Native Client 11.0 tidak mendukung kata kunci string koneksi baru (MultiSubnetFailover=True) untuk pengklusteran failover multi-subnet. Untuk informasi selengkapnya, lihat Catatan Rilis SQL Server.

Catatan

Jika sumber data adalah Microsoft Office Excel 2007 atau Microsoft Office Access 2007, sumber data memerlukan penyedia data yang berbeda dari versi Excel atau Access sebelumnya. Untuk informasi selengkapnya, lihat Menyambungkan ke Buku Kerja Excel dan Menyambungkan ke Database Access.

Beberapa tugas SQL Server Integration Services dan komponen aliran data menggunakan manajer koneksi OLEDB. Misalnya, sumber OLEDB dan tujuan OLEDB menggunakan manajer koneksi ini untuk mengekstrak dan memuat data. Tugas Jalankan SQL dapat menggunakan manajer koneksi ini untuk menyambungkan ke database SQL Server untuk menjalankan kueri.

Anda juga dapat menggunakan pengelola koneksi OLEDB untuk mengakses sumber data OLEDB dalam tugas kustom yang ditulis dalam kode tidak terkelola yang menggunakan bahasa seperti C++.

Saat Anda menambahkan manajer koneksi OLEDB ke paket, Integration Services membuat manajer koneksi yang diselesaikan ke koneksi OLEDB pada runtime, mengatur properti pengelola koneksi, dan menambahkan manajer koneksi ke koleksi Koneksi pada paket.

Properti ConnectionManagerType manajer koneksi diatur ke OLEDB.

Konfigurasikan manajer koneksi OLEDB dengan cara berikut:

  • Berikan string koneksi tertentu yang dikonfigurasi untuk memenuhi persyaratan penyedia yang dipilih.

  • Bergantung pada penyedia, sertakan nama sumber data yang akan disambungkan.

  • Berikan kredensial keamanan yang sesuai untuk penyedia yang dipilih.

  • Menunjukkan apakah koneksi yang dibuat dari manajer koneksi dipertahankan pada runtime.

Catatan

ID Microsoft Entra sebelumnya dikenal sebagai Azure Active Directory (Azure AD).

Mencatat panggilan dan memecahkan masalah koneksi

Anda dapat mencatat panggilan yang dilakukan manajer koneksi OLEDB ke penyedia data eksternal. Anda kemudian dapat memecahkan masalah koneksi yang dilakukan manajer koneksi OLEDB ke sumber data eksternal. Untuk mencatat panggilan yang dilakukan manajer koneksi OLEDB ke penyedia data eksternal, aktifkan pengelogan paket, dan pilih peristiwa Diagnostik di tingkat paket. Untuk informasi selengkapnya, lihat Alat Pemecahan Masalah untuk Eksekusi Paket.

Mengonfigurasi manajer koneksi OLEDB

Anda dapat mengatur properti melalui SSIS Designer, atau secara terprogram. Untuk informasi selengkapnya tentang properti yang bisa Anda atur di SSIS Designer, lihat Mengonfigurasi Pengelola Sambungan OLEDB. Untuk informasi tentang mengonfigurasi pengelola koneksi secara terprogram, lihat dokumentasi untuk kelas T:Microsoft.SqlServer.Dts.Runtime.ConnectionManager di Panduan Pengembang.

Mengonfigurasi pengelola koneksi OLEDB

Gunakan kotak dialog Konfigurasikan Pengelola Sambungan OLEDB untuk menambahkan koneksi ke sumber data. Koneksi ini bisa baru, atau salinan koneksi yang ada.

Catatan

Jika sumber data adalah Microsoft Office Excel 2007, sumber data memerlukan manajer koneksi yang berbeda dari versi Excel sebelumnya. Untuk informasi selengkapnya, lihat Menyambungkan ke Buku Kerja Excel.

Jika sumber data adalah Microsoft Office Access 2007, sumber data memerlukan penyedia OLEDB yang berbeda dari versi Access sebelumnya. Untuk informasi selengkapnya, lihat Menyambungkan ke Database Access.

Untuk mempelajari selengkapnya tentang pengelola koneksi OLEDB, lihat Pengelola Sambungan OLEDB.

Opsi

Koneksi data
Pilih koneksi data OLEDB yang ada dari daftar.

Properti koneksi data
Lihat properti dan nilai untuk koneksi data OLEDB yang dipilih.

Baru
Buat koneksi data OLEDB dengan menggunakan kotak dialog Pengelola Sambungan.

Hapus
Pilih koneksi data, lalu hapus dengan memilih Hapus.

Identitas terkelola untuk autentikasi sumber daya Azure

Saat menjalankan paket SSIS pada runtime integrasi (IR) Azure-SSIS di Azure Data Factory (ADF), Anda dapat menggunakan autentikasi Microsoft Entra dengan identitas terkelola yang ditetapkan sistem atau ditetapkan pengguna untuk ADF Anda untuk mengakses Azure SQL Database atau SQL Managed Instance Anda. Runtime integrasi Azure-SSIS Anda dapat mengakses dan menyalin data dari atau ke database Anda menggunakan identitas terkelola ini.

Catatan

  • Saat Anda mengautentikasi dengan identitas terkelola yang ditetapkan pengguna, runtime integrasi SSIS perlu diaktifkan dengan identitas yang sama. Untuk informasi selengkapnya, lihat Mengaktifkan autentikasi Microsoft Entra untuk runtime integrasi Azure-SSIS.

  • Saat Anda menggunakan autentikasi Microsoft Entra untuk mengakses Azure SQL Database atau Azure SQL Managed Instance, Anda mungkin mengalami masalah yang terkait dengan kegagalan eksekusi paket atau perubahan perilaku yang tidak terduga. Untuk informasi selengkapnya, lihat Fitur dan batasan Microsoft Entra.

Untuk menggunakan autentikasi Microsoft Entra dengan identitas terkelola untuk ADF Anda untuk mengakses server Azure SQL Database, ikuti langkah-langkah berikut:

  1. Provisikan administrator Microsoft Entra untuk server logis Anda di portal Azure, jika Anda belum melakukannya. Administrator Microsoft Entra dapat menjadi pengguna atau grup Microsoft Entra. Jika menetapkan grup sebagai admin, Anda dapat menambahkan identitas terkelola ADF ke grup dan melewati langkah 2 dan 3. Administrator memiliki akses penuh ke server logis Anda untuk Azure SQL Database.

  2. Buat pengguna database mandiri untuk identitas terkelola ADF Anda. Gunakan SQL Server Management Studio (SSMS) untuk menyambungkan ke database dengan pengguna Microsoft Entra yang memiliki setidaknya mengubah izin PENGGUNA APA PUN. Jalankan pernyataan T-SQL berikut:

    CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;

    Jika Anda menggunakan identitas terkelola yang ditetapkan sistem untuk ADF Anda, maka nama identitas terkelola Anda harus menjadi nama ADF Anda. Jika Anda menggunakan identitas terkelola yang ditetapkan pengguna untuk ADF Anda, maka nama identitas terkelola Anda harus menjadi nama identitas terkelola yang ditetapkan pengguna yang ditentukan.

  3. Berikan identitas terkelola untuk ADF Anda izin yang diperlukan, seperti yang biasanya Anda lakukan untuk pengguna SQL. Lihat Peran tingkat database untuk peran yang sesuai. Jalankan pernyataan T-SQL berikut. Untuk opsi lainnya, lihat artikel ini.

    EXEC sp_addrolemember [role name], [your managed identity name];

Untuk menggunakan autentikasi Microsoft Entra dengan identitas terkelola untuk ADF Anda untuk mengakses Azure SQL Managed Instance, ikuti langkah-langkah berikut:

  1. Provisikan administrator Microsoft Entra untuk Azure SQL Managed Instance Anda di portal Azure, jika Anda belum melakukannya. Administrator Microsoft Entra dapat menjadi pengguna atau grup Microsoft Entra. Jika menetapkan grup sebagai admin, Anda dapat menambahkan identitas terkelola ADF ke grup dan melewati langkah 2 dan 3. Administrator memiliki akses penuh ke Azure SQL Managed Instance Anda.

  2. Buat login yang ditetapkan ke identitas terkelola untuk ADF Anda. Di SSMS, sambungkan ke Azure SQL Managed Instance Anda menggunakan akun SQL Server yang merupakan sysadmin. Dalam master database, jalankan pernyataan T-SQL berikut:

    CREATE LOGIN [your managed identity name] FROM EXTERNAL PROVIDER;

    Jika Anda menggunakan identitas terkelola sistem untuk ADF Anda, maka nama identitas terkelola Anda harus menjadi nama ADF Anda. Jika Anda menggunakan identitas terkelola yang ditetapkan pengguna untuk ADF Anda, maka nama identitas terkelola Anda harus menjadi nama identitas terkelola yang ditetapkan pengguna yang ditentukan.

  3. Buat pengguna database mandiri yang mewakili identitas terkelola untuk ADF Anda. Sambungkan ke database dari atau tempat Anda ingin menyalin data menggunakan SSMS dan jalankan pernyataan T-SQL berikut:

    CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;

  4. Berikan identitas terkelola untuk ADF Anda izin yang diperlukan, seperti yang biasanya Anda lakukan untuk pengguna SQL. Jalankan pernyataan T-SQL berikut. Untuk opsi lainnya, lihat artikel ini.

    ALTER ROLE [role name e.g., db_owner] ADD MEMBER [your managed identity name];

Anda kemudian dapat mengonfigurasi penyedia OLEDB di manajer koneksi OLEDB Anda. Berikut adalah opsi untuk melakukan ini:

  • Konfigurasikan pada waktu desain. Di SSIS Designer, klik dua kali manajer koneksi OLEDB Anda untuk membuka jendela Pengelola Sambungan. Di daftar drop-down Penyedia, pilih Driver Microsoft OLEDB untuk SQL Server.

    Catatan

    Penyedia lain dalam daftar drop-down mungkin tidak mendukung autentikasi Microsoft Entra dengan identitas terkelola ADF Anda.

  • Konfigurasikan pada waktu proses. Saat Anda menjalankan paket melalui aktivitas SSMS atau Jalankan Paket SSIS di alur ADF, temukan properti pengelola koneksi ConnectionString untuk manajer koneksi OLEDB. Perbarui properti Provider koneksi ke MSOLEDBSQL (yaitu Driver Microsoft OLEDB untuk SQL Server).

    Data Source=serverName;Initial Catalog=databaseName;Provider=MSOLEDBSQL;...

Anda sekarang dapat mengonfigurasi autentikasi Microsoft Entra dengan identitas terkelola ADF Anda di manajer koneksi OLEDB. Berikut adalah opsi untuk melakukan ini:

  • Konfigurasikan pada waktu desain. Di SSIS Designer, klik kanan pada manajer koneksi OLEDB Anda, dan pilih Properti. Perbarui properti ConnectUsingManagedIdentity ke True.

    Catatan

    Saat ini, properti ConnectUsingManagedIdentity pengelola koneksi tidak berlaku saat Anda menjalankan paket di SSIS Designer atau di SQL Server, yang menunjukkan bahwa autentikasi dengan identitas terkelola ADF Anda tidak berfungsi.

  • Konfigurasikan pada waktu proses. Saat Anda menjalankan paket melalui aktivitas SSMS atau Jalankan Paket SSIS di alur ADF, temukan manajer koneksi OLEDB dan perbarui propertinya ConnectUsingManagedIdentity ke True.

    Catatan

    Pada Runtime integrasi Azure-SSIS, semua metode autentikasi lainnya (misalnya, keamanan dan kata sandi terintegrasi) yang telah dikonfigurasi sebelumnya pada manajer koneksi OLEDB Anda ditimpa saat menggunakan autentikasi Microsoft Entra dengan identitas terkelola.

Untuk mengonfigurasi autentikasi Microsoft Entra dengan identitas terkelola untuk ADF Anda pada paket yang ada, cara yang disukai adalah dengan membangun kembali proyek SSIS Anda dengan SSIS Designer terbaru setidaknya sekali. Sebarkan ulang proyek SSIS Anda untuk berjalan di Runtime integrasi Azure-SSIS, sehingga properti ConnectUsingManagedIdentity pengelola koneksi baru secara otomatis ditambahkan ke semua manajer koneksi OLEDB dalam proyek Anda. Atau, Anda dapat menggunakan penimpaan properti, dengan jalur properti \Package.Connections[{nama pengelola koneksi Anda}]. Properti[ConnectUsingManagedIdentity] ditetapkan pada True waktu proses.

Lihat juga