Skip to main content

데이터 세트 가져오기

[연결] TRAP 파일 세트를 원시 데이터 세트로 가져옵니다.

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

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

이 문서의 내용

참고 항목

이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 요소에 대한 자세한 내용은 http://github.com/github/codeql-cli-binaries/releases을(를) 참조하세요.

이전 릴리스에서 이 명령에 사용할 수 있는 옵션의 세부 정보를 보려면 터미널에서 옵션을 사용하여 --help 명령을 실행합니다.

개요

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

Description

          \[연결] TRAP 파일 세트를 원시 데이터 세트로 가져옵니다.

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

Options

기본 옵션

<dataset>

          \[필수] 만들거나 업데이트할 원시 QL 데이터 세트의 경로입니다. 지정된 디렉터리가 이미 존재하지 않는 경우 만듭니다.

<trap>...

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