Skip to content

docs: update influxdb append mode behavior#2455

Open
v0y4g3r wants to merge 1 commit intomainfrom
docs/influxdb-append-mode
Open

docs: update influxdb append mode behavior#2455
v0y4g3r wants to merge 1 commit intomainfrom
docs/influxdb-append-mode

Conversation

@v0y4g3r
Copy link
Copy Markdown
Contributor

@v0y4g3r v0y4g3r commented May 6, 2026

What's Changed in this PR

Closes #2454

Checklist

  • Please confirm that all corresponding versions of the documents have been revised.
  • Please ensure that the content in sidebars.ts matches the current document structure when you changed the document structure.
  • This change requires follow-up update in localized docs.

Signed-off-by: Lei, HUANG <mrsatangel@gmail.com>
Copilot AI review requested due to automatic review settings May 6, 2026 07:05
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates GreptimeDB documentation to reflect the InfluxDB line protocol “append mode” behavior and how HTTP hints affect auto-created tables, including the interaction between append_mode and merge_mode.

Changes:

  • Documented per-header HTTP hint format (x-greptime-hint-<key>) in the HTTP API docs (EN/ZH).
  • Added/updated InfluxDB line protocol docs to explain how explicitly setting append_mode=true impacts auto-created tables (EN/ZH).
  • Refined the performance-tuning guidance around merge modes vs append-only behavior (EN/ZH).

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
i18n/zh/docusaurus-plugin-content-docs/current/user-guide/protocols/http.md Adds per-header hint format and updates append/merge mode hint descriptions (ZH).
i18n/zh/docusaurus-plugin-content-docs/current/user-guide/ingest-data/for-iot/influxdb-line-protocol.md Documents append_mode hint behavior for InfluxDB auto-created tables (ZH).
i18n/zh/docusaurus-plugin-content-docs/current/user-guide/deployments-administration/performance-tuning/design-table.md Updates append-only vs merge-mode explanation in performance tuning section (ZH).
docs/user-guide/protocols/http.md Adds per-header hint format and updates append/merge mode hint descriptions (EN).
docs/user-guide/ingest-data/for-iot/influxdb-line-protocol.md Documents append_mode hint behavior for InfluxDB auto-created tables (EN).
docs/user-guide/deployments-administration/performance-tuning/design-table.md Updates append-only vs merge-mode explanation in performance tuning section (EN).
Comments suppressed due to low confidence (1)

docs/user-guide/ingest-data/for-iot/influxdb-line-protocol.md:170

  • The list formatting breaks at the “In InfluxDB…” bullet: the continuation lines for the GreptimeDB explanation aren’t indented, so they render as a separate paragraph instead of part of the same list item. Indent the continuation lines under the bullet to keep the list structure consistent.
- In InfluxDB, a point represents a single data record with a measurement, tag set, field set, and a timestamp.
In GreptimeDB, it is represented as a row of data in the time-series table,
where the table name aligns with the measurement,
and the columns are divided into three types: Tag, Field, and Timestamp.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/user-guide/protocols/http.md
Comment thread docs/user-guide/ingest-data/for-iot/influxdb-line-protocol.md
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying greptime-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6840ee4
Status: ✅  Deploy successful!
Preview URL: https://f4ed18ac.greptime-docs.pages.dev
Branch Preview URL: https://docs-influxdb-append-mode.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

Development

Successfully merging this pull request may close these issues.

Update docs for feat(operator): allow last_row merge mode with append mode

3 participants