sonar-employees
로그프레소 소나에 등록된 임직원 목록을 조회합니다. 옵션이 없으며, 실행하면 등록된 모든 임직원을 반환합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
emp_guid | 문자열 | 임직원 GUID(36자) |
emp_key | 문자열 | 임직원 사번. 예: A000001 |
emp_name | 문자열 | 임직원 성명. 예: 홍길동 |
emp_title | 문자열 | 임직원 직위. 예: 과장 |
dept_code | 문자열 | 소속 부서 코드. 예: 001122 |
dept_name | 문자열 | 소속 부서 이름. 예: 영업팀 |
dept_guid | 문자열 | 소속 부서 GUID(36자) |
locale | 문자열 | 임직원 언어 설정. 예: en, ko. 값이 없으면 en으로 반환 |
email | 문자열 | 임직원의 이메일 주소 |
mobile | 문자열 | 임직원의 휴대 전화번호 |
phone | 문자열 | 임직원의 유선 전화번호 |
address | 문자열 | 임직원이 배치된 사업장 위치 |
join_date | 문자열 | 입사일. yyyy-MM-dd HH:mm:ssZ 형식의 문자열로 반환됨(날짜 타입 아님) |
leave_date | 문자열 | 퇴사일. yyyy-MM-dd HH:mm:ssZ 형식의 문자열로 반환됨(날짜 타입 아님) |
self_explanation | 불리언 | 자가 결재 허용 여부(웹 콘솔 임직원 관리 화면의 "자가 결재" 설정에 대응) |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300162 | 임직원 목록 조회는 관리자 권한이 필요합니다. | 관리자 권한이 없는 세션에서 실행한 경우 |
런타임 오류
해당 사항 없음
설명
sonar-employees는 로그프레소 소나에 등록된 모든 임직원을 조회하는 관리자 전용 명령어입니다. 관리자 권한이 없는 세션에서 실행하면 파싱 단계에서 오류가 발생하며 쿼리가 실행되지 않습니다.
내부적으로 1,000건씩 페이지 단위로 조회하여 전체 임직원을 순차적으로 반환하며, 각 임직원의 dept_guid를 기준으로 부서 코드를 함께 조회하여 dept_code 필드로 채웁니다. locale 값이 지정되지 않은 임직원은 en으로 반환됩니다.
self_explanation 필드는 결과 레코드에 항상 포함되지만 열 순서 정의에는 나열되지 않으므로, 결과 표에서 열 순서 정의에 포함된 다른 필드 뒤에 표시됩니다.
조회 결과를 sonar-departments 명령어의 결과와 dept_guid 또는 dept_code로 조인하면 부서 계층 정보를 함께 확인할 수 있습니다. 임직원 데이터를 외부 인사 시스템과 동기화하려면 sonar-sync-employees 명령어를 사용합니다.
사용 예
-
등록된 모든 임직원 조회
sonar-employees -
특정 부서 소속 임직원만 필터링
sonar-employees | search dept_code == "001122" | fields emp_key, emp_name, emp_title, email, phone -
부서 목록과 조인하여 부서 경로 확인
sonar-employees | join dept_guid [ sonar-departments | fields dept_guid, dept_path ] | fields emp_key, emp_name, dept_name, dept_path -
부서별 임직원 수 집계
sonar-employees | stats count by dept_name | sort -count
변경 이력
sonar-employees 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.
이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.