メインコンテンツへスキップ
クライアント証明書による TLS 接続、自分専用のデータベースとロール、すぐに有効化できる定番の拡張機能、定期ジョブ用の pg_cron を備えたマネージド PostgreSQL インスタンスです。すべてのエンジンに共通する事項 (制限、snapshot、Insights) はデータベースの概要にまとめています。

接続する

ダッシュボードのデータベースのページから接続 URL をコピーします。形式は次のとおりで、squarecloud ユーザーと squarecloud データベースはあらかじめ作成されています。
PostgreSQL では、パスワードに加えて SSL/TLS とクライアント証明書が必須です。接続 → SSL/TLS 証明書から .pem をダウンロードし、クライアントにそのファイルを指定します。
Go のクライアントは、この証明書では sslmode=verify-full を拒否します (x509: certificate relies on legacy Common Name field)。証明書がホスト名を Common Name にしか記載しておらず、Go はもうそこを確認しないためです。証明書の検証は引き続き行われる sslmode=verify-ca を使用してください。
ORM やその他のクライアント (Prisma、Drizzle、JDBC、GUI ツール) については、データベース接続エラーで説明しています。

接続数

各データベースは最大 256 の同時接続を受け付け、そのうち 253 がクライアント用です。それを超えると、新しい接続は remaining connection slots are reserved for roles with the SUPERUSER attribute (または sorry, too many clients already) で失敗します。起動時に プロセスごとに 1 つのプールを作成して使い回し、すべてのアプリ、ワーカー、シャードの合計が上限を下回るようにサイズを決めてください。リクエストやクエリのたびに新しい接続を開くと、すぐに上限に達します。開いている接続を誰が保持しているかは Insights タブで確認できます。

ユーザーと権限

squarecloud ロールは LOGIN、CREATEDB、CREATEROLE、BYPASSRLS を持ち、squarecloud データベースを所有しています。データベース、スキーマ、ロール、権限付与を作成でき、通常のユーザーが変更できる設定を、セッション単位またはデフォルトとして変更できます。
このロールはスーパーユーザーではなく、レプリケーション権限もありません。そのため、次のものは使えません。
  • ALTER SYSTEM と、スーパーユーザー専用の設定
  • サーバー側の COPY ... TO/FROM 'file' (自分のマシン上で読み書きする psql の \copy を使ってください)
  • plpython3u などの信頼されていない言語
  • 論理レプリケーションと、それを必要とする変更データキャプチャツール

拡張機能

インストール済み: plpgsql、および postgres データベースの pg_cron と pg_stat_statements。 次の拡張機能は、それを使うデータベースで CREATE EXTENSION を実行すれば、どのデータベースでも有効化できます。 vector (pgvector)、pg_trgm、pgcrypto、uuid-ossp、citext、hstore、unaccent、ltree、btree_gin、btree_gist、cube、dict_int、fuzzystrmatch、intarray、isn、lo、seg、tablefunc、tcn、tsm_system_rows、tsm_system_time。
これ以外の拡張機能は利用できず、リクエストによる追加もできません。たとえば PostGIS は利用できません。

pg_cron による定期ジョブ

pg_cron は postgres データベースにあります。postgres に接続し (同じ URL の末尾を /postgres にします)、自分のデータベースで実行されるようにジョブをスケジュールします。スケジュールは UTC です。
cron.job_run_details の実行履歴は自動では削除されません。古い行を削除するジョブをスケジュールしてください。

メモリと設定

  • shared_buffers はデータベースの RAM の 25% (最低 128 MB) です。RAM を変更すると、反映のためにデータベースが再起動します。
  • 残りについて PostgreSQL はオペレーティングシステムのファイルキャッシュに頼るため、ダッシュボードに表示される RAM は上昇したあと高いまま推移します。これは正常な動作で、メモリリークではありません。
  • 1 つのクエリが書き込める一時ファイル (ソート、ハッシュ) は最大 1 GB です。それを超えるとクエリは temporary file size exceeds temp_file_limit で失敗します。インデックスを追加するか、データをバッチで処理してください。
  • 先行書き込みログ (WAL) は、データベースのストレージのうち 256〜512 MB を使用します。
  • サーバーの設定はすべてのデータベースで共通で、データベースごとには変更できません。

遅いクエリ

100 ms 以上かかったステートメントは記録され、Insights タブに平均時間とともに一覧表示されます。自分で分析するには、postgres データベースに接続して pg_stat_statements を照会し、対象のステートメントに EXPLAIN ANALYZE を使います。

Snapshot

PostgreSQL の snapshot には、インスタンスのすべてのデータベースとロールが含まれます。共通のケースに加えて、ALLOW_CONNECTIONS false のデータベースがある場合や、自分のロック (LOCK TABLE、長時間の ALTER TABLE) が 5 分を超えてエクスポートをブロックした場合にも失敗します。エクスポートはプレーンな SQL テキストのため、10 GB のストレージに近いデータベースは snapshot に収まらないことがあります。

よくあるエラー

お問い合わせ

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