Memcached クライアントライブラリへの自動検出の追加 - Amazon ElastiCache
キャッシュエンジンバージョン 1.4.14 以降キャッシュエンジンバージョン 1.4.14 以前[Output Format] (出力形式)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Memcached クライアントライブラリへの自動検出の追加

自動検出の設定情報は、各 Memcached キャッシュクラスターノードに冗長的に保存されます。クライアントアプリケーションは、任意のキャッシュノードのクエリを実行し、クラスター内のすべてのノードの設定情報を取得できます。

アプリケーションがこれを行う方法は、キャッシュエンジンバージョンによって異なります。

  • キャッシュエンジンバージョンが 1.4.14 以上の場合、config コマンドを使用します。

  • キャッシュエンジンバージョンが 1.4.14 未満の場合、get AmazonElastiCache:cluster コマンドを使用します。

これらの 2 つのコマンドの出力は同じです。以下の「[Output Format] (出力形式)」セクションで説明します。

キャッシュエンジンバージョン 1.4.14 以降

キャッシュエンジンバージョン 1.4.14 以上の場合、config コマンドを使用します。このコマンドは、 によって Memcached ElastiCache ASCIIおよびバイナリプロトコルに追加され ElastiCache、クラスタークライアントに実装されています。別のクライアントライブラリで自動検出を使用する場合、config コマンドをサポートするためにそのライブラリを拡張する必要があります。

注記

次のドキュメントはプロトコルに関連していますASCIIが、 config コマンドは ASCIIと バイナリの両方をサポートしています。バイナリプロトコルを使用して Auto Discovery サポートを追加する場合は、 ElastiCache クラスタークライアントのソースコードを参照してください。

[Syntax] (構文)

config [sub-command] [key]

オプション

名前 説明 必須
sub-command

キャッシュノードの操作に使用されるサブコマンド。自動検出の場合、このサブコマンドは get です。

 あり
key

クラスター設定が格納されたキー。自動検出の場合、このキーの名前は cluster です。

 あり

クラスターの設定情報を取得するには、以下のコマンドを使用します。

config get cluster

キャッシュエンジンバージョン 1.4.14 以前

クラスターの設定情報を取得するには、以下のコマンドを使用します。

get AmazonElastiCache:cluster
注記

AmazonElastiCache「:cluster」キーを改ざんしないでください。これは、クラスター設定情報が存在するためです。このキーを上書きすると、クライアントが短時間 (15 秒以内) 誤って設定され、 によって設定情報が ElastiCache 自動的かつ正しく更新されます。

[Output Format] (出力形式)

config get cluster を使用するか get AmazonElastiCache:cluster を使用するかにかかわらず、応答は 2 行で構成されます。

  • 設定情報のバージョン番号。キャッシュクラスターにノードが追加または削除されるたび、バージョン番号は 1 ずつ増加します。

  • キャッシュノードのリスト。リスト内の各ノードは、hostname|ip-address|port グループによって表され、各ノードはスペースで区切られます。

各行の末尾には、キャリッジリターンと改行文字 (CR + LF) が表示されます。データ行には最後に改行文字 (LF) が含まれ、ここに CR + LF が追加されます。バージョン設定行は、CR なしの LF で終了します。

3 つのノードを含むキャッシュクラスターは、次のように表されます。

configversion\n
hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n

各ノードには、 CNAMEとプライベート IP アドレスの両方が表示されます。CNAME は常に存在します。プライベート IP アドレスが使用できない場合は表示されませんが、パイプ文字|「」は引き続き出力されます。

例

設定情報のクエリを実行した場合に返されるペイロードの例を次に示します。

CONFIG cluster 0 136\r\n
12\n
myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n 
END\r\n
注記

  • 2 行目は、設定情報がこれまで 12 回変更されたことを示しています。

  • 3 行目のノードのリストでは、ホスト名がアルファベット順に並んでいます。この順序は、現在クライアントアプリケーションで何を使用しているかにより異なる場合があります。