# データベース バンドル

CodeQL データベースの再配置可能なアーカイブを作成します。

> [!NOTE]
> このコンテンツでは、CodeQL CLI の最新リリースについて説明します。 このリリースについて詳しくは、 https://github.com/github/codeql-cli-binaries/releases をご覧ください。
>
> 以前のリリースの、このコマンドで使えるオプションを詳しく確認するには、ターミナルで <span style="white-space: nowrap;">`--help`</span> オプションを指定してコマンドを実行してください。

## 概要

```shell copy
codeql database bundle --output=<output> <options>... -- <database>
```

## Description

CodeQL データベースの再配置可能なアーカイブを作成します。

データベースの役に立つ部分を圧縮するコマンド。 ユーザーが結果、ログ、TRAP などを含める必要があることを明示的に要求しない限り、これには必須コンポーネントのみが含まれます。

## オプション

### 主なオプション

#### `<database>`

              \[必須: CodeQL データベースをバンドルするためのパス。

#### `-o, --output=<output>`

              \[必須] 出力ファイル。通常、拡張子 ".zip" が付きます。

#### `--[no-]include-diagnostics`

診断をバンドルに含めます。

              `v2.16.0` 以降で使用できます。

#### `--[no-]include-results`

事前に計算されたクエリ結果をバンドルに含めます。

#### `--[no-]include-logs`

ログ ディレクトリをバンドルに含めます。

              `v2.17.6` 以降で使用できます。

#### `--[no-]include-temp`

生成されたパック、クエリ、スイートが置かれている "temp" ディレクトリを含めます。

              `v2.13.3` 以降で使用できます。

#### `--[no-]include-uncompressed-source`

非圧縮バージョンのソース アーカイブ ディレクトリを含めます。 これは、従来の CodeQL プラグイン (Eclipse 用 CodeQL など) に必要です。

#### `--include=<include>`

              \[[詳細設定] バンドルに含めるデータベース ディレクトリを基準とした追加パス。

              `v2.24.0` 以降で使用できます。

#### `--name=<name>`

バンドル内の最上位ディレクトリの名前。 指定しないと、既定でデータベース ディレクトリの名前になります。

### 低レベルのデータセット クリーンアップ オプション

#### `--max-disk-cache=<MB>`

中間クエリ結果のディスク キャッシュで使用できる最大容量を設定します。

このサイズが明示的に構成されていない場合、エバリュエーターによって、データセットのサイズとクエリの複雑さに基づき、"妥当な" 量のキャッシュ スペースを使うことが試みられます。 このデフォルトの使用量よりも高い制限を明示的に設定すると、追加のキャッシュが有効になり、後のクエリが高速化されます。

#### `--min-disk-free=<MB>`

              \[詳細設定] ファイル システムの空き領域の目標量を設定します。

              `--max-disk-cache` が指定されていない場合、ファイル システムの空き容量がこの値を下回ると、エバリュエーターによってディスク キャッシュの使用量を抑えることが試みられます。

#### `--min-disk-free-pct=<pct>`

              \[詳細設定] ファイル システムの空き領域の目標割合を設定します。

              `--max-disk-cache` が指定されていない場合、ファイル システムの空き容量がこの割合を下回ると、エバリュエーターはディスク キャッシュの使用量を抑えようとします。

#### `--cache-cleanup=<mode>`

キャッシュをどの程度積極的にトリミングするかを選びます。 以下を選択できます。

              `clear`: キャッシュ全体を削除し、新しく抽出されたデータセットの状態にトリミングします

              `trim` (既定値): 明示的に "キャッシュされた" 述語を除くすべてをトリミングします。__

              `fit`: ディスク キャッシュに対して定義されたサイズ制限を確認し、必要な数の中間ファイルを削除します。

              `overlay`: オーバーレイに対して評価するときに役立つデータのみにトリミングします。

#### `--cleanup-upgrade-backups`

データベースのアップグレードに起因するすべてのバックアップ ディレクトリを削除します。

### 共通オプション

#### `-h, --help`

このヘルプ テキストを表示します。

#### `-J=<opt>`

              \[詳細設定] コマンドを実行している JVM にオプションを指定します

(スペースを含むオプションは正しく処理されないことに注意してください)。

#### `-v, --verbose`

出力される進行状況メッセージの数を段階的に増やします。

#### `-q, --quiet`

出力される進行状況メッセージの数を段階的に減らします。

#### `--verbosity=<level>`

              \[詳細設定] 詳細レベルを、errors、warnings、progress、progress+、progress++、progress+++ のいずれかに明示的に設定します。 
              `-v` と `-q` がオーバーライドされます。

#### `--logdir=<dir>`

              \[詳細設定] タイムスタンプと実行中のサブコマンドの名前を含む生成された名前を使用して、指定されたディレクトリ内の 1 つまたは複数のファイルに詳細なログを書き込みます

(完全に制御できる名前でログ ファイルを書き込むには、代わりに `--log-to-stderr` を指定し、必要に応じて stderr をリダイレクトします)。

#### `--common-caches=<dir>`

              \[[詳細設定] ダウンロードした QL パックやコンパイル済みクエリ プランなど、CLI の複数の実行間に保持される、ディスク上でキャッシュされたデータの場所を制御します。 明示的に設定されない場合、デフォルトではユーザーのホーム ディレクトリに名前が付けられた `.codeql` ディレクトリになります。まだ存在しない場合は作成されます。

              `v2.15.2` 以降で使用できます。