Before you connect to an instance of Tair, you must obtain the endpoint of the Tair instance. The virtual IP address (VIP) of the Tair instance may change due to service maintenance or configuration change. We recommend that you connect to Tair instances by using their endpoints (such as r-2vcl6xcftp1nu7****.com
) to ensure service availability. You can view different types of endpoints in the console.
Prerequisites
The IP address of your client is added to a whitelist of the Tair instance. For more information, see Configure whitelists.
Procedure
Log on to the Tair console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click the instance ID.
In the Connection Information section, view different types of endpoints and port numbers.
NoteIf you want to connect to the Tair instance over the Internet, apply for a public endpoint for the instance. For more information, see Apply for a public endpoint for a Tair instance.
You cannot apply for a public endpoint for a cloud-native cluster instance that runs in direct connection mode. For more information, see View endpoints.
Then, you can connect to the Tair instance. For more information, see Use redis-cli to connect to a Tair instance.
Proxy mode and direct connection mode
Tair supports the following connection modes:
Proxy mode
Clients connect to Tair instances by using proxy nodes.
Proxy nodes are developed in-house to enable architecture changes, route commands, balance loads, perform failovers, and run in-house commands for Tair instances in proxy mode. The connection mode offers several advantages, including aggregated connections, enhanced read performance, and ease of use. This can help you design more efficient business systems. For more information, see Features of proxy nodes.
Direct connection mode
For standard master-replica instances, clients directly connect to the master nodes of the instances.
For Tair cluster instances, clients directly connect to the instances, and tasks such as load balancing are handled by the instances. This is exactly the same as the direct connection to native Redis clusters.
Supported network types and connection modes for instances of different architectures
In the following table, ️️️️️✔️ indicates that the feature is supported and ❌ indicates that the feature is not supported.
Deployment mode | Instance architecture | Connection mode | VPC | Internet |
Cloud-native | Standard architecture | Direct connection mode | ✔️ | ✔️ |
Cluster architecture1 | Direct connection mode | ✔️ | ❌ | |
Proxy mode | ✔️ | ✔️ | ||
Read/write splitting architecture | Proxy mode | ✔️ | ✔️ | |
Classic | Standard architecture | Direct connection mode | ✔️ | ✔️ |
Cluster architecture2 | Proxy mode Direct connection mode | ✔️ | ✔️ | |
Read/write splitting architecture | Proxy mode | ✔️ | ✔️ |
1Cloud-native cluster instances support only the direct connection mode or the proxy mode.
2Classic cluster instances support both the direct connection mode and the proxy mode.
VPC and Internet
Network types supported by Tair:
VPC
A virtual private cloud (VPC) is a private network that is isolated from other networks at the network layer on top of physical-layer protocols. VPCs provide high security, reliability, flexibility, scalability, and ease of use. For more information, see What is a VPC?
Scenario: An Elastic Compute Service (ECS) instance is deployed in the same VPC as your Tair instance, and the ECS instance can connect to your Tair instance over the VPC. This achieves higher security and lower network latency.
Internet
For more information, see Apply for a public endpoint for a Tair instance.
Although you are not charged for the traffic to connect to Tair instances over the Internet, the connection may incur risks. We recommend that you use a VPC to ensure higher security.
Scenario: Your Tair instance can be connected over the Internet by using your on-premises device, an ECS instance deployed in a different VPC, or a device within a third-party cloud service.
FAQ
Why is the endpoint of an instance not displayed after I connect to the instance?
Why am I unable to find the entry point to apply for a public endpoint for an instance?
How do I know whether an instance is a cloud-native cluster instance that runs in direct connection mode?
How do I enable the proxy mode for an instance?
连接失败怎么办?
Can I connect to a replica node? Why am I unable to see the endpoint of a replica node?
References
Methods to connect to Tair instances:
If your client fails to connect to an instance and an error is reported, you can refer to the solutions that are provided in Common errors and solutions.