データベース連携

Guida は、ワークスペース内のローカルストアに加えて、外部データベースやオブジェクトストレージへデータを書き込めます。抽出結果を既存のデータパイプラインへ渡したい場合に使います。

対応先

連携	名前空間	用途
PostgreSQL	`g.postgres.*`	SQL クエリ、バッチ更新、テーブル調査
MongoDB	`g.mongodb.*`	コレクション検索、挿入、更新、集計
S3 互換ストレージ	`g.s3.*`	オブジェクト保存、取得、署名付き URL
Elasticsearch	`g.elasticsearch.*`	高速検索、bulk 登録、Query DSL

例

await g.postgres.execute("warehouse", {
  sql: "insert into pages(url, html_length) values($1, $2)",
  parameters: [await g.page.getUrl(), (await g.page.getDom()).length],
});

await g.s3.putObjectText("archive", {
  bucket: "captures",
  key: "example.html",
  content: await g.page.getDom(),
});

認証情報

接続情報は認証情報に保存します。スクリプトに API キーや接続文字列を直接書かないでください。

MCP 由来スクリプトからは、復号済み認証情報へつながる経路が制限されます。AI エージェントに外部データベースアクセスを渡す必要がある場合は、専用のカスタムツールを設計し、承認と監査ログを前提にしてください。