Tair:Connect to a Tair instance

Password-only logon

• Logon method: Connect to your instance by using a password instead of a username-password combination.

• Limits: This method is applicable only to the default account of your instance. Typically, the username of the default account is the instance ID. Examples: r-bp1jpghfglv6****** and default. You can view the default account on the Account Management page in the console.

  This method does not apply to standard accounts.

• Benefits: This method is similar to the way you connect to open source Redis. This is a convenient and widely used method. In this case, the instance may connect to multiple applications by using the default account because an instance has only a single default account.

• Example of using redis-cli to connect to an instance:

  # Use the default account whose username is r-bp1jpghfglv6****** and password is Rp829dlwa to connect to the instance. 
  redis-cli -h r-bp1zx****.redis.rds.aliyuncs.com -p 6379 -a Rp829dlwa

Username-password logon (recommended)

• Logon method: Use the username and password of an account to connect to your instance. Separate the username and password with a colon (:). Example: user:password.

  Note

  • If you use a third-party database management tool such as RDM to connect to your Tair instance, enter the password in the user:password format.

  • If you use Data Management (DMS) to connect to your Tair instance, enter the username of the database account and corresponding password.

  • Tair instances that are compatible with Redis 6.0 or later also support the AUTH user password format and the features of open source Redis 6.0 or later.

• Limits: No limits are imposed on this method. This method is applicable to both the default account and standard accounts of your instance.

• Benefits: You can create multiple accounts for your Tair instance and connect to your instance by using different accounts in different applications to ensure data security. For more information about how to create a database account, see Create and manage database accounts.

• Example of using redis-cli to connect to an instance:

  # Use a custom account whose username is testaccount and password is Rp829dlwa to connect to the instance. 
  
  # Format 1: user:password. 
  # This format is applicable to Tair and ApsaraDB for Redis instances. 
  redis-cli -h r-bp1zx****.redis.rds.aliyuncs.com -p 6379 -a testaccount:Rp829dlwa
  
  # Format 2: user password. 
  # This format is applicable to Tair and ApsaraDB for Redis instances that are compatible with Redis 6.0 or later. 
  redis-cli -h r-bp1zx****.redis.rds.aliyuncs.com -p 6379 
  AUTH testaccount Rp829dlwa

Password-free logon

• Logon method: Connect to your instance without using a username or password.

• Limits:

  • Client: Your client must be deployed within the same VPC as your Tair instance.

  • Instance: Your Tair instance must have password-free access enabled. For more information, see Enable password-free access.

  This method is applicable only when you use the default account to connect to the instance over the internal endpoint of the instance. After you connect to the instance by using this method, you have read and write permissions on the instance.

• Benefits: You can connect to your instance without using a password. This method is less secure than the preceding methods. By default, all clients that are deployed within the same VPC as the instance can connect to the instance by using this method. You can use the #no_loose_check-whitelist-always parameter to specify whether to check that the IP address of a client is added to a whitelist of the instance. For more information, see Parameters that can be configured for Tair instances.

• Example of using redis-cli to connect to an instance:

  # Connect to your instance in password-free mode. 
  redis-cli -h r-bp1zx****.redis.rds.aliyuncs.com -p 6379

If you forget your password, reset the password. If you have not set the password, set the password. For more information, see Change or reset the password.

Common errors