redis-cli を使用して Tair に接続する,redis-cli を使用して Redis に接続する - Tair (Redis® OSS-Compatible)

redis-cli は、Redis に付属のコマンドラインツールです。 redis-cli を使用すると、ECS インスタンスまたはオンプレミスデバイスから Tair および Redis インスタンスに接続して管理できます。このトピックでは、redis-cli のインストール、インスタンスへの接続、および一般的な接続エラーのトラブルシューティング方法について説明します。

無料トライアル

Alibaba Cloud は、対象となる新規ユーザーが期間限定で Alibaba Cloud プロダクトを試用できる無料トライアルを提供しています。詳細については、「無料トライアル」をご参照ください。

接続ワークフロー

手順	説明
1. インスタンスアカウントのパスワードを設定します。	次のいずれかの方法を選択できます。インスタンスのデフォルトアカウントのパスワードを設定します。詳細については、「パスワードの変更またはリセット」をご参照ください。新しいアカウントを作成してパスワードを設定します。詳細については、「アカウントの作成と管理」をご参照ください。
2. IP アドレスをホワイトリストに追加します。	ホワイトリスト内の IP アドレスのみがインスタンスに接続できます。デバイスに基づいてネットワークタイプを決定し、対応する IP アドレスをインスタンスのホワイトリストに追加する必要があります。 ECS (推奨): VPC (Virtual Private Cloud) を使用します。 ECS インスタンスとお使いのインスタンスが同じ VPC にあることを確認してください。次に、ECS インスタンスのプライベート IP アドレスをインスタンスのホワイトリストに追加します。説明 ECS インスタンスとインスタンスが異なるリージョンなど、異なる VPC にある場合は、ECS インスタンスのパブリック IP アドレスをホワイトリストに追加する必要があります。これで、ECS インスタンスからインスタンスのパブリックエンドポイントに接続できます。オンプレミスデバイス: インターネットを使用します。オンプレミスデバイスのパブリック IP アドレスをインスタンスのホワイトリストに追加します。 IP アドレスをホワイトリストに追加する方法の詳細については、「IP ホワイトリストの設定」をご参照ください。
3. インスタンスの接続情報を取得します。	VPC 経由で接続する場合: コンソールでインスタンスの専用ネットワークエンドポイントを取得します。インターネット経由で接続する場合: コンソールでインスタンスのパブリックエンドポイントを申請して取得します。説明デフォルトでは、インスタンスには専用ネットワークエンドポイントしかありません。インターネット経由で接続するには、パブリックエンドポイントを申請する必要があります。詳細については、「エンドポイントの表示」をご参照ください。
4. redis-cli を使用してインスタンスに接続します。	redis-cli を解凍したディレクトリで、関連するコマンドを実行します。接続コマンド: `redis-cli -h hostname -p port` 接続コマンドの例: `redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379` パスワードコマンド: `AUTH user:password` パスワードコマンドの例: `AUTH testaccount:Rp829dlwa` 詳細については、このトピックの「Redis または Tair インスタンスへの接続」をご参照ください。

redis-cli をインストールする

お使いのデバイスに redis-cli がインストールされていない場合は、次の手順に従ってインストールできます。

redis-cli のインストール手順

ECS インスタンスまたはオンプレミスデバイスに Redis をインストールすると、redis-cli もインストールされます。 redis-cli のバージョンは、Tair (Redis OSS-compatible) インスタンスのバージョンと一致する必要はありません。

redis-cli をインストールするデバイス (ECS インスタンスやオンプレミスデバイスなど) にログインします。
redis-cli をダウンロードしてインストールします。
Linux
次のコマンドを実行して、GCC 依存関係をインストールします。
```
sudo yum -y install gcc
```
次のコマンドを実行して、Redis ソースファイルをダウンロードします。
```
wget https://download.redis.io/releases/redis-7.2.0.tar.gz
```
説明
このトピックでは、Redis 7.2.0 を例として使用します。他のバージョンをインストールすることもできます。詳細については、「Redis 公式ウェブサイト」をご参照ください。
次のコマンドを実行して、Redis ソースファイルを解凍します。
```
tar xzf redis-7.2.0.tar.gz
```
次のコマンドを実行して、解凍したディレクトリに移動します。次に、Redis ソースファイルをコンパイルしてインストールします。
```
cd redis-7.2.0&&make
```
説明
コンパイルとインストールには、通常 2〜3 分かかります。
macOS
macOS では、Homebrew パッケージマネージャを使用して Redis クライアントをインストールできます。
Homebrew のインストール (まだインストールされていない場合)
1. ターミナルを開きます。
2. 次のコマンドをコピーしてターミナルに貼り付け、Enter キーを押します。このコマンドは、Homebrew インストールスクリプトをダウンロードして実行します。
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
1. 画面の指示に従います。パスワードの入力が必要になる場合があります。
Homebrew を使用して Redis をインストールする
ターミナルで次のコマンドを実行して、redis-cli を含む Redis ツールセットをインストールします。
```
brew install redis
```
このコマンドは、システムの Redis の最新の安定バージョンをダウンロードしてインストールします。インストールが完了したら、ターミナルでコマンド which redis-cli を実行して redis-cli の場所を見つけることができます。
Windows
64 ビットの Windows システムのみがサポートされています。
1. Redis-x64-3.2.100.zip ファイルをダウンロードします。
  説明
  このトピックでは、Redis 3.2 を例として使用します。他のバージョンをインストールすることもできます。詳細については、「MicrosoftArchive-Redis」をご参照ください。
2. Redis-x64-3.2.100.zip ファイルをターゲットのインストールディレクトリに解凍します。

Redis または Tair インスタンスに接続する

redis-cli がインストールされているディレクトリに移動します。
Linux
..\redis-7.2.0\src ディレクトリに移動します。たとえば、cd /home/redis-7.2.0/src を実行します。
macOS
../redis-cli ディレクトリに移動します。たとえば、cd /opt/homebrew/bin を実行します。
Windows
コマンドラインウィンドウを開き、redis-cli があるディレクトリに移動します。

次のコマンドを実行して、redis-cli を使用してインスタンスに接続します。

./redis-cli -h <hostname> -p <port> [-c]

説明

Windows PowerShell で redis-cli を起動するには、コマンド .\redis-cli -h hostname -p port [-c] を実行します。

表 1. パラメーター

パラメーター	説明	取得方法
hostname	インスタンスのエンドポイント。	VPC 経由で接続する場合: インスタンスの VPC エンドポイントを取得します。インターネット経由で接続する場合: インスタンスのパブリックエンドポイントを取得します。詳細については、「エンドポイントの表示」をご参照ください。
port	インスタンスのポート番号。	デフォルトのポート番号は 6379 です。ポート番号をカスタマイズすることもできます。詳細については、「エンドポイントまたはポートの変更」をご参照ください。
-c	クラスターモードを有効にします。	このモードは、ダイレクト接続アドレスを使用して接続する場合に、クラスターアーキテクチャインスタンスでのみ使用できます。

接続例：

デフォルトのエンドポイント (標準アーキテクチャインスタンスのエンドポイントまたはクラスターアーキテクチャインスタンスのプロキシエンドポイント):
```
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
```
クラスターアーキテクチャインスタンスのダイレクト接続エンドポイント:
```
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
```

次のコマンドを実行して、パスワード認証を完了します。

AUTH <password>

表 2. パラメーター

パラメーター

説明

password

アカウントの種類に応じてアカウントとパスワードを入力します。

デフォルトアカウント (通常は default という名前、またはインスタンス ID): パスワードのみを入力します。
標準アカウント: パスワードの形式は user:password です。たとえば、カスタムアカウントが testaccount で、パスワードが Rp829dlwa の場合、パスワードを testaccount:Rp829dlwa として入力する必要があります。

説明

パスワードを忘れた場合、または設定していない場合は、リセットしてください。詳細については、「パスワードの変更またはリセット」をご参照ください。
インスタンスで VPC 経由のパスワードなしのアクセスが有効になっている場合、VPC 経由でインスタンスに接続するときにパスワード認証は必要ありません。コマンドを直接実行できます。

例：

AUTH testaccount:Rp829dlwa

OK の応答は、接続が成功し、コマンドを実行できることを示します。

エラーが発生した場合は、「一般的なエラー」をご参照ください。
インスタンスがサポートするコマンドの詳細については、「コマンドの概要」をご参照ください。

一般的なエラー

説明

インスタンスのマイナーバージョンが古い場合、返されるエラーメッセージが次の表のメッセージと異なる場合があります。インスタンスを最新のマイナーバージョンにアップグレードできます。詳細については、「マイナーバージョンとプロキシバージョンの更新」をご参照ください。

エラーメッセージ	原因と解決策
`(error) ERR illegal address`	正しい IP アドレスがホワイトリストに追加されていません。接続ワークフローセクションの手順 2 の説明に従って、正しい IP アドレスをホワイトリストに追加できます。
`(error) ERR client ip is not in whitelist`
`(error) ERR invalid password` `(error) WRONGPASS invalid username-password pair`	パスワードが正しくありません。正しいパスワードと形式を使用してください。パスワードの形式は、アカウントの種類によって異なります。デフォルトアカウント (通常は `default` という名前、またはインスタンス ID): パスワードのみを入力します。標準アカウント: パスワードの形式は `user:password` です。たとえば、カスタムアカウントが `testaccount` で、パスワードが `Rp829dlwa` の場合、パスワードを `testaccount:Rp829dlwa` として入力する必要があります。説明 RDM などのサードパーティのデータベース管理ツールを使用してインスタンスに接続する場合は、パスワードフィールドに `user:password` 形式でパスワードを入力する必要があります。パスワードを忘れた場合は、リセットできます。詳細については、「パスワードの変更またはリセット」をご参照ください。