Skip to main content

데이터 세트 가져오기

[내부 처리] TRAP 파일 세트를 원시 데이터 세트에 가져옵니다.

누가 이 기능을 사용할 수 있나요?

CodeQL은(는) 다음 리포지토리 유형에 사용할 수 있습니다.

이 기사에서

데이터 재사용 코드ql-cli.man-pages-version-note %}

개요

Shell
codeql dataset import --dbscheme=<file> [--threads=<num>] <options>... -- <dataset> <trap>...

Description

          \[내부 처리] TRAP 파일 세트를 원시 데이터 세트에 가져옵니다.

TRAP 파일들로 데이터 세트를 생성하거나, 기존 데이터 세트에 TRAP 파일의 데이터를 추가합니다. 데이터 세트 업데이트는 올바른 dbscheme을 갖고 있으며 또한 해당 ID 풀이 초기 가져오기에서 유지된 경우에만 가능합니다.

Options

기본 옵션

<dataset>

          \[필수] 생성하거나 업데이트할 원시 QL 데이터 세트의 경로입니다. 해당 디렉터리가 이미 존재하지 않는 경우 생성될 것입니다.

<trap>...

.trap(.gz) 파일을 가져올 경로 또는 .trap(.gz) 파일을 재귀적으로 검색할 디렉터리의 경로입니다. 파일을 지정하지 않으면 빈 데이터 세트가 생성될 것입니다.

-S, --dbscheme=<file>

          \[필수] 사용자가 가져오려는 TRAP 파일을 설명하는 dbscheme 정의입니다.

-j, --threads=<num>

가져오기 작업에 이 스레드 수를 사용합니다.

기본값은 1입니다. 0을 전달하여 머신의 코어당 한 개의 스레드를 사용할 수 있고, -_N_을 전달하여 _N_개의 코어를 사용하지 않은 상태로 둘 수 있습니다. 단, 최소 한 개의 스레드는 계속 사용됩니다.

--[no-]check-undefined-labels

          \[고급] 정의되지 않은 레이블들의 오류를 보고합니다.

--[no-]check-unused-labels

          \[고급] 사용되지 않은 레이블들의 오류를 보고합니다.

--[no-]check-repeated-labels

          \[고급] 반복되는 레이블들의 오류를 보고합니다.

--[no-]check-redefined-labels

          \[고급] 재정의된 레이블들의 오류를 보고합니다.

--[no-]check-use-before-definition

          \[고급] 정의하기 전에 사용된 레이블들의 오류를 보고합니다.

--[no-]fail-on-trap-errors

          \[고급] 트랩 가져오기 중에 오류가 발생하면 0이 아닌 값으로 종료합니다.

--[no-]include-location-in-star

          \[고급] TRAP 파일에 해당 파일의 발생 위치를 포함하는 방식으로 엔터티 ID를 생성합니다. TRAP 생성기 디버깅에 유용할 수 있지만, 데이터 세트에서 많은 공간을 차지합니다.

--[no-]linkage-aware-import

          \[고급] codeql dataset import의 연결 인식 _(기본값)_ 사용 여부를 제어합니다. 데이터베이스 생성 중에 이 부분에서 과도한 메모리를 사용하는 프로젝트에서 이 옵션을 비활성화하면, 데이터베이스 완성도는 낮아질 수 있으나 진행에 도움이 될 수 있습니다.

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

일반 옵션

-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`부터 사용할 수 있습니다.