redis-cliは、Redisによって提供される組み込みのCLIです。 redis-cliを使用して、Elastic Compute Service (ECS) インスタンスまたはオンプレミスデバイスからTair (Redis OSS互換) インスタンスに接続して管理できます。 このトピックでは、redis-cliをインストールしてTairインスタンスに接続する方法について説明します。 このトピックでは、一般的な接続エラーのトラブルシューティング方法についても説明します。
無料トライアル
Alibaba Cloud無料トライアルは、対象となる新規ユーザーがAlibaba Cloudサービスを期間限定で無料で試すことを可能にするプログラムです。 詳細については、無料トライアルページをご覧ください。
ワークフロー
準備
デバイスにredis-cliがインストールされていない場合は、次の手順を参照してください。
手順
redis-cliがインストールされているディレクトリに移動します。
Windows
CLIを開き、redis-cliがインストールされているディレクトリに移動します。
macOS
末尾にRedis-cliが付いたredisディレクトリに移動します。 例:
cd /opt/homebrew/bin
Linux
接尾辞がsrcのRedisディレクトリに移動します。 例:
cd /home/redis-7.0.0/src
次のコマンドを実行してredis-cliを使用してTairインスタンスに接続します。
./redis-cli -h hostname -p port [-c]
説明Windows PowerShellでredis-cliを開始する場合は、
. \redis-cli -hホスト名-pポート [-c]
コマンドを実行します。表 1 Parameters
パラメーター
説明
パラメータ値を取得するメソッド
ホスト名
Tairインスタンスのエンドポイント。
VPC経由でTairインスタンスに接続する場合は、TairインスタンスのVPCエンドポイントを取得します。
インターネット経由でTairインスタンスに接続する場合は、Tairインスタンスのパブリックエンドポイントを取得します。
詳細については、「エンドポイントの表示」をご参照ください。
ポート
Tairインスタンスのポート番号。
デフォルトのポート番号6379を使用するか、カスタムポート番号を指定します。 詳細については、「インスタンスのエンドポイントまたはポート番号の変更」をご参照ください。
-c
クラスターモードを有効にするかどうかを指定します。
クラスターモードは、Tairインスタンスがプライベートエンドポイントを使用するクラスターインスタンスである場合にのみ使用できます。 詳細については、「クラスターマスターレプリカインスタンス」および「直接接続モードの有効化」をご参照ください。
接続例:
次のサンプルコマンドは、標準インスタンスのエンドポイントやクラスターインスタンスのプロキシエンドポイントなど、デフォルトのエンドポイントを使用してTairインスタンスを接続するシナリオに適しています。
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
次のサンプルコマンドは、プライベートエンドポイントを使用してTairクラスターインスタンスを接続するシナリオに適しています。
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
次のコマンドを実行してパスワードを確認します。
AUTH password
表 2. Parameters
パラメーター
説明
パスワード
アカウントのパスワードを入力します。
ユーザー名が
default
またはインスタンスIDと同じデフォルトアカウントを使用する場合は、パスワードのみを入力します。カスタムアカウントを使用する場合は、
user:password
形式でパスワードを入力します。 たとえば、カスタムアカウントのユーザー名がtestaccount
で、パスワードがRp829dlwa
の場合、パスワードとしてtestaccount:Rp829dlwa
を入力します。
説明パスワードを忘れた場合は、パスワードをリセットしてください。 パスワードを設定していない場合は、パスワードを設定します。 詳細については、「パスワードの変更またはリセット」をご参照ください。
Tairインスタンスに対してパスワードなしのアクセスが有効になっている場合、VPC経由でインスタンスに接続するときに、この手順を実行せずにRedisコマンドを実行できます。 詳細については、「パスワード不要アクセスの有効化」をご参照ください。
例:
AUTH testaccount:Rp829dlwa
[OK]
が表示されると、Tairインスタンスが接続され、Redisコマンドをインスタンスで実行できます。エラーが発生した場合の対処方法については、「一般的なエラーとトラブルシューティング」をご参照ください。
Tair (Redis OSS互換) でサポートされているコマンドについては、「概要」をご参照ください。
一般的なエラーとトラブルシューティング
インスタンスのマイナーバージョンが古い場合、返されるエラーメッセージは次の表に示すものと一致しない可能性があります。 インスタンスを最新のマイナーバージョンに更新することを推奨します。 詳細については、「インスタンスのマイナーバージョンの更新」をご参照ください。
エラーメッセージ | 原因と解決策 |
| ホワイトリストは必要に応じて設定されません。 詳細については、「ワークフロー」セクションの2番目の手順をご参照ください。 |
| |
| パスワードが無効です。 正しいパスワードを有効な形式で指定してください。 パスワードの形式は、選択したアカウントの種類によって異なります。
説明
|