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 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.
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.
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.
Click Test. The Test Connection dialog box opens. Enter the user name and password for your database, or leave these boxes blank if your database does not require them. 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, select the data source you defined from the Data Source list. Enter a user name and password, or leave these boxes blank if your database does not require them. 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.
Connect to a SQL
Server database using the configured JDBC data source, user name
username, and 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.