Skip to content

docs: add documentation for drop_materialized_column Dagster job#53810

Open
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-04-09T00-19-00-445Z-iph7e6
Open

docs: add documentation for drop_materialized_column Dagster job#53810
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-04-09T00-19-00-445Z-iph7e6

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep bot commented Apr 9, 2026

Changes

This PR updates the internal engineering documentation to include the new drop_materialized_column Dagster job added in #53792.

What's added

  • New section "Dropping materialized columns via Dagster" in docs/published/handbook/engineering/databases/materialized-columns.md
  • EU and US Dagster playground links for the drop_materialized_column job
  • YAML configuration example showing how to use the job
  • Documentation of config options: table, column_names, and dry_run
  • Warning that dropping columns is irreversible

Related PR


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

Documents the new `drop_materialized_column` Dagster job from PR #53792
that allows engineers to drop unused materialized columns from ClickHouse
to reclaim storage space.
@inkeep inkeep bot requested a review from timgl April 9, 2026 00:20
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Docs from this PR will be published at posthog.com

Project Deployment Preview Updated (UTC)
posthog.com 🤷 Unknown Preview Apr 9, 2026, 12:20 AM

Preview will be ready in ~10 minutes. Click Preview link above to access docs at /handbook/engineering/

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Apr 9, 2026

Vulnerabilities

No security concerns identified.

Prompt To Fix All With AI
This is a comment left during a code review.
Path: docs/published/handbook/engineering/databases/materialized-columns.md
Line: 87-89

Comment:
**Inconsistent config-option formatting**

The new section uses `**\`field\`** - Description` (dash separator), while the existing "Manual materialization" section uses `**\`field\`**: Description` (colon separator). Keeping the style consistent makes the page easier to scan.

```suggestion
- **`table`**: The ClickHouse table to drop columns from (`events` or `person`, defaults to `events`)
- **`column_names`**: List of materialized column names to drop
- **`dry_run`**: Set to `true` (default) to preview what would be dropped without making changes
```

How can I resolve this? If you propose a fix, please make it concise.

Reviews (1): Last reviewed commit: "docs: add drop_materialized_column Dagst..." | Re-trigger Greptile

Comment on lines +87 to +89
- **`table`** - The ClickHouse table to drop columns from (`events` or `person`, defaults to `events`)
- **`column_names`** - List of materialized column names to drop
- **`dry_run`** - Set to `true` (default) to preview what would be dropped without making changes
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P2 Inconsistent config-option formatting

The new section uses **\field`** - Description(dash separator), while the existing "Manual materialization" section uses`field`: Description` (colon separator). Keeping the style consistent makes the page easier to scan.

Suggested change
- **`table`** - The ClickHouse table to drop columns from (`events` or `person`, defaults to `events`)
- **`column_names`** - List of materialized column names to drop
- **`dry_run`** - Set to `true` (default) to preview what would be dropped without making changes
- **`table`**: The ClickHouse table to drop columns from (`events` or `person`, defaults to `events`)
- **`column_names`**: List of materialized column names to drop
- **`dry_run`**: Set to `true` (default) to preview what would be dropped without making changes
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/published/handbook/engineering/databases/materialized-columns.md
Line: 87-89

Comment:
**Inconsistent config-option formatting**

The new section uses `**\`field\`** - Description` (dash separator), while the existing "Manual materialization" section uses `**\`field\`**: Description` (colon separator). Keeping the style consistent makes the page easier to scan.

```suggestion
- **`table`**: The ClickHouse table to drop columns from (`events` or `person`, defaults to `events`)
- **`column_names`**: List of materialized column names to drop
- **`dry_run`**: Set to `true` (default) to preview what would be dropped without making changes
```

How can I resolve this? If you propose a fix, please make it concise.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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.

0 participants