Prisma Postgresのロゴ

サーバーレスPostgres PostgreSQLについて話す

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

Prisma Postgresは直接TCP接続で動作します。すべてのデータベースは同じホスト名で応答するため、認証情報によってあなたのデータベースが識別されます。

一つの接続、あらゆる表面

Prismaデータはどこに保存されるのか

Query Streams は、読み取り専用接続 1 つを介して、Microsoft Excel、Google Sheets、Power BI、MCP 経由の AI アシスタント、および REST エンドポイントから Prisma Postgres を読み取ります。Prisma には、開始前に知っておくべき 2 つの点で特異な点があります。すべての顧客のデータベースは同じホスト名 db.prisma.io で応答し、認証情報によってどのホスト名にアクセスするかが決まります。また、Prisma は 2 つの異なる接続文字列を配布しますが、そのうちの 1 つだけが実際の Postgres 接続です。このカードは、適切な接続を取得するために作成されています。

Prisma Postgresは、ネットワーク上で動作するPostgreSQLです。 — 標準ドライバーなので、以下のガイドはすべて変更なく適用されます。Prisma固有の部分は接続文字列のみで、以下で説明します。 接続の詳細.

  1. チーム、ベンダー、パートナーの皆様へ
  2. Prisma to Excel Microsoft Excel · Excelアドイン

    Prismaのリアルタイム結果をワークシートに直接取り込み、必要に応じて更新できます。対応プラットフォームは、デスクトップ版Excel、Excel Online、Microsoft 365です。

    PostgreSQLガイド
  3. PrismaからGoogleスプレッドシートへの変換 Sheetsアドオン

    サイドバーから保存済みのPrismaクエリを実行し、結果をシートにドラッグ&ドロップします。共有されている共同作業者は、各自でシートを更新できます。

    PostgreSQLガイド
  4. ノヴァにプリズマについて聞いてみて Nova AI · テキストからSQLへ

    平易な英語で質問してください。Novaは既にPrismaテーブルを認識しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を提供する必要もありません。

    Novaの仕組み
  5. Prismaからデータビューアへ 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ

    Prismaのリアルタイム結果を、同僚、ベンダー、パートナーなど、誰とでも共有できます。共有されたグリッドはブックマーク可能で、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態に戻ります。相手には結果のみが表示され、SQLや認証情報は一切表示されません。

    データビューアの仕組み
  6. アプリとシステム向け
  7. Prisma REST API HTTPエンドポイント

    Prismaクエリを認証済みのJSONエンドポイントとして公開し、あらゆるアプリケーションから呼び出し可能です。OpenAPI 3.1仕様に準拠し、Postman、Insomnia、Hoppscotch用のコレクションも用意されています。データベースポートは開放されません。

    PostgreSQLガイド
  8. PrismaからPower BIへ Power Query M

    生成された Power Query M を Power BI アドバンスト エディターに貼り付けると、レポートは HTTPS 経由で Prisma のリアルタイムの結果を読み取ります。ODBC ドライバーもデータベース ポートも必要ありません。

    Power BI の仕組み
  9. PrismaからAirtableへ 自動化プラットフォーム

    Prismaの行をスケジュールに基づいてAirtableベースに同期したり、Airtableの自動化スクリプト内で取得したりできます。

    PostgreSQLガイド
  10. プリズマからベースロウへ 自動化プラットフォーム

    RESTエンドポイント経由でPrismaからBaserowテーブルにデータを供給します(セルフホスト環境またはBaserowクラウド環境)。

    PostgreSQLガイド
  11. プリズマからシーテーブルへ 自動化プラットフォーム

    ファイルをエクスポートしたりデータベースを公開したりすることなく、SeaTableベースをPrismaデータで常に最新の状態に保つ。

    PostgreSQLガイド
  12. PrismaからSmartsheetへ 自動化プラットフォーム

    Prismaの結果をSmartsheetのグリッドにプッシュすることで、計画やレポートが先週のエクスポートデータではなく、元のシステムから読み込まれるようになります。

    PostgreSQLガイド
  13. プリズマからアンビルへ Anvil Works · アプリプラットフォーム

    Anvil PythonアプリをPrismaでバックアップするには、アプリ内にデータベース認証情報を埋め込むのではなく、RESTエンドポイントを使用します。

    PostgreSQLガイド
  14. AIツール向け
  15. Prisma MCPサーバー Claude、Cursor、およびMCPクライアント

    AIアシスタントに、正しいSQLを作成するために必要なスキーマを含むPrismaへの読み取り専用アクセス権を付与します。チャットに認証情報を含めないでください。

    PostgreSQLガイド
  16. 人々に届けられる
  17. Prismaのアラートとレポート Slack · Discord · メール · Webhook

    Prismaクエリをスケジュール設定して、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、または変化率が設定した値を超えるまでメッセージを保留することができます。

    アラートとレポートの仕組み

仕組み

5つのステップ、受信ファイアウォールの変更は不要

01

ネットワークエージェントは、ご都合の良い場所にインストールしてください。送信接続を1つだけ開き、受信は行わないため、Prismaは通常のクライアントとして認識し、ネットワークに受信ルールは不要です。

02

Prismaコンソールで、直接TCP接続文字列(postgres://)を生成します。これは、コンソールがアプリケーションで使用するために表示するアクセラレートURLとは異なります。

03

貼り付けてください。ホスト名、ポート番号、ユーザー名、パスワードは、貼り付けた内容からそのまま読み込まれます。

04

ご使用のデータベースが異なることが分かっている場合を除き、データベース名はpostgresのままにしておいてください。Prismaの文字列ではデータベース名が省略されることが多いため、カードには通常のデータベース名が自動的に入力されます。

05

保存します。Microsoft Excel、Google Sheets、Power BI、MCP、REST はすべて、その単一の接続を介して読み取るか、単一の読み取り専用ステートメントで他のソースと結合します。

機能の詳細解説

Prismaがあなたに与えるもの

接続文字列が2つあり、そのうち1つだけがPostgresです。

これが人々を惑わす点であり、間違った弦が全く理にかなっているように見えるからこそ、人々は惑わされるのだ。

  • Prisma Accelerate の URL は prisma:// または prisma+postgres:// で始まります。これらは、Postgres のワイヤ プロトコルではなく、Prisma 独自のプロトコルを使用する接続レイヤーにアクセスします。
  • Query Streamsは標準のPostgresドライバを使用して直接TCP接続を行うため、Accelerate URLはどのような認証情報を持っていてもここでは機能しません。
  • どちらか一方を貼り付けると、カードにその旨と、代わりに生成すべき内容が正確に表示されます。これは一般的な解析エラーではなく、2つの文字列が混同されやすいため、具体的なメッセージとして表示されます。
  • 必要なのは postgres:// または postgresql:// で始まり、db.prisma.io の 5432 を指しているものです。

全員が同じホスト名を共有する

ほとんどのマネージドPostgresサービスでは、インスタンスごとに固有のホスト名が割り当てられます。しかし、Prismaではそれがなく、フィールドの意味も変わってきます。

  • PrismaのすべてのPostgresデータベースはdb.prisma.ioで応答します。プロジェクトごと、またはリージョンごとにホスト名を検索する必要はありません。
  • ユーザー名とパスワードは、データベースを選択するために使用されます。これらはユーザーが選択するのではなく、Prismaコンソールで生成され、接続の完全な識別情報となります。
  • そのため、認証情報は慎重に取り扱う必要がある。ほとんどのサービスでは、漏洩したパスワードは不明瞭なホスト名によっても特定されるが、ここではホスト名が公に知られている。
  • 貼り付けられた文字列は決して保存されません。フォームへの入力のために一度読み込まれた後、破棄されるため、パスワードは2か所ではなく1か所に保存されます。

TLSは必須であり、エージェントはそれを偶然に任せることはありません。

ホスト名は固定されていて既知であるため、エージェントはこの点に関して確固たる立場を取ることができる。

  • エージェントはdb.prisma.ioに対してTLS接続を強制します。「SSLを使用する」チェックボックスはデフォルトでオンになっており、オフにしてもPrismaホストへの暗号化されていない接続は生成されません。
  • 証明書チェーンは検証されていません。暗号化が必要です。証明書に署名した人物の検証は行われないため、これはアクセスした内容の証明ではなく、盗聴防止のための保護手段として捉えてください。
  • このパスには接続プーラーがありません。Prismaのプーリング機能はAccelerateにありますが、このカードは意図的にAccelerateを使用しないため、プーリングモードを選択できない直接接続となります。
  • 下流の処理はすべて通常のPostgresです。スキーマ、型、そしてクロスソース参照におけるデフォルトスキーマとしてのpublicなどです。
-- 通常の Postgres、読み取り専用、直接 TCP 経由 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;

すべてのデータベースコネクタで共有されます

すべてのデータベースコネクタに当てはまる

  • 発信専用 エージェントは、クエリ ストリームへの暗号化された接続を 1 つだけ開きます。受信ポートの転送も、VPN も、IP 許可リストも不要で、データベースに関する情報がインターネットに公開されることは一切ありません。
  • 認証情報はそのまま保持されます データベースのユーザー名とパスワードは、エージェントをインストールしたマシン上に存在します。Query Streamsはこれらを受け取ることはなく、単独ではデータベースにアクセスできません。
  • 読み取り専用、強制 一度に1つのステートメントのみ、SELECT文とその関連文のみ。書き込みは、誰かが設定した権限に頼るのではなく、サーバーに送信される前に自分のマシン上で拒否されます。
  • エージェントは好きなだけデプロイできます サイト、リージョン、クラウドごとに1つずつ。ユーザーが確認できるすべてのデータソースは単一のドロップダウンリストに表示されるため、どのエージェントがどのデータをホストしているかを誰も知る必要はありません。

クエリが保存されると、次のようになります。

  • SQLではなく、機能を共有する。 同僚や外部パートナーが、クエリの背後にあるステートメントを見ることなく、クエリを実行してフィルターを変更できてしまう。
  • どちらの方向からでもフィルターをかける それらを@変数として自分で宣言するか、コネクタにWHERE句に既に存在するリテラル値を検出させて、ドロップダウンとして提供させます。
  • どこからでも読める Microsoft Excel、Google Sheets、Power BI、REST API、MCP上のAIアシスタント、クエリビルダー、Novaはすべて、同じ保存済みクエリを読み取ります。
  • 複数同時に実行 — 5つの保存済みクエリを5つのワークシートタブに表示し、結果の規模に関わらず同時にストリーミングします。
  • すでに接続済みの他のものにも接続してください — 別のデータベース、ビジネスAPI、またはファイルフォルダを、1つの読み取り専用ステートメントで取得します。

クロスソースSQL

Prismaを他のデータと連携させる

1つのステートメントで、Prismaと他の接続を同時に処理できます。各ソースは実行可能な部分のみを実行し、結果をストリームで返送します。結合処理は中央で行われるため、ソース同士が直接通信したり、データがどこかにコピーされたりすることはありません。

接続数3件・エージェント数3名

Prisma Postgres サーバーレスPostgres
マイクロソフトSQLサーバー 関係エンジン
ストライプ 支払いと請求

一つの声明

-- コピーなし、マージなし、スケジュールなし
セレクト   c.region、COUNT(*) AS orders、SUM(i.amount_due) AS invoiced
フロム     プリズマアプリ公共命令1 f
ジョイン     erp_sql.dbo.顧客2    c ON c.id = f.customer_id
ジョイン     請求する.stripe.invoices3  i ON i.customer = c.stripe_id
GROUP BY c.領域
ORDER BY 請求書記載のDESC;

接続、スキーマ、テーブルの3つの部分から構成され、接続名はユーザーが自由に設定できます。これは例示用の列であり、テーブルはユーザー自身が設定します。読み取り専用はすべての要素に適用され、SELECT、WITH、EXPLAINのみが使用可能で、1つのクエリで1つのソースが渡せるデータ量には上限があります。 フェデレーションクエリの仕組み

接続の詳細

プリズマが必要とするもの

ホスト
db.prisma.io — すべてのPrisma Postgresデータベースで共通
ポート
5432
ドライバ
エージェントによって提供されるNpgsql。Prisma側でインストールする必要はありません。
貼り付け形式
Prismaコンソールからの直接TCP文字列(postgres:// URI形式)
データベース
デフォルトではPostgreSQLが使用されます。Prismaの接続文字列では、PostgreSQLが省略されていることがよくあります。
ユーザー名
Prismaコンソールで生成されます。これはデータベースを選択するものです。
TLS
必須であり、db.prisma.io のエージェントによって強制されます。暗号化されていますが、証明書チェーンは検証されていません。
プーリング
なし。エージェントはPrismaに対してプーラー適応を適用しません。
このカードではありません
Prisma Accelerate URL が prisma:// または prisma+postgres:// の場合、カードはそれらを拒否し、生成する文字列を指定します。
保存先
PostgreSQLには、Prismaという名称はバッジとして残されているが、Prismaという名前の接続タイプは存在しない。
デフォルトスキーマ
連邦参照が持つパブリックなもの

このカードの最も価値のある機能は、Accelerate の拒否です。Accelerate は Prisma の接続プーラーおよびエッジキャッシュであり、アプリケーションにとって通常は最適な選択肢です。そのため、コンソールでは目立つように表示されています。これは単に Postgres エンドポイントではないため、Postgres ドライバーを使用して接続するツールはこれと通信できません。特定のメッセージがない場合、メッセージを貼り付けると、認証情報が間違っているかのようなエラーが発生し、実際には問題のないパスワードを再生成するように促されます。

共有ホスト名については、認証情報について少し考えてみる価値があります。データベースが推測しにくい長いホスト名で配置されているサービスでは、そのアドレスはセキュリティ上の弱点ではなく、むしろ煩雑さの原因となります。Prismaは設計上、この問題を解消しています。db.prisma.ioは全員共通なので、生成されたユーザー名とパスワードが認証の役割を果たします。ユーザーを読み取り専用に設定し、その文字列を他の秘密情報と同様に扱ってください。

クロスソースクエリの場合、Prismaは通常のPostgresとして動作します。prisma_appという名前で作成した接続はprisma_app.public.ordersとして書き込まれ、CSVファイルのフォルダ、オンプレミスの記録システム、または課金APIに、コピーやスケジュール処理なしで、読み取り専用のステートメント1つで接続します。

ベンダー資料: www.prisma.io

よくある質問

Prisma Postgresに関する質問

Prisma Postgresのデータをクエリストリーム経由で読み取れるツールはどれですか?

Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。データベースに一度接続すれば、すべてのインターフェースが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は一切不要です。

Prisma Postgresデータベースへのファイアウォールポートを開放する必要がありますか?

いいえ。Query Streams Network Agentはネットワーク内で動作し、暗号化された単一の送信接続を開きます。受信トラフィックを監視するものはなく、VPNも不要で、データベースは既存のファイアウォールルールを維持します。

Prisma Postgresでは、クエリストリームでデータを変更できますか?

いいえ。エージェントは実行時に読み取り専用を強制します。つまり、一度に1つのステートメント(SELECT文など)のみを実行します。認証情報はエージェント上に保持され、クエリ ストリームに送信されることはありません。

Query StreamsがPrisma Postgresに接続するために必要なものは何ですか?

到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバを運ぶため、データベースには何もインストールされません。ホスト: db.prisma.io - すべての Prisma Postgres データベースで同じです。ポート: 5432。ドライバ: Npgsql、エージェントによって運ばれます - Prisma 側でインストールする必要はありません。貼り付け形式: Prisma コンソールからの直接の TCP 文字列を postgres:// URI として貼り付けます。

Prisma Postgresを同じクエリ内で別のデータベースに結合することはできますか?

はい、それはフェデレーションクエリです。1つのステートメントで、Prisma Postgresと他の接続を同時に参照できます。これは、connection.schema.table の形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用は、SELECT、WITH、EXPLAIN の各部分のみに適用され、1 つのソースが単一のクエリで渡せるデータ量には上限があります。フェデレーションクエリはプラン機能です。フェデレーションクエリのページには、現在のソースとサイズの制限が表示されます。

Prisma Postgresへの接続は、PostgreSQLへの接続とは異なりますか?

接続文字列のみが必要です。Prisma PostgresはPostgreSQLワイヤプロトコルを使用するため、フィルタ、スケジュール設定、共有、ExcelおよびGoogle Sheetsアドオン、MCPサーバーはすべて同じように動作します。Prismaカードには、プロバイダが想定するホスト、ポート、SSL設定があらかじめ入力されています。

PrismaからExcelへの変換ガイドはありますか?

はい、これはPostgreSQLのガイドであり、記述どおりにPrisma Postgresでも正しく動作します。PrismaはPostgreSQLのワイヤプロトコルを使用するため、PrismaからExcel、PrismaからGoogle Sheets、その他のすべての宛先へのデータ転送は同じ手順で行えます。Prisma固有の部分は接続文字列のみですが、Prismaカードが自動的に入力してくれます。

Prismaを仕事が行われる場所に設置しましょう

エージェントをインストールし、データベースを指定して、保存先を選択してください。

読み取り専用 発信専用 認証情報はエージェントに保持されます