# 데이터 세트 확인

[내부 처리] 특정 데이터 세트의 내부 일관성을 확인합니다.

> [!NOTE]
> 이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 요소에 대한 자세한 내용은 https://github.com/github/codeql-cli-binaries/releases을(를) 참조하세요.
>
> 이전 릴리스에서 이 명령에 사용할 수 있는 옵션의 세부 정보를 보려면 터미널에서 옵션을 사용하여 <span style="white-space: nowrap;">`--help`</span> 명령을 실행합니다.

## 개요

```shell copy
codeql dataset check <options>... -- <dataset>
```

## Description

              \[내부 처리] 특정 데이터 세트의 내부 일관성을 확인합니다.

이 명령은 추출기가 생성한 데이터를 검증하므로, CodeQL 추출기 개발자에게 가장 흔히 유용합니다. 데이터베이스에 대한 쿼리가 일관되지 않은 결과를 반환할 때, 원인이 기본 데이터의 문제인지 배제하기 위해 유용할 수도 있습니다.

## Options

### 기본 옵션

#### `<dataset>`

              \[필수] 확인할 원시 QL 데이터 세트의 경로입니다.

#### `--failing-exitcode=<code>`

              \[고급] 실패가 발생하면 생성할 종료 코드를 설정합니다. 보통 1이지만, 출력을 파싱하는 도구는 0으로 설정하는 것이 유용할 수 있습니다.

#### `--format=<fmt>`

출력 형식을 선택합니다. 가능한 선택지는 다음과 같습니다:

              `text`
              _(기본값)_: 사람이 읽을 수 있는 텍스트 렌더링.

              `json`: 스트리밍 JSON 객체 배열.

              `jsonz`: 0으로 종료되는 JSON 객체 스트림.

#### `--[no-]precise-locations`

              \[고급] 불일치의 정확한 위치를 계산하기 위해 추가 작업을 수행합니다. 이 작업에는 더 많은 시간이 걸리지만, 추출기 동작을 디버깅하기가 더 쉬워질 수 있습니다.

#### `--max-resolve-depth=<n>`

              \[고급] 불일치를 설명하기 위해 ID를 확인해야 하는 최대 깊이입니다. (기본값: 3)

#### `--max-errors-per-checker=<n>`

각 종류별로 명시적으로 보고해야 하는 불일치 오류의 최대 개수입니다. (기본값: 5)

### 일반 옵션

#### `-h, --help`

이 도움말 텍스트를 표시합니다.

#### `-J=<opt>`

              \[고급] 명령을 실행하는 JVM에 옵션을 제공합니다.

(공백을 포함하는 옵션은 올바르게 처리되지 않을 수 있으므로 주의하세요.)

#### `-v, --verbose`

표시되는 진행률 메시지 수를 단계적으로 늘립니다.

#### `-q, --quiet`

표시되는 진행률 메시지 수를 단계적으로 줄입니다.

#### `--verbosity=<level>`

              \[고급] 상세 정보 표시 수준을 오류, 경고, 진행률, 진행률+, 진행률++, 진행률+++ 중 하나로 명시적으로 설정합니다. 
              `-v` 및 `-q`를 재정의합니다.

#### `--logdir=<dir>`

              \[고급] 지정된 디렉터리에 자세한 로그를 하나 이상의 파일로 기록하며, 생성된 이름에는 타임스탬프와 실행 중인 하위 명령 이름이 포함됩니다.

(로그 파일 이름을 완전히 제어하려면 대신 `--log-to-stderr`을(를) 제공하고 필요에 따라 stderr를 리디렉션하세요.)

#### `--common-caches=<dir>`

              \[고급] 다운로드한 QL 팩 및 컴파일된 쿼리 계획과 같이 CLI를 여러 번 실행하는 동안 유지되는 디스크의 캐시된 데이터 위치를 제어합니다. 명시적으로 설정하지 않으면 기본값은 사용자의 홈 디렉터리에 있는 `.codeql`(이)라는 이름의 디렉터리이며, 이미 존재하지 않으면 생성됩니다.

              `v2.15.2`부터 사용할 수 있습니다.