/ /

/ /

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 명령은 선택적 필드 saslSupportedMechs: <db.user>를 허용하여 결과에 추가 필드 hello.saslSupportedMechs를 반환하고 comment <any>를 사용하여 명령과 관련된 로그 주석을 추가합니다.

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

mongosh의 db.hello() 메서드는 hello주위에 래퍼(wrapper)를 제공합니다.

행동

클라이언트 연결 해제

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

쓰기 배치에 허용되는 최대 쓰기 작업 수입니다. 배치가 이 제한을 초과하면 클라이언트 드라이버는 배치를 이 필드 값보다 작거나 같은 수의 작은 그룹으로 나눕니다.

이 제한값은 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 또는 mongos 인스턴스 간의 통신을 압축하는 데 사용되었거나 사용 가능한 압축 알고리즘(즉, 클라이언트와 mongod 또는 mongos 인스턴스 모두에 공통)을 나열하는 배열입니다.

이 필드는 압축을 사용하는 경우에만 사용할 수 있습니다. 예시:

mongod가 snappy,zlib 압축기를 모두 사용하도록 활성화되어 있고 클라이언트가 zlib를 지정한 경우 compression 필드에는 다음이 포함됩니다.
```
"compression": [ "zlib" ]
```
mongod가 snappy,zlib 압축기를 모두 사용하도록 활성화되어 있고 클라이언트가 zlib,snappy를 지정한 경우 compression 필드에는 다음이 포함됩니다.
```
"compression": [ "zlib", "snappy" ]
```
mongod가snappy 압축기를 사용하도록 활성화되어 있고 클라이언트가 zlib,snappy를 지정한 경우 compression 필드에는 다음이 포함됩니다.
```
"compression": [ "snappy" ]
```
mongod이(가) snappy 압축기를 사용하도록 활성화되어 있고 클라이언트가 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: mongos 인스턴스에서 hello가 반환될 때 값 isdbgrid를 포함합니다.

복제본 세트

hello 은(는) 복제본 세트의 멤버가 반환할 때 다음 필드를 포함합니다.

hello.hosts

숨김, 수동 또는 중재자가 아닌 복제본 세트의 모든 멤버를 나열하는 "[hostname]:[port]" 형식의 문자열 배열입니다.

드라이버는 이 배열과 hello.passives를 사용하여 읽을 노드를 결정합니다.

hello.setName: 현재 복제본 세트의 이름입니다.

hello.setVersion: 현재 복제본 세트 구성 버전

hello.secondary: true일 때 mongod가 복제본 세트의 세컨더리 멤버인지 여부를 나타내는 부울 값입니다.

hello.passives

members[n].priority이(가) 0인 복제본 세트의 모든 멤버를 나열하는 "[hostname]:[port]" 형식의 문자열 배열입니다.

이 필드는 members[n].priority가 0인 멤버가 한 명 이상 있는 경우에만 표시됩니다.

드라이버는 이 배열과 hello.hosts를 사용하여 읽을 노드를 결정합니다.

hello.arbiters

중재자인 복제본 세트의 모든 구성원을 나열하는 "[hostname]:[port]" 형식의 문자열 배열입니다.

이 필드는 복제본 세트에 중재자가 한 명 이상 있는 경우에만 표시됩니다.

hello.primary: 복제본 세트의 현재 프라이머리 멤버를 나열하는 "[hostname]:[port]" 형식의 문자열

hello.arbiterOnly: true인 경우 현재 인스턴스가 중재자임을 나타내는 부울 값입니다. arbiterOnly 필드는 인스턴스가 중재자인 경우에만 존재합니다.

hello.passive: true인 경우 현재 인스턴스가 수동 인스턴스임을 나타내는 부울 값입니다. passive 필드는 members[n].priority가 0인 멤버에 대해서만 표시됩니다.

hello.hidden: true인 경우 현재 인스턴스가 숨겨진 인스턴스임을 나타내는 부울 값입니다. hidden 필드는 숨겨진 멤버에 대해서만 표시됩니다.

hello.tags

tags 문서에는 복제본 세트 멤버를 위한 사용자 정의 태그 필드와 값 쌍이 포함되어 있습니다.

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

읽기 작업의 경우, 읽기 설정에서 태그 세트를 지정하여 지정된 해당 태그가 있는 복제본 세트 멤버에게 작업을 지시할 수 있습니다.
쓰기 작업의 경우, settings.getLastErrorModes 및 settings.getLastErrorDefaults를 사용하여 사용자 지정 쓰기 고려를 생성할 수 있습니다.

자세한 내용은 복제본 세트 태그 세트 구성에서 확인하세요.

팁

members[n].tags

hello.me: hello를 반환한 멤버의 [hostname]:[port]입니다.

hello.electionId: 각 투표에 대한 고유 식별자입니다. 프라이머리에 대한 hello의 출력에만 포함됩니다. 클라이언트가 투표가 발생하는 시기를 결정하는 데 사용됩니다.

hello.lastWrite

데이터베이스의 가장 최근 쓰기 작업에 대한 optime 및 날짜 정보가 포함된 문서입니다.

hello.lastWrite.opTime: 마지막 쓰기 작업의 optime을 제공하는 객체입니다.

hello.lastWrite.lastWriteDate: 마지막 쓰기 작업의 시간을 포함하는 날짜 객체입니다.

hello.lastWrite.majorityOpTime: majority 읽기로 읽을 수 있는 마지막 쓰기 작업의 optime을 제공하는 객체입니다.

hello.lastWrite.majorityWriteDate: majority 읽기로 읽을 수 있는 마지막 쓰기 작업 시간을 포함하는 날짜 객체입니다.

ok 상태 필드, operationTime 필드, $clusterTime 필드에 대한 자세한 내용은 명령 응답을 참조하세요.

돌아가기

applyOps

replSetAbortPrimaryCatchUp