správce připojení ADO.NET

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Správce připojení ADO.NET umožňuje balíčku přístup ke zdrojům dat pomocí poskytovatele .NET. Tento správce připojení obvykle používáte pro přístup ke zdrojům dat, jako je Microsoft SQL Server. Ke zdrojům dat vystaveným prostřednictvím OLE DB a XML můžete přistupovat také ve vlastních úlohách, které jsou napsané ve spravovaném kódu, pomocí jazyka, jako je C#.

Když do balíčku přidáte správce připojení ADO.NET, služba SQL Server Integration Services vytvoří správce připojení, který se za běhu vyhodnocuje jako připojení ADO.NET. Nastaví vlastnosti správce připojení a přidá správce připojení do kolekce Connections v balíčku.

Vlastnost ConnectionManagerType správce připojení je nastavena na ADO.NET. Hodnota ConnectionManagerType je kvalifikovaná k zahrnutí názvu zprostředkovatele .NET, který správce připojení používá.

Poznámka:

Microsoft Entra ID se dříve označovala jako Azure Active Directory (Azure AD).

Řešení potíží se správcem připojení ADO.NET

Můžete protokolovat volání, která správce připojení ADO.NET provádí externím poskytovatelům dat. Pak můžete řešit potíže s připojeními, která správce připojení ADO.NET provádí pro externí zdroje dat. Chcete-li protokolovat volání, která správce připojení ADO.NET provádí externím poskytovatelům dat, povolte protokolování balíčku a vyberte diagnostickou událost na úrovni balíčku. Další informace naleznete v tématu Nástroje pro řešení potíží pro spuštění balíčku.

Při čtení správcem připojení ADO.NET data určitých datových typů SQL Serveru generují výsledky uvedené v následující tabulce.

Datový typ SQL Serveru Výsledek
time, datetimeoffset Balíček selže, pokud balíček nepoužívá parametrizované příkazy SQL. Pokud chcete použít parametrizované příkazy SQL, použijte v balíčku spustit úlohu SQL. Další informace naleznete v tématu Spuštění úlohy SQL a spuštění úlohy SQL.
datetime2 Správce připojení ADO.NET zkrátí hodnotu milisekund.

Poznámka:

Další informace o datových typech SQL Serveru a o tom, jak se mapují na datové typy integračních služeb, najdete v tématu Datové typy a datové typy integračních služeb.

konfigurace správce připojení ADO.NET

Vlastnosti můžete nastavit prostřednictvím návrháře SSIS nebo programově.

  • Zadejte konkrétní připojovací řetězec nakonfigurovaný tak, aby splňoval požadavky vybraného poskytovatele .NET.

  • V závislosti na poskytovateli zadejte název zdroje dat, ke kterému se chcete připojit.

  • Zadejte přihlašovací údaje zabezpečení podle potřeby vybraného poskytovatele.

  • Určuje, jestli je připojení vytvořené z správce připojení zachováno za běhu.

Řada možností konfigurace správce připojení ADO.NET závisí na poskytovateli .NET, kterého správce připojení používá.

Informace o programové konfiguraci správce připojení najdete v tématu ConnectionManager a přidávání připojení prostřednictvím kódu programu.

Konfigurace správce připojení ADO.NET

Pomocí dialogového okna Konfigurovat ADO.NET Správce připojení přidejte připojení ke zdroji dat, ke kterému lze získat přístup pomocí zprostředkovatele dat rozhraní .NET Framework. Jedním z těchto poskytovatelů je například zprostředkovatel SqlClient. Správce připojení může použít existující připojení nebo můžete vytvořit nové.

Další informace o správci připojení ADO.NET najdete v tématu ADO.NET Správce připojení.

Možnosti

Možnost Popis
Datová připojení Ze seznamu vyberte existující ADO.NET datové připojení.
Vlastnosti datového připojení Umožňuje zobrazit vlastnosti a hodnoty pro vybrané datové připojení ADO.NET.
Nový Pomocí dialogového okna Správce připojení vytvořte datové připojení ADO.NET.
Vymazat Vyberte připojení a pak ho odstraňte tak, že vyberete Odstranit.

Použití zprostředkovatele dat Microsoft SqlClient

Microsoft SqlClient Data Provider je podporován v SQL Serveru 2025 (17.x) a novějších verzích. Pro SQL Server 2022 (16.x) a verze před ním použijte Oledb Connection Manager, pokud potřebujete MSI nebo ověřování založené na Microsoft Entra ID.

K návrhu balíčku použijte SQL Server Integration Services Projects 2022 nebo novější.

Pokyny ke konfiguraci režimů ověřování Microsoft Entra najdete v tématu Připojení k Azure SQL pomocí ověřování Microsoft Entra a SqlClient.

Spravované identity pro autentizaci zdrojů Azure

Při spouštění balíčků SSIS v prostředíAzure-SSIS Integration Runtime (IR) ve službě Azure Data Factory (ADF) můžete použít ověřování Microsoft Entra se spravovanou identitou pro váš ADF pro přístup ke službě Azure SQL Database nebo SQL Managed Instance. Vaše IR Azure-SSIS může přistupovat k datům a kopírovat je z vaší databáze nebo do ní pomocí této spravované identity.

Poznámka:

Při ověřování pomocí spravované identity přiřazené uživatelem je potřeba povolit prostředí SSIS Integration Runtime se stejnou identitou. Další informace naleznete v tématu Povolení ověřování Microsoft Entra pro Azure-SSIS Integration Runtime.

Pokud chcete službě ADF povolit přístup ke službě Azure SQL Database pomocí spravované identity, postupujte takto:

  1. Pokud jste to ještě neudělali, zřiďte správce Microsoft Entra pro logický server ve službě Azure SQL Database prostřednictvím webu Azure Portal. Správcem Microsoft Entra může být uživatel nebo skupina. Pokud přiřadíte skupinu jako správce a spravovaná identita ADF je členem této skupiny, můžete přeskočit kroky 2 a 3. Správce má úplný přístup k vašemu logickému serveru.

  2. Vytvořte uživatele databáze s omezením , který bude reprezentovat spravovanou identitu přiřazenou k vaší službě ADF. Připojte se k databázi nebo ke které chcete kopírovat data pomocí aplikace SQL Server Management Studio (SSMS) s uživatelem Microsoft Entra, který má alespoň ALTER ANY USER oprávnění. Spusťte následující příkaz T-SQL:

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

    Pokud pro ADF použijete spravovanou identitu přiřazenou systémem, pak název spravované identity je název ADF. Pokud pro ADF použijete spravovanou identitu přiřazenou uživatelem, pak název spravované identity je název spravované identity.

  3. Udělte spravované identitě pro ADF požadovaná oprávnění, jak obvykle děláte pro uživatele SQL. Pro informace o rolích na úrovni databáze se podívejte na odpovídající role. Spusťte následující příkaz T-SQL. Další možnosti najdete v tomto článku.

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

Pokud chcete pro přístup ke službě Azure SQL Managed Instance použít spravovanou identitu přiřazenou vaší službě ADF, postupujte takto:

  1. Pokud jste to ještě neudělali, zřiďte správce Microsoft Entra pro vaši spravovanou instanci Azure SQL v Azure Portal. Správcem Microsoft Entra může být uživatel nebo skupina. Pokud přiřadíte skupinu jako správce a vaše spravovaná identita je členem této skupiny, můžete přeskočit kroky 2 až 4. Správce má úplný přístup k vaší spravované instanci.

  2. Vytvořte přihlašovací jméno pro spravovanou identitu ADF. V nástroji SSMS se připojte ke spravované instanci pomocí účtu s oprávněními správce systému nebo správce Microsoft Entra. master V databázi spusťte následující příkaz T-SQL:

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

    Pokud pro ADF použijete spravovanou identitu přiřazenou systémem, pak název spravované identity je název ADF. Pokud pro ADF použijete spravovanou identitu přiřazenou uživatelem, pak název spravované identity je název spravované identity.

  3. Vytvořte uživatele databáze s omezením představující spravovanou identitu pro vaši službu ADF. Připojte se k databázi, ze které chcete kopírovat data z aplikace SSMS, a spusťte následující příkaz T-SQL:

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

  4. Udělte spravované identitě pro ADF požadovaná oprávnění, jak obvykle děláte pro uživatele SQL. Spusťte následující příkaz T-SQL. Další možnosti najdete v tomto článku.

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

Nakonec můžete nakonfigurovat ověřování Microsoft Entra pomocí spravované identity vašeho ADF ve správci připojení ADO.NET. Tady jsou možnosti, jak to udělat:

  • Konfigurujte v době návrhu. V nástroji SSIS Designer klikněte pravým tlačítkem na správce připojení ADO.NET a vyberte Vlastnosti. Aktualizujte vlastnost ConnectUsingManagedIdentity na True.

    Poznámka:

    Vlastnost ConnectUsingManagedIdentity správce připojení se neprojeví při spuštění balíčku v nástroji SSIS Designer nebo na SQL Serveru, což znamená, že ověřování Microsoft Entra se spravovanou identitou vaší služby ADF nefunguje.

  • Konfigurujte v době běhu. Když balíček spustíte přes kanál SSMS nebo ADF, vyhledejte správce připojení ADO.NET a aktualizujte jeho vlastnost ConnectUsingManagedIdentity na True.

    Poznámka:

    V Azure-SSIS IR se při použití ověřování Microsoft Entra s spravovanou identitou vaší služby ADF překonfigurují všechny ostatní metody ověřování (například integrované zabezpečení a heslo) ve správci připojení ADO.NET.

Pokud chcete nakonfigurovat ověřování Microsoft Entra se spravovanou identitou vaší služby ADF ve stávajících balíčcích, je upřednostňovaným způsobem opětovné sestavení projektu SSIS pomocí nejnovějšího návrháře SSIS alespoň jednou. Znovu nasaďte projekt SSIS tak, aby běžel na Azure-SSIS IR, aby se nová vlastnost ConnectUsingManagedIdentity správce připojení automaticky přidala do všech správců připojení ADO.NET ve vašem projektu. Alternativně můžete přímo použít překrytí nastavení vlastností cestou k vlastnosti \Package.Connections[{název správce připojení}].Vlastnosti[ConnectUsingManagedIdentity], které jsou přiřazené k True během běhu.

Související obsah

  • Poslední aktualizace v