Skip to content

Conversation

@Blargian
Copy link
Member

@Blargian Blargian commented Mar 20, 2025

Summary

Adds global settings to settings autogeneration script.

Code: 107. DB::Exception: File /opt/clickhouse-docs/scripts/tmp/_server_settings_outside_source.md doesn't exist. (FILE_DOESNT_EXIST)

We will need to merge ClickHouse/ClickHouse#78012 first

Checklist

@Blargian Blargian requested a review from a team as a code owner March 20, 2025 15:23
@vercel
Copy link

vercel bot commented Mar 20, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

2 Skipped Deployments
Name Status Preview Comments Updated (UTC)
clickhouse-docs-ru ⬜️ Ignored (Inspect) Visit Preview Mar 26, 2025 11:25am
clickhouse-docs-zh ⬜️ Ignored (Inspect) Visit Preview Mar 26, 2025 11:25am

@vercel
Copy link

vercel bot commented Mar 20, 2025

@Blargian is attempting to deploy a commit to the ClickHouse Team on Vercel.

A member of the Team first needs to authorize it.


./clickhouse -q "
WITH
settings_outside_source AS
Copy link
Member

Choose a reason for hiding this comment

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

To avoid confusion, could you name the scalar variable settings_outside_source perhaps server_settings_outside_source?

replaceRegexpAll(replaceRegexpAll(g[2], '\n(Type|Default( value)?): [^\n]+\n', ''), '^\n+|\n+$', '') AS doc
FROM file('_server_settings_outside_source.md', RawBLOB)
),
settings_in_source AS
Copy link
Member

Choose a reason for hiding this comment

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

settings_in_source --> server_settings_in_source

replaceRegexpAll(description, '(?m)^[ \t]+', '') AS description
FROM system.server_settings
),
combined_settings AS
Copy link
Member

Choose a reason for hiding this comment

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

combined_server_settings

(
SELECT
'---
description: ''This section contains descriptions of server settings that cannot be
Copy link
Member

Choose a reason for hiding this comment

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

L. 162/163 sound like there are also server settings which can be changed at the session or query level. Maybe [...], i.e. settings which cannot be changed at the session or query level?

description: ''This section contains descriptions of server settings that cannot be
changed at the session or query level.''
keywords: [''global server settings'']
sidebar_label: ''Global Server Settings''
Copy link
Member

Choose a reason for hiding this comment

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

Maybe just Server Settings?

# Global Server Settings
This section contains descriptions of server settings that cannot be changed at
Copy link
Member

Choose a reason for hiding this comment

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

The same ambiguity here too.

# Global Server Settings
This section contains descriptions of server settings that cannot be changed at
the session or query level. These settings are stored in the `config.xml` file
Copy link
Member

Choose a reason for hiding this comment

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

The 2nd sentence is slightly incorrect: a) the cfg file can be named different than config.xml (as long as it is an xml or json file), b) it is technically not stored "on" the ClickHouse server. It is also not stored "in" the server. I don't really know how to rephrase this. Maybe just omit that sentence.

@Blargian
Copy link
Member Author

Requires ClickHouse/ClickHouse#78282 first

…into autogenerate_global_server_settings
@Blargian Blargian merged commit 250eb65 into ClickHouse:main Mar 26, 2025
7 of 11 checks passed
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.

3 participants