데이터베이스 통합

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 에이전트에 외부 데이터베이스 접근을 넘겨야 한다면 전용 사용자 지정 도구를 설계하고 승인과 감사 로그를 전제로 하세요.