# データベースのクリーンアップ

ディスク上の CodeQL データベースを圧縮します。

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

## 概要

```shell copy
codeql database cleanup <options>... -- <database>
```

## Description

ディスク上の CodeQL データベースを圧縮します。

一時データを削除し、一般に、将来の有用性を低下させることなく、ディスク上のデータベースをできるだけ小さくします。

## オプション

### 主なオプション

#### `<database>`

              \[CodeQL データベースのクリーンアップのためのパスは必ず指定してください。

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

#### `--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` 以降で使用できます。