Skip to content

docs(influxdb3-enterprise): rename PachaTree partitions to shards#7189

Open
alamb wants to merge 1 commit into
masterfrom
docs/rename-partition-to-shard-3491
Open

docs(influxdb3-enterprise): rename PachaTree partitions to shards#7189
alamb wants to merge 1 commit into
masterfrom
docs/rename-partition-to-shard-3491

Conversation

@alamb
Copy link
Copy Markdown
Contributor

@alamb alamb commented May 7, 2026

Summary

  • Part of influxdata/influxdb_pro#3404
  • Closes influxdata/influxdb_pro#3491

We are updating the term "partition" to "shard" so we should also update the customer facing flags

  • Update Enterprise performance preview compactor docs to use the new --pt-shard-count flag
  • Update Enterprise performance preview monitoring docs to describe WAL shards and shard system-table fields

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

Vale Style Check Results

Metric Count
Errors 0
Warnings 0
Suggestions 2

Check passed

@alamb alamb force-pushed the docs/rename-partition-to-shard-3491 branch from fb99008 to b97c605 Compare May 7, 2026 13:54
|:------------|:-------------|:------------|:---------|:---------|:---------|:----------|:-----------|
| wal_001 | p_1 | db_1 | t_1 | 2024-01-01T00:00:00Z | 2024-01-01T00:10:00Z | 50000 | 2456789 |
| wal_002 | p_1 | db_1 | t_1 | 2024-01-01T00:10:00Z | 2024-01-01T00:20:00Z | 48000 | 2345678 |
| wal_file_id | shard_start_time | shard_duration_seconds | min_time | max_time | row_count | size_bytes |
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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


- **WAL accumulation**: Track the number and size of unmerged WAL files
- **Partition distribution**: See how data is distributed across partitions
- **Shard distribution**: See how data is distributed across shards
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I think @pauldix mentioned that the WAL is no longer partitioned/sharded. Maybe we should rename these fields 🤔

@alamb alamb force-pushed the docs/rename-partition-to-shard-3491 branch from b97c605 to 51effe7 Compare May 7, 2026 14:00
| Option | Description | Default |
|:-------|:------------|:--------|
| `--pt-partition-count` | Target number of partitions per compaction window. | `1` |
| `--pt-shard-count` | Target number of shards per compaction window. | `1` |
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@alamb alamb marked this pull request as ready for review May 7, 2026 14:05
@alamb alamb requested a review from a team as a code owner May 7, 2026 14:05
@alamb alamb requested review from jstirnaman and removed request for a team May 7, 2026 14:05
@alamb
Copy link
Copy Markdown
Contributor Author

alamb commented May 7, 2026

FYI this relates to a code change that will first appear in the 3.10 release (not sure how the docs are versioned)

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

PR Preview Action v1.4.8
🚀 Deployed preview to https://influxdata.github.io/docs-v2/pr-preview/pr-7189/
on branch gh-pages at 2026-05-07 14:07 UTC

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

📦 PR Preview — Preview Bot

Status Details
Result ✅ DEPLOYED
Preview View preview
Pages 2 page(s) deployed
Build time 67s
Last updated 2026-05-07 14:07:56 UTC
Pages included in this preview
  • /influxdb3/enterprise/performance-preview/configure/
  • /influxdb3/enterprise/performance-preview/monitor/

Preview auto-deploys on push. Will be cleaned up when PR closes.

@jstirnaman jstirnaman requested a review from peterbarnett03 May 7, 2026 17:58
@jstirnaman jstirnaman added release:pending Waiting for product release before merging product:v3-monolith InfluxDB 3 Core and Enterprise (single-node / clusterable) labels May 7, 2026
@jstirnaman jstirnaman added this to the influxdbv3.10 milestone May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:v3-monolith InfluxDB 3 Core and Enterprise (single-node / clusterable) release:pending Waiting for product release before merging

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants