警告
CodeQL CLI データベース バンドルには、CodeQL によって分析されるソース コードのコピーが含まれているため、これらのバンドルは、そのソース コードへのアクセスが許可されているユーザーとのみ共有することをお勧めします。
メモ
この記事では、GitHub Enterprise Server 3.20 の初期リリースに含まれている CodeQL CLI 2.23.9 バンドルで使用できる機能について説明します。
サイト管理者が CodeQL CLI のバージョンをより新しいリリースに更新している場合は、この記事の GitHub Enterprise Cloud バージョンで最新の機能に関する情報を参照してください。
トラブルシューティングのためにデータベース バンドルを作成するときは、次の CodeQL CLI コマンド構文をお勧めします。 このサンプル database bundle コマンドには、CodeQL CLI バージョン 2.17.6 以降が必要です。
codeql database bundle --output=codeql-debug-artifacts.zip --include-diagnostics --include-logs --include-results -- <dir>
このコマンドの場合、<dir> は、CodeQL データベースが作成されたディレクトリのパスにする必要があります。
このコマンドの実行が成功すると、CodeQL のトラブルシューティング情報を含む codeql-debug-artifacts.zip という ZIP ファイルが作成されます。 そのファイルは、データベース バンドルです。
このコマンドは、--log-dir コマンド ライン引数が database create および database analyze コマンドで使われていないことを前提としています。 そのコマンド ライン引数を使用すると、それらのコマンドが作成したログ ファイルはデータベース バンドルに含まれません。
`database create` と `database analyze` の詳細度を高める
トラブルシューティング目的において、database create および database analyze コマンドの詳細度が足りない場合は、詳細度を高めることができます。
どちらのコマンドも、データベース バンドルを作成する前に --verbosity に設定できる progress++ コマンド ライン引数をサポートしています。