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. Der Task „SQL ausführen“ kann diesen Verbindungs-Manager verwenden, um eine Verbindung mit einer SQL Server-Datenbank herzustellen und Abfragen auszuführen.

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 mit dem Verbindungs-Manager erstellte Verbindung zur Laufzeit 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 Verbindungsprobleme beheben, die der OLE DB-Verbindungs-Manager mit externen Datenquellen verursacht. 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.

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.

Optionen

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-Datenbank 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 mit einem Microsoft Entra-Benutzer eine Verbindung mit der Datenbank 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 Ihrer ADF die erforderlichen Berechtigungen, wie Sie sie SQL-Benutzern normalerweise erteilen. 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. Stellen Sie einen Microsoft Entra-Administrator bereit für Ihre Azure SQL Managed Instance im Azure-Portal, falls Sie dies noch nicht getan haben. 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 Sie eine Anmeldung, die der verwalteten Identität Ihrer 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 Sie einen enthaltenen Datenbankbenutzer, der die verwaltete Identität für Ihre ADF-Instanz darstellt. 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 Ihrer ADF die erforderlichen Berechtigungen, wie Sie es normalerweise für SQL-Benutzer tun. 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:

• Beim Entwurf konfigurieren. 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 Drop-down-Liste unterstützen die Microsoft Entra-Authentifizierung mit der verwalteten Identität Ihrer ADF möglicherweise nicht.

• Konfigurieren zur Laufzeit. Wenn Sie Ihr Paket über SSMS oder Ausführen eines SSIS-Pakets mit der Aktivität „SSIS-Paket ausführen“ in ADF 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:

• Beim Entwurf konfigurieren. 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 die Aktivität „SSIS-Paket ausführen“ in der ADF-Pipeline 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 bereit, damit es auf Azure-SSIS IR ausgeführt wird, sodass die neue Eigenschaft des Verbindungs-Managers ConnectUsingManagedIdentity 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.

Siehe auch

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