Accessing MySQL Database

Last updated: 2020-05-26 15:51:41

PDF

TencentDB for MySQL can be accessed in the following two methods:

  • Private network access: a CVM instance can be used to access the private network address of a TencentDB instance. This access method relies on the high-speed private network of Tencent Cloud and features low delay.

    • The two instances must be under the same account and in the same VPC in the same region or both in the classic network.
    • The private network address is provided by the system by default and can be viewed in the instance list or on the instance details page in the TencentDB for MySQL Console.
  • Public network access: if you cannot connect to the private network, you can access your TencentDB for MySQL instance at its public network address.

    • The public network address can be enabled only for instances in the Guangzhou, Shanghai, Beijing, Chengdu, Chongqing, Hong Kong (China), Singapore, Seoul, Tokyo, and Silicon Valley regions.
    • The public network address needs to be manually enabled. It can be viewed on the instance details page in the TencentDB for MySQL Console and can be disabled if no longer needed.
    • Enabling the public network address will expose your database service to the public network, which may lead to database intrusions or attacks; therefore, you are recommended to use the private network to access the database.
    • Public network access to TencentDB is suitable for development or auxiliary management of databases but not for real business access, as potentially uncontrollable factors may lead to unavailability of the public network access, such as DDoS attacks and surges in access traffic.

The following describes how to log in to a TencentDB for MySQL instance from Windows and Linux CVM instance over the private and public networks.

Accessing from Windows CVM

  1. Log in to a Windows CVM instance. For more information, please see Customizing Windows CVM Configurations.
  2. Download a standard SQL client.

    MySQL Workbench is recommended. Visit https://dev.mysql.com/downloads/workbench/ and download an appropriate installer based on your system version.

  3. Login, Sign Up, and No, thanks, just start my download. will appear on the page. Select No, thanks, just start my download. to download quickly.
  4. Install MySQL Workbench on this CVM instance.
    • Microsoft .NET Framework 4.5 and Visual C++ Redistributable for Visual Studio 2015 are required for the installation.
    • If needed, you can click Download Prerequisites in the MySQL Workbench installation wizard to enter the corresponding page to download and install them. Then, install MySQL Workbench.
  5. Open MySQL Workbench, select Database > Connect to Database, enter your TencentDB for MySQL instance's private (or public) network address, username, and password and click OK to log in.
    • Hostname: enter the private (or public) network address which can be viewed together with the ports on the instance details page in the TencentDB for MySQL Console. For the public network address, check whether it has been enabled as instructed in Enabling Public Network Address.
    • Port: private (or public) network port
    • Username: the username is root by default. For public network access, you are recommended to create a separate account for easier access control.
    • Password: the password corresponding to Username. If you forgot the password, please reset it as instructed in Resetting Password.
  6. After successful login, the following page will appear, where you can view the modes and objects of the MySQL database, create tables, and perform operations such as data insertion and query.

Accessing from Linux CVM

  1. Log in to a Linux CVM instance. For more information, please see Customizing Linux CVM Configurations.
  2. Taking a CVM instance on CentOS 7.2 (64-bit) as an example, install the MySQL client by running the following command:
    yum install mysql
    If Complete! is displayed, it means the MySQL client is installed successfully.
  3. Perform the corresponding operation based on the access method:
    • Private network access:
      1. Run the following command to log in to the TencentDB for MySQL instance:
        mysql -h hostname -u username -p
        • hostname: replace it with the private network address of the target TencentDB for MySQL instance, which can be viewed on the instance details page in the TencentDB for MySQL Console.
        • username: replace it with the default username root.
      2. Enter the password corresponding to the root account of the TencentDB for MySQL instance after the prompt Enter password: is displayed. If you forgot the password, please reset it as instructed in Resetting Password.
        If MySQL [(none)]> is displayed, it means that you have logged in to MySQL successfully.
    • Public network access:
      1. Run the following command to log in to the TencentDB for MySQL instance:
        mysql -h hostname -P port -u username -p
        • hostname: replace it with the public network address of the target TencentDB for MySQL instance, which can be viewed together with the port on the instance details page in the TencentDB for MySQL Console. If the public network address has not been enabled, please enable it as instructed in Enabling Public Network Address.
        • port: replace it with the public network port number.
        • username: replace it with the public network access username for public network access. You are recommended to create a separate account for easier access control.
      2. Enter the password corresponding to the public network access username after the prompt Enter password: is displayed. If you forgot the password, please reset it as instructed in Resetting Password.
        In this example, hostname is 59281c4exxx.myqcloud.com and public network port is 15311.
  4. Under the prompt MySQL [(none)]>, you can send an SQL statement to the MySQL server for execution. For specific command lines, see mysql Client Commands.
    Take show databases; for example as below:

Appendix 1. Enabling Public Network Access

  1. Log in to the TencentDB for MySQL Console. In the instance list, click an instance name or Manage in the "Operation" column to enter the instance details page.
  2. Find Public Network Address in the basic information section on the instance details page and click Enable.
  3. Click OK and the enabling process starts.
  4. After the public network address is enabled successfully, it can be found in the basic information.

    The public network access can be disabled using the switch. When it is enabled again, the public network address corresponding to the domain name remains the same.

Appendix 2. Troubleshooting

If the TencentDB for MySQL instance cannot be connected, please troubleshoot as instructed in Instance Disconnection.