ADO.NET verbindingsbeheer

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

Met een ADO.NET verbindingsbeheer kan een pakket toegang krijgen tot gegevensbronnen met behulp van een .NET-provider. Normaal gesproken gebruikt u dit verbindingsbeheer voor toegang tot gegevensbronnen zoals Microsoft SQL Server. U kunt ook toegang krijgen tot gegevensbronnen die beschikbaar zijn via OLE DB en XML in aangepaste taken die zijn geschreven in beheerde code, met behulp van een taal zoals C#.

Wanneer u een ADO.NET verbindingsbeheer aan een pakket toevoegt, maakt SQL Server Integration Services een verbindingsbeheer dat tijdens runtime wordt omgezet als een ADO.NET-verbinding. Hiermee worden de eigenschappen van verbindingsbeheer ingesteld en wordt het verbindingsbeheer toegevoegd aan de verzameling Verbindingen in het pakket.

De ConnectionManagerType eigenschap van het verbindingsbeheer is ingesteld op ADO.NET. De waarde van ConnectionManagerType is gekwalificeerd om de naam op te nemen van de .NET-provider die door de verbindingsbeheerder wordt gebruikt.

Probleemoplossing voor ADO.NET verbindingsbeheer

U kunt de aanroepen die de ADO.NET verbindingsbeheer uitvoert, registreren bij externe gegevensproviders. Vervolgens kunt u problemen oplossen met de verbindingen die de ADO.NET verbindingsbeheer maakt met externe gegevensbronnen. Als u de aanroepen wilt registreren die de ADO.NET verbindingsbeheer uitvoert bij externe gegevensproviders, schakelt u logboekregistratie van pakketten in en selecteert u de diagnostische gebeurtenis op pakketniveau. Zie Hulpprogramma's voor probleemoplossing voor pakketuitvoering voor meer informatie.

Wanneer gegevens van bepaalde SQL Server-datumgegevenstypen worden gelezen door een ADO.NET verbindingsbeheer, worden de resultaten gegenereerd die worden weergegeven in de volgende tabel.

configuratie van ADO.NET verbindingsbeheer

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

• Geef een specifieke verbindingsreeks op die is geconfigureerd om te voldoen aan de vereisten van de geselecteerde .NET-provider.

• Neem, afhankelijk van de provider, de naam op van de gegevensbron waarmee verbinding moet worden gemaakt.

• Geef de beveiligingsreferenties op die geschikt zijn voor de geselecteerde provider.

• Geef aan of de verbinding die is gemaakt vanuit het verbindingsbeheer, tijdens runtime wordt bewaard.

Veel configuratieopties van het ADO.NET verbindingsbeheer zijn afhankelijk van de .NET-provider die door het verbindingsbeheer wordt gebruikt.

Voor informatie over het programmatisch configureren van een verbindingsbeheer, raadpleegt u ConnectionManager en Verbindingen Programmeren Toevoegen.

ADO.NET verbindingsbeheer configureren

Gebruik het dialoogvenster ADO.NET Verbindingsbeheer configureren om een verbinding toe te voegen aan een gegevensbron die toegankelijk is via een .NET Framework-gegevensprovider. Een dergelijke provider is bijvoorbeeld de SqlClient-provider. De verbindingsbeheerder kan een bestaande verbinding gebruiken of u kunt een nieuwe maken.

Zie ADO.NET Verbindingsbeheer voor meer informatie over het ADO.NET verbindingsbeheer.

Opties

Microsoft SqlClient-gegevensprovider gebruiken

Microsoft SqlClient Data Provider wordt ondersteund in SQL Server 2025 (17.x) Preview en latere versies. Voor SQL Server 2022 (16.x) en eerdere versies gebruikt u Oledb Connection Manager als u msi- of Microsoft Entra ID-verificatie nodig hebt.

Voor pakketontwerp gebruikt u SQL Server Integration Services Projects 2022 of hoger.

Zie Verbinding maken met Azure SQL met Microsoft Entra-verificatie en SqlClient voor hulp bij het configureren van Microsoft Entra-verificatiemodi.

Als u .NET API Microsoft.SqlServer.Dts.Runtime-naamruimte wilt gebruiken, moet u het volgende doen:

1. Voeg de volgende verwijzing toe voor uw cs-project:

   <ItemGroup>
     <PackageReference Include="Microsoft.Data.SqlClient" Version="5.0.0" />
   </ItemGroup>
   

2. Voeg de volgende configuratie toe aan uw {processname}-.exe.config:

   <system.data>
       <DbProviderFactories>
           <add name="SqlClient Data Provider" invariant="Microsoft.Data.SqlClient" description=".Net Framework Data Provider for SqlServer" type="Microsoft.Data.SqlClient.SqlClientFactory, Microsoft.Data.SqlClient" />
       </DbProviderFactories>
   </system.data>
   

   Als u .NET API Microsoft.SqlServer.Dts.Runtime-naamruimte gebruikt bij het uitvoeren van een upgrade naar SQL 2025, moeten uw projecten de verwijzingen bijwerken en opnieuw bouwen voor onderstaande gevallen:

3. SSIS-pakket heeft SQL-taak uitgevoerd

   Voeg de volgende verwijzing van Microsoft.Data.SqlClient toe aan uw project en bouw het project opnieuw op:

   <ItemGroup>
     <PackageReference Include="Microsoft.Data.SqlClient" Version="5.0.0" />
   </ItemGroup>
   

4. SSIS-pakket bevat de volgende SSIS-taken die afhankelijk zijn van SQL Server Management Objects (SMO): Databasetaak Overdragen, Taak Overdrachtsfoutberichten, Taak Overdrachttaken, Aanmeldingstaak Overdragen, Taak Hoofdopgeslagen Procedures Overdragen, SQL Server-objecten Overdragen Taak, Onderhoud Opschonen Taak, Back-up Databasetaak Maken, Geschiedenis Opschonen Taak, Operator Waarschuwen Taak, Database-integriteit Controleren Taak, Indextaak Herbouwen, Databasetaak Verkleinen, Indextaak Opnieuw Ordenen, SQL Server Agent Job Uitvoeren Taak, T-SQL-instructietaak Uitvoeren en Statistieken Bijwerken Taak, voeg de volgende verwijzing toe aan het project en bouw het project opnieuw op.

   <ItemGroup><PackageReference Include="Microsoft.SqlServer.SqlManagementObjects" Version="172.74.0" />  </ItemGroup>
   

Beheerde identiteiten voor authenticatie van Azure-resources

Wanneer u SSIS-pakketten uitvoert op Azure-SSIS Integration Runtime (IR) in Azure Data Factory (ADF), kunt u Microsoft Entra-verificatie gebruiken met de beheerde identiteit voor uw ADF voor toegang tot Azure SQL Database of SQL Managed Instance. Uw Azure-SSIS IR heeft toegang tot en kopieert gegevens uit of naar uw database met behulp van deze beheerde identiteit.

Voer de volgende stappen uit om uw ADF toegang te geven tot Azure SQL Database met behulp van de beheerde identiteit:

1. Richt een Microsoft Entra-beheerder in voor uw logische server in Azure SQL Database via Azure Portal, als u dit nog niet hebt gedaan. De Microsoft Entra-beheerder kan een gebruiker of groep zijn. Als u een groep toewijst als de beheerder en de beheerde identiteit van uw ADF lid is van die groep, kunt u stap 2 en 3 overslaan. De beheerder heeft volledige toegang tot uw logische server.

2. Maak een ingesloten databasegebruiker om de beheerde identiteit weer te geven die is toegewezen aan uw ADF. Maak verbinding met de database van of waarmee u gegevens wilt kopiëren met behulp van SQL Server Management Studio (SSMS) met een Microsoft Entra-gebruiker met ten minste ALTER ANY USER-machtigingen. Voer de volgende T-SQL-instructie uit:

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

   Als u de door het systeem toegewezen beheerde identiteit voor uw ADF gebruikt, is de naam van uw beheerde identiteit uw ADF-naam. Als u een door de gebruiker toegewezen beheerde identiteit voor uw ADF gebruikt, is de naam van uw beheerde identiteit de naam van de beheerde identiteit.

3. Geef de beheerde identiteit van uw ADF de vereiste machtigingen, zoals u normaal gesproken doet voor SQL-gebruikers. Raadpleeg rollen op databaseniveau voor de juiste rollen. Voer de volgende T-SQL-instructie uit. Zie dit artikel voor meer opties.

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

Als u een beheerde identiteit wilt gebruiken die is toegewezen aan uw ADF voor toegang tot Azure SQL Managed Instance, voert u de volgende stappen uit:

1. Richt een Microsoft Entra-beheerder in voor uw Azure SQL Managed Instance in Azure Portal als u dit nog niet hebt gedaan. De Microsoft Entra-beheerder kan een gebruiker of groep zijn. Als u een groep toewijst als de beheerder en uw beheerde identiteit lid is van die groep, kunt u stap 2 tot en met 4 overslaan. De beheerder heeft volledige toegang tot uw beheerde exemplaar.

2. Maak een aanmelding voor de beheerde identiteit van uw ADF. Maak in SSMS verbinding met uw beheerde exemplaar met behulp van een account met sysadmin-machtigingen of de Microsoft Entra-beheerder. Voer in de master database de volgende T-SQL-instructie uit:

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

   Als u de door het systeem toegewezen beheerde identiteit voor uw ADF gebruikt, is de naam van uw beheerde identiteit uw ADF-naam. Als u een door de gebruiker toegewezen beheerde identiteit voor uw ADF gebruikt, is de naam van uw beheerde identiteit de naam van de beheerde identiteit.

3. Maak een ingesloten databasegebruiker die de beheerde identiteit voor uw ADF vertegenwoordigt. Maak verbinding met de database waaruit u gegevens wilt kopiëren met behulp van SSMS en voer de volgende T-SQL-instructie uit:

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

4. Geef de beheerde identiteit van uw ADF de vereiste machtigingen, zoals u normaal gesproken doet voor SQL-gebruikers. Voer de volgende T-SQL-instructie uit. Zie dit artikel voor meer opties.

   ALTER ROLE [role name, for example, db_owner] ADD MEMBER [your managed identity name];
   

Ten slotte kunt u Microsoft Entra-verificatie configureren met de beheerde identiteit van uw ADF in het ADO.NET verbindingsbeheer. Dit zijn de opties om dit te doen:

• Configureren tijdens het ontwerp. Klik in SSIS Designer met de rechtermuisknop op uw ADO.NET verbindingsbeheer en selecteer Eigenschappen. Werk de eigenschap ConnectUsingManagedIdentity bij naar True.

  Opmerking

  De eigenschap ConnectUsingManagedIdentity Verbindingsbeheer wordt niet van kracht wanneer u uw pakket uitvoert in SSIS Designer of op SQL Server, wat aangeeft dat Microsoft Entra-verificatie met de beheerde identiteit van uw ADF niet werkt.

• Configureren tijdens runtime. Wanneer u uw pakket uitvoert via SSMS of SSIS-pakketactiviteit uitvoeren in de ADF-pijplijn, zoekt u het ADO.NET verbindingsbeheer en werkt u de eigenschap bij ConnectUsingManagedIdentity naar True.

  Opmerking

  Op Azure-SSIS IR worden alle andere verificatiemethoden (bijvoorbeeld geïntegreerde beveiliging en wachtwoord) die vooraf zijn geconfigureerd in uw ADO.NET verbindingsbeheer, overschreven bij het gebruik van Microsoft Entra-verificatie met de beheerde identiteit van uw ADF.

Als u Microsoft Entra-verificatie wilt configureren met de beheerde identiteit van uw ADF op uw bestaande pakketten, kunt u het SSIS-project het beste ten minste één keer herbouwen met de nieuwste SSIS Designer . Implementeer uw SSIS-project opnieuw om uit te voeren op Azure-SSIS IR, zodat de nieuwe eigenschap ConnectUsingManagedIdentity verbindingsbeheer automatisch wordt toegevoegd aan alle ADO.NET verbindingsbeheerders in uw project. U kunt ook eigenschapoverschrijvingen rechtstreeks gebruiken met het eigenschapspad \Package.Connections[{de naam van uw verbindingsbeheer}].Properties[ConnectUsingManagedIdentity] toegekend aan True tijdens uitvoeringstijd.

Verwante inhoud

• ADO NET-bron
• ADO NET-bestemming
• SSIS-verbindingen (Integration Services)