{"meta":{"title":"데이터베이스 추가 진단","intro":"[실험적] 데이터베이스에 진단 정보를 추가합니다.","product":"보안 및 코드 품질","breadcrumbs":[{"href":"/ko/code-security","title":"보안 및 코드 품질"},{"href":"/ko/code-security/reference","title":"Reference"},{"href":"/ko/code-security/reference/code-scanning","title":"코드 검사"},{"href":"/ko/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ko/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"CodeQL CLI 매뉴얼"},{"href":"/ko/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-add-diagnostic","title":"데이터베이스 추가 진단"}],"documentType":"article"},"body":"# 데이터베이스 추가 진단\n\n[실험적] 데이터베이스에 진단 정보를 추가합니다.\n\n> [!NOTE]\n> 이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 요소에 대한 자세한 내용은 https://github.com/github/codeql-cli-binaries/releases을(를) 참조하세요.\n>\n> 이전 릴리스에서 이 명령에 사용할 수 있는 옵션의 세부 정보를 보려면 터미널에서 옵션을 사용하여 <span style=\"white-space: nowrap;\">`--help`</span> 명령을 실행합니다.\n\n## 개요\n\n```shell copy\ncodeql database add-diagnostic --source-id=<id> --source-name=<name> <options>... -- <database>\n```\n\n## Description\n\n              \\[실험적] 데이터베이스에 진단 정보를 추가합니다.\n\n              `v2.12.6`부터 사용할 수 있습니다.\n\n## Options\n\n### 기본 옵션\n\n#### `<database>`\n\n              \\[필수] 번들로 묶을 CodeQL 데이터베이스의 경로입니다.\n\n#### `--markdown-message=<markdownMessage>`\n\n진단 메시지로, GitHub 스타일의 Markdown 형식입니다.\n\n#### `--plaintext-message=<plaintextMessage>`\n\n진단 메시지로, 일반 텍스트 형식입니다. 이 옵션은 --markdown-message로 Markdown 메시지를 작성하는 것이 실용적이지 않을 때만 사용해야 합니다.\n\n#### `--severity=<severity>`\n\n진단의 심각도입니다. 값으로는 \"error\", \"warning\", 또는 \"note\"를 사용할 수 있습니다.\n\n#### `--help-link=<helpLinks>`\n\n진단과 관련된 도움말 링크입니다.\n\n#### `--attributes-json=<attributesJson>`\n\n진단과 관련된 구조화된 메타데이터입니다.\n\n### 진단 메시지를 표시할 위치를 지정하는 옵션입니다.\n\n#### `--ready-for-status-page`\n\n진단을 상태 페이지에 표시하기에 적합함을 나타냅니다.\n\n#### `--ready-for-cli-summary-table`\n\n진단을 `database analyze`과 같은 명령에서 출력되는 진단 요약 표에 표시하기에 적합함을 나타냅니다.\n\n### 진단의 출처를 설명하는 옵션입니다.\n\n#### `--source-id=<id>`\n\n              \\[필수] 이 진단의 출처를 나타내는 식별자입니다.\n\n#### `--source-name=<name>`\n\n              \\[필수] 이 진단 출처에 대한 사람이 읽을 수 있는 설명입니다.\n\n#### `--extractor-name=<extractorName>`\n\n이 진단이 CodeQL 추출기에 의해 생성된 경우, 해당 CodeQL 추출기의 이름입니다.\n\n### 진단 위치를 설명하는 옵션입니다.\n\n#### `--file-path=<file>`\n\n진단이 적용되는 파일의 경로로, 소스 루트를 기준으로 한 상대 경로입니다.\n\n#### `--start-line=<startLine>`\n\n진단 위치가 시작되는 1부터 시작하는 행 번호(포함)입니다.\n\n#### `--start-column=<startColumn>`\n\n진단 위치가 시작되는 1부터 시작하는 열 번호(포함)입니다.\n\n#### `--end-line=<endLine>`\n\n진단 위치가 끝나는 1부터 시작하는 행 번호(포함)입니다.\n\n#### `--end-column=<endColumn>`\n\n진단 위치가 끝나는 1부터 시작하는 열 번호(포함)입니다.\n\n### 일반 옵션\n\n#### `-h, --help`\n\n이 도움말 텍스트를 표시합니다.\n\n#### `-J=<opt>`\n\n              \\[고급] 명령을 실행하는 JVM에 옵션을 전달합니다.\n\n(공백이 포함된 옵션은 올바르게 처리되지 않을 수 있습니다.)\n\n#### `-v, --verbose`\n\n출력되는 진행 메시지의 수를 점진적으로 증가시킵니다.\n\n#### `-q, --quiet`\n\n출력되는 진행 메시지의 수를 점진적으로 줄입니다.\n\n#### `--verbosity=<level>`\n\n              \\[고급] 상세 수준을 명시적으로 설정합니다. 선택 가능한 값: errors, warnings, progress, progress+, progress++, progress+++. \n              `-v` 및 `-q`를 재정의합니다.\n\n#### `--logdir=<dir>`\n\n              \\[고급] 지정된 디렉토리에 자세한 로그를 하나 이상 기록합니다. 로그 파일 이름에는 타임스탬프와 실행 중인 하위 명령 이름이 포함됩니다.\n\n(로그 파일 이름을 완전히 제어하고 싶다면, 대신 `--log-to-stderr`을 사용하고 원하는 대로 stderr를 리디렉션하세요.)\n\n#### `--common-caches=<dir>`\n\n              \\[고급] CLI의 여러 실행 간에 유지되는 디스크상의 캐시 데이터 위치를 제어합니다. 여기에는 다운로드된 QL 팩과 컴파일된 쿼리 계획이 포함됩니다. 명시적으로 설정하지 않은 경우, 사용자 홈 디렉터리에 있는 `.codeql`이라는 이름의 디렉터리를 기본값으로 사용하며, 해당 디렉터리가 존재하지 않으면 새로 생성됩니다.\n\n              `v2.15.2`부터 사용할 수 있습니다."}