Tair (Redis® OSS-Compatible):redis-cli を使用したインスタンスへの接続

前提条件

作業を開始する前に、以下が準備できていることを確認してください：

• インスタンスアカウントのパスワードが設定されていること。デフォルトアカウントのパスワードを使用するか、標準アカウントを作成して独自のパスワードを設定できます。パスワードの変更またはリセットについては、「パスワードの変更またはリセット」をご参照ください。

• お使いのデバイスの IP アドレスがインスタンスの IP ホワイトリストに追加されていること。詳細については、「IP ホワイトリストの設定」をご参照ください。

• インスタンスのエンドポイントを取得済みであること。詳細については、「エンドポイントの表示」をご参照ください。

使用するエンドポイントと IP アドレス：

デフォルトでは、インスタンスには VPC エンドポイントしかありません。インターネット経由で接続するには、まず パブリックエンドポイントを申請する必要があります。

redis-cli のインストール

redis-cli は Redis パッケージの一部としてインストールされます。redis-cli のバージョンは、インスタンスのバージョンと一致する必要はありません。

インスタンスへの接続

1. redis-cli ディレクトリへの移動

   Linux

   Redis ソースフォルダー内の src ディレクトリに移動します。たとえば、cd /home/redis-7.2.0/src を実行します。

   macOS

   Homebrew の bin ディレクトリに移動します。たとえば、cd /opt/homebrew/bin を実行します。

   Windows

   コマンドラインウィンドウを開き、redis-cli が配置されているディレクトリに移動します。

2. 接続コマンドの選択

   コマンドを実行する前に、次の 2 点を確認してください：

   • インスタンスアーキテクチャ — 標準またはクラスター。コンソールのインスタンス詳細ページで確認できます。

   • 接続タイプ — VPC エンドポイントまたはパブリックエンドポイント。これにより、使用するホスト名が決まります。

   設定に一致するコマンドを選択してください：

   シナリオ	コマンド
   標準アーキテクチャ、またはプロキシエンドポイント経由のクラスターアーキテクチャ	./redis-cli -h <hostname> -p <port>
   直接接続アドレス経由のクラスターアーキテクチャ	./redis-cli -h <hostname> -p <port> -c

   Windows PowerShell では、./redis-cli を .\redis-cli に置き換えてください。

   パラメーター：

   パラメーター	説明	取得方法
   <hostname>	インスタンスのエンドポイント	コンソールで VPC エンドポイントまたはパブリックエンドポイントを確認できます。詳細については、「エンドポイントの表示」をご参照ください。
   <port>	インスタンスのポート	デフォルトは 6379 です。カスタムポートについては、「エンドポイントまたはポートの変更」をご参照ください。
   -c	クラスターモードの有効化	クラスターアーキテクチャのインスタンスで 直接接続アドレスを使用する場合にのみ必要です。

   例：

   ./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

3. 認証

   接続後、AUTH コマンドを実行します：

   AUTH <password>

   パスワードの形式は、アカウントの種類によって異なります：

   アカウントの種類	パスワードの形式	例
   デフォルトアカウント (名前が default またはインスタンス ID)	パスワードのみ	AUTH Rp829dlwa
   標準アカウント	user:password	AUTH testaccount:Rp829dlwa

   VPC 経由でのパスワードなしのアクセスが有効になっている場合は、認証をスキップして直接コマンドを実行できます。

4. 接続の確認

   OK が AUTH コマンドの応答として返されれば、接続は成功です。簡単なテストを実行して、読み取り/書き込みアクセスが可能か確認します：

   set testkey "hello"    # テスト値を書き込む
   OK
   get testkey            # 読み戻す
   "hello"
   set tempkey "bye" EX 5 # 5 秒の有効期限付きで書き込む
   get tempkey
   "bye"
                          # 5 秒待機
   get tempkey
   (nil)                  # キーの有効期限が切れた

   サポートされているコマンドのリストについては、「コマンドの概要」をご参照ください。

トラブルシューティング

インスタンスのマイナーバージョンが古い場合、エラーメッセージが以下と異なることがあります。 マイナーバージョンを更新して、最新のエラーメッセージが表示されるようにしてください。

RDM などのサードパーティーツールを使用する場合、パスワードフィールドに user:password 形式でパスワードを入力してください。

関連トピック

• コマンドの概要：サポートされている Redis コマンドを閲覧できます。

• アカウントの作成と管理：インスタンスのアカウントと権限の管理。