> ## 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 の MySQL: 接続、権限、制限

> Square Cloud のマネージド MySQL: 接続文字列、必須の TLS、caching_sha2_password、ユーザー権限、DEFINER を含むダンプのインポート、バッファプール、スロークエリログ、よくあるエラー。

TLS 接続のみを受け付け、自分のデータベース、ユーザー、ルーチン、イベントを管理できるユーザーを備えたマネージド MySQL インスタンスです。すべてのエンジンに共通する事項 (制限、snapshot、Insights) は[データベースの概要](https://docs.squarecloud.app/ja/services/databases.md)にまとめています。

## 接続する

ダッシュボードのデータベースのページから接続 URL をコピーします。形式は次のとおりで、`squarecloud` ユーザーと `squarecloud` データベースはあらかじめ作成されています。

```
mysql://squarecloud:PASSWORD@HOST:PORT/squarecloud
```

MySQL では **SSL/TLS** が必須ですが、クライアント証明書は不要です。`ssl-mode=REQUIRED` を使うか、サーバーも検証する場合は、**接続** → **SSL/TLS 証明書**の `.pem` を CA とした `VERIFY_CA` を使います。

サーバーが受け付ける認証方式は `caching_sha2_password` のみです。npm の `mysql` パッケージなど、これに対応していない古いドライバーはログインに失敗します。Node.js では `mysql2` を、それ以外では最新のコネクタを使ってください。

> [tab] Node.js
>
> ```javascript theme={"system"}
> import fs from "node:fs";
> import mysql from "mysql2/promise";
>
> // One pool for the whole process, created once and reused.
> export const pool = mysql.createPool({
>   uri: process.env.DATABASE_URL,
>   ssl: { ca: fs.readFileSync("certificate.pem", "utf8") },
>   connectionLimit: 10,
> });
>
> const [rows] = await pool.query("SELECT NOW()");
> ```

> [tab] Python
>
> ```python theme={"system"}
> import os
> from urllib.parse import urlparse, unquote
> import pymysql
>
> url = urlparse(os.environ["DATABASE_URL"])
> conn = pymysql.connect(
>     host=url.hostname,
>     port=url.port,
>     user=unquote(url.username),
>     password=unquote(url.password),
>     database=url.path.lstrip("/"),
>     ssl={"ca": "certificate.pem"},
> )
> ```

> [tab] mysql CLI
>
> ```bash theme={"system"}
> mysql --host=HOST --port=PORT --user=squarecloud --password \
>   --ssl-mode=VERIFY_CA --ssl-ca=certificate.pem squarecloud
> ```

サーバーはホスト名を解決しません。ユーザーを作成するとき、ホスト部分には IP アドレスか `'%'` を指定してください。

ORM や GUI ツール (Prisma、MySQL Workbench、DBeaver、HeidiSQL) については、[データベース接続エラー](https://docs.squarecloud.app/ja/platform/troubleshooting/database-connection-errors.md)で説明しています。

## 接続数

各データベースは最大 256 の同時接続を受け付けます。それを超えると、新しい接続は `Too many connections` で失敗します。起動時に **プロセスごとに 1 つのプール**を作成して使い回し、すべてのアプリ、ワーカー、シャードの合計が上限を下回るようにサイズを決めてください。開いている接続を誰が保持しているかは **Insights** タブで確認できます。

## ユーザーと権限

`squarecloud@'%'` ユーザーは、管理系の権限を除くすべての権限を `GRANT OPTION` 付きで持っています。データベース、ユーザー、権限付与、ルーチン、トリガー、イベントを作成でき、`SET GLOBAL` と `SET PERSIST` でグローバル変数を変更できます。

管理系の権限で可能になる次の操作は利用できません。

* サーバー側のファイル: `LOAD DATA INFILE` と `SELECT ... INTO OUTFILE`
* `FLUSH PRIVILEGES`。`ERROR 1227` が返ります。`GRANT`、`CREATE USER`、`ALTER USER` は即座に反映されるため、不要です
* `SHOW ENGINE INNODB STATUS`
* レプリケーション

## ダンプのインポート

別のサーバーで取得したダンプには、ビュー、ルーチン、トリガー、イベントに `DEFINER=root@localhost` (または別の管理アカウント) が含まれていることがよくあります。そのままインポートすると `ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)` で失敗します。インポートの前にこれらの句を削除するか、自分のユーザーに置き換えてください。

```bash theme={"system"}
sed -E 's/DEFINER=`[^`]+`@`[^`]+`//g' dump.sql > dump-clean.sql
mysql --host=HOST --port=PORT --user=squarecloud --password \
  --ssl-mode=REQUIRED squarecloud < dump-clean.sql
```

## 設定

* **バイナリログはありません。** レプリケーション、変更データキャプチャ (Debezium など)、ポイントインタイムリカバリは利用できません。
* **バッファプール:** `innodb_buffer_pool_size` は MySQL のデフォルトの **128 MB** のままで、データベースの RAM に応じて増えることはありません。割り当てた RAM の範囲内で、接続とサーバー自体の分を残して引き上げられます (RAM の約半分から始めるのが安全です)。
  ```sql theme={"system"}
  SET PERSIST innodb_buffer_pool_size = 536870912; -- 512 MB
  ```
  永続化した値は、データベースを snapshot から復元したときやアップグレードしたときに失われます。その後にもう一度設定してください。
* **`max_allowed_packet`** は 64 MB で、サーバーが受け付ける 1 つのステートメントまたは行の最大サイズです。
* それ以外のサーバー設定は、すべてのデータベースで共通です。

## 遅いクエリ

**Insights** タブには、ステートメントが平均時間順に一覧表示されます (100 ms 以上かかった実行が 1 回でもあるステートメント)。生のスロークエリログが必要な場合は有効にしてください。同じ 100 ms のしきい値で `mysql.slow_log` テーブルに書き込まれ、期限切れにならず、データベースのストレージを使用するため、終わったら空にしてください。

```sql theme={"system"}
SET GLOBAL slow_query_log = ON;
SELECT start_time, query_time, sql_text FROM mysql.slow_log ORDER BY start_time DESC LIMIT 10;
TRUNCATE TABLE mysql.slow_log;
SET GLOBAL slow_query_log = OFF;
```

## Snapshot

MySQL の snapshot には、スキーマ、ルーチン、トリガー、イベント、ユーザーが含まれ、単一のトランザクションでエクスポートされます。InnoDB のテーブルでは一貫性が保たれますが、MyISAM では保証されません。[共通のケース](https://docs.squarecloud.app/ja/services/databases.md#snapshot-と復元)に加えて、自分の `LOCK TABLES` が 5 分を超えてエクスポートをブロックした場合にも失敗します。エクスポートはプレーンな SQL テキストのため、10 GB のストレージに近いデータベースは snapshot に収まらないことがあります。

## よくあるエラー

| メッセージ | 意味 | 対処方法 |
| :- | :- | :- |
| `Connections using insecure transport are prohibited while --require_secure_transport=ON` | クライアントが SSL/TLS なしで接続しました。 | SSL/TLS を有効にします (`ssl-mode=REQUIRED`)。 |
| `ER_NOT_SUPPORTED_AUTH_MODE` | ドライバーが `caching_sha2_password` に対応していません。 | `mysql2` または最新のコネクタに切り替えます。 |
| `Too many connections` | 256 の接続がすべて使用中です。 | プロセスごとに共有プールを 1 つ使います。[接続数](#接続数)を参照してください。 |
| `ERROR 1227 (42000): Access denied; you need ... privilege(s)` | ステートメントに管理系の権限が必要か、ダンプに `DEFINER=root` が含まれています。 | `FLUSH PRIVILEGES` を削除し、`DEFINER` 句を取り除きます。 |
| `Got a packet bigger than 'max_allowed_packet' bytes` | ステートメントまたは行が 64 MB を超えています。 | より小さな INSERT に分割します。 |
| `The table '...' is full` | 10 GB のストレージがいっぱいで、書き込みが失敗します。 | データを削除します。[ディスクがいっぱい](https://docs.squarecloud.app/ja/platform/troubleshooting/database-performance.md#ディスクがいっぱい)を参照してください。 |

強制停止のあと、MySQL は次回の起動時にクラッシュリカバリを実行します。大きなデータベースほど時間がかかるため、完了するまで待ってください。

## お問い合わせ

**技術的な問題**が解決しない場合は、**専門のサポートチーム**がお手伝いします。[**お問い合わせ**](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.