From fa4ab93f21f3566633de8f94cd35b6c9284bd732 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Mon, 1 May 2023 14:06:50 -0400
Subject: [PATCH] add dynamic and nested dynamic

---
 .../mergetree-family/mergetree.md             | 43 +++++++++++++++++--
 1 file changed, 39 insertions(+), 4 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index a1e6fb90af2..12da62a147c 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -736,7 +736,7 @@ Disks, volumes and storage policies should be declared inside the `<storage_conf
 :::tip
 Disks can also be declared in the `SETTINGS` section of a query.  This is useful
 for adhoc analysis to temporarily attach a disk that is, for example, hosted at a URL.
-See [nested dynamic storage](#nested-dynamic-storage) for more details.
+See [dynamic storage](#dynamic-storage) for more details.
 :::
 
 Configuration structure:
@@ -882,11 +882,46 @@ You could change storage policy after table creation with [ALTER TABLE ... MODIF
 
 The number of threads performing background moves of data parts can be changed by [background_move_pool_size](/docs/en/operations/server-configuration-parameters/settings.md/#background_move_pool_size) setting.
 
+### Dynamic Storage
+
+This example query shows how to attach a table stored at a URL and configure the
+remote storage within the query. The web storage is not configured in the ClickHouse
+configuration files; all the settings are in the ATTACH query.
+
+```sql
+ATTACH TABLE uk_price_paid UUID 'cf712b4f-2ca8-435c-ac23-c4393efe52f7'
+(
+    price UInt32,
+    date Date,
+    postcode1 LowCardinality(String),
+    postcode2 LowCardinality(String),
+    type Enum8('other' = 0, 'terraced' = 1, 'semi-detached' = 2, 'detached' = 3, 'flat' = 4),
+    is_new UInt8,
+    duration Enum8('unknown' = 0, 'freehold' = 1, 'leasehold' = 2),
+    addr1 String,
+    addr2 String,
+    street LowCardinality(String),
+    locality LowCardinality(String),
+    town LowCardinality(String),
+    district LowCardinality(String),
+    county LowCardinality(String)
+)
+ENGINE = MergeTree
+ORDER BY (postcode1, postcode2, addr1, addr2)
+  # highlight-start
+  SETTINGS disk = disk(
+      type=web,
+      endpoint='https://raw.githubusercontent.com/ClickHouse/web-tables-demo/main/web/'
+      );
+  # highlight-end
+```
+
 ### Nested Dynamic Storage
 
-This example query shows how to use a local disk for to cache data from a table stored
-at a URL.  Neither the cache disk nor the web storage is configured in the ClickHouse
-configuration files; both are configured in the ATTACH query settings.
+This example query builds on the above dynamic disk configuration and shows how to
+use a local disk to cache data from a table stored at a URL. Neither the cache disk
+nor the web storage is configured in the ClickHouse configuration files; both are
+configured in the ATTACH query settings.
 
 In the settings highlighted below notice that the disk of `type=web` is nested within 
 the disk of `type=cache`.