JDBC drivers location
Wednesday, 21 January 2026 · 2 messages
YK
Yitzhak Khabinsky21 Jan 2026 13:47 #
Hello,
Congrats on the BaseX 12.2 release!
It seems that I bumped into a minor issue on a machine with MS Windows OS.
My XQuery is using SQL module, and for that I am using Microsoft JDBC Driver for SQL Server. In particular, its mssql-jdbc-13.2.1.jre11.jar file needs to be in the ~basex\lib directory.
It looks like that in-place update from the BaseX 12.1 to BaseX 12.2 deleted the ~basex\lib\mssql-jdbc-13.2.1.jre11.jar file.
I received an error message.
The solution was very simple, I copied the missing mssql-jdbc-13.2.1.jre11.jar file to the same location, restarted the BaseX GUI, and database calls started to work again.
As a test, I deleted Microsoft jar in the ~\basex\lib\
and copied it to the ~\basex\lib\custom\
And database calls started to work again.
The documentation says the following:
"..If you work with the full distributions of BaseX, you can copy the driver into the lib directory..." https://docs.basex.org/main/SQL_Functions
IMHO, it is better to update BaseX documentation, and recommend to copy JDBC *.jar files to the ~\basex\lib\custom\ directory. This way JDBC drivers will survive BaseX updates in-place.
Regards,
Yitzhak Khabinsky
CG
Christian Grün21 Jan 2026 15:01 #
Quoted text · Yitzhak Khabinsky · 1 line
> IMHO, it is better to update BaseX documentation, and recommend to copy JDBC *.jar files to the ~\basex\lib\custom\ directory.
This way JDBC drivers will survive BaseX updates in-place.
Done; thank you.
Quoted text · Yitzhak Khabinsky · 23 lines
Von: Yitzhak Khabinsky via BaseX-Talk <basex-talk at mailman.uni-konstanz.de> Gesendet: Mittwoch, 21. Januar 2026 13:47 An: basex-talk at mailman.uni-konstanz.de <basex-talk at mailman.uni-konstanz.de> Betreff: [basex-talk] JDBC drivers location Hello, Congrats on the BaseX 12.2 release! It seems that I bumped into a minor issue on a machine with MS Windows OS. My XQuery is using SQL module, and for that I am using Microsoft JDBC Driver for SQL Server. In particular, its mssql-jdbc-13.2.1.jre11.jar file needs to be in the ~basex\lib directory. It looks like that in-place update from the BaseX 12.1 to BaseX 12.2 deleted the ~basex\lib\mssql-jdbc-13.2.1.jre11.jar file. I received an error message. The solution was very simple, I copied the missing mssql-jdbc-13.2.1.jre11.jar file to the same location, restarted the BaseX GUI, and database calls started to work again. As a test, I deleted Microsoft jar in the ~\basex\lib\ and copied it to the ~\basex\lib\custom\ And database calls started to work again. The documentation says the following: "..If you work with the full distributions of BaseX, you can copy the driver into the lib directory..." https://docs.basex.org/main/SQL_Functions IMHO, it is better to update BaseX documentation, and recommend to copy JDBC *.jar files to the ~\basex\lib\custom\ directory. This way JDBC drivers will survive BaseX updates in-place. Regards, Yitzhak Khabinsky
Written for BaseX 12.2. BaseX may have changed since: please check the current documentation.
⚡Generated with XQuery