{"meta":{"title":"데이터베이스 번들 해제","intro":"CodeQL 데이터베이스 아카이브를 추출합니다.","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-unbundle","title":"데이터베이스 번들 해제"}],"documentType":"article"},"body":"# 데이터베이스 번들 해제\n\nCodeQL 데이터베이스 아카이브를 추출합니다.\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 unbundle <options>... -- <archive>\n```\n\n## Description\n\nCodeQL 데이터베이스 아카이브를 추출합니다.\n\n이 명령은 [codeql database bundle](/ko/code-security/reference/code-scanning/codeql/codeql-cli-manual/database-bundle)로 생성된 CodeQL 데이터베이스 아카이브를 추출합니다. 이는 unzip을 사용해 데이터베이스를 추출하는 것과 유사하지만, 특정 환경에서는 성능이 더 우수하며(예를 들어 Windows에서는 unzip이 매우 느릴 수 있음), 추출되는 데이터베이스의 이름을 지정하는 등 추가 옵션을 지원합니다.\n\n## Options\n\n### 기본 옵션\n\n#### `<archive>`\n\n```\n          \\[필수] 압축을 해제할 CodeQL 데이터베이스 아카이브의 경로입니다.\n```\n\n#### `--name=<name>`\n\n생성될 CodeQL 데이터베이스에 부여할 이름입니다. 제공되지 않은 경우, 아카이브에 포함된 데이터베이스의 이름이 그대로 사용됩니다.\n\n#### `--target=<target>`\n\nCodeQL 데이터베이스를 압축 해제할 디렉터리입니다. 제공되지 않은 경우, 현재 작업 디렉터리가 기본값으로 사용됩니다.\n\n### 일반 옵션\n\n#### `-h, --help`\n\n이 도움말 텍스트를 표시합니다.\n\n#### `-J=<opt>`\n\n```\n          \\[고급] 명령을 실행하는 JVM에 옵션을 전달합니다.\n```\n\n(공백이 포함된 옵션은 올바르게 처리되지 않을 수 있습니다.)\n\n#### `-v, --verbose`\n\n출력되는 진행 메시지의 수를 점진적으로 증가시킵니다.\n\n#### `-q, --quiet`\n\n출력되는 진행 메시지의 수를 점진적으로 줄입니다.\n\n#### `--verbosity=<level>`\n\n```\n          \\[고급] 상세 수준을 명시적으로 설정합니다. 선택 가능한 값: errors, warnings, progress, progress+, progress++, progress+++. \n          `-v` 및 `-q`를 재정의합니다.\n```\n\n#### `--logdir=<dir>`\n\n```\n          \\[고급] 지정된 디렉토리에 자세한 로그를 하나 이상 기록합니다. 로그 파일 이름에는 타임스탬프와 실행 중인 하위 명령 이름이 포함됩니다.\n```\n\n(로그 파일 이름을 완전히 제어하고 싶다면, 대신 `--log-to-stderr`을 사용하고 원하는 대로 stderr를 리디렉션하세요.)\n\n#### `--common-caches=<dir>`\n\n```\n          \\[고급] CLI의 여러 실행 간에 유지되는 디스크상의 캐시 데이터 위치를 제어합니다. 여기에는 다운로드된 QL 팩과 컴파일된 쿼리 계획이 포함됩니다. 명시적으로 설정하지 않은 경우, 사용자 홈 디렉터리에 있는 `.codeql`이라는 이름의 디렉터리를 기본값으로 사용하며, 해당 디렉터리가 존재하지 않으면 새로 생성됩니다.\n\n          `v2.15.2`부터 사용할 수 있습니다.\n```"}