Redis 接続文字列ビルダー
Redis または Valkey の接続 URI、StackExchange.Redis の構成文字列、redis-cli コマンドを 1 つのフォームから作成するか、いずれかを貼り付けて、各オプションの動作と、パスワードが平文のままネットワークを流れるかどうかを確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
Redis 接続文字列の形式
ほぼすべての Redis クライアントは URI を受け付けます: redis://[[user]:password@]host[:port][/db]、または rediss:// TLS用。.NETクライアントのStackExchange.Redisは例外で、次のようなカンマ区切りの設定文字列を使用します host:6380,password=...,ssl=true.
redis:// は平文で、AUTH パスワードも含まれます。マネージドサービス (Azure Cache for Redis、転送中の暗号化が有効な ElastiCache、Upstash) では次が必要です rediss://.
TLS 付きの URI redis-py、node-redis、ioredis、go-redis、Lettuce、Jedis、SQLly
rediss://:[email protected]/0
ACL ユーザー付きの URI (Redis 6+) 同じ
rediss://app_user:[email protected]:6380/0
StackExchange.Redis .NET
cache.example.com:6380,password=your_password,ssl=true,abortConnect=false
redis-cli コマンドライン
redis-cli -h cache.example.com -p 6380 --tls --askpass
次のようなプレースホルダー your_password 例にすぎません。実際の文字列は上のフォームで組み立ててください。SQLlyをRedisに接続する方法の詳細: Redis 向け SQLly.
Redis URI の各部
redis そして rediss は暫定的なIANA URIスキームです。ユーザー名とパスワードの特殊文字はパーセントエンコードしてください。ユーザーなしのパスワード(redis://:pw@host)は、次のものとしてサインインします default ユーザー。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
scheme |
- | redis | redis:// プレーンな TCP、 rediss:// TLS。Valkey クライアントも同じものを受け付けます。一部は次も受け付けます: valkey://. |
user |
- | デフォルト | ACL ユーザー名(Redis 6+)。 |
password |
- | - | AUTH のパスワード。 |
host:port |
- | ローカルホスト:6379 | サーバーアドレス。 |
/db |
?db= | 0 | データベースインデックス (デフォルトは 0〜15)。 |
StackExchange.Redis の設定オプション
フォーマット: host:port[,host2:port2],option=value,...。オプション名は大文字小文字を区別しません。カンマを含むパスワードは、文字列には書けません。次を設定してください ConfigurationOptions.Password コード内で。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
password |
- | - | AUTH のパスワード。 |
user |
- | - | ACL ユーザー名。 |
ssl |
- | 偽 | TLS を使用します。次を指定した場合: ssl=true 、ポートの指定もない場合、既定のポートは6380です。 |
sslHost |
- | - | 証明書と一致している必要があるホスト名。 |
abortConnect |
- | true (Azure Cache for Redis では false) | false は、Connect から例外をスローせず、バックグラウンドで再試行を続けます。 |
connectTimeout |
- | 5000 | ミリ秒。 |
syncTimeout |
- | 5000 | 同期操作のためのミリ秒。 |
asyncTimeout |
- | syncTimeout | 非同期操作のためのミリ秒。 |
connectRetry |
- | 3 | 接続の試行回数。 |
defaultDatabase |
- | - | データベースインデックス。 |
name |
- | - | クライアント名 (CLIENT SETNAME)。 |
allowAdmin |
- | 偽 | FLUSHALL、CONFIG、その他の管理者コマンドを許可 |
keepAlive |
- | -1 (60 s) | キープアライブ ping の間隔 (秒)。 |
serviceName |
- | - | Sentinel マスター名。 |
redis-cli 接続フラグ
redis-cli も受け付けます -u redis://....
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
-h |
- | 127.0.0.1 | ホスト。 |
-p |
- | 6379 | ポート。 |
--user |
- | - | ACL ユーザー(パスワード付き)。 |
-a / --pass |
- | - | コマンドラインのパスワード。シェル履歴とプロセス一覧に表示されます。推奨されるのは --askpass または REDISCLI_AUTH 環境変数。 |
-n |
- | 0 | データベースインデックス。 |
--tls |
- | - | TLS を使用します。次を追加: --cacert プライベート CA 用。 |
よくある Redis の接続エラー
NOAUTH Authentication required.
理由: サーバーにパスワード(requirepass または ACL ユーザー)が設定されているのに、クライアントが認証せずにコマンドを送信しました。通常は、URI にパスワードが含まれていないことが原因です。
修正: パスワードを追加します: redis://:password@host:6379、または redis://user:password@host ACL ユーザー用。
WRONGPASS invalid username-password pair or user is disabled.
理由: Redis 6 以降では認証情報が拒否されました。多くの場合、パスワードがユーザー名として指定されています。一部のクライアントは、次のように読み取ります redis://secret@host ユーザーとして secret パスワードなしで。
修正: 書き込み redis://:secret@host (コロンに注意)、またはユーザーとパスワードの両方を指定します。
It was not possible to connect to the redis server(s).
理由: StackExchange.Redis が接続できませんでした: ホストまたはポートが間違っている、TLS が必要なのに ssl=true 欠落している(またはその逆)か、ファイアウォールです。次を使うと abortConnect=true (デフォルト)では、すぐにエラーが発生します。
修正: 確認 ssl とポート(TLSエンドポイントは多くの場合6380)を確認し、 abortConnect=false そのため、マルチプレクサーは再試行を続けます。
DENIED Redis is running in protected mode because protected mode is enabled
理由: パスワードも明示的なバインドアドレスも設定されていない Redis は、他のマシンからの接続を拒否します。
修正: パスワード(またはACLユーザー)を設定し、さらに bind 保護モードをオフにするのではなく、サーバー上のアドレスで。
Redis 接続文字列の FAQ
Redis 接続文字列の形式は何ですか?
redis://[[user]:password@]host[:port][/db]、または rediss:// TLS 用。例: rediss://:[email protected]:6380/0。StackExchange.Redis は次を使用します host:port,password=...,ssl=true 代わりに。
Redis のデフォルトポートは何ですか?
6379。多くのマネージドサービスは 6380 で TLS を提供し、StackExchange.Redis は次の場合に 6380 を想定します ssl=true 、ポートの指定もない場合は
Redis URI にユーザー名を入れる方法は?
Redis 6 で ACL ユーザーが追加されました: redis://user:password@host:6379。パスワードのみの場合は、次のように書きます redis://:password@host; サーバーは次のユーザーとしてサインインさせます default ユーザー。
これらの接続文字列は Valkey でも使えますか?
はい。Valkey は Redis とプロトコル互換なので、同じ URI、設定文字列、redis-cli のフラグ(または valkey-cli)がそのまま使えます。SQLly が受け付けるのは valkey:// そして valkeys://.
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、Redis などでスキーマ対応の IntelliSense を利用できます。