This tutorial shows how to set up a data source and connect to a MySQL® database using the Database Explorer app or the command line. This tutorial uses a MySQL ODBC 5.3 Driver to connect to the MySQL database.
The ODBC driver is typically preinstalled on your computer. For details about the driver installation or troubleshooting the installation, contact your database administrator or refer to your database documentation on ODBC drivers. For information about the Microsoft® ODBC Data Source Administrator, see Driver Installation.
Database Toolbox™ no longer supports connecting to a database using a 32-bit driver. Use the 64-bit version of MySQL. If you have issues working with the ODBC driver, use the JDBC driver instead. For details, see MySQL JDBC for Windows. For details about working with the 64-bit version of Windows®, see https://www.mathworks.com/products/matlab/preparing-for-64-bit-windows.html.
If you use a MySQL ODBC driver version
8 or later, MATLAB® has unexpected behavior. To avoid this behavior, install a
previous version of the ODBC driver or use the JDBC driver instead. For details
about the JDBC driver, see MySQL JDBC for Windows.
The Database Explorer app accesses the Microsoft ODBC Data Source Administrator automatically when you configure an ODBC data source. Alternatively, you can access the Microsoft ODBC Data Source Administrator using the
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 ODBC data source.
In the ODBC Data Source Administrator dialog box, you define the ODBC data source.
When setting up an ODBC data source, you can specify a user data source name (DSN) or a system DSN. A user DSN is specific to the person logged into a machine. Only this person sees the data sources that are defined on the user DSN tab. A system DSN is not specific to the person logged into a machine. Any person who logs into the machine can see the data sources that are defined on the system DSN tab. Your ability to set up a user DSN or system DSN depends on the database and ODBC driver you are using. For details, contact the database administrator or refer to the ODBC driver documentation.
Click the System DSN tab, and then click Add.
The Create New Data Source dialog box opens and displays a list of installed ODBC drivers.
Select the ODBC driver
MySQL ODBC 5.2a Driver.
The name of the ODBC driver can vary.
In the MySQL Connector/ODBC Data Source Configuration dialog box, fill out the boxes.
In the Data Source Name box, enter an
appropriate name for the data source, such as
MySQL. You use this name to establish a
connection to your database.
In the Description box, enter a
description for this data source, such as
In the TCP/IP Server box, enter the name of your database server. Consult your database administrator for the name of your database server.
In the Port box, enter the port number.
The default port number is
In the User box, enter your user name.
In the Password box, enter your password.
In the Database box, enter the name of your database.
Click Test to test the connection to your database. If your computer successfully connects to the database, the Test Result dialog box opens and displays a message indicating the connection is successful.
Click OK in the MySQL Connector/ODBC Data Source Configuration dialog
box. The ODBC Data Source Administrator dialog box shows the ODBC data
After you complete the data source setup, connect to the MySQL database using the Database Explorer app or the command line with the native ODBC connection.
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.
In the Catalog list, select the catalog. 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
two tabs named
MySQL1 are open, then close both tabs.
To close all database connections, close the Database Explorer app.
Connect to the database with the ODBC data source name. For example, this code assumes that
you are connecting to a data source named
the user name
username and the password
conn = database('MySQL','username','pwd');
Close the database connection.