OLEDB-Verbindungs-Manager

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Durch einen OLEDB-Verbindungs-Manager kann ein Paket mithilfe eines OLEDB-Anbieters eine Verbindung mit einer Datenquelle herstellen. Beispielsweise kann ein OLEDB-Verbindungs-Manager, der eine Verbindung mit SQL Server herstellt, den Microsoft OLEDB-Anbieter für SQL Server verwenden.

Mehrere Tasks und Datenflusskomponenten von SQL Server Integration Services verwenden einen OLEDB-Verbindungs-Manager. Beispielsweise verwenden die OLEDB-Quelle und das OLEDB-Ziel diesen Verbindungs-Manager zum Extrahieren und Laden von Daten. Ein Paket mit einem Task „SQL ausführen“ kann diesen Verbindungs-Manager zum Herstellen einer Verbindung mit einer SQL Server -Datenbank zum Ausführen von Abfragen verwenden.

Sie können den OLEDB-Verbindungs-Manager auch für den Zugriff auf OLEDB-Datenquellen in benutzerdefinierten Tasks verwendet, die in nicht verwaltetem Code in einer Programmiersprache wie z. B. C++ geschrieben sind.

Wenn Sie einem Paket einen OLEDB-Verbindungs-Manager hinzufügen, erstellt Integration Services einen Verbindungs-Manager, der zur Runtime in eine OLEDB-Verbindung aufgelöst wird, die Eigenschaften des Verbindungs-Managers festlegt und den Verbindungs-Manager der Sammlung Verbindungen im Paket hinzufügt.

Die ConnectionManagerType-Eigenschaft des Verbindungs-Managers ist auf OLEDB festgelegt.

Sie haben folgende Möglichkeiten, um den OLEDB-Verbindungs-Manager zu konfigurieren:

• Stellen Sie eine Verbindungszeichenfolge bereit, die die Anforderungen des ausgewählten Anbieters erfüllt.

• Schließen Sie in Abhängigkeit vom Anbieter den Namen der Datenquelle ein, mit der eine Verbindung hergestellt werden soll.

• Stellen Sie entsprechende Sicherheitsanmeldeinformationen für den ausgewählten Anbieter bereit.

• Geben Sie an, ob die im Verbindungs-Manager erstellte Verbindung zur Runtime beibehalten wird.

Protokollieren von Aufrufen und Behandeln von Verbindungsproblemen

Sie können die vom OLEDB-Verbindungs-Manager an externe Datenanbieter gerichteten Aufrufe protokollieren. Anschließend können Sie Probleme bei Verbindungen behandeln, die vom OLEDB-Verbindungs-Manager mit externen Datenquellen hergestellt werden. Aktivieren Sie zum Protokollieren der vom OLEDB-Verbindungs-Manager an externe Datenanbieter gerichteten Aufrufe die Paketprotokollierung, und wählen Sie das Diagnostic-Ereignis auf Paketebene aus. Weitere Informationen finden Sie unter Behandeln von Problemen mit Paketausführungstools.

Konfigurieren des OLEDB-Verbindungs-Managers

Sie können Eigenschaften mit dem SSIS-Designer oder programmgesteuert festlegen. Weitere Informationen zu den Eigenschaften, die Sie im SSIS-Designer festlegen können, finden Sie unter Konfigurieren des OLEDB-Verbindungs-Managers. Informationen zum programmgesteuerten Konfigurieren eines Verbindungs-Managers finden Sie in der Dokumentation zur T:Microsoft.SqlServer.Dts.Runtime.ConnectionManager -Klasse im Entwicklerhandbuch.

Konfigurieren des OLEDB-Verbindungs-Managers

Über das Dialogfeld OLEDB-Verbindungs-Manager konfigurieren können Sie eine Verbindung einer Datenquelle hinzufügen. Dies kann eine neue Verbindung oder eine Kopie einer vorhandenen Verbindung sein.

Weitere Informationen zum OLEDB-Verbindungs-Manager finden Sie unter OLEDB-Verbindungs-Manager.

Tastatur

Datenverbindungen
Wählen Sie aus der Liste eine vorhandene OLEDB-Datenverbindung aus.

Datenverbindungseigenschaften
Zeigt die Eigenschaften und Werte der ausgewählten OLEDB-Datenverbindung an.

Neu
Erstellen Sie mithilfe des Dialogfelds Verbindungs-Manager eine OLEDB-Datenverbindung.

Löschen
Wählen Sie eine Datenverbindung aus, und löschen Sie sie mithilfe von Löschen.

Verwaltete Identitäten für die Authentifizierung von Azure-Ressourcen

Wenn Sie SSIS-Pakete auf Azure-SSIS Integration Runtime (IR) in Azure Data Factory (ADF) ausführen, können Sie die Microsoft Entra-Authentifizierung mit system- oder benutzerzugeordneten verwalteten Identitäten für Ihre ADF verwenden, um auf Ihre Azure SQL-Datenbank oder SQL Managed Instance zuzugreifen. Ihre Azure-SSIS IR kann mithilfe dieser verwalteten Identität auf Daten in Ihrer Datenbank zugreifen und Daten daraus oder dort hinein kopieren.

Um die Microsoft Entra-Authentifizierung mit der verwalteten Identität für Ihre ADF zu verwenden, um auf den Azure SQL Database Server zuzugreifen, führen Sie die folgenden Schritte aus:

1. Bereitstellen eines Microsoft Entra-Administrators für Ihren logischen Server im Azure-Portal, sofern dies noch nicht geschehen ist. Der Microsoft Entra-Administrator kann ein Microsoft Entra-Benutzer oder eine Gruppe sein. Wenn Sie eine Gruppe als Administrator zuweisen, können Sie der Gruppe die verwaltete Identität Ihrer ADF hinzufügen und die Schritte 2 und 3 überspringen. Der Administrator hat Vollzugriff auf Ihren logischen Server für die Azure SQL-Datenbank.

2. Erstellen Sie einen eigenständige Datenbanknutzer für die verwaltete ADF-Identität. Verwenden Sie SQL Server Management Studio (SSMS), um eine Verbindung mit der Datenbank mit einem Microsoft Entra-Benutzer herzustellen, der mindestens ÜBER DIE Berechtigung ALTER ANY USER verfügt. Führen Sie folgende T-SQL-Anweisung aus:

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

   Wenn Sie die vom System verwaltete Identität für Ihre ADF verwenden, sollte der Name Ihrer verwalteten Identität Ihr ADF-Name sein. Wenn Sie eine benutzerseitig zugewiesene verwaltete Identität für Ihre ADF verwenden, sollte der Name Ihrer verwalteten Identität der Name der angegebenen benutzerseitig zugewiesenen verwalteten Identität sein.

3. Erteilen Sie der verwalteten Identität für Ihre ADF die erforderlichen Berechtigungen wie normalerweise SQL-Benutzern. Informationen zu den entsprechenden Rollen finden Sie unter Rollen auf Datenbankebene. Führen Sie folgende T-SQL-Anweisung aus. Weitere Optionen finden Sie in diesem Artikel.

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

Führen Sie die folgenden Schritte aus, um die Microsoft Entra-Authentifizierung mit der angegebenen verwalteten Identität für Ihre ADF für den Zugriff auf Azure SQL Managed Instance zu verwenden:

1. Bereitstellen eines Microsoft Entra-Administrators für Ihre Azure SQL Managed Instance im Azure-Portal bereit, sofern dies noch nicht geschehen ist. Der Microsoft Entra-Administrator kann ein Microsoft Entra-Benutzer oder eine Gruppe sein. Wenn Sie eine Gruppe als Administrator zuweisen, können Sie der Gruppe die verwaltete Identität Ihrer ADF hinzufügen und die Schritte 2 und 3 überspringen. Der Administrator hat Vollzugriff auf Ihre Azure SQL Managed Instance.

2. Erstellen einer Anmeldung, die der angegebenen verwalteten Identität für Ihre ADF zugewiesen ist. Stellen Sie in SSMS über ein SQL Server-Konto (ein Sysadmin-Konto) eine Verbindung mit Azure SQL Managed Instance her. Führen Sie in der master-Datenbank folgende T-SQL-Anweisung aus:

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

   Wenn Sie die vom System verwaltete Identität für Ihre ADF verwenden, sollte der Name Ihrer verwalteten Identität Ihr ADF-Name sein. Wenn Sie eine benutzerseitig zugewiesene verwaltete Identität für Ihre ADF verwenden, sollte der Name Ihrer verwalteten Identität der Name der angegebenen benutzerseitig zugewiesenen verwalteten Identität sein.

3. Erstellen eines Benutzers einer eigenständigen Datenbank, um die verwaltete Identität für Ihre ADF anzugeben. Stellen Sie eine Verbindung mit der Datenbank her, aus der bzw. in die Sie Daten mit SSMS kopieren möchten, und führen Sie folgende T-SQL-Anweisung aus:

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

4. Erteilen Sie der verwalteten Identität für Ihre ADF die erforderlichen Berechtigungen wie normalerweise SQL-Benutzern. Führen Sie folgende T-SQL-Anweisung aus. Weitere Optionen finden Sie in diesem Artikel.

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

Anschließend können Sie den OLEDB-Anbieter in Ihrem OLEDB-Verbindungs-Manager konfigurieren. Es gibt dafür folgende Optionen:

• Konfigurieren zur Entwurfszeit. Doppelklicken Sie im SSIS-Designer auf den OLEDB-Verbindungs-Manager, um das Fenster Verbindungs-Manager zu öffnen. Wählen Sie in der Dropdownliste Anbieter die Option Microsoft OLEDB-Treiber für SQL Server aus.

  Hinweis

  Andere Anbieter in der Dropdownliste bieten möglicherweise keine Unterstützung für die Microsoft Entra-Authentifizierung der verwalteten Identität Ihrer ADF.

• Konfigurieren zur Laufzeit. Wenn Sie Ihr Paket über SSMS oder Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“ in Azure Data Factory ausführen, suchen Sie die Verbindungs-Manager-Eigenschaft ConnectionString für den OLEDB-Verbindungs-Manager. Aktualisieren Sie die Verbindungseigenschaft Provider auf MSOLEDBSQL (d. h. Microsoft OLEDB-Treiber für SQL Server).

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

Sie können jetzt die Microsoft Entra-Authentifizierung mit der verwalteten Identität Ihrer ADF im OLEDB-Verbindungs-Manager konfigurieren. Es gibt dafür folgende Optionen:

• Konfigurieren zur Entwurfszeit. Klicken Sie im SSIS-Designer mit der rechten Maustaste auf den OLEDB-Verbindungs-Manager, und wählen Sie Eigenschaften aus. Aktualisieren Sie die Eigenschaft ConnectUsingManagedIdentity auf True.

  Hinweis

  Derzeit hat die Verbindungs-Manager-Eigenschaft ConnectUsingManagedIdentity keine Auswirkung, wenn Sie Ihr Paket in SSIS Designer oder auf SQL Server ausführen, was bedeutet, dass die Authentifizierung mit der verwalteten Identität Ihrer ADF nicht funktioniert.

• Konfigurieren zur Laufzeit. Wenn Sie Ihr Paket über SSMS oder Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“ in Azure Data Factory ausführen, suchen Sie den OLEDB-Verbindungs-Manager, und aktualisieren Sie dessen Eigenschaft ConnectUsingManagedIdentity auf True.

  Hinweis

  In Azure-SSIS IR werden alle anderen Authentifizierungsmethoden (z. B. integrierte Sicherheit und Kennwort), die im OLEDB-Verbindungs-Manager vorkonfiguriert sind, überschrieben, wenn die Microsoft Entra-Authentifizierung mit der verwalteten Identität verwendet wird.

Um die Microsoft Entra-Authentifizierung mit der verwalteten Identität für Ihre ADF in Ihren vorhandenen Paketen zu konfigurieren, sollten Sie Ihr SSIS-Projekt am besten mindestens einmal mit dem aktuellen SSIS-Designer neu erstellen. Stellen Sie Ihr SSIS-Projekt erneut in Ihrer Azure-SSIS IR bereit, sodass die neue Eigenschaft ConnectUsingManagedIdentity des Verbindungs-Managers automatisch allen OLEDB-Verbindungs-Managern in Ihrem Projekt hinzugefügt wird. Alternativ können Sie mit Überschreibungen von Eigenschaften mit dem Eigenschaftenpfad \Package.Connections[{Name Ihres Verbindungs-Managers}].Properties[ConnectUsingManagedIdentity] verwenden, der zur Runtime True zugewiesen wird.

Weitere Informationen

• OLE DB-Quelle
• OLE DB-Ziel
• Integration Services-Verbindungen (SSIS)