> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# データベースのメモリ、接続、遅いクエリ

> Square Cloud のデータベースの問題を解決: 増え続ける RAM、メモリ不足による停止、接続数の超過、遅いクエリ、ディスクの容量不足、強制停止後の遅い起動。

データベースの問題の多くは、リークしているように見えるメモリ、足りなくなる接続、遅くなるクエリとして現れます。以下の症状から始めてください。エンジンごとの詳細は [PostgreSQL](https://docs.squarecloud.app/ja/services/databases/postgresql.md)、[MySQL](https://docs.squarecloud.app/ja/services/databases/mysql.md)、[MongoDB](https://docs.squarecloud.app/ja/services/databases/mongodb.md)、[Redis](https://docs.squarecloud.app/ja/services/databases/redis.md) の各ページにあります。

## RAM が増え続ける

**意味:** データベースの RAM のグラフが起動後に上昇し、トラフィックが減っても高いまま推移します。

**発生理由:** ダッシュボードに表示される RAM はインスタンスのメモリ全体で、エンジンが温めておくオペレーティングシステムのファイルキャッシュも含まれます。さらに、各エンジンは意図的にメモリを保持します。

* **PostgreSQL:** `shared_buffers` (RAM の 25%) とファイルキャッシュ。
* **MongoDB:** WiredTiger キャッシュと、解放したメモリを再利用のために保持するアロケーター。
* **MySQL:** InnoDB バッファプール (引き上げていなければ 128 MB) とファイルキャッシュ。
* **Redis:** データそのもの (RAM の 90% まで)。

上昇したあと横ばいになるのは正常な動作で、メモリリークではありません。

**問題になる場合:** データベースがメモリ不足になると停止し、再び起動するまで停止したままになります (メモリ不足による停止のあとは自動で再起動しません)。その場合は次のようにします。

1. ダッシュボードから起動します。
2. 何が増えたのかを突き止めます: 大量のデータを対象にしたクエリや集計、多すぎる接続 (接続ごとにメモリを消費します)、Redis では有効期限のないキー。
3. それを減らすか、データベースの RAM を増やします。

## 接続が多すぎる

**意味:** 新しい接続が拒否されます。

| エンジン | メッセージ |
| :- | :- |
| PostgreSQL | `remaining connection slots are reserved for roles with the SUPERUSER attribute` / `sorry, too many clients already` |
| MySQL | `Too many connections` |
| MongoDB | 接続がすぐに閉じられる |
| Redis | `max number of clients reached` |

**発生理由:** どのデータベースも、サイズに関係なく最大 256 の同時接続を受け付けます (PostgreSQL ではクライアント用が 253)。よくある原因は、リクエストごとに新しいクライアントや接続を作る、プロセスごとではなくモジュールごとにプールを作る、複数のアプリやシャードがそれぞれ大きなプールを持つ、MongoDB で多数の `MongoClient` インスタンスを作る (それぞれプールに 2 つの監視用接続が加わります) といったものです。

**修正方法:**

1. 起動時に**プロセスごとに 1 つのプールまたはクライアント**を作成し、あらゆる場所で使い回します (`pg.Pool`、`mysql2.createPool`、1 つの `MongoClient`、1 つの Redis クライアント)。
2. すべてのプロセスの合計が余裕をもって上限を下回るように、プールのサイズを決めます。プールが 20 のプロセスが 4 つあれば 80 を使います。
3. データベースの **Insights** タブを開き、どのクライアントアドレスが接続を保持しているかを確認します (各 IP アドレスの 3 番目の部分はマスクされます)。

## 遅いクエリ

**意味:** アプリへのリクエストが遅くなり、データベースの CPU が高いまま推移します。

**見つけ方:** **Insights** タブに遅いクエリが一覧表示され、60 秒ごとに更新されます。

* **PostgreSQL と MySQL:** ステートメントと平均時間。100 ms 以上かかった実行が 1 回でもあれば表示されます。
* **MongoDB:** プロファイラーが記録した、100 ms 以上かかった個々の操作。
* **Redis:** `SLOWLOG` (10 ms 以上のコマンド)。

**修正方法:** 遅いクエリに対してエンジンの explain を実行し、必要なインデックスを追加します (PostgreSQL では `EXPLAIN ANALYZE`、MySQL では `EXPLAIN`、MongoDB では `explain("executionStats")`)。Redis では、キースペース全体や巨大なキーを走査するコマンド (`KEYS`、巨大なハッシュに対する `HGETALL`) を `SCAN`、`HSCAN`、`SSCAN` に置き換えます。大量のデータを読み取るクエリには RAM も必要です。RAM を増やすと、より多くのデータをキャッシュに保持できます。

## データベースが勝手に停止した

| 原因 | 表示される状態 | その後の動作 |
| :- | :- | :- |
| メモリ不足 | データベースが停止し、RAM のグラフが上限に達しています。 | 起動するまで停止したままです。[RAM が増え続ける](#ram-が増え続ける)を参照してください。 |
| エラーによるクラッシュ | データベースが予期せず停止しました。 | 自動で再起動します。ただし 1 時間に 1 回までで、少なくとも 60 秒間稼働していた場合に限ります。 |
| ストレージがいっぱい (MongoDB) | MongoDB が書き込みを停止し、シャットダウンしました。 | 停止したままです。[ディスクがいっぱい](#ディスクがいっぱい)を参照してください。 |

## ディスクがいっぱい

各データベースのストレージは **10 GB** で固定です。データ、インデックス、エンジン自身のファイルでこれを共有します: PostgreSQL の先行書き込みログ (256〜512 MB)、MongoDB の診断データ (最大 200 MB)、スロークエリログを有効にした場合の MySQL の `mysql.slow_log` テーブル、Redis ではデータファイルの隣に保存のために必要な領域です。

| エンジン | いっぱいになったときの動作 |
| :- | :- |
| PostgreSQL | 書き込みが失敗します (`could not extend file ... No space left on device`)。 |
| MySQL | 書き込みが失敗します (`The table '...' is full`)。 |
| MongoDB | サーバーが停止し、自動では復帰しません。 |
| Redis | 保存が失敗し、保存が成功するまで書き込みは `MISCONF` を返します。 |

**修正方法:**

1. 不要なデータを削除またはアーカイブし、使っていないインデックスを削除します。画像やアップロードなどのファイルは、データベースではなく [Blob Storage](https://docs.squarecloud.app/ja/services/blob.md) に置くべきものです。
2. 容量を回収します: PostgreSQL では、通常の `VACUUM` でテーブル内の領域が再利用可能になり、`VACUUM FULL` ではディスクに返却されますが、実行中はテーブルと同じサイズの空き容量が必要です。MySQL では `OPTIMIZE TABLE` でテーブルを再構築します。MongoDB ではコレクションに対して `compact` を実行します。
3. MongoDB では、まずダッシュボードからデータベースを起動し、すぐに空き容量を確保します。

> [!WARNING]
>
> 10 GB に近いデータベースは、snapshot の取得にも失敗することがあります。エクスポートは約 10 GB までに制限されており、PostgreSQL と MySQL のエクスポートは非圧縮の SQL テキストです。余裕を残しておいてください。

## 停止後の起動が遅い

**意味:** 起動した直後に PostgreSQL が `the database system is not yet accepting connections` を返す、または MySQL が接続を受け付けるまでに長い時間がかかります。

**発生理由:** データベースを停止すると、正常にシャットダウンするための猶予は 5 秒です。負荷の高いデータベースはそれ以上かかることがあり、その場合は強制的に停止されます。次回の起動時にクラッシュリカバリが実行され (PostgreSQL は先行書き込みログを再生し、MySQL の InnoDB はテーブルを復旧します)、大きなデータベースほど時間がかかります。

**修正方法:** 復旧が終わるまで待ちます。待っていても何も失われません。データベースは書き込み負荷が低いときに停止してください。

## 関連ガイド

* [データベースの概要](https://docs.squarecloud.app/ja/services/databases.md): 制限、snapshot、Insights、すべてのデータベースに含まれるもの。
* [データベース接続エラー](https://docs.squarecloud.app/ja/platform/troubleshooting/database-connection-errors.md): SSL/TLS、認証、ネットワークのエラー。

## お問い合わせ

**技術的な問題**が解決しない場合は、**専門のサポートチーム**がお手伝いします。[**お問い合わせ**](https://squarecloud.app/ja/support)いただければ、どのような問題でも喜んで解決をサポートいたします。サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に[**402 件のレビューで 4.9/5**](https://www.trustpilot.com/review/squarecloud.app)という評価をつけている理由の 1 つです。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.