{"meta":{"title":"クエリのコンパイル","intro":"QL コードをコンパイルまたはチェックします。","product":"セキュリティとコードの品質","breadcrumbs":[{"href":"/ja/code-security","title":"セキュリティとコードの品質"},{"href":"/ja/code-security/reference","title":"リファレンス"},{"href":"/ja/code-security/reference/code-scanning","title":"コードスキャン"},{"href":"/ja/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ja/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"CodeQL CLI のマニュアル"},{"href":"/ja/code-security/reference/code-scanning/codeql/codeql-cli-manual/query-compile","title":"クエリのコンパイル"}],"documentType":"article"},"body":"# クエリのコンパイル\n\nQL コードをコンパイルまたはチェックします。\n\n> \\[!NOTE]\n> このコンテンツでは、CodeQL CLI の最新リリースについて説明します。このリリースについて詳しくは、をご覧ください。\n>\n> 以前のリリースの、このコマンドで使えるオプションを詳しく確認するには、ターミナルで `--help` オプションを指定してコマンドを実行してください。\n\n## 概要\n\n```shell copy\ncodeql query compile [--check-only] [--keep-going] [--threads=] [--ram=] ... -- ...\n```\n\n## Description\n\nQL コードをコンパイルまたはチェックします。\n\n1 つ以上のクエリをコンパイルします。通常、このコマンドの主な結果は、クエリのコンパイル済みバージョンが\\_コンパイルキャッシュ\\_に書き込まれ、後でクエリが実行されたときに見つかることです。その他の出力オプションは、主にデバッグ用です。\n\n## オプション\n\n### 主なオプション\n\n#### `...`\n\n```\n \\[必須] コンパイルするクエリ。各引数は、次のいずれかです。\n```\n\n* コンパイルする ql ファイル。\n* .ql ファイルを再帰的に検索するディレクトリ。\n* 特定のクエリセットを定義する .qls ファイル。\n* インストールされている QL パックの 1 つによってエクスポートされた \"既知の\" .qls ファイルのベース名。\n\n#### `-n, --check-only`\n\nQL が有効であることを確認し、エラーを出力するだけです。実際にはクエリプランを最適化して格納しません。これは、完全コンパイルよりもはるかに高速な場合があります。\n\n#### `--[no-]precompile`\n\n```\n \\[詳細設定] コンパイルされた各クエリをバイナリ `.qlx` ファイルとして `.ql` ソースの横に保存します。\n```\n\nこれは、配布用のクエリパックを準備するときにのみ使用することを想定しています (この場合、[codeql pack publish](/ja/code-security/reference/code-scanning/codeql/codeql-cli-manual/pack-publish) によって自動的に使用されます)。\n`.qlx` ファイルが存在すると、クエリを実行するその後のコマンドでは、コンパイル済みバージョンが優先されて QL ソースへの変更が無視される場合があります。\n\n使用頻度の低いコンパイルオプションの中には、これと互換性がないものがあり、実行時エラーが発生します。\n\n```\n `v2.12.0` 以降で使用できます。\n```\n\n#### `--[no-]dump-dil`\n\n```\n \\[詳細設定] コンパイル中に、最適化された DIL 中間表現を標準出力に出力します。\n```\n\nJSON 出力が選択されている場合、DIL は単一行の文字列の配列として表され、どのクエリがコンパイルされるかを識別するためにラップされます。\n\n#### `-k, --[no-]keep-going`\n\nエラーが見つかってもコンパイルを続行します。\n\n#### `--[no-]dump-ra`\n\n```\n \\[詳細設定] コンパイル中に、最適化された RA クエリプランを標準出力に出力します。\n```\n\nJSON 出力が選択されている場合、RA は単一行の文字列の配列として表され、どのクエリがコンパイルされるかを識別するためにラップされます。\n\n#### `--format=`\n\n出力形式に、`text`*(既定値)* または `json` を選択します。\n\n#### `-j, --threads=`\n\nこの数のスレッドをクエリのコンパイルに使用します。\n\n既定値は 1 です。 0 を渡して、コンピューター上のコアごとに 1 つのスレッドを使用したり、*N* を渡して、*N* 個のコアを未使用のままにしたりすることができます (ただし、その場合でも、少なくとも 1 つのスレッドが使用されます)。\n\n#### `-M, --ram=`\n\nコンパイラで使用できる必要がある RAM の合計量を設定します。\n\n### QL バリアントとコンパイラ制御オプション\n\n#### `--warnings=`\n\nQL コンパイラからの警告を処理する方法。つぎのいずれかです。\n\n```\n `hide`: 警告を表示しません。\n\n `show`\n _(既定値)_: 警告を出力しますが、コンパイルを続行します。\n\n `error`: 警告をエラーとして扱います。\n```\n\n#### `--no-debug-info`\n\nデバッグ目的で RA にソースの場所情報を出力しないでください。\n\n#### `--[no-]fast-compilation`\n\n```\n \\[非推奨] \\[詳細設定] 特に速度の遅い最適化手順を省略します。\n```\n\n#### `--no-release-compatibility`\n\n```\n \\[詳細設定] 移植性を犠牲にして、最新のコンパイラ機能を使用します。\n```\n\n場合によっては、新しい QL 言語機能とエバリュエーターの最適化が、それらが QL コンパイラにおいて既定で有効になる数リリース前に、QL エバリュエーターによってサポートされます。これにより、最新の CodeQL リリースでクエリを開発するときに生じるパフォーマンスを、コードスキャンまたは CI 統合にまだ使用されている可能性がある少し古いリリースと一致させることができます。\n\nクエリが他の (以前または以降の) CodeQL リリースと互換性があるかどうかを気にする必要がない場合は、このフラグを使用してコンパイラの最近の改善を早期に有効にすることで、パフォーマンスを多少向上させることができます。\n\nリリースに有効にすべき最近の改善がない場合、このオプションは通知することなく何も実行しません。このため、グローバル CodeQL 構成ファイルで一度にすべて設定しても安全です。\n\n```\n `v2.11.1` 以降で使用できます。\n```\n\n#### `--[no-]local-checking`\n\n使用される QL ソースの部分に対してのみ最初のチェックを実行します。\n\n#### `--no-metadata-verification`\n\nQLDoc コメントに埋め込まれたクエリメタデータの有効性はチェックされません。\n\n#### `--compilation-cache-size=`\n\n```\n \\[詳細設定] コンパイルキャッシュディレクトリの既定の最大サイズをオーバーライドします。\n```\n\n#### `--fail-on-ambiguous-relation-name`\n\n```\n \\[詳細設定] コンパイル中にあいまいな関係名が生成された場合、コンパイルを失敗させます。\n```\n\n### コンパイル環境を設定するためのオプション\n\n#### `--search-path=[:...]`\n\nQL パックが見つかる可能性があるディレクトリのリスト。各ディレクトリは、QL パック (またはルートに `.codeqlmanifest.json` ファイルを含むパックのバンドル)、または 1 つ以上のこのようなディレクトリの直接の親ディレクトリのいずれかです。\n\nパスに複数のディレクトリを含める場合は、それらの順序で、それらの間の優先順位を定義します。解決する必要があるパック名が複数のディレクトリツリーで一致する場合は、最初に指定したものが優先されます。\n\nオープンソースの CodeQL リポジトリのチェックアウトでこれを指定すると、そこにある言語の 1 つを照会するときに機能するはずです。\n\nCodeQL リポジトリを、アンパックされた CodeQL ツールチェーンの兄弟としてチェックアウトしている場合、このオプションを指定する必要はありません。このような兄弟ディレクトリは、他の方法では見つからない QL パックについて常に検索されます (この既定値が機能しない場合、ユーザーごとの構成ファイルで `--search-path` を一度にすべて設定することを強くお勧めします)。\n\n(注: Windows ではパスの区切りは `;` です)。\n\n#### `--additional-packs=[:...]`\n\nこのディレクトリの一覧が指定されている場合、パックは、`--search-path` 内のディレクトリの前に、これらのディレクトリで検索されます。これらの間の順序は重要ではありません。このリストの 2 か所でパック名が見つかった場合は、エラーです。\n\nこれは、既定のパスにも表示される新しいバージョンのパックを一時的に開発している場合に役立ちます。一方、構成ファイルでこのオプションを上書きすることは \"お勧めしません\"。一部の内部アクションでは、このオプションをオンザフライで追加し、構成された値がオーバーライドされます。\\_\\_\n\n(注: Windows ではパスの区切りは `;` です)。\n\n#### `--library-path=[:...]`\n\n```\n \\[詳細設定] QL ライブラリの生インポート検索パスに追加するオプションのディレクトリリスト。これを使う必要があるのは、QL パックとしてパッケージ化されていない QL ライブラリを使用する場合のみです。\n```\n\n(注: Windows ではパスの区切りは `;` です)。\n\n#### `--dbscheme=`\n\n```\n \\[詳細設定] どの dbscheme クエリに対してコンパイルする必要があるかを明示的に定義します。これは、自分が何をしているかを確信している呼び出し元のみが指定する必要があります。\n```\n\n#### `--compilation-cache=`\n\n```\n \\[詳細設定] コンパイルキャッシュとして使用する追加のディレクトリを指定します。\n```\n\n#### `--no-default-compilation-cache`\n\n```\n \\[詳細設定] クエリを含む QL パックや CodeQL ツールチェーンディレクトリなどの標準の場所でコンパイルキャッシュを使用しません。\n```\n\n### CodeQL パッケージマネージャーを構成するためのオプション\n\n#### `--registries-auth-stdin`\n\n```\n \\\n =\n \\ ペアのコンマ区切りリストを渡すことで、GitHub Enterprise Server コンテナーレジストリに対して認証を行います。\n```\n\nたとえば、`https://containers.GHEHOSTNAME1/v2/=TOKEN1,https://containers.GHEHOSTNAME2/v2/=TOKEN2` を渡して、\n2 つの GitHub Enterprise Server インスタンスに対して認証を行うことができます。\n\nこれは、CODEQL\\_REGISTRIES\\_AUTH and GITHUB\\_TOKEN 環境変数をオーバーライドします。 github.com コンテナーレジストリに対する認証のみが必要な場合は、代わりに、より単純な `--github-auth-stdin` オプションを使って認証できます。\n\n#### `--github-auth-stdin`\n\n標準入力を介して github.com GitHub Apps トークンまたは個人用アクセストークンを渡して、github.com コンテナーレジストリに対して認証を行います。\n\nGitHub Enterprise Server コンテナーレジストリに対して認証を行うには、`--registries-auth-stdin` を渡すか、CODEQL\\_REGISTRIES\\_AUTH 環境変数を使ってください。\n\nこれは、GITHUB\\_TOKEN 環境変数をオーバーライドします。\n\n### 共通オプション\n\n#### `-h, --help`\n\nこのヘルプテキストを表示します。\n\n#### `-J=`\n\n```\n \\[詳細設定] コマンドを実行している JVM にオプションを指定します。\n```\n\n(スペースを含むオプションは、正しく処理されないことにご注意ください)。\n\n#### `-v, --verbose`\n\n出力される進行状況メッセージの数を段階的に増やします。\n\n#### `-q, --quiet`\n\n出力される進行状況メッセージの数を段階的に減らします。\n\n#### `--verbosity=`\n\n```\n \\[詳細設定] 詳細レベルを、errors、warnings、progress、progress+、progress++、progress+++ のいずれかに明示的に設定します。 \n `-v` と `-q` がオーバーライドされます。\n```\n\n#### `--logdir=`\n\n```\n \\[詳細設定] タイムスタンプと実行中のサブコマンドの名前を含む生成された名前を使って、指定されたディレクトリ内の 1 つまた複数のファイルに詳細なログを書き込みます。\n```\n\n(完全に制御できる名前でログファイルを書き込むには、代わりに `--log-to-stderr` を指定し、必要に応じて stderr をリダイレクトします)。\n\n#### `--common-caches=`\n\n```\n \\[詳細設定] ダウンロードした QL パックやコンパイル済みクエリプランなど、CLI の複数の実行間に保持される、ディスク上でキャッシュされたデータの場所を制御します。明示的に設定されない場合、既定値は、ユーザーのホームディレクトリの `.codeql` という名前のディレクトリになります。まだ存在しない場合は、作成されます。\n\n `v2.15.2` 以降で使用できます。\n```"}