Skip to content

docs: document PostgreSQL COPY FROM STDIN ingestion - #3055

Draft
sunng87 wants to merge 3 commits into
mainfrom
docs/postgres-copy-in
Draft

sunng87 wants to merge 3 commits into
mainfrom
docs/postgres-copy-in

Conversation

@sunng87

@sunng87 sunng87 commented Nov 18, 2026 •

Copy link
Copy Markdown
Member

What changed

Add a PostgreSQL COPY FROM STDIN guide and link it from the PostgreSQL overview and Protocols sidebar. The guide compares payloads, COPY targets, and table-creation requirements for CSV, JSONL, InfluxDB line protocol, Arrow IPC, OTLP, and Prometheus Remote Write. It explains why to use COPY on database-only connections, with a measured throughput comparison and a link to PostgreSQL's extensible COPY proposal. Each format lists its supported WITH options, including the HTTP header or query parameter equivalents and OTLP signal restrictions. A runnable Psycopg 3 example shows how to send encoded records and finish the copy.

Implementation references: GreptimeTeam/greptimedb#9297, GreptimeTeam/greptimedb#9982, GreptimeTeam/greptimedb#10050, GreptimeTeam/greptimedb#10092, GreptimeTeam/greptimedb#10449, GreptimeTeam/greptimedb#10470, GreptimeTeam/greptimedb#10450. Publish this draft after the JSONL implementation (GreptimeTeam/greptimedb#10109) lands. The JSONL guide describes the behavior verified against that PR and its integration tests at d99cd1b324. No assumptions are made about its memory-accounting follow-up (GreptimeTeam/greptimedb#10493).

Scope

  • Documentation versions: Nightly only; no release backport.
  • Languages: English and Chinese.

Verification

  • DOC_LANG=en pnpm check:links and DOC_LANG=zh pnpm check:links passed (strict builds for both locales). Checked the rendered sidebar and overview links.
  • Compared both locales' option names with the five COPY format parsers on GreptimeDB main at 9cf76e20ad. Confirmed all example code blocks match across locales.
  • Smoke-tested ingestion and readback for the five merged formats on a local standalone instance. The standalone Psycopg 3 example reported COPY 2 and stored both expected room temperatures.
  • git diff --cached --check passed. pnpm test: 59 passed. pnpm typecheck reports an unrelated JSX Redirect type error in the unchanged src/theme/Root/index.tsx:21.

Checklist

  • I verified the content against the applicable GreptimeDB version.
  • I updated the relevant documentation versions and languages, or explained why not.
  • I checked changed links and anchors.
  • I updated navigation when the document structure changed.
  • Release upgrade review is not applicable: no version cut, stable promotion, or feature backport.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

Deploying greptime-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: ecdbe30
Status: ✅  Deploy successful!
Preview URL: https://203fe2fc.greptime-docs.pages.dev
Branch Preview URL: https://docs-postgres-copy-in.greptime-docs.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant