confdb

설정DB(ConfigDatabase)의 데이터베이스, 컬렉션, 문서, 커밋 로그를 조회합니다. 이 명령어를 실행하려면 관리자 권한이 필요합니다.

명령어 속성

항목설명
명령어 유형드라이버 쿼리
필요 권한관리자
라이선스 사용량해당 없음
병렬 실행미지원
분산 실행미지원

문법

데이터베이스 목록을 조회하려면

confdb databases

컬렉션 목록을 조회하려면

confdb cols DB_NAME

문서를 조회하려면

confdb docs DB_NAME COL_NAME

커밋 로그를 조회하려면

confdb logs DB_NAME

대상

OP
수행할 조회 유형을 지정합니다.
  • databases: 설정DB의 데이터베이스 목록을 조회합니다.
  • cols: 지정한 데이터베이스의 컬렉션 목록을 조회합니다.
  • docs: 지정한 데이터베이스의 컬렉션에 속한 문서를 조회합니다.
  • logs: 지정한 데이터베이스의 커밋 로그를 조회합니다.
DB_NAME
대상 데이터베이스 이름. cols, docs, logs 조회 시 필수입니다.
COL_NAME
대상 컬렉션 이름. docs 조회 시 필수입니다.

출력 필드

databases 조회 시:

필드타입설명
name문자열데이터베이스 이름
rev64비트 정수최신 리비전 번호
commits64비트 정수커밋 수
last_msg문자열마지막 커밋 메시지
last_commit날짜마지막 커밋 시각

cols 조회 시:

필드타입설명
name문자열컬렉션 이름

docs 조회 시:

필드타입설명
doc_id32비트 정수문서 식별자
doc_prev32비트 정수이전 리비전 번호
doc_rev32비트 정수현재 리비전 번호
doc문서 내용. 문서가 맵 타입인 경우 각 키-값이 개별 필드로 할당됩니다.

logs 조회 시:

필드타입설명
_time날짜커밋 시각
rev_id64비트 정수리비전 식별자
committer문자열커밋 수행자
msg문자열커밋 메시지
manifest_id64비트 정수매니페스트 식별자. 설정DB가 지원하는 경우에만 할당됩니다.

오류 코드

파싱 오류
오류 코드메시지설명
10000권한이 없습니다. 관리자 권한이 필요합니다.관리자 권한이 없는 경우
10001입력된 옵션 값이 없습니다.조회 유형(databases, cols, docs, logs)을 지정하지 않은 경우
10002confdb 데이타베이스 이름을 입력하십시오.cols, docs, logs 조회 시 데이터베이스 이름을 지정하지 않은 경우
10003confdb 컬렉션 이름을 입력하십시오.docs 조회 시 컬렉션 이름을 지정하지 않은 경우
10004[op]는 지원하지 않는 옵션 입니다.지원하지 않는 조회 유형을 지정한 경우
런타임 오류

해당 사항 없음

설명

confdb 명령어는 시스템 설정DB의 내부 데이터를 직접 조회합니다.

  • databases 조회: 전체 데이터베이스 목록과 각 데이터베이스의 리비전, 커밋 수, 마지막 커밋 정보를 반환합니다.
  • cols 조회: 지정한 데이터베이스에 속한 컬렉션 이름 목록을 반환합니다. 데이터베이스가 존재하지 않으면 결과가 없습니다.
  • docs 조회: 지정한 컬렉션의 모든 문서를 반환합니다. 문서가 맵 타입인 경우 각 키-값 쌍이 개별 출력 필드로 할당됩니다. 그렇지 않은 경우 doc 필드에 문서 전체를 할당합니다.
  • logs 조회: 지정한 데이터베이스의 커밋 로그를 최대 1,000건 단위로 반복 조회하여 반환합니다.

사용 예

  1. 데이터베이스 목록 조회

    confdb databases
    
  2. 컬렉션 목록 조회

    confdb cols araqne-log-api
    
  3. 문서 조회

    confdb docs araqne-log-api logger
    
  4. 커밋 로그 조회

    confdb logs araqne-log-api
    

호환성

confdb 명령어는 소나 4.0 이전 버전부터 제공되었습니다.