This tutorial shows how to set up a data source and connect to a Microsoft® SQL Server® database using the Database Explorer app or the command line. This tutorial uses the Microsoft JDBC Driver 4.0 for Microsoft SQL Server to connect to a Microsoft SQL Server 2016 Express database.
If the JDBC driver for Microsoft SQL Server is not installed on your computer, find the link on the Driver Installation page to install the driver. Follow the instructions to download and install this driver on your computer.
Complete the following steps on the machine where SQL Server is installed to find your port number for database connection. If you experience connection issues with the port number that you find, contact your database administrator.
On the machine where your SQL Server database is installed, click Start. Select your Microsoft SQL Server version folder and click SQL Server Configuration Manager.
On the left of the Sql Server Configuration Manager window, click SQL Server Network Configuration. Double-click Protocols for SQLEXPRESS.
See if TCP/IP is enabled. If so, skip steps 4 and 5.
If TCP/IP is disabled, right-click TCP/IP and select Enable.
To finish the process of enabling the TCP/IP protocol, restart the server. On the left side of the window, click SQL Server Services. Right-click SQL Server (SQLEXPRESS) and click Restart. The server restarts, enabling TCP/IP.
Click Protocols for SQLEXPRESS and right-click TCP/IP. Select Properties.
In the TCP/IP Properties dialog box, scroll to the bottom on the
IP Addresses tab until you see the
IPAll group. The number next to TCP
Dynamic Ports is the port number. Use this port number in the
JDBC Data Source Configuration dialog box when configuring a data source
using the Database Explorer app. Or, enter this port number as an input
argument of the
database function at the command line.
Here, the port number is
53917. If this number is
0 or if you want to configure your SQL
Server database server to listen to a specific port, delete the entry
in the TCP Dynamic Ports box. Then, enter another port
number in the TCP Port box.
Click Apply and click OK to close the TCP/IP Properties dialog box. Then, close the Sql Server Configuration Manager dialog box.
Windows® authentication enables you to connect to a database using your Windows user account. In this case, Windows performs user validation, and the database does not require a different user name and password. Windows authentication facilitates the maintenance of database access credentials. After you add the required libraries to the system path, the Microsoft SQL Server JDBC driver enables connectivity using Windows authentication. The following steps show how to add these libraries to the Java® library path in MATLAB®. For details about Java libraries, see Java Class Path (MATLAB).
Ensure that you have the latest Java driver library installed on your computer. To install the latest library, see Driver Installation.
prefdir function in the Command Window. The output of this command is a file path to the MATLAB preferences folder on your computer. For details, see
Navigate to the folder from step 2, and create a file named
javalibrarypath.txt in the folder.
javalibrarypath.txt and insert the path to the
Java library file
sqljdbc_auth.dll. This file is
installed in the following location:
<installation> is the installation folder of the
SQL Server JDBC driver,
<version> is the JDBC
<language> is the JDBC driver
<arch> is the architecture.
Use the x64 folder. In the entry, include the full path to the library
file. Do not include the library file name. The following is an example of
You can set up a data source using the JDBC Data Source Configuration dialog box, which you can open from the Database Explorer app or at the command line.
Open the Database Explorer app by clicking the Apps tab on the MATLAB Toolstrip. Then, on the right of the Apps section, click the Show more arrow to open the apps gallery. Under Database Connectivity and Reporting, click Database Explorer. Alternatively, enter
databaseExplorer at the command line.
In the Data Source section, select Configure Data Source > Configure JDBC data source.
configureJDBCDataSource at the command
The JDBC Data Source Configuration dialog box opens.
In the Name box, enter a name for your data source.
You use this name to establish a connection to your database. If you enter a
name that duplicates an existing ODBC data source name, the Database
Explorer app appends
_JDBC to the name after you save
From the Vendor list, select
In the Driver Location box, enter the full path to the JDBC driver file.
In the Database box, enter the name of your database. In the Server box, enter the name of your database server. Consult your database administrator for the name of your database server. In the Port Number box, enter the port number.
To establish the data source with Windows authentication, set Authentication to
Or, to establish the data source without Windows authentication, set Authentication to
Click Test. The Test Connection dialog box opens. If you are connecting without Windows authentication, then enter the user name and password for your database. Click Test.
If your connection succeeds, the Database Explorer dialog box displays a message indicating the connection is successful. Otherwise, it displays an error message.
Click Save. The JDBC Data Source Configuration dialog box displays a message indicating the data source is saved successfully. Close this dialog box.
After you complete the data source setup, connect to the SQL Server database using the Database Explorer app or JDBC driver and command line.
On the Database Explorer tab, in the Data Source section, click New Query.
In the Connect to a Data Source dialog box, connect with Windows authentication by selecting the data source you defined from the Data Source list. Leave the Username and Password boxes blank. Click Connect.
Or, connect to your database without Windows authentication by selecting the data source you defined. Enter a user name and password. Click Connect.
The Catalog and Schema dialog box opens.
Select the catalog and schema from the Catalog and Schema lists. Click OK.
The Database Explorer app connects to the database and displays database tables in the Data Browser pane. A data source tab appears to the right of the pane. The title of the data source tab is the data source name that you defined during the setup. The data source tab contains empty SQL Query and Data Preview panes.
Select tables in the Data Browser pane to query the database.
Close the data source tab to close the SQL query and the database connection.
To close the database connection, close all tabs that have titles
beginning with the name of the corresponding data source. For
example, if the data source name is
Server, and two tabs named
MS SQL Server1 are open,
then close both tabs.
To close all database connections, close the Database Explorer app.
To connect with Windows authentication, use the configured JDBC data source and
specify a blank user name and password. For example, this code assumes
that you are connecting to a JDBC data source named
datasource = "MSSQLServerAuth"; username = ""; password = ""; conn = database(datasource,username,password);
Or, to connect without Windows authentication, use the configured JDBC data source and
specify the user name
username and the password
pwd. For example, this code assumes that you are
connecting to a JDBC data source named
datasource = "MSSQLServer"; username = "username"; password = "pwd"; conn = database(datasource,username,password);
Close the database connection.