Koyebのロゴ

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

接続する コイエブ Excel、Google Sheets、AI、RESTへ

KoyebのサーバーレスPostgresは.pg.koyeb.appで動作します。このカードは、誰もが犯しがちな間違い、つまりデータベースのホスト名ではなくアプリのホスト名を貼り付けてしまうというミスを検出します。

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

Koyeb データが保存される場所

Query Streams は、1 つの読み取り専用接続を介して、Microsoft Excel、Google Sheets、Power BI、MCP 経由の AI アシスタント、および REST エンドポイントから Koyeb Postgres を読み取ります。Koyeb は、隣接するホスト名でアプリとデータベースをホストしていますが、そのうちデータベースは 1 つだけです。アプリは .koyeb.app に、Postgres は .pg.koyeb.app にあります。この 2 つの混同が、この接続が失敗する最も一般的な原因であるため、カードはそれをチェックし、タイムアウトとして失敗させるのではなく、平易な言葉でその旨を表示します。

コイエブはPostgreSQLをインターネット上で発信している。 — 標準ドライバーなので、以下のガイドはすべて変更なく適用されます。Koyeb固有の部分は接続文字列のみで、以下で説明します。 接続の詳細.

  1. チーム、ベンダー、パートナーの皆様へ
  2. コイエブが卓越する Microsoft Excel · Excelアドイン

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

    PostgreSQLガイド
  3. Koyeb を Google スプレッドシートへ Sheetsアドオン

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

    PostgreSQLガイド
  4. コイエブについてノヴァに聞いてみよう Nova AI · テキストからSQLへ

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

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

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

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

    Koyebクエリを認証済みのJSONエンドポイントとして公開します。このエンドポイントは、OpenAPI 3.1仕様に準拠し、Postman、Insomnia、Hoppscotch用の既製コレクションも用意されているため、どのアプリケーションでも呼び出すことができます。データベースポートは開放されません。

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

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

    Power BI の仕組み
  9. コイエブからエアテーブルへ 自動化プラットフォーム

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

    PostgreSQLガイド
  10. コイエブからバセロウへ 自動化プラットフォーム

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

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

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

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

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

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

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

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

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

    PostgreSQLガイド
  16. 人々に届けられる
  17. コイエブの警告と報告 Slack · Discord · メール · Webhook

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

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

仕組み

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

01

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

02

Koyebコンソールのデータベースで「接続の詳細」タブを開き、文字列をコピーしてください。アプリからではなく、データベースからコピーしてください。

03

貼り付けてください。ホスト、ポート、ユーザー、パスワード、データベースがすべて読み取られ、ホストにはデータベースエンドポイントであることを示す .pg. が含まれているかどうかがチェックされます。

04

Koyebのデフォルト設定(ユーザーはkoyeb-adm、データベースはkoyebdb)は既に入力済みなので、新規サービスの場合は通常パスワードのみが必要です。

05

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

機能の詳細解説

コイエブがあなたに与えるもの

アプリのホスト名はデータベースのホスト名ではありません

KoyebはPostgresも動作するアプリケーションプラットフォームであり、両者はラベルが1つだけ異なる環境で動作しています。これは非常にありがちなミスで、重大なエラーにつながるため、カードがそれをインターセプトします。

  • アプリケーションは.koyeb.appから提供されます。データベースには.pg.koyeb.appからアクセスできます。違いは、真ん中の.pg.です。
  • .koyeb.appで終わるホスト名を貼り付けると、カードはその説明を表示して処理を停止し、タイムアウトするだけの接続を保存できなくなります。
  • タイムアウトは最悪の症状です。ファイアウォールの問題のように見えるため、人々は実際には問題ではなかったネットワークルールを確認しに行ってしまうからです。
  • データベースのホスト名は、ep-<名前>-<ID> の形式に従います。Koyeb 氏の Postgres は Neon ベースであり、この形式は Neon から来ています。

それ以上に、意図的に平凡な

ここに巧妙な仕掛けなどなく、そう装うのは誤解を招くだけだ。このカードの役割は、細部を正確に伝え、余計な装飾をしないことにある。

  • チェックボックスの設定に関わらず、.pg.koyeb.app ホストすべてで TLS が強制的に適用されるため、クリップボードで SSL モードが失われた文字列も暗号化されたまま送信されます。トラフィックは暗号化されますが、証明書チェーンは検証されません。
  • パス上にプーラーは存在しません。一部のサーバーレスPostgresサービスでは、トランザクションモードのプーラーを前面に配置し、それに対応するためにプリペアドステートメントを固定する必要がありますが、Koyebではそうではないため、エージェントは直接接続し、それらの処理をすべてスキップします。
  • koyeb-admとkoyebdbは、新規のKoyebデータベースの初期状態を示すため、あらかじめ入力されています。新規サービスの場合、パスワード以外に何も必要ない場合がほとんどです。
  • 接続はPostgreSQLとして保存され、バッジとしてKoyebが保持されます。Koyebという名前の接続タイプは存在しません。 つまり、以前に.pg.koyeb.appホストに対して行った通常のPostgres接続でも、すぐにブランドが認識されるということです。
-- 通常の 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;

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

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

  • 発信専用 エージェントは、クエリ ストリームへの暗号化された接続を 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

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

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

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

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

一つの声明

-- コピーなし、マージなし、スケジュールなし
セレクト   c.region、COUNT(*) AS orders、SUM(i.amount_due) AS invoiced
フロム     koyeb_app公共命令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つのソースが渡せるデータ量には上限があります。 フェデレーションクエリの仕組み

接続の詳細

コイエブが必要としているもの

ホスト
ep-<name>-<id>.<region>.pg.koyeb.app — .pg. に注目してください。これはアプリではなくデータベースであることを示しています。
ポート
5432
ドライバ
エージェントによって提供されるNpgsql - Koyeb側では何もインストールする必要はありません
データベース
koyebdb は新しいサービスで、このように事前入力されています
ユーザー名
koyeb-adm は新しいサービスで、このように事前入力されています
TLS
必須であり、エージェントによってすべての .pg.koyeb.app ホストに強制されます。暗号化されていますが、証明書チェーンは検証されていません。
プーリング
なし — Koyeb はプールされたエンドポイントを必要としないため、エージェントは直接接続します
接続タイムアウト
30秒、1回のみ
保存先
PostgreSQLでは、Koyebはバッジとして保持されていますが、Koyebという名前の接続タイプは存在しません。
デフォルトスキーマ
連邦参照が持つパブリックなもの

検証ツールの一つにこのカードがあり、脚注ではなくセクションとして説明する価値がある理由があります。ほとんどの接続エラーは自明です。パスワードが間違っていれば認証エラー、データベース名が間違っていればデータベースが存在しないことを示します。しかし、Postgresクライアントをアプリケーションのホスト名に向けると、そのようなエラーは発生しません。タイムアウトが発生します。なぜなら、相手側には実際のホストが存在し、Postgresからのリクエストを待機していないからです。タイムアウトはネットワークの問題と解釈されるため、人々はファイアウォールルールを確認したり、プラットフォームチームにエグレスについて問い合わせたりして、ホスト名に.pg.が欠けているというだけで午後を無駄にしてしまいます。貼り付けの段階でエラーを検出できれば、たった2行のコードで済む以上の価値があります。

このコネクタに関するその他の点は、正直言って特筆すべきことはなく、ページにもその旨が明記されているだけで、誇張された説明は一切ありません。Koyeb PostgresはNeonベースで、エージェントは強制TLS経由でNpgsqlを使用して通信し、プーラーは不要です。これが全てであり、長くて美化された話よりも、簡潔な真実の方がはるかに優れています。

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

ベンダー資料: www.koyeb.com

よくある質問

コイエブに関する質問

クエリ ストリームを介して Koyeb のデータを読み取ることができるツールはどれですか?

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

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

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

クエリ ストリームは Koyeb のデータを変更できますか?

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

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

到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバを運ぶため、データベースには何もインストールされません。 ホスト: ep-<name>-<id>.<region>.pg.koyeb.app - .pg. に注意してください。これは、アプリケーションではなくデータベースであることを示しています。 ポート: 5432。 ドライバ: Npgsql、エージェントによって運ばれます - Koyeb 側でインストールするものはありません。 データベース: 新しいサービス上の koyebdb、そのように事前入力されています。

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

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

Koyebへの接続はPostgreSQLへの接続と異なりますか?

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

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

はい、これはPostgreSQLのガイドであり、Koyebにもそのまま適用できます。KoyebはPostgreSQLのワイヤプロトコルを使用するため、KoyebからExcel、KoyebからGoogleスプレッドシート、その他のすべての宛先への接続手順は同じです。Koyeb固有の部分は接続文字列のみですが、Koyebカードが自動的に入力してくれます。

コイエブを仕事が行われる場所に配置する

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

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