接続する
ダッシュボードのデータベースのページから接続 URL をコピーします。形式は次のとおりで、squarecloud ユーザーと squarecloud データベースはあらかじめ作成されています。
ssl-mode=REQUIRED を使うか、サーバーも検証する場合は、接続 → SSL/TLS 証明書の .pem を CA とした VERIFY_CA を使います。
サーバーが受け付ける認証方式は caching_sha2_password のみです。npm の mysql パッケージなど、これに対応していない古いドライバーはログインに失敗します。Node.js では mysql2 を、それ以外では最新のコネクタを使ってください。
- Node.js
- Python
- mysql CLI
'%' を指定してください。
ORM や GUI ツール (Prisma、MySQL Workbench、DBeaver、HeidiSQL) については、データベース接続エラーで説明しています。
接続数
各データベースは最大 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) で失敗します。インポートの前にこれらの句を削除するか、自分のユーザーに置き換えてください。
設定
- バイナリログはありません。 レプリケーション、変更データキャプチャ (Debezium など)、ポイントインタイムリカバリは利用できません。
- バッファプール:
innodb_buffer_pool_sizeは MySQL のデフォルトの 128 MB のままで、データベースの RAM に応じて増えることはありません。割り当てた RAM の範囲内で、接続とサーバー自体の分を残して引き上げられます (RAM の約半分から始めるのが安全です)。永続化した値は、データベースを snapshot から復元したときやアップグレードしたときに失われます。その後にもう一度設定してください。 max_allowed_packetは 64 MB で、サーバーが受け付ける 1 つのステートメントまたは行の最大サイズです。- それ以外のサーバー設定は、すべてのデータベースで共通です。
遅いクエリ
Insights タブには、ステートメントが平均時間順に一覧表示されます (100 ms 以上かかった実行が 1 回でもあるステートメント)。生のスロークエリログが必要な場合は有効にしてください。同じ 100 ms のしきい値でmysql.slow_log テーブルに書き込まれ、期限切れにならず、データベースのストレージを使用するため、終わったら空にしてください。
Snapshot
MySQL の snapshot には、スキーマ、ルーチン、トリガー、イベント、ユーザーが含まれ、単一のトランザクションでエクスポートされます。InnoDB のテーブルでは一貫性が保たれますが、MyISAM では保証されません。共通のケースに加えて、自分のLOCK TABLES が 5 分を超えてエクスポートをブロックした場合にも失敗します。エクスポートはプレーンな SQL テキストのため、10 GB のストレージに近いデータベースは snapshot に収まらないことがあります。
よくあるエラー
強制停止のあと、MySQL は次回の起動時にクラッシュリカバリを実行します。大きなデータベースほど時間がかかるため、完了するまで待ってください。

