Skip to main content

CodeQL 데이터베이스 관리

익스텐션을 사용하여 CodeQL 데이터베이스로 작업할 수 있습니다.

CodeQL 데이터베이스 정보

프로젝트를 분석하려면 해당 프로젝트에 대한 CodeQL 데이터베이스를 선택해야 합니다. 로컬(ZIP 보관 파일 또는 보관하지 않은 폴더에서), 공용 URL 또는 GitHub의 프로젝트 URL에서 데이터베이스를 선택할 수 있습니다. 또는 CodeQL CLI를 사용하여 데이터베이스를 만들 수 있습니다. "CodeQL 분석을 위한 코드 준비"을(를) 참조하세요.

GitHub에서 데이터베이스 다운로드

GitHub.com에서는 분석을 테스트하는 데 사용할 수 있는 200,000개 이상의 오픈 소스 리포지토리에 대한 CodeQL 데이터베이스를 저장합니다. 또한 시스템에 대한 설정을 편집하고 URL을 정의하여 데이터 보존 기능을 갖춘 GitHub Enterprise Cloud에서 호스트된 리포지토리에 대한 데이터베이스에 액세스할 수도 있습니다. "확장에 사용되는 GitHub URL 변경"을 참조하세요.

리포지토리에 다운로드할 수 있는 CodeQL 데이터베이스가 있는지 확인하고, 있는 경우 REST API를 사용하여 다운로드합니다. 자세한 내용은 GitHub REST API 설명서에서 “리포지토리에 대한 CodeQL 데이터베이스 나열" 및 "리포지토리에 대한 CodeQL 데이터베이스 가져오기"를 참조하세요.

분석할 데이터베이스 선택

  1. "데이터베이스" 보기의 제목 표시줄을 마우스로 가리키고 적절한 아이콘을 선택하여 데이터베이스를 선택합니다. 로컬(ZIP 보관 파일 또는 보관하지 않은 폴더에서), 공용 URL 또는 GitHub의 프로젝트 URL에서 데이터베이스를 선택할 수 있습니다.

  2. 데이터베이스를 선택하면 "데이터베이스" 보기에 표시됩니다. 데이터베이스와 상호 작용하기 위한 메뉴 옵션을 보려면 목록에서 항목을 마우스 오른쪽 단추로 클릭합니다. 한 번에 여러 데이터베이스를 선택할 수 있습니다.

참고: 테스트 데이터베이스를 분석할 수도 있습니다. CodeQL CLI을(를) 사용하여 사용자 지정 쿼리에서 재발 테스트를 실행할 때 테스트 데이터베이스(.testproj 익스텐션이 있는 폴더)가 생성됩니다. 쿼리가 재발 테스트에 실패하는 경우 테스트 데이터베이스를 Visual Studio Code(으)로 가져와서 오류를 디버그할 수 있습니다. 쿼리 테스트 실행에 대한 자세한 내용은 "사용자 지정 쿼리 테스트" 섹션을 참조하세요.

언어별 데이터베이스 및 쿼리 필터링

필요에 따라 특정 언어와 해당 언어에 대해 작성된 쿼리가 포함된 데이터베이스를 보려면 언어 선택기를 사용하여 언어 필터를 적용하면 됩니다.

  1. 사용 가능한 언어 필터를 보려면 사이드바에서 "언어" 보기를 엽니다.

  2. 적용할 언어 필터를 마우스로 가리킨 다음 선택을 클릭합니다.

다음 단계

CodeQL 데이터베이스에서 쿼리를 실행하여 익스텐션을 통해 프로젝트를 분석하는 방법을 알아보려면 "CodeQL 쿼리 실행" 섹션을 참조하세요.