全部产品
Search
文档中心

Tair (Redis® OSS-Compatible):Langkah 3: Terhubung ke sebuah instans

更新时间:Nov 10, 2025

Bagian ini menjelaskan cara terhubung ke instans Tair (Redis OSS-kompatibel) menggunakan redis-cli, kode, atau Data Management (DMS).

Persyaratan awal

Prosedur

redis-cli

Contoh ini menunjukkan cara menggunakan redis-cli pada instans ECS Linux untuk mengakses instans Tair (Redis OSS-kompatibel) dalam VPC yang sama.

Catatan

Untuk terhubung dari perangkat lokal, Anda dapat meminta titik akhir publik dan menggunakannya untuk terhubung.

  1. Masuk ke instans ECS. Jalankan perintah berikut untuk mengunduh, menginstal, dan mengkompilasi redis-cli.

    sudo yum -y install gcc            # Instal dependensi 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

    Contoh ini menggunakan redis-cli versi 7.2.0. Anda dapat menginstal versi lainnya. Proses kompilasi dan instalasi biasanya memakan waktu 2 hingga 3 menit.

  2. Jalankan perintah berikut untuk terhubung ke instans.

    src/redis-cli -h hostname -a kata sandi -p port

    Parameter:

    • hostname: Titik akhir instans. Di area Connection Information konsol, Anda dapat melihat titik akhir VPC instans, seperti r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com. Untuk informasi lebih lanjut, lihat Lihat titik akhir.

    • password: Kata sandi.

    • port: Nomor port. Default adalah 6379.

    Contoh:

    src/redis-cli -h r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com -a TestPassword123 -p 6379
  3. Tulis dan baca data.

    1. Jalankan perintah SET bar foo.

      Output yang diharapkan adalah OK.

    2. Jalankan perintah GET bar.

      Output yang diharapkan adalah "foo".

Koneksi kode

Catatan

Untuk terhubung dari perangkat lokal, Anda dapat meminta titik akhir publik dan menggunakannya untuk terhubung.

Contoh ini menunjukkan cara menggunakan klien Jedis untuk terhubung ke instans. Untuk contoh kode untuk klien umum lainnya, lihat Contoh koneksi untuk klien umum.

  1. Tambahkan konfigurasi pom.xml.

    <!-- Impor spring-data-redis -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-redis</artifactId>
        <!-- Setelah Spring Boot 2.0, Lettuce adalah klien default. Kecualikan Lettuce saat menggunakan Jedis. -->
        <exclusions>
            <exclusion>
                <groupId>io.lettuce</groupId>
                <artifactId>lettuce-core</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- Impor jedis -->
    <dependency>
        <groupId>redis.clients</groupId>
        <artifactId>jedis</artifactId>
    </dependency>
  2. Konfigurasikan informasi koneksi. Ubah parameter berdasarkan komentar.

    @Configuration
    public class RedisConfig {
        
        @Bean
        JedisConnectionFactory redisConnectionFactory() {
            // Contoh ini hanya untuk pengujian koneksi. Dalam lingkungan produksi, kami sarankan Anda menulis informasi koneksi ke file konfigurasi dan membacanya menggunakan anotasi @Value.
            // Dapatkan titik akhir (hostName) dan port (port) dari bagian Informasi Koneksi pada halaman detail instans. Pilih titik akhir VPC atau titik akhir publik berdasarkan lingkungan jaringan klien.
            RedisStandaloneConfiguration config = new RedisStandaloneConfiguration("r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com", 6379);
            // Format kata sandi adalah akun:kata sandi. Misalnya, jika akun adalah testaccount dan kata sandi adalah Rp829dlwa, atur kata sandi menjadi testaccount:Rp829dlwa.
            // Jika Anda lupa akun atau kata sandi, buka halaman detail instans dan klik Manajemen Akun di panel navigasi di sebelah kiri untuk mengatur ulang kata sandi atau membuat akun.
            config.setPassword(RedisPassword.of("Akun:KataSandi"));
            JedisPoolConfig jedisPoolConfig = new JedisPoolConfig();
            // Atur jumlah maksimum koneksi sesuai kebutuhan. Nilai ini tidak boleh melebihi jumlah maksimum koneksi yang didukung oleh tipe instans.
            jedisPoolConfig.setMaxTotal(30);
            // Atur jumlah maksimum koneksi idle sesuai kebutuhan. Nilai ini tidak boleh melebihi jumlah maksimum koneksi yang didukung oleh tipe instans.
            jedisPoolConfig.setMaxIdle(20);
            // Matikan testOn[Borrow|Return] untuk mencegah perintah PING tambahan.
            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. Uji koneksi.

    @SpringBootTest
    public class RedisTest {
        @Autowired
        private RedisTemplate<String, Object> redisTemplate;
    
        @Test
        void test() {
            try {
                redisTemplate.opsForValue().set("test_key", "hello world!");
                System.out.println("Koneksi berhasil:"+redisTemplate.opsForValue().get("test_key"));
            } catch (Exception e) {
                e.printStackTrace();
                System.out.println("Terjadi pengecualian selama koneksi. Lihat dokumentasi di " +
                        "https://www.alibabacloud.com/help/en/redis/support/how-do-i-troubleshoot-connection-issues-in-apsaradb-for-redis" +
                        " untuk memecahkan masalah jaringan, daftar putih, serta akun atau kata sandi." +
                        " Anda juga dapat melihat dokumentasi berdasarkan pesan kesalahan: https://www.alibabacloud.com/help/en/redis/support/common-errors-and-troubleshooting");
            }
    
        }
    }

    Jalankan kode. Jika koneksi berhasil, hasil berikut akan dikembalikan:

    Koneksi berhasil:hello world!

DMS

  1. Masuk ke konsol dan buka halaman Instans. Di bilah navigasi atas, pilih wilayah tempat instans yang ingin Anda kelola berada. Kemudian, temukan instans dan klik ID instans.

  2. Di sudut kanan atas halaman, klik tombol Log on to the database.

  3. Di halaman logon DMS, atur Access Mode ke Password Logon dan masukkan kata sandi Anda.

    Metode ini masuk dengan akun default. Anda dapat melihat detail akun di halaman Account Management di konsol.

  4. Klik tombol Login.

  5. Tulis dan baca data.

    1. Di halaman SQL Console DMS, masukkan perintah SET foo hello dan klik Execute (F8).

      Output yang diharapkan adalah OK.

    2. Masukkan perintah GET foo dan klik Execute (F8).

      Output yang diharapkan adalah hello.

Referensi

Topik berikut memberikan deskripsi dan contoh yang lebih rinci.

Metode Koneksi Khusus

  • Aktifkan enkripsi SSL untuk terhubung ke instans: Mengaktifkan fitur enkripsi Transport Layer Security (TLS) meningkatkan keamanan tautan data dan memastikan integritas data.

  • Gunakan mode koneksi langsung untuk terhubung ke instans: Untuk instans kluster, Anda dapat meminta titik akhir koneksi langsung. Titik akhir ini memungkinkan Anda mengakses shard data backend secara langsung. Ini mirip dengan menghubungkan ke kluster Redis asli. Dibandingkan dengan modus proxy , mode koneksi langsung mengurangi waktu respons karena permintaan tidak perlu diproses oleh proxy.

  • Gunakan mode kompatibel Sentinel untuk terhubung ke instans: Sebuah instans menyediakan mode kompatibel Sentinel. Setelah Anda mengaktifkan mode ini, klien dapat terhubung ke instans dengan cara yang sama seperti menghubungkan ke Sentinel Redis asli.

Kesalahan umum

Pesan kesalahan

Penyebab dan solusi

(error) ERR illegal address

Daftar putih tidak dikonfigurasi dengan benar. Periksa item berikut:

  1. Periksa apakah alamat IP klien telah ditambahkan ke daftar putih instans. Untuk informasi lebih lanjut, lihat Konfigurasikan daftar putih.

  2. Periksa apakah Anda memilih titik akhir yang benar untuk instans. Misalnya, jika Anda terhubung ke instans melalui Internet, Anda harus menggunakan titik akhir publik instans. Jika Anda menggunakan titik akhir VPC, koneksi gagal.

  3. Jika Anda menggunakan instans ECS untuk terhubung melalui VPC, periksa apakah instans ECS dan instans Tair berada dalam VPC yang sama. Jika mereka tidak berada dalam VPC yang sama, Anda harus terhubung melalui Internet.

Setelah Anda memperbaiki masalah, Anda dapat menjalankan perintah ping <titik_akhir_instans> untuk menguji konektivitas jaringan. Misalnya, jalankan ping r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com. Jika tanggapan normal dikembalikan, klien dapat terhubung ke instans.

(error) ERR client ip is not in whitelist

Could not connect to Redis

  • (error) ERR invalid password

  • (error) WRONGPASS invalid username-password pair

Kata sandi tidak valid. Gunakan kata sandi yang benar dalam format yang valid. Format kata sandi bervariasi berdasarkan akun yang dipilih.

  • Jika Anda menggunakan akun default, masukkan kata sandi. Misalnya, jika nama pengguna akun default adalah r-bp1zxszhcgatnx**** dan kata sandi adalah Password21, perintah yang digunakan untuk memverifikasi kata sandi adalah AUTH Password21.

  • Jika Anda menggunakan akun kustom, masukkan kata sandi dalam format pengguna:kata sandi. Misalnya, jika nama pengguna akun kustom adalah testaccount dan kata sandi adalah Rp829dlwa, perintah yang digunakan untuk memverifikasi kata sandi adalah AUTH testaccount:Rp829dlwa.

Catatan
  • Jika Anda menggunakan alat manajemen database pihak ketiga, seperti RDM, untuk terhubung ke instans Anda, masukkan kata sandi dalam format pengguna:kata sandi di bidang kata sandi. Jangan masukkan informasi apa pun di bidang Username. Jika tidak, koneksi gagal.

  • Jika Anda lupa kata sandi, Anda dapat mengatur ulang. Untuk informasi lebih lanjut, lihat Ubah atau atur ulang kata sandi.