Redis Cluster

実装済み

Redis Cluster、ElastiCache クラスターモード、MemoryDB:スロットルーティング、到達不能なノードのアドレスを示すノードマップ、ノードごとの SSH フォワード、トポロジ。

SQLLY は、Redis Cluster、セルフホストのクラスター、クラスターモードの Amazon ElastiCache、Amazon MemoryDB に接続し、すべてのコマンドをキーのハッシュスロットを所有するノードへルーティングします。クラスターがスロットを移動すると (フェイルオーバーやリシャード)、クライアントはその MOVED または ASK 応答に従い、スロットマップを更新し、スクリプトが何回リダイレクトを受けたかを知らせます。キーブラウザー、メモリアナライザー、一括操作、プロファイラー、Pub/Sub ビューアーは、すべてのマスターにまたがって動作します。

接続中

通常どおり Redis 接続を作成します。 サーバー シードノードはコンマ区切りで複数指定できます(10.0.0.1:7000, 10.0.0.2:7001)。ポートのないエントリは次を使用します ポート フィールド。次のようなURLを貼り付けると redis://user:[email protected]:7000,10.0.0.2:7001 すべてのホストを保持します。 クラスターモード 選択:

  • 自動検出 (デフォルト)- 最初の接続時にサーバーに問い合わせます INFO cluster そして、終了するまで回答を記憶するので、サーバー1台につきセッションごとに追加のプローブが1回発生するだけで、他は何も変わりません。
  • 単一サーバー - サーバーがクラスターノードであっても、スロットによるルーティングは行いません。
  • Redis Cluster - 常にスロットでルーティングします。

クラスターには論理データベースが 1 つしかないため、次は空のままにしてください データベース 空白にするか0に設定します。ElastiCacheの場合、接続先をクラスターの構成エンドポイントに向けてください。MemoryDBは常にクラスターです。

ノードマップ: ノードが接続できないアドレスを通知してくる場合

クラスターノードは、他のノードがどこにあるかを、通知するよう設定されたアドレスを使ってクライアントに伝えます。NAT、Docker のポートマッピング、または SSH 踏み台サーバーの内側では、それらはこのマシンから到達できないプライベートアドレスであることがよくあります。次の クラスターノードマップ フィールドがそれらを書き換えます: 1つ advertised host:port => dial host:port 行ごとに、例えば 10.0.0.5:7001 => 127.0.0.1:17001。アドバタイズされるアドレスは(スロットマップ、リダイレクト、TLS サーバー名として)引き続きノードの名前を示し、ソケットだけがダイヤル先のアドレスに向かいます。

SSH トンネルとプロキシで、すべてのノードに接続できます。 SSH ホップや SOCKS/HTTP プロキシを使う接続では、SQLLY はクラスターが示すノードごとに、同じホップを経由する個別のローカルフォワードを開くため、踏み台サーバーからしか到達できないノードアドレスでも動作します。ノードマップが最初に適用されるので、踏み台サーバーが接続する先も書き換えられます。Kubernetes のポートフォワードは 1 つのサービスポートしか通せないため、到達できるのはシードノードのみで、リレーブリッジ経由の接続はまだクラスターモードをサポートしていません。

クラスターでエディターが拒否するもの

各コマンドは送信前に拒否され、その理由となったルールを示すメッセージが表示されます:

  • スロットをまたぐ複数キーのコマンド - MGET, MSET, DEL 複数のキーを伴う、 SUNION, RENAME, EVAL 複数のキーを使うコマンドなどは、すべてのキーが同じスロットに割り当てられる場合にのみ実行されます。関連するキーには共通のハッシュタグを付けます: user:{42}:profile そして user:{42}:cart スロットを共有します。
  • SELECT 0 以外のもの - クラスターには 1 つの論理データベースがあります。
  • KEYS そして SCAN - KEYS すべてのマスターをブロックし、さらに SCAN カーソルは 1 つのノードに属します。キー ブラウザ、または SQLLY.KEYS pattern [limit [cursor]]、すべてのマスターをページ単位で順に調べ、それらをまたいで続くカーソルを返します。
  • MULTI / EXEC - 各コマンドは個別にルーティングされるため、エディターからのトランザクションが 1 つのノードにとどまることはありません。

選択したノードでコマンドを実行する

行の先頭に SQLLY.ON と、キーを所有するノードの代わりに、選んだノードへ送信するためのターゲット。ターゲットは masters, replicas, all、ノードの host:port Cluster Topologyビューに表示されるとおりに指定するか、カンマで区切って複数指定します:

  • SQLLY.ON masters DBSIZE - マスターごとに 1 行、キー数付き。
  • SQLLY.ON masters FLUSHALL - すべてのマスターを空にします(レプリカも追従します)。
  • SQLLY.ON 10.0.0.4:7003 INFO replication - 1 つのレプリカ自身の応答。
  • SQLLY.ON replicas DBSIZE - すべてのレプリカが、マスターと同じ数のキーを保持していることを確認します。

この行は、入力したとおりそのまま各ノードで実行されます。これは redis-cli なしでも動作します -c: リダイレクトは追従されないため、キーを所有しないノードの応答は MOVED、および上で拒否されたコマンド(KEYS, SCAN)。選択したノードで実行されます。レプリカは次に切り替わります READONLY 最初に表示され、キーの読み取りを処理します。複数のノードが1つのグリッドで応答します ノード そして ロール 列があり、エラーで応答したノードには専用の行が付きます。コマンドをどこかで実行する前にすべてのノードに接続されるため、到達できないノードがあると、どのノードも実行しないうちにその行が停止します。プレフィックスは安全性に関して何も変えません。読み取り専用の接続は引き続き拒否します SQLLY.ON masters FLUSHALL、書き込みや破壊的なコマンドは引き続き確認を求められます。クラスタートポロジービューでは、ノードを選択して次を押します ノードに対するクエリ そのノードの行から始まるクエリタブを開くには。

スクリプトの実行中にクライアントがリダイレクトに従った場合、メッセージペインにその回数が表示されます(たとえばフェイルオーバーの後など)。クラスターがスロットを移動した直後であれば正常です。リダイレクトが途切れず続く場合は、リシャーディングが進行中であることを示しています。

クラスター全体を対象とするツール

  • キーブラウザー - すべてのマスターから順番にキーを一覧表示し、通常の上限に達するまで続けます。途中で止まった場合は、注記行に、いくつのマスターにわたって何個のキーをスキャンしたかが表示され、 さらにスキャン 停止したノードから続行します。
  • メモリアナライザー - サンプルは各マスターのキー数に比例して配分され、合計はそれらを合算して求めます。
  • 一括削除 - 一致したキーはハッシュスロットごとにグループ化されるため、すべての UNLINK バッチは1つのスロットの中にとどまります。
  • プロファイラー - 次を実行 MONITOR をすべてのマスターで一度に実行し、そのストリームを 1 つのテーブルにマージします。テーブルには ノード 列。
  • Pub/Sub ビューアー - キースペース通知はすべてのマスターで購読され(ノードごとのため)、通常のチャンネルとパターンは 1 つのマスターで購読されます(クラスターは配信します PUBLISH どこでも)、およびシャードチャンネル - 先頭に付けて入力してください #、たとえば #orders - 各チャンネルを所有するマスター上。行には次の ノード 列。シャードチャンネルはスタンドアロンのRedis 7サーバーでも動作します。

クラスタートポロジ

Redisデータベースを右クリックし、次を選択します ツール › クラスタートポロジー…、次を実行 Redis Cluster トポロジ… コマンドパレットから、またはクラスター接続のサーバーダッシュボードのリンクから開きます。ペインには、次のすべてのノードが一覧表示されます CLUSTER SHARDS (または CLUSTER NODES 7.0 より前のサーバー): ID、ロール、アドバタイズしているアドレス、SQLLY が接続に使うアドレス、通知されたホスト名とクライアントが送る TLS サーバー名、スロット、ヘルス、レプリケーションオフセット、リンク状態。フッターにはマスターとレプリカの数が表示され、16,384 スロットすべてがカバーされていることを確認し、正常でないノードや、アドバタイズしているのとは別のアドレスで接続しているノードの名前を示します。

トレース 各ノードに対して、テスト接続と同じ段階的なチェックを実行します。名前解決、トンネルまたはプロキシ(ノードマップ使用)、TCP、TLS(ノードが通知するアドレスに対して確認)、サインイン、プロトコルと ping、データベース、そして CLUSTER INFO - ステップごとに 1 行。最初に失敗した行が、何を直すべきかを教えてくれます。ノードマップのエントリの誤り、ブロックされたポート、TLS 名の不一致、ACL の問題、またはクラスターが正常であることを報告しないノードです。どちらのレポートも、次としても利用できます SQLLY.TOPOLOGY そして SQLLY.TRACE クエリタブで。読み取りのみを行います。