接続する PlanetScale Postgres Excel、Google Sheets、AI、RESTへ

これはPlanetScale Postgresであり、PlanetScale MySQLではありません。

PlanetScaleは長年Vitessという会社として活動していたため、このカードがどの製品に接続されるのかを率直に述べておく価値がある。

• このコネクタはPlanetScale Postgres用です — .horizon.psdb.cloud 上のマネージド Postgres サービス。Postgres ワイヤプロトコルに対応しており、エージェントは Npgsql を使用してこのサービスに接続します。
• これはVitessを基盤とするMySQLサービス向けではありません。そのためのプリセットは存在せず、PlanetScaleのMySQL接続文字列はこのカードには適合しません。
• 接続はPostgreSQLとして保存され、バッジとしてPlanetScaleが保持されます。PlanetScaleという名前の接続タイプは存在しません。 つまり、以前に.horizon.psdb.cloudホストに対して行った通常のPostgres接続でも、すぐにブランドが認識されるということです。
• 下流の処理はすべて通常のPostgresです。スキーマ、型、そしてクロスソース参照におけるデフォルトスキーマとしてのpublicなどです。

PSBouncerがデフォルトであり、ポートによって決まります。

PlanetScaleは、直接エンドポイントと同じホスト名で、ポート番号を1つずらしたアドレスでプーラーを実行します。PlanetScaleが指定するアドレスであるため、カードはデフォルトでプーラーを使用するようになります。

• 直接接続先はポート5432です。PSBouncer PlanetScaleのトランザクションプーラーは、同じホスト上のポート6432を使用します。両者の間には他に何も変更はありません。
• 6432番ポートでは、エージェントがプリペアドステートメントを無効にし、セッション終了時のリセットを停止します。トランザクションプーラーはステートメント間で異なるバックエンドを提供する可能性があり、そうでないと想定するドライバは、一見ランダムに見えるような形で障害が発生します。
• トリガーとなるのはポート番号であり、ドロップダウンメニューではありません。ドロップダウンメニューは、カードが2つの選択肢の不一致を拒否できるようにするために存在します。つまり、間違ったポート番号でプール接続を選択した場合や、6432番ポートに直接接続した場合などです。そして、最初の異常なエラーが発生した後ではなく、保存する前に警告が表示されます。
• 覚えておくべき別のホスト名や、2組目の認証情報はありません。ポートを変更するだけで、スイッチの操作は完了です。

ユーザー名にはドットが含まれており、それが重要です

4つの項目のうち2つは微妙に間違えやすいので、このカードでは両方をチェックするようになっている。

• PlanetScaleのユーザー名は、postgres.<データベースID>の形式です。ドットなしで貼り付けると、カードがそれを阻止します。ドット以降の部分がデータベースを選択する部分だからです。
• 先頭または末尾に空白文字を含むパスワードはフラグが立てられます。これはクリップボードの痕跡であり、通常の認証エラーとして処理されるため、ユーザーは誤った問題を探してしまうことになります。
• PostgreSQLの接続文字列でないものはすべて、誤ったフィールドに中途半端に解析されるのではなく、正しい接続文字列の場所を示すメッセージとともに拒否されます。
• 貼り付けられた文字列は決して保存されません。フォームへの入力のために一度読み込まれた後、破棄されるため、パスワードは2か所ではなく1か所に保存されます。

-- 通常の Postgres、読み取り専用、PSBouncer 経由または直接 SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;