digna CLI 참조 2025.04¶
2025-04-01
이 페이지는 digna CLI 릴리스 2025.04에서 사용 가능한 전체 명령어 세트를 예제와 옵션을 포함해 문서화합니다.
CLI 기본사항¶
help 옵션 사용하기¶
--help 옵션은 사용 가능한 명령어와 사용법에 대한 정보를 제공합니다. 이 옵션을 사용하는 주요 방법은 두 가지입니다:
- 일반 도움말 표시:
dignacli 키워드 바로 뒤에 --help를 사용하세요.
dignacli --help
- 특정 명령어에 대한 도움말 얻기:
특정 명령어에 대한 상세 정보를 보려면 해당 명령어 뒤에 --help를 추가합니다.
예를 들어 add-user 명령어의 도움말을 보려면 다음을 실행합니다:
dignacli add-user --help
### 출력:
- 명령어 설명: 명령어가 수행하는 작업에 대한 상세 설명을 제공합니다.
- 구문: 필수 및 선택 인수를 포함한 정확한 구문을 보여줍니다.
- 옵션: 명령어별 옵션과 그 설명을 나열합니다.
- 예제: 명령어를 효과적으로 실행하는 방법의 예제를 제공합니다.
check-repo-connection 명령어 사용하기¶
check-repo-connection 명령어는 지정된 digna 저장소에 대한 연결 및 접근성을 테스트하도록 설계된 유틸리티입니다. 이 명령어는 CLI가 저장소와 상호작용할 수 있는지 확인합니다.
명령어 사용법¶
dignacli check-repo-connection
성공적으로 실행되면 저장소 버전, 호스트, 데이터베이스 및 스키마 등의 저장소 세부 정보와 함께 연결 확인 메시지를 출력합니다.
저장소 연결이 성공하지 않으면 config.toml 파일에서 설정이 올바른지 확인하세요.
version 명령어 사용하기¶
설치된 dignacli 버전을 확인하려면 --version 옵션을 사용하세요.
명령어 사용법¶
dignacli --version
예제 출력¶
dignacli version 2025.04
로깅 옵션 사용하기¶
기본적으로 digna 명령어의 콘솔 출력은 최소화되어 있습니다. 대부분의 명령어는 추가 정보를 제공할 수 있는 다음 옵션들을 제공합니다:
-- verbose (-v)
-- debug (-d)
-- logfile (lf)
“verbose”와 “debug”는 출력 세부 수준을 정의하며, “logfile” 스위치는 출력을 콘솔 대신 파일로 스트리밍하도록 리디렉션합니다.
사용자 관리¶
add-user 명령어 사용하기¶
digna CLI의 add-user 명령어는 새로운 사용자를 digna 시스템에 추가하는 데 사용됩니다.
명령어 사용법¶
dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD
인수¶
- USER_NAME: 새 사용자의 사용자 이름 (필수).
- USER_FULL_NAME: 새 사용자의 전체 이름 (필수).
- USER_PASSWORD: 새 사용자의 비밀번호 (필수).
옵션¶
--is_superuser,-su: 새 사용자를 관리자(슈퍼유저)로 지정하는 플래그.--valid_until,-vu: 계정 만료일을YYYY-MM-DD HH:MI:SS형식으로 설정합니다. 설정하지 않으면 계정에 만료일이 없습니다.
예제¶
사용자 이름 jdoe, 전체 이름 John Doe, 비밀번호 password123으로 새 사용자를 추가하려면:
dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD
계정 만료일을 설정하여 새 사용자를 추가하려면:
dignacli add-user jdoe "John Doe" password123 --valid_until "2024-12-31 23:59:59"
delete-user 명령어 사용하기¶
digna CLI의 delete-user 명령어는 기존 사용자를 digna 시스템에서 제거하는 데 사용됩니다.
명령어 사용법¶
dignacli delete-user USER_NAME
인수¶
- USER_NAME: 삭제할 사용자의 사용자 이름 (필수). 이 명령어에 필요한 유일한 인수입니다.
예제¶
dignacli delete-user jdoe
이 명령을 실행하면 사용자 jdoe가 digna 시스템에서 제거되어 접근 권한이 취소되고 저장소에서 관련 데이터와 권한이 삭제됩니다.
modify-user 명령어 사용하기¶
digna CLI의 modify-user 명령어는 기존 사용자의 정보를 업데이트하는 데 사용됩니다.
명령어 사용법¶
dignacli modify-user <USER_NAME> <USER_FULL_NAME> [options]
인수¶
- USER_NAME: 수정할 사용자의 사용자 이름 (필수).
- USER_FULL_NAME: 사용자의 새로운 전체 이름 (필수).
옵션¶
--is_superuser,-su: 사용자를 슈퍼유저로 설정하여 권한을 상승시킵니다. 이 플래그는 값이 필요 없습니다.--valid_until,-vu: 계정 만료일을YYYY-MM-DD HH:MI:SS형식으로 설정합니다. 제공하지 않으면 계정은 무기한 유효합니다.
예제¶
사용자 jdoe의 전체 이름을 “Johnathan Doe”로 수정하고 해당 사용자를 슈퍼유저로 설정하려면:
dignacli modify-user jdoe "Johnathan Doe" --is_superuser
modify-user-pwd 명령어 사용하기¶
digna CLI의 modify-user-pwd 명령어는 기존 사용자의 비밀번호를 변경하는 데 사용됩니다.
명령어 사용법¶
dignacli modify-user-pwd <USER_NAME> <USER_PWD>
인수¶
- USER_NAME: 비밀번호를 변경할 사용자의 사용자 이름 (필수).
- USER_PWD: 사용자의 새 비밀번호 (필수).
예제¶
사용자 jdoe의 비밀번호를 newpassword123으로 변경하려면:
dignacli modify-user-pwd jdoe newpassword123
list-users 명령어 사용하기¶
digna CLI의 list-users 명령어는 digna 시스템에 등록된 모든 사용자의 목록을 표시합니다.
명령어 사용법¶
dignacli list-users
이 명령을 실행하면 digna 저장소에 연결하여 모든 사용자의 ID, 사용자 이름, 전체 이름, 슈퍼유저 상태 및 만료 타임스탬프를 표시합니다.
저장소 관리¶
upgrade-repo 명령어 사용하기¶
digna CLI의 upgrade-repo 명령어는 digna 저장소를 업그레이드하거나 초기화하는 데 사용됩니다. 이 명령어는 업데이트를 적용하거나 저장소 인프라를 처음 설정할 때 필수적입니다.
명령어 사용법¶
dignacli upgrade-repo [options]
옵션¶
--simulation-mode,-s: 활성화하면 시뮬레이션 모드로 실행되어 실제로 SQL 문을 실행하지 않고 실행될 SQL 문을 출력합니다. 변경사항을 적용하지 않고 미리 확인할 때 유용합니다.
예제¶
옵션 없이 digna 저장소를 업그레이드하려면:
dignacli upgrade-repo
dignacli upgrade-repo --simulation-mode
이 명령어는 데이터베이스 스키마 및 기타 저장소 구성 요소가 소프트웨어의 최신 버전과 일치하도록 하여 digna 시스템을 유지 관리하는 데 매우 중요합니다.
encrypt 명령어 사용하기¶
digna CLI의 encrypt 명령어는 비밀번호를 암호화하는 데 사용됩니다.
명령어 사용법¶
dignacli encrypt <PASSWORD>
인수¶
- PASSWORD: 암호화할 비밀번호 (필수).
예제¶
비밀번호를 암호화하려면 비밀번호를 인수로 제공해야 합니다.
예를 들어 비밀번호 mypassword123을 암호화하려면:
dignacli encrypt mypassword123
generate-key 명령어 사용하기¶
generate-key 명령어는 저장소에 저장된 비밀번호를 보호하는 데 필요한 Fernet 키를 생성하는 데 사용됩니다.
명령어 사용법¶
dignacli generate-key
데이터 관리¶
clean-up 명령어 사용하기¶
digna CLI의 clean-up 명령어는 지정된 프로젝트 내 하나 이상의 데이터 소스에 대해 프로파일, 예측 및 트래픽 라이트 시스템 데이터를 삭제하는 데 사용됩니다. 이 명령어는 구식 또는 불필요한 데이터를 정리하여 데이터 수명 주기 관리를 돕고 정리된 효율적인 데이터 환경을 유지하는 데 필수적입니다.
명령어 사용법¶
dignacli clean-up <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]
인수¶
- PROJECT_NAME: 데이터를 제거할 프로젝트 이름 (필수). 이 인수에
all-projects키워드를 사용하면 digna가 모든 기존 프로젝트를 순회하며 명령을 적용합니다. - FROM_DATE: 데이터 제거의 시작 날짜 및 시간. 허용되는 형식에는 %Y-%m-%d, %Y-%m-%dT%H:%M:%S 또는 %Y-%m-%d %H:%M:%S가 포함됩니다 (필수).
- TO_DATE: 데이터 제거의 종료 날짜 및 시간으로 FROM_DATE와 동일한 형식이 허용됩니다 (필수).
옵션¶
--table-name,-tn: 정리 작업을 프로젝트 내 특정 테이블로 제한합니다.--table-filter,-tf: 테이블 이름에 지정된 부분 문자열이 포함된 테이블로 정리 작업을 제한하는 필터입니다.--timing,-tm: 완료 후 정리 프로세스의 소요 시간을 표시합니다.--help: clean-up 명령어의 도움말을 표시하고 종료합니다.
예제¶
프로젝트 ProjectA에서 2023년 1월 1일부터 2023년 6월 30일까지의 데이터를 제거하려면:
dignacli clean-up ProjectA 2023-01-01 2023-06-30
특정 테이블 Table1의 데이터만 제거하려면:
dignacli clean-up ProjectA 2023-01-01 2023-06-30 --table-name Table1
이 명령은 저장소의 데이터 관리를 돕고 관련 정보만 저장되도록 보장합니다.
list-projects 명령어 사용하기¶
digna CLI의 list-projects 명령어는 시스템 내 사용 가능한 모든 프로젝트 목록을 표시하는 데 사용됩니다.
명령어 사용법¶
dignacli list-projects
이 명령은 여러 프로젝트를 관리하는 관리자와 사용자에게 유용하며 digna 저장소에서 사용 가능한 프로젝트를 빠르게 파악할 수 있게 합니다.
list-ds 명령어 사용하기¶
digna CLI의 list-ds 명령어는 지정된 프로젝트 내 사용 가능한 모든 데이터 소스 목록을 표시하는 데 사용됩니다. 이 명령은 분석 및 관리 가능한 데이터 자산을 이해하는 데 유용합니다.
명령어 사용법¶
dignacli list-ds <PROJECT_NAME>
인수¶
- PROJECT_NAME: 데이터 소스를 나열할 프로젝트 이름 (필수).
예제¶
프로젝트 ProjectA의 모든 데이터 소스를 나열하려면:
dignacli list-ds ProjectA
이 명령은 프로젝트 내 사용 가능한 데이터 소스에 대한 개요를 제공하여 데이터 환경을 보다 효과적으로 탐색하고 관리할 수 있게 합니다。
inspect 명령어 사용하기¶
digna CLI의 inspect 명령어는 지정된 프로젝트 내 하나 이상의 데이터 소스에 대해 프로파일, 예측 및 트래픽 라이트 시스템 데이터를 생성하는 데 사용됩니다. 이 명령은 정의된 기간 동안 데이터를 분석하고 모니터링하는 데 도움이 됩니다.
명령어 사용법¶
dignacli inspect <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]
인수¶
- PROJECT_NAME: 데이터를 검사할 프로젝트 이름 (필수). 이 인수에
all-projects키워드를 사용하면 digna가 모든 기존 프로젝트를 순회하며 명령을 적용합니다. - FROM_DATE: 검사 시작 날짜 및 시간. 허용되는 형식에는 %Y-%m-%d, %Y-%m-%dT%H:%M:%S 또는 %Y-%m-%d %H:%M:%S가 포함됩니다 (필수).
- TO_DATE: 검사 종료 날짜 및 시간으로 FROM_DATE와 동일한 형식이 허용됩니다 (필수).
옵션¶
--table-name,-tn: 검사를 프로젝트 내 특정 테이블로 제한합니다.--table-filter,-tf: 이름에 지정된 부분 문자열이 포함된 테이블만 검사하도록 필터링합니다.--do-profile: 프로파일 재수집을 트리거합니다. 기본값은 do-profile입니다.--no-do-profile: 프로파일 재수집을 방지합니다.--do-prediction: 예측 재계산을 트리거합니다. 기본값은 do-prediction입니다.--no-do-prediction: 예측 재계산을 방지합니다.--do-alert-status: 경고 상태 재계산을 트리거합니다. 기본값은 do-alert-status입니다.--no-do-alert-status: 경고 상태 재계산을 방지합니다.--iterative: 일 단위 반복으로 기간을 검사합니다. 기본값은 iterative입니다.--no-iterative: 전체 기간을 한 번에 검사합니다.--enable_notification,-en: 경고 발생 시 알림 전송을 활성화합니다.--timing,-tm: 완료 후 검사 프로세스의 소요 시간을 표시합니다.
예제¶
프로젝트 ProjectA의 2024년 1월 1일부터 2024년 1월 31일까지의 데이터를 검사하려면:
dignacli inspect ProjectA 2024-01-01 2024-01-31
특정 테이블만 검사하고 예측 재계산을 강제하려면:
dignacli inspect ProjectA 2024-01-01 2024-01-31 --table-name Table1 --force-prediction
tls-status 명령어 사용하기¶
digna CLI의 tls-status 명령어는 특정 날짜에 프로젝트 내 특정 테이블에 대한 Traffic Light System(TLS)의 상태를 조회하는 데 사용됩니다. Traffic Light System은 데이터의 건전성과 품질에 대한 인사이트를 제공하여 주의가 필요한 문제나 경고를 알려줍니다.
명령어 사용법¶
dignacli tls-status <PROJECT_NAME> <TABLE_NAME> <DATE>
인수¶
- PROJECT_NAME: TLS 상태를 조회할 프로젝트 이름 (필수).
- TABLE_NAME: TLS 상태를 확인할 프로젝트 내 특정 테이블 이름 (필수).
- DATE: TLS 상태를 조회할 날짜로 일반적으로 %Y-%m-%d 형식을 사용합니다 (필수).
예제¶
프로젝트 ProjectA의 테이블 UserData에 대해 2024-07-01의 TLS 상태를 확인하려면:
dignacli tls-status ProjectA UserData 2024-07-01
이 명령은 미리 정의된 기준에 따라 명확하고 실행 가능한 상태 보고서를 제공하여 데이터 품질을 모니터링하고 유지하는 데 도움을 줍니다.
inspect-async 명령어 사용하기¶
digna CLI의 inspect-async 명령어는 백엔드에 비동기적으로 지정된 프로젝트의 하나 이상의 데이터 소스에 대해 검사를 수행하도록 지시합니다. project_name이 all-projects로 설정되면 사용 가능한 모든 프로젝트를 순회하여 검사를 수행합니다. 이 명령은 요청 ID를 반환하며, 해당 ID로 검사 진행 상황을 추적할 수 있습니다.
명령어 사용법¶
dignacli inspect-async <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]
인수¶
- PROJECT_NAME: 검사를 수행할 프로젝트 이름 (필수).
all-projects키워드를 사용하면 digna가 모든 기존 프로젝트를 순회하며 명령을 적용합니다. - FROM_DATE: 검사 시작 날짜 및 시간. 허용되는 형식에는 %Y-%m-%d, %Y-%m-%dT%H:%M:%S 또는 %Y-%m-%d %H:%M:%S가 포함됩니다 (필수).
- TO_DATE: 검사 종료 날짜 및 시간으로 FROM_DATE와 동일한 형식이 허용됩니다 (필수).
옵션¶
--table-name,-tn: 검사를 프로젝트 내 특정 테이블로 제한합니다.--table-filter,-tf: 이름에 지정된 부분 문자열이 포함된 테이블만 검사하도록 필터링합니다.
예제¶
프로젝트 ProjectA의 2024년 1월 1일부터 2024년 1월 31일까지의 데이터를 비동기 검사하려면:
dignacli inspect-async ProjectA 2024-01-01 2024-01-31
inspect-status 명령어 사용하기¶
digna CLI의 inspect-status 명령어는 비동기 검사 요청 ID를 기반으로 진행 상황을 확인하는 데 사용됩니다.
명령어 사용법¶
dignacli inspect-status <REQUEST ID> [options]
인수¶
- REQUEST_ID:
inspect-async명령어가 반환한 요청 ID
옵션¶
--report_level,-rl: 리포트 수준 설정: 'task' 또는 'step' [기본값: task]
예제¶
요청 ID 12345인 검사의 상세 단계 수준에서 진행 상황을 확인하려면:
dignacli inspect-status 12345 --report-level step
export-ds 명령어 사용하기¶
digna CLI의 export-ds 명령어는 digna 저장소에서 데이터 소스의 내보내기를 생성하는 데 사용됩니다. 기본적으로 지정된 프로젝트의 모든 데이터 소스가 내보내집니다.
명령어 사용법¶
dignacli export-ds <PROJECT_NAME> [options]
인수¶
- PROJECT_NAME: 데이터 소스를 내보낼 프로젝트 이름.
옵션¶
--table_name,-tn: 프로젝트에서 특정 데이터 소스를 내보냅니다.--exportfile,-ef: 내보내기 파일 이름을 지정합니다.
예제¶
프로젝트 ProjectA의 모든 데이터 소스를 내보내려면:
dignacli export-ds ProjectA
이 명령은 ProjectA의 모든 데이터 소스를 JSON 문서로 내보내며, 다른 프로젝트나 digna 저장소로 가져오는 데 사용할 수 있습니다.
import-ds 명령어 사용하기¶
digna CLI의 import-ds 명령어는 데이터 소스를 대상 프로젝트로 가져오고 가져오기 보고서를 생성하는 데 사용됩니다.
명령어 사용법¶
dignacli import-ds <PROJECT_NAME> <EXPORT_FILE> [options]
인수¶
- PROJECT_NAME: 데이터 소스를 가져올 대상 프로젝트 이름.
- EXPORT_FILE: 가져올 데이터 소스 내보내기 파일 이름.
옵션¶
--output-file,-o: 가져오기 보고서를 저장할 파일 (지정하지 않으면 터미널에 표 형태로 출력).--output-format,-f: 가져오기 보고서를 저장할 형식 (json, csv).
예제¶
내보내기 파일 my_export.json의 모든 데이터 소스를 ProjectB로 가져오려면:
dignacli import-ds ProjectB my_export.json
가져오기 후 이 명령은 가져온 객체와 건너뛴 객체에 대한 보고서도 표시합니다. ProjectB에는 새로운 데이터 소스만 가져옵니다. 어떤 객체가 가져와지고 건너뛰어질지 확인하려면 plan-import-ds 명령을 사용할 수 있습니다.
plan-import-ds 명령어 사용하기¶
digna CLI의 plan-import-ds 명령어는 가져오기 전에 내보내기 파일을 분석하여 대상 프로젝트로 어떤 데이터 소스가 가져와질지에 대한 계획을 생성하는 데 사용됩니다.
명령어 사용법¶
dignacli plan-import-ds <PROJECT_NAME> <EXPORT_FILE> [options]
인수¶
- PROJECT_NAME: 데이터 소스가 가져와질 대상 프로젝트 이름.
- EXPORT_FILE: 가져오기 전에 분석할 데이터 소스 내보내기 파일 이름.
옵션¶
--output-file,-o: 가져오기 계획 보고서를 저장할 파일 (지정하지 않으면 터미널에 표 형태로 출력).--output-format,-f: 가져오기 계획 보고서를 저장할 형식 (json, csv).
예제¶
내보내기 파일 my_export.json에서 ProjectB로 가져올 때 어떤 데이터 소스가 가져와지고 건너뛰어질지 확인하려면:
dignacli plan-import-ds ProjectB my_export.json
이 명령은 가져와질 객체와 건너뛰어질 객체의 가져오기 계획만 표시합니다.