一括操作
実装済みドライランの件数を確認してからパターンでキーを削除・有効期限設定でき、コマンドファイルをインポートできます。
一括操作なら、1 キー用のダイアログと同じ安全性を保ったまま、多数のキーを一度に整理できます。エクスプローラーで Redis データベースかキー フォルダーを右クリックしてください (データベースでは、削除と TTL の変更は 一括編集 およびその下のコマンドファイル インポート/エクスポート):
- パターンでキーを削除… (データベース) または フォルダー内のキーを削除… (フォルダ)
- パターンで TTL を設定… または フォルダーに TTL を設定… - 一致したすべてのキーに有効期限を設定するか、次の 代わりに有効期限を削除 (PERSIST) クリアするには
- コマンドファイルをインポート… (database)- Redis コマンドが 1 行に 1 つずつ並んだファイルを実行します。
- コマンドファイルとしてエクスポート… (データベース) または フォルダーをコマンドファイルとしてエクスポート… (folder)- 一致するキーを、「コマンドファイルのインポート…」で再実行できるファイルに書き出します
1 つのキーのメニューには次が追加されます 名前を変更… (RENAMENX、または RENAME 上書きを許可した場合)、また コピー先, データベースにコピー… (COPY key key DB n、Redis 6.2 以降)および 接続にコピー… (DUMP この接続で、 RESTORE 選んだものに対して(有効期限を含む)。いずれも実行前に正確なコマンドを表示し、読み取り専用の接続やロックされた本番接続では無効になります(Copy to Connection はチェックします) ターゲット 接続も)、クエリタブが確認を求める場面では2回目のクリックを求めます。オンにすると 置換 コピー先にすでに存在するキーを上書きします。これがない場合、コピーは拒否され、その旨が表示されます。
まずドライラン
削除と TTL 設定は、先に書き込むことはありません。ダイアログはフォルダーのプレフィックスまたはデータベースの現在のキーフィルターから始まり、 一致するキーを数える 同じ上限付きでキースペースを走査する SCAN キーブラウザが使用するもの(最大 25,000 キー)のため、カウントしても何も変わりません。カウントは、累計を表示しながら 1 ページずつ実行され、 停止 ボタン、停止または上限に達したカウントには次のラベルが付きます 部分的な、適用ステップが操作するのは、ドライランで一覧表示されたキーだけで、それ以外には一切触れません。何かを適用する前に、一致するキーの数を確認できます。一括削除では、ボタンが有効になる前に、一致したキーの数を入力するよう求められ、その後バッチ処理で実行されます UNLINK 進捗件数付きのコマンドと 停止 ボタン。バッチは500キーから始まり、1回に1秒以上かかると(最小50まで)小さくなるため、Stopが処理中のバッチを長く待つことはありません。TTLの変更では1回につき1つの EXPIRE または PERSIST キーごとに、同じペースのバッチで処理されます。秒フィールドと 代わりに有効期限を削除 (PERSIST) ボックスは、カウント後も編集可能なままです。バイナリのキー名は常にバイト単位で正確に保持されます。


選択したキーに対する操作
パターンで記述するよりも選びやすいキーを使いたい場合は、クエリタブで次のようにして一覧表示します SQLLY.KEYS <pattern> <limit>、グリッドを並べ替えたりフィルターしたりします(次の基準で ttl_seconds、たとえば)、行を選択して右クリックし、次を選びます ツール › Redis キー › 選択したキーを削除…, 選択したキーに TTL を設定… または 選択したキーの有効期限を削除…。待たされるドライランはありません。選択範囲がそのまま一覧になるため、ダイアログは選択したキーが表示された確認画面で開きます。削除では引き続きキーの件数の入力を求められ、クラスター上のキーは 1 つのハッシュスロット内に収まるバッチで削除されます。このアクションは、グリッドが属するタブの接続とデータベースを使用します。次を参照してください キーブラウザ どの結果でメニューが表示されるかについては。
コマンドファイルのインポート
1 行に 1 つのコマンドを含む UTF-8 テキストファイルを選択します(SET, HSET, EXPIRE…。空白行と # コメントはスキップされます)。バイナリ値は引用符で囲んで次のように書きます "\xHH" エスケープ。SQLlyは、何かを実行する前にファイル全体を読み込んで解析し、実行可能なコマンドスクリプトではないファイルは、行を示して拒否します: 閉じていない引用符、不正なJSON行、有効なUTF-8ではないバイトなどです。その後、すべての行を最大1回ずつ実行し、処理済みコマンド数を随時表示します。失敗した行があってもインポートは止まりません。失敗ごとに、行番号、コマンド、サーバーのエラーが一覧表示され、サマリーには成功した数と失敗した数が示されます。1つの SELECT ファイルの中にあるものは、その後の行にも引き継がれます。
ファイルは約 200 行ずつのバッチで、それぞれ別の接続で実行されるため、 MULTI … EXEC ブロックが2つのバッチにまたがって分割されることはありません。トランザクション内の行が失敗すると、トランザクションは破棄されます。そのブロックの残りはトランザクション外で実行されずにスキップされ、サマリーにはスキップされた行数が含まれます。
コマンドファイルとしてフォルダーをエクスポートする
エクスポートは、フォルダーのプレフィックス (またはデータベースのキーフィルター) に一致するすべてのキーを、それを再構築するコマンドとして書き出します: SET 文字列用、 HSET, RPUSH, SADD そして ZADD は 1 行あたり最大 500 メンバーで書き出され、ストリームのエントリごとに 1 つの XADD ストリームエントリごとに、元の ID 付きで、 JSON.SET JSONドキュメントの場合、次に PEXPIRE 有効期限 (TTL) があったキーについて (インポート時点から起算)。バイナリのキー名と値はそのまま書き込まれます "\xHH" エスケープ。そのため、ファイルを空のデータベースにインポートすると、同じバイト列と同じ数のキーが復元されます。読み取りのみを行い、サーバー上は何も変更されないので、読み取り専用の接続でも動作します。
エクスポートは、選んだキー数の上限(既定は 10,000)と、インポートのファイル上限である 8 MB で停止するため、どのエクスポートも再度インポートできます。停止したエクスポートは、 # partial 行です。インポートで再構築できない型 (その他のモジュール型) は次として一覧表示されます # skipped 黙って省略せずコメントとして残します。ストリームのコンシューマーグループはエクスポートされず、エントリのみです。既存のキーの上にインポートすると、リストとストリームに追記されます。空のデータベースにエクスポートするか、先にフォルダーを削除してください。
安全レビュー
インポートを実行する前に、すべての行が、クエリ エディターで使用するのと同じ Redis コマンド リストと照合されます。ダイアログには書き込みを行う行数が表示され、見つかった破壊的なコマンドやサーバー管理コマンドを行番号付きで一覧表示します。たとえば FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN, DEBUG, SCRIPT, MODULE そして ACL。いずれかが存在する場合、または接続の安全設定によりエディターが確認を求める場合は、次を入力する必要があります RUN ALL ファイルが実行可能になる前に。
一括書き込みとインポートは、読み取り専用接続、および書き込みがロックされている間の本番接続では無効になります。エクスプローラーの項目はグレーアウトされ、ダイアログにはその理由が表示されますが、件数やファイルのチェックは引き続き実行できます。先にステータス バーのチップから書き込みのロックを解除してください。ロックは確認時にもう一度チェックされるため、ダイアログを開いている間にロック解除の期限が切れた場合も、その状態が反映されます。実行中にダイアログを閉じると、処理中のバッチが終わった時点で停止し、部分的な結果の概要がステータス バーに表示されます。