Freigeben über

ADO.NET-Verbindungs-Manager

  • Artikel

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

Ein ADO.NET -Verbindungs-Manager ermöglicht einem Paket den Zugriff auf Datenquellen mithilfe eines .NET-Anbieters. In der Regel verwenden Sie diesen Verbindungs-Manager für den Zugriff auf Datenquellen wie Microsoft SQL Server. Sie können darüber hinaus auch auf Datenquellen zugreifen, die durch OLE DB und XML in benutzerdefinierten Tasks verfügbar gemacht werden, die mit einer Programmiersprache wie C# in verwaltetem Code geschrieben sind.

Wenn Sie einem Paket einen ADO.NET-Verbindungs-Manager hinzufügen, erstellt SQL Server Integration Services einen Verbindungs-Manager, der zur Runtime als ADO.NET-Verbindung aufgelöst wird. Es werden die Eigenschaften des Verbindungs-Managers festgelegt und der Verbindungs-Manager wird der Sammlung Verbindungen im Paket hinzugefügt.

Die ConnectionManagerType-Eigenschaft des Verbindungs-Managers ist auf ADO.NET festgelegt. Der Wert von ConnectionManagerType ist qualifiziert, um den Namen des .NET-Anbieters einzuschließen, der vom Verbindungs-Manager verwendet wird.

Hinweis

Microsoft Entra ID war zuvor als Azure Active Directory (Azure AD) bekannt.

Problembehandlung für den ADO.NET-Verbindungs-Manager

Microsoft.Data.SqlClient-Treiber wird in SQL 2022 und unten nicht unterstützt. Wenn Sie die msi- oder Microsoft Entra ID-basierte Authentifizierungsmethode benötigen, verwenden Sie stattdessen den Oledb-Verbindungs-Manager.

Sie können die vom ADO.NET -Verbindungs-Manager an externe Datenanbieter gerichteten Aufrufe protokollieren. Anschließend können Sie Probleme bei Verbindungen behandeln, die vom ADO.NET-Verbindungs-Manager mit externen Datenquellen hergestellt werden. Aktivieren Sie zum Protokollieren der vom ADO.NET-Verbindungs-Manager an externe Datenprovider 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.

Daten bestimmter SQL Server-Datumsdatentypen generieren beim Lesen durch einen ADO.NET-Verbindungs-Manager die in der folgenden Tabelle dargestellten Ergebnisse.

SQL Server-Datentyp Ergebnis
time, datetimeoffset Das Paket erzeugt einen Fehler, sofern das Paket keine parametrisierten SQL-Befehle verwendet. Um parametrisierte SQL-Befehle zu verwenden, verwenden Sie den Task SQL ausführen im Paket. Weitere Informationen finden Sie unter SQL ausführen (Task) und Parameter und Rückgabecodes im Task „SQL ausführen“.
datetime2 Der ADO.NET -Verbindungs-Manager schneidet den Millisekundenwert ab.

Hinweis

Weitere Informationen zu SQL Server-Datentypen sowie deren Zuordnung zu Integration Services-Datentypen finden Sie unter Datentypen (Transact-SQL) und Integration Services-Datentypen.

Konfiguration des ADO.NET-Verbindungs-Managers

Sie können Eigenschaften mit dem SSIS-Designer oder programmgesteuert festlegen.

  • Stellen Sie eine Verbindungszeichenfolge bereit, die die Anforderungen des ausgewählten .NET-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.

Viele der Konfigurationsoptionen des ADO.NET -Verbindungs-Managers hängen vom .NET-Anbieter ab, der vom Verbindungs-Manager verwendet wird.

Weitere Informationen zu den Eigenschaften, die Sie im SSIS-Designer festlegen können, finden Sie unter Konfigurieren des ADO.NET-Verbindungs-Managers.

Weitere Informationen zum programmgesteuerten Konfigurieren eines Verbindungs-Managers finden Sie unter ConnectionManager und Programmgesteuertes Hinzufügen von Verbindungenfestgelegt.

Konfigurieren des ADO.NET-Verbindungs-Managers

Verwenden Sie das Dialogfeld ADO.NET-Verbindungs-Manager konfigurieren, um eine Verbindung zu einer Datenquelle hinzuzufügen, auf die mithilfe eines .NET Framework-Datenanbieter zugegriffen werden kann. Ein solcher Anbieter ist beispielsweise der SqlClient-Anbieter. Der Verbindungs-Manager kann eine vorhandene Verbindung verwenden, oder Sie können eine neue erstellen.

Weitere Informationen zum ADO.NET-Verbindungs-Manager finden Sie unter ADO.NET Connection Manager.

Tastatur

Datenverbindungen
Wählen Sie in der Liste eine vorhandene ADO.NET.Datenverbindung aus.

Datenverbindungseigenschaften
Zeigt Eigenschaften und Werte für die ausgewählte ADO.NET-Datenverbindung an.

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

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

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

Beim Ausführen von SSIS-Paketen in Azure-SSIS Integration Runtime (IR) in Azure Data Factory (ADF) können Sie die Microsoft Entra-Authentifizierung mit der verwalteten Identität für Ihre ADF verwenden, um auf Azure SQL Database bzw. 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.

Hinweis

Wenn Sie die benutzerseitig zugewiesene verwaltete Identität zur Authentifizierung verwenden, muss die SSIS-Integrationslaufzeit mit derselben Identität aktiviert werden. Weitere Informationen finden Sie unter Microsoft Entra-Authentifizierung für die Azure-SSIS Integration Runtime aktivieren.

Führen Sie die folgenden Schritte aus, um ihrer ADF den Zugriff auf die Azure SQL-Datenbank mithilfe der verwalteten Identität zu ermöglichen:

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

  2. Erstellen Sie einen Benutzer einer eigenständigen Datenbank, um die zugewiesene verwaltete Identität für Ihre ADF anzugeben. Stellen Sie eine Verbindung mit der Datenbank her, aus der bzw. in die Sie Daten mithilfe von SQL Server Management Studio (SSMS) mit einem Microsoft Entra-Benutzer kopieren möchten, 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 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 eine verwaltete 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 Benutzer oder eine Gruppe sein. Wenn Sie eine Gruppe als Administrator zuweisen und Ihre verwaltete Identität Mitglied dieser Gruppe ist, können Sie die Schritte 2 bis 4 überspringen. Der Administrator hat Vollzugriff auf Ihre verwaltete Instanz.

  2. Erstellen Sie eine Anmeldung für die verwaltete Identität Ihrer ADF. Stellen Sie in SSMS mithilfe eines Kontos mit sysadmin-Berechtigungen oder dem Microsoft Entra-Administrator eine Verbindung mit Ihrer verwalteten Instanz her. Führen Sie in der master-Datenbank die 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 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 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];

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

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

    Hinweis

    Die Eigenschaft ConnectUsingManagedIdentity des Verbindungsmanagers wird nicht wirksam, wenn Sie Ihr Paket in SSIS Designer oder auf SQL Server ausführen, was darauf hinweist, dass die Microsoft Entra-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 ADO.NET-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 ADO.NET-Verbindungs-Manager vorkonfiguriert sind, überschrieben, wenn die Microsoft Entra-Authentifizierung mit der verwalteten Identität für Ihre ADF verwendet wird.

Um die Microsoft Entra-Authentifizierung von verwalteten Identitäten für vorhandene Pakete zu konfigurieren, besteht die bevorzugte Methode darin, das SSIS-Projekt mindestens einmal mit dem neuesten SSIS-Designer neu zu erstellen. Stellen Sie Ihr SSIS-Projekt erneut in Ihrer Azure-SSIS IR bereit, sodass die neue Eigenschaft ConnectUsingManagedIdentity des Verbindungs-Managers automatisch allen ADO.NET-Verbindungs-Managern in Ihrem Projekt hinzugefügt wird. Alternative können Sie Überschreibungen von Eigenschaften direkt mit dem Eigenschaftenpfad \Package.Connections[{Name Ihres Verbindungs-Managers}].Properties[ConnectUsingManagedIdentity] verwenden, dem zur Runtime True zugewiesen wird.

Siehe auch