Tous les produits
Search
Centre de documentation

Tair (Redis® OSS-Compatible):Étape 3 : Se connecter à une instance

Dernière mise à jour :Oct 10, 2026

Connectez-vous à une instance Tair (Redis OSS-compatible) avec redis-cli, du code ou Data Management (DMS).

Prérequis

Procédure

redis-cli

Cet exemple utilise redis-cli sur une instance Elastic Compute Service (ECS) Linux pour se connecter à une instance Tair (Redis OSS-compatible) située dans le même cloud privé virtuel (VPC).

Remarque

Pour vous connecter via Internet, demandez un endpoint public.

  1. Connectez-vous à l'instance ECS et exécutez les commandes suivantes pour télécharger, compiler et installer 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

    Cet exemple utilise redis-cli 7.2.0. Vous pouvez installer une version différente. La compilation prend 2 à 3 minutes.

  2. Exécutez la commande suivante pour vous connecter à l'instance :

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

    Paramètres :

    • hostname : l'endpoint de l'instance. Dans la section Connection Information de la page des détails de l'instance, repérez l'endpoint VPC, par exemple r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com. Pour plus d'informations, consultez la rubrique Afficher les endpoints.

    • password : le mot de passe de l'instance.

    • port : le numéro de port. Valeur par défaut : 6379.

    Exemple de commande :

    src/redis-cli -h r-8vbwds91ie1rdl****.redis.zhangbei.rds.aliyuncs.com -a TestPassword123 -p 6379
  3. Écrivez et lisez des données.

    1. Exécutez la commande SET bar foo.

      Sortie attendue : OK.

    2. Exécutez la commande GET bar.

      Sortie attendue : "foo".

Code

Remarque

Pour vous connecter via Internet, demandez un endpoint public.

Cet exemple utilise le client Jedis . Pour les autres types de clients, reportez-vous à la rubrique Exemples de code de connexion avec des types de clients courants.

  1. Ajoutez les dépendances requises au fichier 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. Modifiez les paramètres de connexion selon les commentaires.

    @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. Testez la connectivité.

    @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");
            }
    
        }
    }

    Si la connexion réussit, la sortie est la suivante :

    Connection successful: hello world!

DMS

  1. Connectez-vous à la console et accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance à gérer. Repérez ensuite l'instance et cliquez sur son ID.

  2. Dans le coin supérieur droit de la page des détails de l'instance, cliquez sur Log into Database.

  3. Dans la boîte de dialogue Log on to Database Instance, définissez le paramètre Access mode sur password login et saisissez un mot de passe.

    Ce mode utilise le compte par défaut. Consultez les détails du compte sur la page Account Management de la console.

  4. Cliquez sur Login.

  5. Écrivez et lisez des données.

    1. Sur la page SQLConsole, saisissez la commande SET foo hello et cliquez sur Execute(F8).

      Sortie attendue : OK.

    2. Saisissez la commande GET foo et cliquez sur Execute(F8).

      Sortie attendue : hello.

Références

Pour plus d'informations, consultez les rubriques suivantes :

Méthodes de connexion spéciales

Erreurs courantes et dépannage

Message d'erreur

Cause et solution

(error) ERR illegal address

La liste d'autorisation est mal configurée.

  1. Vérifiez si l'adresse IP de votre client est ajoutée à une liste d'autorisation de l'instance. Pour plus d'informations, consultez l'Étape 2 : Configurer les listes d'autorisation.

  2. Vérifiez l'endpoint de l'instance. Utilisez l'endpoint public pour les connexions Internet.

  3. Vérifiez que votre instance ECS se trouve dans le même VPC que l'instance Tair (Redis OSS-compatible). Sinon, connectez-vous via Internet.

Exécutez ping <Endpoint de l'instance> pour vérifier la connectivité. Exemple : ping r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com.

(error) ERR client ip is not in whitelist

Could not connect to Redis

  • (error) ERR invalid password

  • (error) WRONGPASS invalid username-password pair

Mot de passe invalide. Le format requis varie selon le type de compte.

  • Si vous utilisez le compte par défaut, saisissez le mot de passe. Par exemple, si le nom d'utilisateur du compte par défaut est r-bp1zxszhcgatnx**** et le mot de passe est Password21, la commande utilisée pour vérifier le mot de passe est AUTH Password21.

  • Si vous utilisez un compte personnalisé, saisissez le mot de passe au format user:password. Par exemple, si le nom d'utilisateur du compte personnalisé est testaccount et le mot de passe est Rp829dlwa, la commande utilisée pour vérifier le mot de passe est AUTH testaccount:Rp829dlwa.

Remarque
  • Lors de l'utilisation d'un outil tiers tel que RDM, saisissez le mot de passe au format user:password et laissez le champ username vide. Sinon, la connexion à l'instance échouera.

  • Si vous avez oublié votre mot de passe, vous pouvez le réinitialiser. Pour plus d'informations, consultez la rubrique Modifier ou réinitialiser le mot de passe.