데이터베이스 init

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

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

개요

Shell

codeql database init --source-root=<dir> [--language=<lang>[,<lang>...]] [--github-auth-stdin] [--github-url=<url>] [--extractor-option=<extractor-option-name=value>] <options>... -- <database>

codeql database init --source-root=<dir> [--language=<lang>[,<lang>...]] [--github-auth-stdin] [--github-url=<url>] [--extractor-option=<extractor-option-name=value>] <options>... -- <database>

설명

[배관] 빈 CodeQL 데이터베이스를 만듭니다.

아직 원시 QL 데이터 세트가 없지만, 추출기 단계를 실행할 준비가 된 CodeQL 데이터베이스에 대한 기본 구조를 만듭니다. 이 명령이 완료되면 하나 이상의 codeql 데이터베이스 추적 명령 명령을 실행한 다음, codeql 데이터베이스가 종료되어 쿼리할 데이터베이스를 준비합니다 .

이 작업의 일부는 적절한 언어 팩의 위치를 확인하고 데이터베이스 메타데이터에 저장하여 각 추출 명령에서 다시 실행하지 않아도 되도록 하는 작업입니다. 추출 작업 중간에 추출기를 전환하는 것은 유효하지 않습니다.)

옵션

기본 옵션

`<database>`

[필수] 만들 CodeQL 데이터베이스의 경로입니다. 이 디렉터리가 만들어지고 아직 존재하지 않아야 합니다(하지만 해당 부모는 반드시 존재해야 합니다).

--db-cluster 옵션이 지정된 경우 데이터베이스 자체가 아니라 동일한 원본 루트에서 빌드된 여러 언어에 대한 데이터베이스를 포함하는 디렉터리가 됩니다.

이 디렉터리가 빌드 프로세스에게 방해받을 위치에 있지 않은 것이 중요합니다. 예를 들어 Maven 프로젝트의 target 디렉터리는 적합하지 않습니다.

`-s, --source-root=<dir>`

[필수] 루트 소스 코드 디렉터리입니다. 대부분의 경우, 검사 루트가 됩니다. 파일 내의 파일은 이 데이터베이스의 기본 원본 파일로 간주됩니다 일부 출력 형식에서는 파일이 이 디렉터리의 상대 경로로 참조됩니다.

`--[no-]overwrite`

[고급] 데이터베이스가 이미 있는 경우, 데이터베이스를 삭제하고 실패하는 대신 이 명령을 계속 진행합니다. 디렉터리가 있지만 데이터베이스처럼 보이지 않는 경우 오류가 발생합니다.

`--[no-]force-overwrite`

[고급] 데이터베이스가 이미 있는 경우, 데이터베이스처럼 보이지 않더라도 삭제하고 실패하지 않도록 이 명령을 계속 진행합니다. 이 옵션은 전체 데이터베이스 디렉터리를 재귀적으로 삭제할 수 있으므로 주의해서 사용해야 합니다.

`--codescanning-config=<file>`

[고급] CodeQL 데이터베이스를 만드는 방법과 이후 단계에서 실행할 쿼리에 대한 옵션을 지정하는 코드 검색 구성 파일을 읽습니다. 이 구성 파일의 형식에 대한 자세한 내용은 코드 검색을 위한 고급 설정 사용자 지정을 참조하세요. 이후 단계에서 이 파일에서 쿼리를 실행하려면 지정된 다른 쿼리 없이 codeql 데이터베이스 분석을 호출합니다.

`--[no-]db-cluster`

단일 데이터베이스를 만드는 대신 다양한 언어에 대한 데이터베이스의 "클러스터"를 만듭니다. 각 데이터베이스는 명령줄에 지정된 디렉터리의 하위 디렉터리입니다.

`-l, --language=<lang>[,<lang>...]`

새 데이터베이스를 분석하는 데 사용할 언어입니다.

codeql 확인 언어를 사용하여 검색 경로에 있는 플러그형 언어 추출기 목록을 가져옵니다.

--db-cluster 옵션을 지정하면, 여러 번 표시되거나 값이 쉼표로 구분된 언어 목록일 수 있습니다.

이 옵션을 생략하고 분석 중인 원본 루트가 GitHub 리포지토리의 검사인 경우, CodeQL CLI는 GitHub API를 호출하여 분석할 언어를 자동으로 결정하려고 시도합니다. 이렇게 하려면 환경 변수 GITHUB_토큰 또는 --github-auth-stdin 옵션을 사용하여 표준 입력을 통해 GitHub PAT 토큰을 제공해야 합니다.

`--build-mode=<mode>`

데이터베이스를 만드는 데 사용할 빌드 모드입니다.

분석 중인 언어에 따라 빌드 모드 선택:

none: 원본 루트를 빌드하지 않고도 데이터베이스를 만들 수 있습니다. C#, Java, JavaScript/TypeScript, Python 및 Ruby에서 사용 가능합니다.

autobuild: 원본 루트를 자동으로 빌드하려 시도하여 데이터베이스를 만듭니다. C/C++, C#, Go, Java/Kotlin 및 Swift에서 사용 가능합니다.

manual: 수동으로 지정한 빌드 명령을 사용해 원본 루트를 빌드하여 데이터베이스를 만듭니다. C/C++, C#, Go, Java/Kotlin 및 Swift에서 사용 가능합니다.

--command을(를) 사용해 데이터베이스를 만드는 경우, '--build-mode manual'을 추가로 지정하지 않아도 됩니다.

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

`--[no-]allow-missing-source-root`

[고급] 지정된 원본 루트가 없더라도 계속 진행합니다.

`--[no-]begin-tracing`

[고급] 명시적 빌드 명령을 사용할 수 없는 경우, 기존 빌드 워크플로에 통합할 수 있는 "간접 빌드 추적"을 설정하는 데 사용할 수 있는 스크립트를 만듭니다. 이 기능을 사용하는 시기와 방법에 대한 자세한 내용은 CodeQL 분석을 위한 코드 준비의 설명서를 참조하세요.

기준 계산 옵션

`--[no-]calculate-baseline`

[고급] 분석 중인 코드에 대한 기준 정보를 계산하고 데이터베이스에 추가합니다. 기본적으로 원본 루트가 파일 시스템의 루트가 아닌 한, 사용하도록 설정됩니다. 이 플래그를 사용하여 파일 시스템의 루트에서도 동작을 사용하지 않도록 설정하거나 강제로 사용하도록 설정할 수 있습니다.

`--[no-]sublanguage-file-coverage`

[GitHub.com 및 GitHub Enterprise Server v3.12.0 이상 전용] 하위 언어 파일 적용 범위 정보를 사용합니다. C 및 C++, Java 및 Kotlin, JavaScript 및 TypeScript와 같은 CodeQL 추출기를 공유하는 언어에 대한 별도의 파일 적용 범위 정보를 계산, 표시 및 내보냅니다.

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

추출기 선택 옵션

`--search-path=<dir>[:<dir>...]`

추출기 팩을 찾을 수 있는 디렉터리 목록. 디렉터리는 추출기 팩 자체 또는 즉시 하위 디렉터리로 추출기를 포함 하는 디렉터리 수 있습니다.

경로에 여려 디렉터리 트리가 포함된 경우 해당 순서는 우선 순위를 정의합니다. 대상 이름이 디렉터리 트리 중 하나 이상에서 일치하는 경우 지정된 첫 번째 트리가 우선적으로 적용됩니다.

CodeQL 도구 체인 자체와 함께 번들로 제공되는 추출기는 항상 찾을 수 있지만 별도로 분산된 추출기를 사용해야 하는 경우, 이 옵션을 제공해야 합니다(아니면 사용자별 구성 파일에서 --search-path을(를) 설치하는 것이 더 좋습니다).

(참고: Windows에서는 경로 구분 기호가 ;입니다.)

GitHub API를 호출하여 언어를 자동으로 검색하는 방법을 구성하는 옵션입니다

`-a, --github-auth-stdin`

표준 입력을 통해 GitHub 앱 토큰 또는 개인용 액세스 토큰을 수락합니다.

이렇게 하면 GITHUB_TOKEN 환경 변수가 재정의됩니다.

`-g, --github-url=<url>`

사용할 GitHub 인스턴스의 URL입니다. 생략된 경우 CLI는 검사 경로에서 이에 대한 자동 감지를 시도하며 감지할 수 없는 경우 기본값은 https://github.com/입니다

패키지 관리자 구성하는 옵션

`--registries-auth-stdin`

쉼표로 구분된 <registry_url>=<token> 쌍 목록을 전달하여 GitHub Enterprise Server 컨테이너 레지스트리에 인증합니다.

예를 들어 https://containers.GHEHOSTNAME1/v2/=TOKEN1,https://containers.GHEHOSTNAME2/v2/=TOKEN2를 전달하여 두 개의 GitHub Enterprise Server 인스턴스에 인증할 수 있습니다.

이렇게 하면 CODEQL_REGISTRIES_AUTH 및 GITHUB_TOKEN 환경 변수가 재정의됩니다. github.com 컨테이너 레지스트리에만 인증해야 하는 경우 더 간단한 --github-auth-stdin 옵션을 사용하여 인증할 수 있습니다.

Windows 추적을 구성하는 옵션

`--trace-process-name=<process-name>`

[Windows 전용] 추적을 초기화할 때, 이름이 이 인수와 일치하는 CodeQL CLI의 부모 프로세스에 추적기를 삽입합니다. 둘 이상의 부모 프로세스에 이 이름이 있으면 프로세스 트리에서 가장 낮은 프로세스가 선택됩니다. 이 옵션은 --trace-process-level을(를) 재정의하므로 둘 다 전달되면 이 옵션만 사용됩니다.

`--trace-process-level=<process-level>`

[Windows만] 추적을 초기화할 때, CodeQL CLI를 호출하는 프로세스에 해당하는 0을 사용하여 추적기를 현재 프로세스 위에 삽입합니다. 인수가 전달되지 않는 경우, CLI의 기본 동작은 GitHub Actions 및 Azure Pipelines에 대한 몇 가지 특별한 경우와 함께 호출 프로세스의 부모에 삽입하는 것입니다.

간접 빌드 추적을 구성하는 옵션

`--no-tracing`

[고급] 지정된 명령을 추적하지 않고 필요한 모든 데이터를 직접 생성합니다.

`--extra-tracing-config=<tracing-config.lua>`

[고급] 추적기 구성 파일의 경로입니다. 빌드 추적기의 동작을 수정하는 데 사용할 수 있습니다. 빌드 명령의 일부로 실행되는 컴파일러 프로세스를 선택하고 다른 도구의 실행을 트리거하는 데 사용할 수 있습니다. 추출기는 대부분의 상황에서 작동해야 하는 기본 추적기 구성 파일을 제공합니다.

추출기 동작을 제어하는 옵션: 간접 추적 환경에만 적용됨

`-O, --extractor-option=<extractor-option-name=value>`

CodeQL 추출기에 대한 옵션을 설정합니다. extractor-option-name은(는) extractor_name.group1.group2.option_name 또는 group1.group2.option_name의 형식이어야 합니다. extractor_option_name이(가) 추출기 이름으로 시작하는 경우, 표시된 추출기는 group1.group2.option_name 옵션을 선언해야 합니다. 그렇지 않으면 옵션 group1.group2.option_name을 선언하는 모든 추출기에서 옵션을 설정합니다. value은(는) 줄을 포함하지 않는 모든 문자열일 수 있습니다.

이 명령줄 옵션을 반복적으로 사용하여 여러 추출기 옵션을 설정할 수 있습니다. 동일한 추출기 옵션에 여러 값을 제공하는 경우, 동작은 추출기 옵션이 예상하는 형식에 따라 달라집니다. 문자열 옵션은 제공된 마지막 값을 사용합니다. 배열 옵션은 제공된 모든 값을 순서대로 사용합니다. 이 명령줄 옵션을 사용하여 지정된 추출기 옵션은 추출기 옵션을 통해 --extractor-options-file이(가) 제공된 후에 처리됩니다.

codeql 데이터베이스 init 또는 codeql database begin-tracing에 전달되면 옵션이 간접 추적 환경에만 적용됩니다. 워크플로에서 codeql 데이터베이스 추적 명령을 호출하는 경우, 원하는 경우의 옵션도 전달해야 합니다.

각 추출기에서 선언한 옵션을 나열하는 방법을 포함하여 CodeQL 추출기 옵션에 대한 자세한 내용은 https://codeql.github.com/docs/codeql-cli/extractor-options을(를) 참조하세요.

데이터베이스 init

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

이 문서의 내용