add experimental and beta settings

Author: Blargian

.gitignore

@@ -50,6 +50,8 @@ docs/cloud/manage/api/privateEndpointConfig-api-reference.md
 docs/cloud/manage/api/prometheus-api-reference.md
 docs/cloud/manage/api/usageCost-api-reference.md
 docs/whats-new/changelog/index.md
+docs/settings/beta-and-experimental-features.md
+
 .vscode
 .aspell.en.prepl
 *.md.bak

scripts/settings/beta-settings.sql

@@ -0,0 +1,36 @@
+-- First write the header
+SELECT '\n\n## Beta settings {#beta-settings}\n\n| Name | Default |\n|------|--------|'
+INTO OUTFILE 'beta-settings.md' TRUNCATE
+FORMAT TSVRaw;
+
+-- Then append the table content
+WITH
+    experimental_session_settings AS
+        (
+            SELECT
+                format('[{}](/operations/settings/settings#{})', name, name) AS Name,
+                format('`{}`', ifNull(default, ' ')) AS Default
+FROM system.settings
+WHERE tier = 'Beta' AND alias_for=''
+    ),
+    experimental_mergetree_settings AS
+    (
+SELECT
+    format('[{}](/operations/settings/merge-tree-settings#{})', name, name) AS Name,
+    format('`{}`', default) AS Default
+FROM system.merge_tree_settings
+WHERE tier = 'Beta'
+    ),
+    combined AS
+    (
+SELECT *
+FROM experimental_session_settings
+UNION ALL
+SELECT *
+FROM experimental_mergetree_settings
+ORDER BY Name ASC
+    )
+SELECT concat('| ', Name, ' | ', Default, ' |')
+FROM combined
+    INTO OUTFILE 'beta-settings.md' APPEND
+FORMAT TSVRaw;

scripts/settings/experimental-settings.sql

@@ -1,30 +1,36 @@
+-- First write the header
+SELECT '\n\n## Experimental settings {#experimental-settings}\n\n| Name | Default |\n|------|--------|'
+INTO OUTFILE 'experimental-settings.md' TRUNCATE
+FORMAT TSVRaw;
+
+-- Then append the table content
 WITH
     experimental_session_settings AS
         (
             SELECT
                 format('[{}](/operations/settings/settings#{})', name, name) AS Name,
                 format('`{}`', default) AS Default
-            FROM system.settings
-            WHERE tier = 'Experimental'
-        ),
+FROM system.settings
+WHERE tier = 'Experimental' AND alias_for=''
+    ),
     experimental_mergetree_settings AS
-        (
-            SELECT
-                format('[{}](/operations/settings/merge-tree-settings#{})', name, name) AS Name,
-                format('`{}`', default) AS Default
-            FROM system.merge_tree_settings
-            WHERE tier = 'Experimental'
-        ),
+    (
+SELECT
+    format('[{}](/operations/settings/merge-tree-settings#{})', name, name) AS Name,
+    format('`{}`', default) AS Default
+FROM system.merge_tree_settings
+WHERE tier = 'Experimental'
+    ),
     combined AS
-        (
-            SELECT *
-            FROM experimental_session_settings
-            UNION ALL
-            SELECT *
-            FROM experimental_mergetree_settings
-        )
+    (
 SELECT *
-FROM combined
+FROM experimental_session_settings
+UNION ALL
+SELECT *
+FROM experimental_mergetree_settings
 ORDER BY Name ASC
-INTO OUTFILE 'experimental-settings.md' TRUNCATE
-FORMAT markdown
+    )
+SELECT concat('| ', Name, ' | ', Default, ' |')
+FROM combined
+    INTO OUTFILE 'experimental-settings.md' APPEND
+FORMAT TSVRaw;