Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

Hello

項目一覧

  • 定義
  • 互換性
  • 構文
  • 動作
  • 出力
hello

バージョン 5.0 で追加

helloは、 mongodインスタンスのロールを説明するドキュメントを返します。 任意フィールドsaslSupportedMechsが指定されている場合、コマンドは指定されたユーザーの認証情報の作成に使用されるarray of SASL mechanismsも返します。

インスタンスがレプリカセットのメンバーである場合、 helloはレプリカセット構成のサブセットと、インスタンスがレプリカセットのプライマリであるかどうかなどのステータスを返します。

レプリカセットのノードではないmongodインスタンスに送信されると、 helloはこの情報のサブセットを返します。

MongoDBドライバークライアントhelloを使用してレプリカセット メンバーの状態を判断し、レプリカセットの追加メンバーを検出します。

このコマンドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

注意

このコマンドは、すべてのMongoDB Atlasクラスターでサポートされています。すべてのコマンドの Atlas サポートの詳細については、「 サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

コマンドは、次の形式をとります。

db.runCommand( { hello: 1 } )

helloコマンドは、結果に追加のフィールドhello.saslSupportedMechsを返すためのオプション フィールドsaslSupportedMechs: <db.user>と、コマンドに関連付けられたログ コメントを追加するためのcomment <any>を受け入れます。

db.runCommand( { hello: 1, saslSupportedMechs: "<db.username>", comment: <any> } )

db.hello()hellomongosh メソッドは を囲むラッパーを提供します。

MongoDB 4.2以降では、 helloを発行したクライアントが操作の完了前に切断した場合、MongoDB は killOp を使用してhelloを終了対象としてマークし

次のhelloフィールドはすべてのロールに共通です。

hello.isWritablePrimary

このノードが書込み可能であることを報告するブール値。 trueの場合、このインスタンスは レプリカセット 内の プライマリmongos 、または インスタンス、またはスタンドアロンのmongod です。

このフィールドは、インスタンスがレプリカセットのセカンダリノードである場合、またはノードがレプリカセットのアービタである場合はfalseになります。

hello.topologyVersion

MongoDB の内部使用のためのものです。

hello.maxBsonObjectSize

この mongodプロセスに許可される BSON オブジェクトの最大サイズ(バイト単位)。指定しない場合、クライアントは " 16 * 1024 * 1024の最大サイズを想定します。

hello.maxMessageSizeBytes

BSONワイヤプロトコル メッセージの最大許可サイズ。 デフォルト値は48000000バイトです。

hello.maxWriteBatchSize

書込み (write) バッチで許可される書込み (write) 操作の最大数。 バッチがこの制限を超える場合、クライアント ドライバーはバッチを小さなグループに分割し、各グループのカウントはこのフィールドの値以下になります。

この制限の値は100,000回の書込みです。

hello.localTime

ローカル サーバー時間を UTC で返します。 この値はISO 日付です。

hello.logicalSessionTimeoutMinutes

セッションが最後に使用されてからアクティブな状態である時間(分単位)。クライアントから新しい読み取りもしくは書き込み操作を受信していないセッション、またはこのしきい値内に refreshSessions で更新されていないセッションは、キャッシュからクリアされます。 期限切れのセッションに関連付けられた状態は、サーバーによっていつでもクリーンアップされる可能性があります。

featureCompatibilityVersion"3.6"以上の場合にのみ使用できます。

hello.connectionId

mongod / mongosインスタンスのクライアントへの送信接続の識別子。

hello.minWireVersion

このmongodまたはmongosインスタンスがクライアントと通信するために使用できるワイヤプロトコルの最も初期のバージョン。

クライアントはminWireVersionを使用して、MongoDB との互換性をネゴシエートするのに役立ちます。

hello.maxWireVersion

このmongodまたはmongosインスタンスがクライアントとの通信に使用できるワイヤプロトコルの最新バージョン。

クライアントはmaxWireVersionを使用して、MongoDB との互換性をネゴシエートするのに役立ちます。

hello.readOnly

ブール値trueの場合、 mongodまたはmongosが読み取り専用モードで実行されていることを示します。

hello.compression

クライアントとmongod mongosmongodまたは インスタンス間の通信を圧縮するために使用される、または使用可能な圧縮アルゴリズム(クライアントとmongos または インスタンスの両方に共通)をリストする配列。

このフィールドは、圧縮が使用されている場合にのみ使用できます。 例:

  • mongodsnappy,zlibコンプレッサーの両方を使用するように有効になっており、クライアントがzlibを指定している場合、 compressionフィールドには次の内容が含まれます。

    "compression": [ "zlib" ]
  • mongodsnappy,zlibコンプレッサーの両方を使用するように有効になっており、クライアントがzlib,snappyを指定している場合、 compressionフィールドには次の内容が含まれます。

    "compression": [ "zlib", "snappy" ]
  • mongodsnappyコンプレッサーを使用するよう有効になっており、クライアントがzlib,snappyを指定している場合、 compressionフィールドには が含まれます。

    "compression": [ "snappy" ]
  • mongodsnappyコンプレッサーを使用するよう有効になっており、クライアントがzlibを指定しているか、クライアントがコンプレッサーを指定していない場合、 フィールドは省略されます。

つまり、クライアントが圧縮を指定しない場合、または接続されたmongodまたはmongosインスタンスで有効になっていないコンプレッサーをクライアントが指定した場合、 フィールドは返されません。

hello.saslSupportedMechs

ユーザーの認証情報を作成するために使用される SASL メカニズムの配列。 サポートされている SASL メカニズムは次のとおりです。

  • GSSAPI

  • SCRAM-SHA-256

  • SCRAM-SHA-1

フィールドは、コマンドがsaslSupportedMechsフィールドとともに実行された場合にのみ返されます。

db.runCommand( { hello: 1, saslSupportedMechs: "<db.username>" } )

mongosインスタンスはhello応答ドキュメントに次のフィールドを追加します。

hello.msg

hellomongosインスタンスから返す場合、値isdbgridが含まれます。

hello レプリカセットのノードによって返された場合、これらのフィールドが含まれます。

hello.hosts

非表示"[hostname]:[port]"パッシブ アービタ のいずれにもない レプリカセット のすべてのノードを一覧表示する 形式の文字列の配列。

ドライバーはこの配列とhello.passivesを使用して、読み取るメンバーを決定します。

hello.setName

現在の : レプリカセットの名前。

hello.setVersion

現在のレプリカセット構成バージョン。

hello.secondary

trueブール値は の場合、mongod レプリカセット セカンダリ メンバーであるかどうかを示します。

hello.passives

が の members[n].priorityを持つ レプリカセット のすべてのメンバーを一覧表示する 形式の string"[hostname]:[port]"0 の配列。

このフィールドは、 members[n].priority0のノードが少なくとも 1 つある場合にのみ表示されます。

ドライバーはこの配列とhello.hostsを使用して、読み取るメンバーを決定します。

hello.arbiters

アービタ"[hostname]:[port]" である レプリカセット のすべてのノードを一覧表示する 形式の文字列の配列。

このフィールドは、レプリカセット内に少なくとも 1 つのアービタが存在する場合にのみ表示されます。

hello.primary

レプリカセットの現在のプライマリメンバーを一覧表示する"[hostname]:[port]"形式の string。

hello.arbiterOnly

ブール値 は、 trueの場合、現在のインスタンスがアービタであることを示します。 arbiterOnlyフィールドは、インスタンスがアービタである場合にのみ存在します。

hello.passive

ブール値で、 trueの場合は、現在のインスタンスがアクティブであることを示します。 passiveフィールドは、 members[n].priority0のメンバーにのみ存在します。

hello.hidden

ブール値はtrueの場合、現在のインスタンスが非表示であることを示します。 hiddenフィールドは非表示メンバーにのみ存在します。

hello.tags

tags ドキュメントには、レプリカセットのユーザー定義タグ フィールドと値のペアが含まれています。

{ "<tag1>": "<string1>", "<tag2>": "<string2>",... }

詳しくは、「レプリカセットのタグセットの構成」を参照してください。

Tip

以下も参照してください。

hello.me

[hostname]:[port]を返したノードのhello

hello.electionId

各選挙の一意の識別子。 プライマリ のhello の出力にのみ含まれます。選挙がいつ行われるかを決定するためにクライアントが使用します。

hello.lastWrite

データベースの最新の書込み (write) 操作のoptimeと日付の情報を含むドキュメント。

hello.lastWrite.opTime

最後の書込み (write) 操作のoptimeを提供するオブジェクト。

hello.lastWrite.lastWriteDate

最後の書込み (write) 操作の時刻を含む日付オブジェクト。

hello.lastWrite.majorityOpTime

読み取り可能な最後の書込み操作のmajority optime を付与するオブジェクト。

hello.lastWrite.majorityWriteDate

majorityが読み取り可能な最後の書込み操作の時刻を含む日付オブジェクト。

okステータス フィールド、 operationTimeフィールド、 $clusterTimeフィールドの詳細については、「コマンド応答 」を参照してください。

戻る

applyOps