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 | 문자열 | 데이터베이스 이름 |
| rev | 64비트 정수 | 최신 리비전 번호 |
| commits | 64비트 정수 | 커밋 수 |
| last_msg | 문자열 | 마지막 커밋 메시지 |
| last_commit | 날짜 | 마지막 커밋 시각 |
cols 조회 시:
| 필드 | 타입 | 설명 |
|---|---|---|
| name | 문자열 | 컬렉션 이름 |
docs 조회 시:
| 필드 | 타입 | 설명 |
|---|---|---|
| doc_id | 32비트 정수 | 문서 식별자 |
| doc_prev | 32비트 정수 | 이전 리비전 번호 |
| doc_rev | 32비트 정수 | 현재 리비전 번호 |
| doc | 맵 | 문서 내용. 문서가 맵 타입인 경우 각 키-값이 개별 필드로 할당됩니다. |
logs 조회 시:
| 필드 | 타입 | 설명 |
|---|---|---|
| _time | 날짜 | 커밋 시각 |
| rev_id | 64비트 정수 | 리비전 식별자 |
| committer | 문자열 | 커밋 수행자 |
| msg | 문자열 | 커밋 메시지 |
| manifest_id | 64비트 정수 | 매니페스트 식별자. 설정DB가 지원하는 경우에만 할당됩니다. |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 10000 | 권한이 없습니다. 관리자 권한이 필요합니다. | 관리자 권한이 없는 경우 |
| 10001 | 입력된 옵션 값이 없습니다. | 조회 유형(databases, cols, docs, logs)을 지정하지 않은 경우 |
| 10002 | confdb 데이타베이스 이름을 입력하십시오. | cols, docs, logs 조회 시 데이터베이스 이름을 지정하지 않은 경우 |
| 10003 | confdb 컬렉션 이름을 입력하십시오. | docs 조회 시 컬렉션 이름을 지정하지 않은 경우 |
| 10004 | [op]는 지원하지 않는 옵션 입니다. | 지원하지 않는 조회 유형을 지정한 경우 |
런타임 오류
해당 사항 없음
설명
confdb 명령어는 시스템 설정DB의 내부 데이터를 직접 조회합니다.
databases조회: 전체 데이터베이스 목록과 각 데이터베이스의 리비전, 커밋 수, 마지막 커밋 정보를 반환합니다.cols조회: 지정한 데이터베이스에 속한 컬렉션 이름 목록을 반환합니다. 데이터베이스가 존재하지 않으면 결과가 없습니다.docs조회: 지정한 컬렉션의 모든 문서를 반환합니다. 문서가 맵 타입인 경우 각 키-값 쌍이 개별 출력 필드로 할당됩니다. 그렇지 않은 경우doc필드에 문서 전체를 할당합니다.logs조회: 지정한 데이터베이스의 커밋 로그를 최대 1,000건 단위로 반복 조회하여 반환합니다.
사용 예
-
데이터베이스 목록 조회
confdb databases -
컬렉션 목록 조회
confdb cols araqne-log-api -
문서 조회
confdb docs araqne-log-api logger -
커밋 로그 조회
confdb logs araqne-log-api
호환성
confdb 명령어는 소나 4.0 이전 버전부터 제공되었습니다.