Step 3: Connect to an instance

redis-cli

This example uses redis-cli on a Linux Elastic Compute Service (ECS) instance to connect to a Tair (Redis OSS-compatible) instance in the same virtual private cloud (VPC).

1. Log on to the ECS instance and run the following commands to download, compile, and install redis-cli:

   sudo yum -y install gcc            # Install GNU Compiler Collection (GCC).
   wget https://download.redis.io/releases/redis-7.2.0.tar.gz
   tar xzf redis-7.2.0.tar.gz
   cd redis-7.2.0&&make

   This example uses redis-cli 7.2.0. You can install a different version. Compilation takes 2 to 3 minutes.

2. Run the following command to connect to the instance:

   src/redis-cli -h hostname -a password -p port

   Parameters:

   • hostname: the instance endpoint. In the Connection Information section on the instance details page, find the VPC endpoint, for example, r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com. For more information, see View endpoints.

   • password: the instance password.

   • port: the port number. Default: 6379.

   Sample command:

   src/redis-cli -h r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com -a TestPassword123 -p 6379

3. Write and read data.

   1. Run the SET bar foo command.

      Expected output:OK.

   2. Run the GET bar command.

      Expected output:"foo".

Code

This example uses the Jedis client. For the complete code example, see redistest. For other client types, see Connection code examples with common types of clients.

1. Add the required dependencies to pom.xml.

   <!-- Import spring-data-redis -->
   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-redis</artifactId>
       <!-- Since Spring Boot 2.0, Lettuce is the default client. Exclude lettuce when using Jedis. -->
       <exclusions>
           <exclusion>
               <groupId>io.lettuce</groupId>
               <artifactId>lettuce-core</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   <!-- Import jedis -->
   <dependency>
       <groupId>redis.clients</groupId>
       <artifactId>jedis</artifactId>
   </dependency>

2. Modify the connection parameters based on the comments.

   @Configuration
   public class RedisConfig {
       
       @Bean
       JedisConnectionFactory redisConnectionFactory() {
           // This example is used only to test connectivity. In production environments, we recommend that you place connection information in a configuration file and retrieve it using the @Value annotation.
           // The endpoint (hostName) and port (port) can be obtained from the Connection Information section of the instance details page. Select a VPC endpoint or public endpoint based on your client network environment.
           RedisStandaloneConfiguration config = new RedisStandaloneConfiguration("r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com", 6379);
           // Specify the password in the username:password format. For example, if the username is testaccount and the password is Rp829dlwa, enter testaccount:Rp829dlwa as the password.
           // If you forget your username or password, you can reset the password or create a new account by clicking Account Management in the left-side navigation pane of the instance details page.
           config.setPassword(RedisPassword.of("Username:Password"));
           JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
           // Specify the maximum number of connections based on your business requirements. This value cannot exceed the maximum number of connections supported by the instance.
           jedisPoolConfig.setMaxTotal(30);
           // Specify the maximum number of idle connections based on your business requirements. This value cannot exceed the maximum number of connections supported by the instance.
           jedisPoolConfig.setMaxIdle(20);
           // Disable testOn[Borrow|Return] to prevent additional PING commands from being generated.
           jedisPoolConfig.setTestOnBorrow(false);
           jedisPoolConfig.setTestOnReturn(false);
   
           JedisClientConfiguration jedisClientConfiguration = JedisClientConfiguration.builder().usePooling().poolConfig(
                   jedisPoolConfig).build();
   
           return new JedisConnectionFactory(config, jedisClientConfiguration);
       }
       @Bean
       public RedisTemplate<String, Object> redisTemplate() {
           RedisTemplate<String, Object> template = new RedisTemplate<>();
           template.setConnectionFactory(redisConnectionFactory());
           template.setKeySerializer(new StringRedisSerializer());
           template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
           return template;
       }
   }

3. Test connectivity.

   @SpringBootTest
   public class RedisTest {
       @Autowired
       private RedisTemplate<String, Object> redisTemplate;
   
       @Test
       void test() {
           try {
               redisTemplate.opsForValue().set("test_key", "hello world!");
               System.out.println("Connection successful:"+redisTemplate.opsForValue().get("test_key"));
           } catch (Exception e) {
               e.printStackTrace();
               System.out.println("An exception occurred during the connection attempt. Refer to the documentation " +
                       "https://www.alibabacloud.com/help/en/redis/support/how-do-i-troubleshoot-connection-issues-in-apsaradb-for-redis?spm=a2c63.p38356.help-menu-26340.d_5_1_1_4.47ca2024nvxRlS" +
                       "to troubleshoot network, whitelist, and account/password issues." +
                       "You can also refer to the documentation based on the error message: https://www.alibabacloud.com/help/en/redis/support/common-errors-and-troubleshooting?spm=a2c63.p38356.help-menu-26340.d_5_0.77cc79fejApYJN");
           }
   
       }
   }

   If the connection succeeds, the output is:

   Connection successful: hello world!

DMS

1. Log on to the 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.

2. In the upper-right corner of the instance details page, click Log into Database.

3. In the Log on to Database Instance dialog box, set Access mode to password login and enter a password.

   This mode uses the default account. View account details on the Account Management page in the console.

4. Click Login.

5. Write and read data.

   1. On the SQLConsole page, enter the SET foo hello command and click Execute(F8).

      Expected output:OK.

   2. Enter the GET foo command and click Execute(F8).

      Expected output:hello.