# 데이터 세트 측정값

[내부 처리] 특정 데이터세트에 포함된 관계에 대한 통계를 수집합니다.

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

## 개요

```shell copy
codeql dataset measure --output=<file> [--threads=<num>] <options>... -- <dataset>
```

## Description

              \[내부 처리] 특정 데이터세트에 포함된 관계에 대한 통계를 수집합니다.

이 명령은 일반적으로 CodeQL 추출기를 개발할 때, 데이터베이스 스키마에 영향을 미치는 변경이 발생하여 쿼리 최적화기가 사용하는 통계에도 이에 상응하는 변경이 필요할 경우에만 사용됩니다.

## Options

### 기본 옵션

#### `<dataset>`

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

#### `-o, --output=<file>`

              \[필수] 통계를 기록할 출력 파일로, 일반적으로 확장자는 .dbscheme.stats입니다.

#### `-j, --threads=<num>`

사용할 동시 실행 스레드 수입니다.

기본값은 1입니다. 0을 전달하면 머신의 각 코어당 하나의 스레드를 사용하고, -_N_을 전달하면 _N_개의 코어를 사용하지 않도록 설정할 수 있습니다(단, 최소 하나의 스레드는 여전히 사용됨).

### 일반 옵션

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

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

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

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

(공백이 포함된 옵션은 올바르게 처리되지 않을 수 있습니다.)

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

출력되는 진행 메시지의 수를 점진적으로 증가시킵니다.

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

출력되는 진행 메시지의 수를 점진적으로 줄입니다.

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

              \[고급] 상세 수준을 명시적으로 설정합니다. 선택 가능한 값: errors, warnings, progress, progress+, progress++, progress+++. 
              `-v` 및 `-q`를 재정의합니다.

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

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

(로그 파일 이름을 완전히 제어하고 싶다면, 대신 `--log-to-stderr`을 사용하고 원하는 대로 stderr를 리디렉션하세요.)

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

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

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