Once the instance is created and its status becomes Running, you can connect to the database to perform read/write and query operations. This document describes three methods to connect to the database.
Connection via client: You can connect to a TencentDB instance at its automatically assigned private address from a Windows or Linux CVM instance based on the client. This connection method utilizes the high-speed private network of Tencent Cloud and features low delay. Both instances should be under the same account and reside in the same VPC in the same region or reside in the classic network.
Note:
CVM and TencentDB instances in different VPCs (under the same or different accounts in the same or different regions) can be interconnected over the private network through Cloud Connect Network.
CVM and TencentDB instances in different VPCs can be connected through the public network address as instructed in Configuring Public Network Address.
Connection via DMC: You can use Tencent Cloud Database Management Center (DMC) to log in to your TencentDB instance to access them, view their key metric information, and run Redis commands.
Connection via SDK: You can connect to a Tencent Cloud Distributed Cache instance by configuring auto-assigned private IP address, port, instance ID, and password in the SDK for the corresponding programming language. Then, you can manipulate it, get and set its key, and do more.
Prepare a database account and password. For more information, see Managing Account. You can use the default account or a custom account.
Configure security group rules for the CVM instance and the Tencent Cloud Distributed Cache instance. For more information, see Configuring Security Group.
Obtain the Private IPv4 Address for database connection in the Network Info section on the Instance Details page in the Tencent Cloud Distributed Cache console.
Connecting by Using Client Tool
Note:
The Redis 6.2 version does not support the RESP3 protocol.
2. Take a CVM instance running CentOS as an example. Run the following command to install the Redis protocol client:
yum install redis -y
If Complete! is displayed, the client is installed successfully.
Step 2. Connect to an instance
Passwordless authentication
If your instance is password-free, the connection command is as follows:
redis-cli -h IP address -p port
Here, the IP address and port are the Private IPv4 Address and Port obtained in the Network Info section on the Instance Details page in the Tencent Cloud Distributed Cache console.
Access with default account
The default account refers to the account assigned by the system by default. When you purchase and create a Tencent Cloud Distributed Cache instance, the password you set to access the instance is the database password corresponding to the default account. To use the default account with a password to access the database, the following open-source connection command is supported:
redis-cli -h IP address -p port -a password
Here, the IP address and port are the Private IPv4 Address and Port obtained in the Network Info section on the Instance Details page in the Tencent Cloud Distributed Cache console. For example, if the password you set is abcd1234, the connection command should be as follows:
redis-cli -h IP address -p port -a abcd1234
Note:
To access instances purchased before January 2018, you need to replace the "password" with "instance ID:password", for example, redis-cli -h IP address -p port -a crs-bkuza6i3:abcd1234.
Access with custom account
If you use a custom account as described in Managing Account when connecting, then the authentication method of the custom account is account name@password, which acts as the password parameter for accessing Tencent Cloud Distributed Cache:
redis-cli -h IP address -p port -a account name@password
2. In the Windows CVM instance, download the Tencent Cloud Distributed Cacheclient over the internet and install it.
3. Open the Redis client, configure the instance's private IP address, and click Test Connection to connect to the instance.
Parameter
Description
Name
The name of the connection to the database instance.
Address
Enter the private IPv4 address of the database instance, which can be obtained in the Network Info section on the Instance Details page in the console.
Verification
Enter the password for database instance connection.
4. Click
and enter a Redis command in the input box in the bottom-right corner to run it.
Connection via DMC
Note:
Memcached instances do not currently support DMC connections.
3. In the instance list, find the target instance.
4. Click Log In in the Operation column.
5. You will be redirected to the login page of DMC. Enter the default account password of the target instance and click Log In.
6. You can view the instance monitoring information on the Instance Info tab on the Database Management page.
7. Click the Command Line tab and enter a Redis command in the input box at the bottom to run it:
8. If you are unfamiliar with Redis command parameters, you can select the slot range and database for storing key values in the Object List section on the left of the page, click Create, select the key data type, click OK, edit the key name in the Key Name input box, and click Add element and create key. Then, enter the corresponding key value and click OK in the Add Element window. The system will run commands based on the set key and key value.
Connection via SDK
Tencent Cloud Distributed Cache can be accessed via SDKs for various programming languages, including PHP, Java, Node.js, Python, C, Go, and .NET. For specific samples, see PHP Connection Sample. You can download an SDK client and then connect to a Tencent Cloud Distributed Cacheinstance by configuring its private IP, port, instance ID, and password as instructed in the sample code.
