接続する ザタ Excel、Google Sheets、AI、RESTへ

データベースフィールドは名前ではなくルートです

他のすべてのPostgresコネクタでは、データベースフィールドに識別子が格納され、クエリストリームはPostgresが引用符なしの名前に対して行う処理に従って、それを小文字に変換します。Xataではこれは明らかに誤りであるため、このルールが無効になっている唯一の場所です。

• 値はデータベース:ブランチのペアです — mydb:main — これは Xata によってルートとして解決されます。これは Postgres の識別子ではなく、識別子の折りたたみ規則に従いません。
• Feature-X というブランチは、F と X の両方を大文字のまま保持します。feature-x と小文字にすると解決できなくなるため、Xata は正規化の対象外となる唯一のコネクタです。
• コロンを省略しても接続は機能します — デフォルトブランチに着地します。このカードは、何もせずに見過ごすのではなく、この点を指摘します。なぜなら、フィーチャーブランチを指定しようとしたのにメインブランチに着地してしまうと、間違ったデータから正しいように見える数値が生成されてしまうからです。
• 名前に関するその他の情報はチェックされません。クエリ ストリームは入力されたとおりにルートを渡し、解決するかどうかは Xata に判断させます。

エージェントがXataホストに対して行うこと

2つの動作は.sql.xata.shという拡張子に関連付けられており、どちらもユーザーが設定できるものではありません。

• TLSは必須であり、要求されるものではありません。.sql.xata.shホストは、[SSLを使用する]チェックボックスに関係なく暗号化された状態で接続されるため、クリップボードでsslmodeが失われた文字列も暗号化された状態で送信されます。
• 接続は暗号化されていますが、証明書チェーンは検証されていません。これが現状の正確な説明であり、Query Streamsが認識するすべてのホスティングプロバイダーで同じです。
• パス上にプーラーは存在しません。一部のサーバーレスPostgresサービスでは、トランザクションモードのプーラーを前面に配置し、それに対応するためにプリペアドステートメントを固定する必要がありますが、Xataではそうではないため、エージェントは直接接続し、それらの処理をすべてスキップします。
• 接続はPostgreSQLとして保存され、バッジとしてXataが保持されます。Xataという名前の接続タイプは存在しません。 つまり、以前に同じホストに対して行った通常のPostgres接続でも、Xataのブランドがすぐに認識されるということです。

再入力するのではなく、貼り付けてください。

認証情報は4つあり、そのうち2つは混同しやすく、1つは入力ミスしやすいほど長い。このカードは、文字列を貼り付けて残りの部分を処理する仕組みになっている。

• コンソールからの `postgresql://` URI は想定される形式です。`libpq host=` キーワード形式も解析されます。
• PostgreSQLの接続文字列でないものはすべて拒否され、正しい接続文字列がどこにあるかを示すメッセージが表示されます。間違ったフィールドに中途半端に解析されることはありません。
• 先頭または末尾に空白文字が含まれるAPIキーはフラグが立てられます。これはクリップボードの痕跡であり、通常の認証エラーとして処理されるため、誤った問題を探すことにつながります。
• ワークスペースIDはユーザー名欄に、APIキーはパスワード欄に入力します。カードには「ユーザー名」と「パスワード」と表示されて推測を強いられるのではなく、このようにラベル付けされています。

-- 通常の Postgres、読み取り専用、指定したブランチに対して 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;