次の方法で共有

クライアント ツールを使用して Azure Managed Redis のデータを管理する

  • 適用対象: ✅ Azure Managed Redis

次のツールを使用して、クライアントとしてAzure Managed Redis のデータにアクセスして管理できます。 これらのツールを使用して、Azure Managed Redis インスタンスと直接対話し、デバッグとトラブルシューティングを行います。

  • Redis Insight
  • redis-cli コマンド ライン ツール

Redis Insight

Redis Insight は、Redis コマンドを発行し、Redis インスタンスの内容を表示するための豊富なオープンソースのグラフィカルおよび CLI ツールです。 Azure Managed Redis で動作し、Linux、Windows、macOS でサポートされています。

Redis Insight のインストール

Redis Insight をインストールするには、 Redis Insight ドキュメントの手順に従います。

ヒント

インストール時に、[EULA とプライバシー設定] ページで [推奨設定を使用する] を選択することをお勧めします。

Redis Insight を使用して Azure Managed Redis へのアクセスを構成する

Redis Insight は、Microsoft Entra IDまたはアクセス キー認証を使用して、Azure Managed Redis インスタンスに対して認証できます。 セキュリティを強化するためにMicrosoft Entra IDを使用することをお勧めします。

バージョン 3.2.0 以降、Redis Insight は PKCE OAuth 2.0 フローを使用して Microsoft Entra ID により Azure Managed Redis を認証し、サブスクリプション間のデータベースの自動検出とパスワードレス認証を可能にします。

Redis Insight を使用して Azure Managed Redis へのアクセスを構成する手順については、Redis Insight GitHub リポジトリを参照してください。 これは、Azure テナントごとに 1 回限りセットアップされます。

Redis Insight を使用して Azure Managed Redis に接続する

Microsoft Entra IDアクセスが構成されたら、次の手順に従って、Redis Insight でAzure Managed Redis インスタンスに接続します。

  1. Redis Insight の [ Redis データベース ] タブで、[ + 既存のデータベースの接続] を選択します。
  2. データベースの追加 ウィンドウで、Azure Managed Redis を選択します。
  3. プロンプトに従って、Microsoft Entra ID認証を使用して接続します。
  4. Subscription ページで、Azure Managed Redis インスタンスを含むサブスクリプションを選択し、データベースの追加を選択します。
  5. 接続するAzure Managed Redis インスタンス (データベース) を選択し、データベースの追加を選択します。 同時に接続する複数のデータベースを選択できます。
  6. 上記の手順を繰り返して、同じサブスクリプションまたは別のAzure サブスクリプションに必要に応じて、Azure Managed Redis インスタンスを追加します。

  • Azure Managed Redis インスタンスを追加したら、Redis Insight の Redis データベースの一覧からそれを選択し、コマンドの発行とデータの表示を開始できます。

  • 組み込みの CLI にアクセスするには、選択したデータベースの画面の下部にある (>_ CLI) を選択します。

redis-cli コマンド ライン ツール

redis-cli コマンドライン ツールを使用して、Azure Managed Redis インスタンスをクライアントとして操作します。 redis_cliは、コマンドを発行したり、スクリプトで繰り返しテストしたりするための軽量な方法として使用します。

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

redis-cli ツールは、複数のオペレーティング システムで使用できる "Redis パッケージ" と共に自動的にインストールされます。 お好みのオペレーティング システムに関する最も詳細なドキュメントについては、open source install Redis ガイドを参照してください。

リナックス

redis-cli は Linux 上でネイティブに実行されます。ほとんどのディストリビューションには、redis-cli ツールを含む "Redis パッケージ" が含まれています。 たとえば、Ubuntu では、次のコマンドを使用して "Redis パッケージ" をインストールします。

sudo apt-get update
sudo apt-get install redis

Windows

Windows コンピューターで redis-cli を使用する最善の方法は、Windows Subsystem for Linux (WSL) をインストールすることです。 Linux サブシステムを使用すると、Windowsで Linux ツールを直接実行できます。 WSL をインストールするには、WSL のインストール手順に従います。

WSL がインストールされたら、WSL 用に選択した Linux ディストリビューションで使用可能な任意のパッケージ管理を使って redis-cli をインストールできます。

キャッシュ アクセス情報を収集する

次の方法を使用して、キャッシュにアクセスするために必要な情報を収集できます。

このセクションでは、Azure ポータルから情報を取得します。

Azure Managed Redis サーバーに接続するには、キャッシュ クライアントにキャッシュ エンドポイント、ポート、およびキャッシュのキーが必要です。 クライアントによっては、これらの項目を参照するための名前が若干異なる場合があります。 この情報は、Azure ポータルから取得できます。

  • キャッシュのエンドポイントとポートを取得するには、[リソース] メニューから [概要] を選択します。 エンドポイントは、 {yourcachename}.{region}.redis.azure.net形式です。 ポートは、すべてのAzure Managed Redis インスタンスに対して 10000 です。

  • アクセス キーを取得するには、[設定] メニューから [認証] を選択します。 次に、[ アクセス キー ] タブを選択します。ここでは、キャッシュのプライマリ キーとセカンダリ キーを見つけることができます。 いずれかのキーを使用して、クライアント ツールに接続できます。

redis-cli を使用して接続する

"Redis パッケージ" がインストールされているコンピューターでシェルまたはターミナルを開きます。 WSL を使用している場合は、Windows Terminalを使用して Linux コマンド ラインを開くことができます。 redis-cli を使って接続する前に、次のことを確認します。

  1. TLS アクセスが必要かどうか - 既定では、Azure Managed Redis インスタンスは接続に TLS 暗号化を使用します。 サーバー側で TLS が使用されている場合は常に、--tls オプションを使って redis-cli の TLS を有効にする必要があります。
  2. 使用されるポート - すべてのAzure Managed Redis インスタンスは、ポート 10000 を使用します。 これは、Redis コミュニティ エディションの既定値 (6379) とは異なることに注意してください。
  3. キャッシュ インスタンスが OSS クラスター ポリシーを使用するかどうか - OSS クラスター ポリシーを使用している場合は、-c オプションを追加して、すべてのシャードに確実にアクセスできるようにします。

例示

  1. TLS でエンタープライズ クラスター ポリシーを使用して、Azure Managed Redis インスタンスに接続します。

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. OSS クラスター ポリシーと TLS を使用して、Azure Managed Redis インスタンスに接続します。

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

接続のテスト

接続が確立されたら、Azure Managed Redis インスタンスにコマンドを発行できます。 接続をテストする簡単な方法の 1 つは、PING コマンドを使用することです。 このコマンドでは、コンソールで PONG が返されます。

yourcachename.region.redis.azure.net:10000> PING
PONG

SET や GET などのコマンドを実行することもできます。

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

これで、redis-cli を使用してAzure Managed Redis インスタンスに接続されました。

関連するコンテンツ

新しい Azure Managed Redis Instance インスタンスを作成することから始めましょう。

  • Last updated on