Main Content

Configure MySQL Native Interface Data Source

This tutorial shows how to set up a MySQL® native interface data source and connect to a MySQL database using the Database Explorer app or the command line. This tutorial uses the MariaDB® C Connector driver to connect to a MySQL database.

The configuration steps show configuring the MySQL native data source on the Windows® platform. The same steps work on Linux® and macOS platforms.

Database Toolbox™ provides MariaDB C Connector driver for connecting to MySQL server. Therefore, you do not have to install and configure the driver.

Step 1. Set up the data source.

You can set up a data source using the Database Explorer app or the command line.

Set Up Data Source Using Database Explorer App

  1. 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.

  2. In the Data Source section, select Configure Data Source > Configure native data source > MySQL.

    Configure MySQL native interface data source

    The MySQL Data Source Configuration dialog box opens.

  3. In the Name box, enter the name of your data source. (This example uses a data source named MySQLDataSource.) You use this name to establish a connection to your database.

    MySQL Data Source Configuration dialog box

  4. In the Database Name 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.

  5. Under Connection Options, in the Name column, enter the name of an additional driver-specific option. Then, in the Value column, enter the value of the driver-specific option. Click the plus sign + to specify additional driver-specific options.

  6. Click Test. The Test Connection dialog box opens. 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.

  7. Click Save. The MySQL Data Source Configuration dialog box displays a message indicating the data source is saved successfully. Close this dialog box.

Set Up Data Source Using Command Line

  1. Create a MySQL native interface data source for a MySQL database.

    vendor = "MySQL";
    opts = databaseConnectionOptions("native",vendor);
  2. Set the database connection options. For example, this code assumes that you are connecting to a data source named MySQLDataSource, database name toystore_doc, database server dbtb01, and port number 3306.

    opts = setoptions(opts, ...
        'DataSourceName',"MySQLDataSource", ...
        'DatabaseName',"toystore_doc",'Server',"dbtb01", ...
        'PortNumber',3306);
    
  3. Test the database connection by specifying the user name and password.

    username = "root";
    password = "matlab";
    status = testConnection(opts,username,password);
  4. Save the data source.

    saveAsDataSource(opts)

After you complete the data source setup, connect to the MySQL database using the Database Explorer app or the command line.

Step 2. Connect using the Database Explorer app or the command line.

Connect to MySQL Using Database Explorer App

  1. On the Database Explorer tab, in the Connections section, click Connect and select the data source for the connection.

  2. In the connection dialog box, enter a user name and password. Click Connect.

    The Catalog and Schema dialog box opens.

  3. In the Catalog list, select the catalog. Click OK.

    The app connects to the database and displays its 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.

  4. Select tables in the Data Browser pane to query the database.

  5. Close the data source tab to close the SQL query. In the Connections section, close the database connection by clicking Close Connection.

    Note

    If multiple connections are open, close the database connection of your choice by selecting the corresponding data source from the Close Connection list.

Connect to MySQL Using Command Line

  1. Connect to a MySQL database using the configured MySQL native interface data source, user name, and password.

    datasource = "MySQLDataSource";
    username = "root";
    password = "matlab";
    conn = mysql(datasource,username,password);
  2. Close the database connection.

    close(conn)

See Also

Apps

Functions

Related Topics