Tair (Redis® OSS-Compatible)：Gunakan mode koneksi langsung untuk menghubungkan ke instans cluster

Contoh ini menggunakan Jedis 4.3.0. Untuk informasi lebih lanjut, kunjungi GitHub.

• Kolam Koneksi Kustom (Direkomendasikan)

  import redis.clients.jedis.*;
  import java.util.HashSet;
  import java.util.Set;
  
  public class DirectTest {
      private static final int DEFAULT_TIMEOUT = 2000;
      private static final int DEFAULT_REDIRECTIONS = 5;
      private static final ConnectionPoolConfig config = new ConnectionPoolConfig();
  
      public static void main(String args[]) {
          // Tentukan jumlah maksimum koneksi. Dalam mode koneksi langsung, klien langsung terhubung ke shard dari instans cluster. Oleh karena itu, persyaratan berikut harus dipenuhi: Jumlah klien × Nilai MaxTotal < Jumlah maksimum koneksi ke satu shard. 
          config.setMaxTotal(30);
          // Tentukan jumlah maksimum koneksi idle berdasarkan kebutuhan bisnis Anda. 
          config.setMaxIdle(20);
          config.setMinIdle(15);
  
          // Tentukan titik akhir pribadi yang dialokasikan untuk instans cluster. 
          String host = "r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com";
          int port = 6379;
          // Tentukan kata sandi yang digunakan untuk terhubung ke instans cluster. 
          String password = "xxxxx";
  
          Set<HostAndPort> jedisClusterNode = new HashSet<HostAndPort>();
          jedisClusterNode.add(new HostAndPort(host, port));
          JedisCluster jc = new JedisCluster(jedisClusterNode, DEFAULT_TIMEOUT, DEFAULT_TIMEOUT, DEFAULT_REDIRECTIONS,
              password, "clientName", config);
  
          jc.set("key", "value");
          jc.get("key");
  
          jc.close();     // Jika aplikasi keluar dan Anda ingin menghapus sumber daya, panggil metode ini. Dengan cara ini, koneksi ditutup, dan sumber daya dilepaskan. 
      }
  }

• Kolam Koneksi Default

  import redis.clients.jedis.ConnectionPoolConfig;
  import redis.clients.jedis.HostAndPort;
  import redis.clients.jedis.JedisCluster;
  import java.util.HashSet;
  import java.util.Set;
  
  public class DirectTest{
      private static final int DEFAULT_TIMEOUT = 2000;
      private static final int DEFAULT_REDIRECTIONS = 5;
      private static final ConnectionPoolConfig DEFAULT_CONFIG = new ConnectionPoolConfig();
  
      public static void main(String args[]){
  
          // Tentukan titik akhir pribadi yang dialokasikan untuk instans cluster. 
          String host = "r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com";
          int port = 6379;
          String password = "xxxx";
  
          Set<HostAndPort>  jedisClusterNode = new HashSet<HostAndPort>();
          jedisClusterNode.add(new HostAndPort(host, port));
  
          JedisCluster jc = new JedisCluster(jedisClusterNode, DEFAULT_TIMEOUT, DEFAULT_TIMEOUT,
              DEFAULT_REDIRECTIONS,password, "clientName", DEFAULT_CONFIG);
  
          jc.set("key","value");
          jc.get("key");
  
          jc.close();     // Jika aplikasi keluar dan Anda ingin menghapus sumber daya, panggil metode ini. Dengan cara ini, koneksi ditutup, dan sumber daya dilepaskan. 
      }
  }

Contoh ini menggunakan PhpRedis 5.3.7. Untuk informasi lebih lanjut, kunjungi GitHub.

<?php
 // Tentukan titik akhir pribadi dan nomor port yang digunakan untuk terhubung ke instans cluster. 
 $array = ['r-bp1xxxxxxxxxxxx.redis.rds.aliyuncs.com:6379'];
 // Tentukan kata sandi yang digunakan untuk terhubung ke instans cluster. 
 $pwd = "xxxx";
 
 // Gunakan kata sandi untuk terhubung ke instans cluster. 
 $obj_cluster = new RedisCluster(NULL, $array, 1.5, 1.5, true, $pwd);
 
 // Tampilkan hasil koneksi. 
 var_dump($obj_cluster);
 
 if ($obj_cluster->set("foo", "bar") == false) {
     die($obj_cluster->getLastError());
 }
 $value = $obj_cluster->get("foo");
 echo $value;
 ?>

Contoh ini menggunakan Python 3.9 dan redis-py 4.4.1. Untuk informasi lebih lanjut, kunjungi GitHub.

# !/usr/bin/env python
# -*- coding: utf-8 -*-
from redis.cluster import RedisCluster
# Ganti nilai parameter host dan port dengan titik akhir dan nomor port yang digunakan untuk terhubung ke instans. 
host = 'r-bp10noxlhcoim2****.redis.rds.aliyuncs.com'
port = 6379
# Ganti nilai parameter user dan pwd dengan nama pengguna dan kata sandi yang digunakan untuk terhubung ke instans. 
user = 'testaccount'
pwd = 'Rp829dlwa'
rc = RedisCluster(host=host, port=port, username=user, password=pwd)
# Anda dapat melakukan operasi pada instans setelah koneksi dibuat. Kode berikut memberikan contoh tentang cara memanggil metode set dan get: 
rc.set('foo', 'bar')
print(rc.get('foo'))

Proyek sampel berikut dibuat menggunakan Maven. Anda juga dapat mengunduh klien Lettuce atau Jedis secara manual.

1. Tambahkan dependensi Maven berikut:

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <parent>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-parent</artifactId>
           <version>2.4.2</version>
           <relativePath/> <!-- lookup parent from repository -->
       </parent>
       <groupId>com.aliyun.tair</groupId>
       <artifactId>spring-boot-example</artifactId>
       <version>0.0.1-SNAPSHOT</version>
       <name>spring-boot-example</name>
       <description>Demo project for Spring Boot</description>
       <properties>
           <java.version>1.8</java.version>
       </properties>
       <dependencies>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-web</artifactId>
           </dependency>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-test</artifactId>
               <scope>test</scope>
           </dependency>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-data-redis</artifactId>
           </dependency>
           <dependency>
               <groupId>redis.clients</groupId>
               <artifactId>jedis</artifactId>
           </dependency>
           <dependency>
               <groupId>io.lettuce</groupId>
               <artifactId>lettuce-core</artifactId>
               <version>6.3.0.RELEASE</version>
           </dependency>
           <dependency>
               <groupId>io.netty</groupId>
               <artifactId>netty-transport-native-epoll</artifactId>
               <version>4.1.100.Final</version>
               <classifier>linux-x86_64</classifier>
           </dependency>
       </dependencies>
       <build>
           <plugins>
               <plugin>
                   <groupId>org.springframework.boot</groupId>
                   <artifactId>spring-boot-maven-plugin</artifactId>
               </plugin>
           </plugins>
       </build>
   </project>

2. Masukkan kode berikut di editor Spring Data Redis dan modifikasi berdasarkan komentar.

   Contoh ini menggunakan Spring Data Redis 2.4.2.

   • (Direkomendasikan) Spring Data Redis dengan Jedis

     @Bean
          JedisConnectionFactory redisConnectionFactory() {
              List<String> clusterNodes = Arrays.asList("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379");
              RedisClusterConfiguration redisClusterConfiguration = new RedisClusterConfiguration(clusterNodes);
              redisClusterConfiguration.setUsername("user");
              redisClusterConfiguration.setPassword("password");
            
      
              JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
              // Tentukan jumlah maksimum koneksi idle. Dalam mode koneksi langsung, klien langsung terhubung ke shard dari instans cluster. Oleh karena itu, persyaratan berikut harus dipenuhi: Jumlah klien × Nilai MaxTotal < Jumlah maksimum koneksi ke satu shard. 
              jedisPoolConfig.setMaxTotal(30);
              // Tentukan jumlah maksimum koneksi idle berdasarkan kebutuhan bisnis Anda. 
              jedisPoolConfig.setMaxIdle(20);
              // Nonaktifkan testOn[Borrow|Return] untuk mencegah menghasilkan perintah ping tambahan.
              jedisPoolConfig.setTestOnBorrow(false);
              jedisPoolConfig.setTestOnReturn(false);
      
              return new JedisConnectionFactory(redisClusterConfiguration, jedisPoolConfig);
          }

   • Spring Data Redis dengan Lettuce

     Peringatan

     • Konfigurasi default Lettuce dapat menyebabkan masalah seperti latensi aplikasi meningkat dan ketidaktersediaan saat instans diubah. Untuk mengonfigurasi Lettuce dengan benar, bacalah deskripsi parameter terkait Lettuce.

     • Versi Lettuce harus 6.3.0.RELEASE atau lebih baru. Untuk informasi lebih lanjut, lihat [Pemberitahuan] Saran untuk Pemutakhiran Lettuce.

          /**
          * Aktifkan TCP keepalive dan konfigurasikan tiga parameter berikut:
          *  TCP_KEEPIDLE = 30
          *  TCP_KEEPINTVL = 10
          *  TCP_KEEPCNT = 3
          */
         private static final int TCP_KEEPALIVE_IDLE = 30;
     
         /**
          * Anda dapat menggunakan parameter TCP_USER_TIMEOUT untuk menghindari situasi di mana Lettuce tetap macet dalam loop timeout terus-menerus selama kejadian kegagalan atau crash. 
          * refer: https://github.com/lettuce-io/lettuce-core/issues/2082
          */
         private static final int TCP_USER_TIMEOUT = 30;
     
         @Bean
         public LettuceConnectionFactory redisConnectionFactory() {
             List<String> clusterNodes = Arrays.asList("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379");
             RedisClusterConfiguration redisClusterConfiguration = new RedisClusterConfiguration(clusterNodes);
             redisClusterConfiguration.setUsername("user");
             redisClusterConfiguration.setPassword("password");
     
             // Konfigurasi TCP KeepAlive
             SocketOptions socketOptions = SocketOptions.builder()
                 .keepAlive(KeepAliveOptions.builder()
                     .enable()
                     .idle(Duration.ofSeconds(TCP_KEEPALIVE_IDLE))
                     .interval(Duration.ofSeconds(TCP_KEEPALIVE_IDLE / 3))
                     .count(3)
                     .build())
                 .tcpUserTimeout(TcpUserTimeoutOptions.builder()
                     .enable()
                     .tcpUserTimeout(Duration.ofSeconds(TCP_USER_TIMEOUT))
                     .build())
                 .build();
     
             ClusterTopologyRefreshOptions topologyRefreshOptions = ClusterTopologyRefreshOptions.builder()
                 .enablePeriodicRefresh(Duration.ofSeconds(60))
                 .dynamicRefreshSources(false)
                 .enableAllAdaptiveRefreshTriggers() 
                 .adaptiveRefreshTriggersTimeout(Duration.ofSeconds(15)).build();
     
             LettuceClientConfiguration lettuceClientConfiguration = LettuceClientConfiguration.builder().
                 clientOptions(ClusterClientOptions.builder()
                     .socketOptions(socketOptions)
                     .validateClusterNodeMembership(false) 
                     .topologyRefreshOptions(topologyRefreshOptions).build()).build();
     
             return new LettuceConnectionFactory(redisClusterConfiguration, lettuceClientConfiguration);
         }

Contoh ini menggunakan .NET 6.0 dan StackExchange.Redis 2.6.90.

using StackExchange.Redis;

class RedisConnSingleton {
    // Tentukan titik akhir, nomor port, nama pengguna, dan kata sandi yang digunakan untuk terhubung ke instans cluster. 
    private static ConfigurationOptions configurationOptions = ConfigurationOptions.Parse("r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379,user=testaccount,password=Rp829dlwa,connectTimeout=2000");
    //lock untuk singleton
    private static readonly object Locker = new object();
    //singleton
    private static ConnectionMultiplexer redisConn;
    //singleton
    public static ConnectionMultiplexer getRedisConn()
    {
        if (redisConn == null)
        {
            lock (Locker)
            {
                if (redisConn == null || !redisConn.IsConnected)
                {
                    redisConn = ConnectionMultiplexer.Connect(configurationOptions);
                }
            }
        }
        return redisConn;
    }
}

class Program
{
    static void Main(string[] args)
    {
        ConnectionMultiplexer cm = RedisConnSingleton.getRedisConn();
        var db = cm.GetDatabase();
        db.StringSet("key", "value");
        String ret = db.StringGet("key");
        Console.WriteLine("get key: " + ret);
    }
}

Contoh ini menggunakan Node.js 19.4.0 dan node-redis 4.5.1.

import { createCluster } from 'redis';

// Tentukan titik akhir, nomor port, nama pengguna, dan kata sandi yang digunakan untuk terhubung ke instans. 
// Setelah Anda menyediakan nama pengguna dan kata sandi untuk parameter url, Anda juga harus menyediakan nama pengguna dan kata sandi global untuk parameter defaults. 
// Nama pengguna dan kata sandi global digunakan untuk mengautentikasi node yang tersisa. Jika node yang tersisa tidak diautentikasi, kesalahan NOAUTH terjadi. 

const cluster = createCluster({
    rootNodes: [{
        url: 'redis://testaccount:Rp829dlwa@r-bp10noxlhcoim2****.redis.rds.aliyuncs.com:6379'
    }],
    defaults: {
        username: 'testaccount',
        password: 'Rp829dlwa'
    }
});

cluster.on('error', (err) => console.log('Redis Cluster Error', err));

await cluster.connect();

await cluster.set('key', 'value');
const value = await cluster.get('key');
console.log('get key: %s', value);

await cluster.disconnect();

Contoh ini menggunakan Go 1.19.7 dan go-redis 9.5.1.