Závislosti funkcí ovladače Microsoft JDBC pro SQL Server

Článek
03/30/2025

Tento článek uvádí knihovny, na které závisí ovladač Microsoft JDBC pro SQL Server. Projekt má následující závislosti:

Čas kompilace

com.azure:azure-security-keyvault-keys: Klientská knihovna Microsoft Azure pro klíče služby KeyVault pro ovladače JDBC verze 9.2 a vyšší nebo com.microsoft.azure:azure-keyvault: Microsoft Azure SDK for Key Vault pro ovladač JDBC verze 8.4 a novější pro funkci Always Encrypted Azure Key Vault. (volitelné)
com.azure:azure-identity: Microsoft Azure klientská knihovna pro identitu pro ovladače JDBC verze 9.2 a vyšší nebo com.microsoft.azure:adal4j: Microsoft Entra Authentication Library pro ovladače JDBC verze 8.4 a níže pro funkce ověřování Microsoft Entra a Azure Key Vault. (volitelné)
com.microsoft.azure:msal4j: Microsoft Authentication Library (MSAL) pro Javu. (volitelné)
org.antlr:antlr4-runtime: ANTLR 4 Runtime pro funkci useFmtOnly. (volitelné)
org.osgi:org.osgi.core: Základní knihovna OSGi pro podporu architektury OSGi.
org.osgi:org.osgi.service.jdbc: Doprovodný kód OSGi pro JDBC.
com.google.code.gson: Analyzátor JSON pro funkci Always Encrypted se zabezpečenými enklávy (volitelné)
org.bouncycastle.bcprov-jdk18on: Poskytovatel Bouncy Castle pro funkcionalitu Always Encrypted se zabezpečenými enklávami pouze pro Java 8. (volitelné)

Doba běhu

Projekty, které vyžadují některou z předchozích funkcí, musí explicitně deklarovat příslušné závislosti v souboru POM, které odpovídají závislostem použité verze ovladače.

Příklad: Pokud používáte funkci ověřování Microsoft Entra s ovladačem JDBC verze 10.2 a vyšší, musíte deklarovat závislost azure-identity v souboru POM projektu. Podívejte se na následující fragment kódu:

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>10.2.0.jre11</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.4.3</version>
</dependency>

Příklad: Pokud používáte funkci ověřování Microsoft Entra s ovladačem JDBC verze 8.4 a novější, musíte deklarovat adal4j a client-runtimes závislosti v souboru POM projektu. Podívejte se na následující fragment kódu:

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>8.4.0.jre11</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>adal4j</artifactId>
    <version>1.6.5</version>
</dependency>

<dependency>
    <groupId>com.microsoft.rest</groupId>
    <artifactId>client-runtime</artifactId>
    <version>1.7.4</version>
</dependency>

Příklad: Pokud používáte funkci Azure Key Vault s ovladačem JDBC verze 10.2 a vyšší, musíte deklarovat azure-security-keyvault-keys a azure-identity závislosti v souboru POM projektu. Podívejte se na následující fragment kódu:

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>10.2.0.jre11</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.4.3</version>
</dependency>

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-security-keyvault-keys</artifactId>
    <version>4.3.6</version>
</dependency>

Příklad: Pokud používáte funkci Azure Key Vault s ovladačem JDBC verze 8.4 a novější, musíte deklarovat azure-keyvault, adal4ja client-runtime závislostí v souboru POM projektu. Podívejte se na následující fragment kódu:

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>8.4.0.jre11</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>adal4j</artifactId>
    <version>1.6.5</version>
</dependency>

<dependency>
    <groupId>com.microsoft.rest</groupId>
    <artifactId>client-runtime</artifactId>
    <version>1.7.4</version>
</dependency>

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-keyvault</artifactId>
    <version>1.2.4</version>
</dependency>

Poznámka

Nezapomeňte použít verzi souboru POM, který je dodáván s verzí ovladače JDBC, který používáte. Závislosti a verze se mohly změnit.

Pokud k sestavení nebo otestování projektu používáte Maven, Maven automaticky stáhne závislé knihovny v souboru POM spolu s jejich tranzitivními knihovnami. Také můžete použít Maven Dependency Plugin ke stažení všech závislostí projektu do požadovaného umístění. Pokud Maven nepoužíváte, musíte si stáhnout závislosti a tranzitivní závislosti ručně, abyste měli jistotu, že máte všechny správné verze každé knihovny. Po stažení požadovaných závislých knihoven je přidejte do classpathu projektu a spusťte aplikaci.

Požadavky na závislost pro ovladač JDBC

Práce s poskytovatelem služby Azure Key Vault

Ovladač JDBC verze 12.10.0 – Verze závislostí: Azure-security-keyvault-keys (verze 4.9.2) a Azure-identity (verze 1.15.3) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 12.8.0 – Verze závislostí: Azure-security-keyvault-keys (verze 4.7.3) a Azure-identity (verze 1.12.2) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 12.6.0 – Verze závislostí: Azure-security-keyvault-keys (verze 4.7.3) a Azure-identity (verze 1.11.1) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 12.4.0 – verze závislostí: Azure-security-keyvault-keys (verze 4.6.1) a Azure-identity (verze 1.9.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 12.2.0 – verze závislostí: Azure-security-keyvault-keys (verze 4.5.3) a Azure-identity (verze 1.7.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 11.2.0 – verze závislostí: Azure-security-keyvault-keys (verze 4.4.1) a Azure-identity (verze 1.5.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 10.2.0 – Verze závislostí: Azure-security-keyvault-keys (verze 4.3.6) a Azure-identity (verze 1.4.3) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 9.4.1 – verze závislostí: Azure-security-keyvault-keys (verze 4.2.8) a Azure-identity (verze 1.3.3) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 9.2.1 – Verze závislostí: Azure-security-keyvault-keys (verze 4.2.1) a Azure-identity (verze 1.1.3) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 8.4.1 – Verze závislostí: Azure-Keyvault (verze 1.2.4), Adal4j (verze 1.6.5), Client-Runtime-for-AutoRest (verze 1.7.4) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 8.2.2 – verze závislostí: Azure-Keyvault (verze 1.2.2), Adal4j (verze 1.6.4), Client-Runtime-for-AutoRest (verze 1.7.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 7.4.1 – Verze závislostí: Azure-Keyvault (verze 1.2.1), Adal4j (verze 1.6.4), Client-Runtime-for-AutoRest (verze 1.6.10) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 7.2.2 – verze závislostí: Azure-Keyvault (verze 1.2.0), Azure –Keyvault-Webkey (verze 1.2.0), Adal4j (verze 1.6.3), Client-Runtime-for-AutoRest (1.6.5) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 7.0.0 – verze závislostí: Azure-Keyvault (verze 1.0.0), Adal4j (verze 1.6.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 6.4.0 – verze závislostí: Azure-Keyvault (verze 1.0.0), Adal4j (verze 1.4.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 6.2.2 – verze závislostí: Azure-Keyvault (verze 1.0.0), Adal4j (verze 1.4.0) a jejich závislosti (ukázková aplikace)
Ovladač JDBC verze 6.0.0 – verze závislostí: Azure-Keyvault (verze 0.9.7), Adal4j (verze 1.3.0) a jejich závislosti ( ukázková aplikace)

Poznámka

U verzí ovladačů 6.2.2 a 6.4.0 se závislost azure-keyvault-java aktualizovala na verzi 1.0.0. Nová verze však nebyla kompatibilní s předchozí verzí (0.9.7) a přerušila stávající implementaci v ovladači. Nová implementace v ovladači vyžaduje změny v rozhraní API, které naopak narušují klientské programy používající poskytovatele služby Azure Key Vault.

Tento problém je vyřešený s nejnovějšími verzemi ovladačů (7.0.0 atd.). Odebraný konstruktor, který používal mechanismus ověřování pomocí zpětného volání, se vrací zpět do zprostředkovatele služby Azure Key Vault kvůli zpětné kompatibilitě.

Práce s ověřováním Microsoft Entra

Ovladač JDBC verze 12.10.0 – verze závislostí: Azure-identity (verze 1.15.3) a její závislosti.
Ovladač JDBC verze 12.8.0 – verze závislostí: Azure-identity (verze 1.12.2), Msal4j (verze 1.15.1) a jejich závislosti.
Ovladač JDBC verze 12.6.0 – verze závislostí: Azure-identity (verze 1.11.1), Msal4j (verze 1.14.1) a jejich závislosti.
Ovladač JDBC verze 12.4.0 – verze závislostí: Azure-identity (verze 1.9.0), Msal4j (verze 1.13.8) a jejich závislosti.
Ovladač JDBC verze 12.2.0 – verze závislostí: Azure-identity (verze 1.7.0), Msal4j (verze 1.13.3) a jejich závislosti.
Ovladač JDBC verze 11.2.0 – verze závislostí: Azure-identity (verze 1.5.0) a jejich závislosti.
Ovladač JDBC verze 10.2.0 – Verze závislostí: Azure-identity (verze 1.4.3) a jejich závislosti.
Ovladač JDBC verze 9.4.1 – verze závislostí: Azure-identity (verze 1.3.3) a jejich závislosti.
Ovladač JDBC verze 9.2.1 – verze závislostí: Azure-identity (verze 1.1.3) a jejich závislosti.
Ovladač JDBC verze 8.4.1 – verze závislostí: Adal4j (verze 1.6.5), Client-Runtime-for-AutoRest (1.7.4) a jejich závislosti.
Ovladač JDBC verze 8.2.2 – verze závislostí: Adal4j (verze 1.6.4), Client-Runtime-for-AutoRest (1.7.0) a jejich závislosti. V této verzi ovladače byl sqljdbc_auth.dll přejmenován na mssql-jdbc_auth-\<version>-\<arch>.dll.
Ovladač JDBC verze 7.4.1 – verze závislostí: Adal4j (verze 1.6.4), Client-Runtime-for-AutoRest (1.6.10) a jejich závislosti
Ovladač JDBC verze 7.2.2 – verze závislostí: Adal4j (verze 1.6.3), Client-Runtime-for-AutoRest (1.6.5) a jejich závislosti
Ovladač JDBC verze 7.0.0 – verze závislostí: Adal4j (verze 1.6.0) a jeho závislosti
Ovladač JDBC verze 6.4.0 – verze závislostí: Adal4j (verze 1.4.0) a jeho závislosti
Ovladač JDBC verze 6.2.2 – verze závislostí: Adal4j (verze 1.4.0) a jeho závislosti
Ovladač JDBC verze 6.0.0 – verze závislostí: Adal4j (verze 1.3.0) a jejich závislosti. V této verzi ovladače se můžete připojit pomocí ActiveDirectoryIntegrated Režimu ověřování, pouze v operačním systému Windows a pomocí sqljdbc_auth.dll a knihovny Active Directory Authentication Library pro SQL Server (ADALSQL.DLL).

Od ovladače verze 6.4.0 dále aplikace nevyžadují použití ADALSQL.DLL v operačních systémech Windows. Pro operační systémy jiné než Windowsvyžaduje ovladač lístek Kerberos pro práci s ověřováním integrovaným do Active Directory. Další informace o připojení ke službě Active Directory pomocí protokolu Kerberos najdete v tématu Nastavení lístku Kerberos ve Windows, Linuxu a macOS.

V případě operačních systémů Windowsovladač ve výchozím nastavení hledá sqljdbc_auth.dll a nevyžaduje nastavení lístku Kerberos ani závislosti na knihovně Azure. Pokud sqljdbc_auth.dll není k dispozici, ovladač hledá ticket Kerberos pro ověření vůči službě Active Directory, stejně jako v jiných operačních systémech.

Od ovladače verze 8.2.2 se sqljdbc_auth.dll přejmenuje na mssql-jdbc_auth-\<version>-\<arch>.dll. Například mssql-jdbc_auth-8.2.2.x64.dll.

Kromě mssql-jdbc_auth<verze>–<arch>.dll (k dispozici v balíčku ovladače JDBC), musí být pro integrované ověřování služby Active Directory nainstalovaná také knihovna Azure Active Directory Authentication Library (ADAL.DLL). Knihovnu Microsoft Azure Active Directory Authentication Library lze nainstalovat z ovladače Microsoft ODBC pro SQL Server nebo z ovladače Microsoft OLE DB pro SQL Server. Ovladač JDBC podporuje pouze verze 1.0.2028.318 a vyšší pro ADAL.DLL.

Můžete získat ukázkovou aplikaci využívající tuto funkci.

Viz také

úložiště GitHub ovladače JDBC
Referenční rozhraní API ovladače JDBC

Sdílet prostřednictvím