メインコンテンツへスキップ
TLS 接続のみを受け付け、自分のデータベース、ユーザー、ルーチン、イベントを管理できるユーザーを備えたマネージド MySQL インスタンスです。すべてのエンジンに共通する事項 (制限、snapshot、Insights) はデータベースの概要にまとめています。

接続する

ダッシュボードのデータベースのページから接続 URL をコピーします。形式は次のとおりで、squarecloud ユーザーと squarecloud データベースはあらかじめ作成されています。
MySQL では SSL/TLS が必須ですが、クライアント証明書は不要です。ssl-mode=REQUIRED を使うか、サーバーも検証する場合は、接続 → SSL/TLS 証明書の .pem を CA とした VERIFY_CA を使います。 サーバーが受け付ける認証方式は caching_sha2_password のみです。npm の mysql パッケージなど、これに対応していない古いドライバーはログインに失敗します。Node.js では mysql2 を、それ以外では最新のコネクタを使ってください。
サーバーはホスト名を解決しません。ユーザーを作成するとき、ホスト部分には IP アドレスか '%' を指定してください。 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 は次回の起動時にクラッシュリカバリを実行します。大きなデータベースほど時間がかかるため、完了するまで待ってください。

お問い合わせ

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