Knowledge Base

How to use MySQL client applications

This article describes how to use MySQL client applications to access and manage your MySQL databases.

MySQL client applications

MySQL provides several GUI (graphical user interface) client applications that you can use:

  • MySQL Workbench: This integrated tools environment enables you to manage databases, run queries, and much more. It replaces the older MySQL GUI Tools application bundle.
  • MySQL GUI Tools: This application bundle includes the MySQL Administrator and MySQL Query Browser. MySQL Administrator has graphical traffic and health-monitoring features and optimization tools. You can also complete database backups. MySQL Query Browser is a graphical database browser and SQL query builder. You can view data, add and drop columns and rows, change values, and more.

Both of these application suites are free to download and use. There are versions for Microsoft Windows, Mac OS X, Linux, and other operating systems.

MySQL Workbench

MySQL Workbench enables you to quickly and securely connect to your MySQL databases using an SSH tunnel. To do this, follow these steps:

  1. Start MySQL Workbench.
  2. From the workspace page, click New Connection. The Setup New Connection dialog appears.
  3. In the Connection Name text box, type a name for the connection.
  4. In the Connection Method list box, select Standard (TCP/IP) over SSH.
  5. In the SSH Hostname text box, type example.com:7822, where example.com represents your domain name.
  6. In the SSH Username text box, type your A2 Hosting (cPanel) account username.
  7. In the MySQL Hostname text box, type localhost.
  8. Confirm that the MySQL Server Port text box is set to 3306.
  9. In the Username text box, type one of the following usernames:
    • Your A2 Hosting (cPanel) account username: With this username, you can access all of the MySQL databases on your hosting account.
    • A MySQL database username you created in cPanel: With this username, you can access all of the MySQL databases for which the specified user has been granted privileges.
  10. Click Test Connection. The Open SSH Tunnel dialog box appears.
  11. In the Password text box, type your A2 Hosting (cPanel) account password.

    To have MySQL Workbench remember your password, select the Save password in vault check box.
  12. Click OK. The Connect to MySQL Server dialog box appears.
  13. In the Password text box, type the password for the username you specified in step 9.

    To have MySQL Workbench remember your password, select the Save password in vault check box.
  14. Click OK. If the connection is successful, you receive a Connection parameters are correct message. If you do not receive this message, check the values you specified in steps 3 to 9, and then try again.
  15. On the Setup New Connection dialog box, click OK.
  16. You can now run queries, create tables, and more. For example, from the workspace page, under Open Connection to Start Querying, double-click the connection name you specified in step 3. MySQL Workbench connects to your account and displays your databases.
MySQL GUI Tools

To use this application, you must first do one (or both) of the following:

  • Set up an SSH tunnel for the MySQL connection. For more information about how to do this, please see this article.
  • Enable remote MySQL access in cPanel. For information about how to do this, please see this article.

To connect to your MySQL databases using MySQL GUI Tools, follow these steps:

  1. Start MySQL Adminstrator or MySQL Browser.
  2. In the Server Hostname text box, type one of the following:
    • If you are using an SSH tunnel, type 127.0.0.1.
    • If you are using a direct connection to the server, type your domain name.
  3. In the Port text box, type 3306.

    If you are using a different port on your local computer for port forwarding, type that port number instead.
  4. In the Username text box, type one of the following usernames:

    • Your A2 Hosting (cPanel) account username: With this username, you can access all of the MySQL databases on your hosting account.
    • A MySQL database username you created in cPanel: With this username, you can access all of the MySQL databases for which the specified user has been granted privileges.
  5. In the Password text box, type the password for the username you specified in step 4.
  6. Click Connect.

More Information