pg_cron を備えたマネージド PostgreSQL インスタンスです。すべてのエンジンに共通する事項 (制限、snapshot、Insights) はデータベースの概要にまとめています。
接続する
ダッシュボードのデータベースのページから接続 URL をコピーします。形式は次のとおりで、squarecloud ユーザーと squarecloud データベースはあらかじめ作成されています。
.pem をダウンロードし、クライアントにそのファイルを指定します。
- Node.js
- Python
- psql
Go のクライアントは、この証明書では
sslmode=verify-full を拒否します (x509: certificate relies on legacy Common Name field)。証明書がホスト名を Common Name にしか記載しておらず、Go はもうそこを確認しないためです。証明書の検証は引き続き行われる sslmode=verify-ca を使用してください。接続数
各データベースは最大 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。
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 に収まらないことがあります。

