Merge pull request #4472 from duckdb/auto_update_community_extensions…

…_docs chore: update Community Extensions docs
duckdb · Jan 5, 2025 · d316c27 · d316c27
2 parents 7c41e49 + e5dd708
commit d316c27
Show file tree

Hide file tree

Showing 35 changed files with 124 additions and 79 deletions.
diff --git a/community_extensions/extensions/avro.md b/community_extensions/extensions/avro.md
@@ -30,7 +30,7 @@ docs:
 
 extension_star_count: 18
 extension_star_count_pretty: 18
-extension_download_count: 10353
+extension_download_count: 10365
 extension_download_count_pretty: 10.4k
 image: '/images/community_extensions/social_preview/preview_community_extension_avro.png'
 layout: community_extension_doc

diff --git a/community_extensions/extensions/bigquery.md b/community_extensions/extensions/bigquery.md
@@ -53,8 +53,8 @@ docs:
 
 extension_star_count: 81
 extension_star_count_pretty: 81
-extension_download_count: 503
-extension_download_count_pretty: 503
+extension_download_count: 475
+extension_download_count_pretty: 475
 image: '/images/community_extensions/social_preview/preview_community_extension_bigquery.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/capi_quack.md b/community_extensions/extensions/capi_quack.md
@@ -27,8 +27,8 @@ docs:
 
 extension_star_count: 5
 extension_star_count_pretty: 5
-extension_download_count: 336
-extension_download_count_pretty: 336
+extension_download_count: 348
+extension_download_count_pretty: 348
 image: '/images/community_extensions/social_preview/preview_community_extension_capi_quack.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/chsql.md b/community_extensions/extensions/chsql.md
@@ -8,7 +8,7 @@ excerpt: |
 extension:
   name: chsql
   description: ClickHouse SQL Macros for DuckDB
-  version: 1.0.6
+  version: 1.0.7
   language: SQL & C++
   build: cmake
   license: MIT
@@ -18,21 +18,20 @@ extension:
 
 repo:
   github: quackscience/duckdb-extension-clickhouse-sql
-  ref: 9ab2e8118dbb9e429fa8d2a9026ad019f5bf7706
+  ref: 16bcb5b0fda0ccca22f42695295f9bb4171190fb
 
 docs:
   hello_world: |
     -- Use boring ClickHouse SQL function macros in DuckDB SQL queries. Examples:
-    SELECT toString('world') AS hello, toInt8OrZero('world') AS zero;
-
+    D SELECT toString('world') AS hello, toInt8OrZero('world') AS zero;
     ┌─────────┬───────┐
     │  hello  │ zero  │
     │ varchar │ int64 │
     ├─────────┼───────┤
     │ world   │     0 │
     └─────────┴───────┘
 
-    SELECT IPv4NumToString(167772161), IPv4StringToNum('10.0.0.1');
+    D SELECT IPv4NumToString(167772161), IPv4StringToNum('10.0.0.1');
     ┌────────────────────────────┬─────────────────────────────┐
     │ ipv4numtostring(167772161) │ ipv4stringtonum('10.0.0.1') │
     │          varchar           │            int32            │
@@ -41,7 +40,7 @@ docs:
     └────────────────────────────┴─────────────────────────────┘
 
     -- Query a remote ClickHouse instance via HTTP/S API using multiple formats
-    SELECT * FROM ch_scan("SELECT number * 100 FROM numbers(3)","https://play.clickhouse.com", format := 'Parquet');
+    D SELECT * FROM ch_scan("SELECT number * 100 FROM numbers(3)","https://play.clickhouse.com", format := 'Parquet');
     ┌───────────────────────┐
     │ multiply(number, 100) │
     │        varchar        │
@@ -51,14 +50,53 @@ docs:
     │ 200                   │
     └───────────────────────┘
 
+    -- Query the emulated system tables to explore columns, rows, types, storage, etc
+    D SELECT * FROM system.tables;
+    D SELECT * FROM system.columns;
+    D SELECT * FROM system.functions;
+    D SELECT * FROM system.uptime;
+    D SELECT * FROM system.disks;
+    ┌──────────┬──────────────┬────────────┬─────────────┬──────────────────┬─────────────────┬─────────┬─────────────────────┬───────────────┬──────────────┬──────────────┬───────────────┬───────────┬───────────┬────────────┐
+    │   name   │     path     │ free_space │ total_space │ unreserved_space │ keep_free_space │  type   │ object_storage_type │ metadata_type │ is_encrypted │ is_read_only │ is_write_once │ is_remote │ is_broken │ cache_path │
+    │ varchar  │   varchar    │   int64    │    int64    │      int64       │      int64      │ varchar │       varchar       │    varchar    │   boolean    │   boolean    │    boolean    │  boolean  │  boolean  │  varchar   │
+    ├──────────┼──────────────┼────────────┼─────────────┼──────────────────┼─────────────────┼─────────┼─────────────────────┼───────────────┼──────────────┼──────────────┼───────────────┼───────────┼───────────┼────────────┤
+    │ localdb  │ test.db      │          0 │      262144 │                0 │               0 │ Local   │ None                │ None          │ false        │ false        │ false         │ false     │ false     │            │
+    │ memory   │ NULL         │          0 │           0 │                0 │               0 │ Local   │ None                │ None          │ false        │ false        │ false         │ false     │ false     │            │
+    │ testduck │ /tmp/duck.db │     262144 │      786432 │           262144 │               0 │ Local   │ None                │ None          │ false        │ false        │ false         │ false     │ false     │            │
+    └──────────┴──────────────┴────────────┴─────────────┴──────────────────┴─────────────────┴─────────┴─────────────────────┴───────────────┴──────────────┴──────────────┴───────────────┴───────────┴───────────┴────────────┘
     
   extended_description: |
-    This extension implements a growing number of [ClickHouse SQL Macros](https://duckdb.org/community_extensions/extensions/chsql#added-functions) and functions for DuckDB.
+  
+    ## DuckDB ClickHouse SQL extension    
+    The DuckDB chsql community extension implements 100+ popular [ClickHouse SQL Macros](https://duckdb.org/community_extensions/extensions/chsql#added-functions), functions and helpers making it easier for users to transition between OLAP systems ⭐ 
+  
+    ### Motivation
+    DuckDB is our favourite OLAP engine but ClickHouse has lots of integrations and users. This extension is dedicated to ClickHouse refugeess.
+
+    ```
+    ✔ DuckDB SQL is awesome and full of great functions.<br>
+    ✔ ClickHouse SQL is awesome and full of great functions.
+    
+    ✔ The DuckDB library is ~51M and modular. Can LOAD extensions.<br>
+    ❌ The ClickHouse monolith is ~551M and growing. No extensions.
+    
+    ✔ DuckDB is open source and protected by a no-profit foundation.<br>
+    ❌ ClickHouse is open core and controlled by for-profit corporation.
+    
+    ✔ DuckDB embedded is fast, mature and elegantly integrated in many languages.<br>
+    ❌ chdb is still experimental, unstable and currently only supports Python.
+    ``` 
+
+    ### Extensions
+    - [chsql_native](https://duckdb.org/community_extensions/extensions/chsql_native) provides a native clickhouse client (binary) and a reader for ClickHouse Native format files
+
+    #### Legal Disclaimer
+    > DuckDB ® is a trademark of DuckDB Foundation. ClickHouse® is a trademark of ClickHouse Inc. All trademarks, service marks, and logos mentioned or depicted are the property of their respective owners. The use of any third-party trademarks, brand names, product names, and company names is purely informative or intended as parody and does not imply endorsement, affiliation, or association with the respective owners.
 
 extension_star_count: 43
 extension_star_count_pretty: 43
-extension_download_count: 355
-extension_download_count_pretty: 355
+extension_download_count: 361
+extension_download_count_pretty: 361
 image: '/images/community_extensions/social_preview/preview_community_extension_chsql.png'
 layout: community_extension_doc
 ---
@@ -192,7 +230,14 @@ LOAD {{ page.extension.name }};
 | toUInt16OrNull         | macro         | Converts to an unsigned 16-bit integer or returns NULL on failure                            |                                               | SELECT toUInt16OrNull('abc');                                                                        |
 | toUInt8                | macro         | Converts a value to an unsigned 8-bit integer                                                |                                               | SELECT toUInt8('123');                                                                               |
 | JSONExtractString      | macro         | Extracts JSON data as a VARCHAR from a JSON object                                           |                                               | SELECT JSONExtractString(json_column, 'user.email');                                                 |
+| system_columns         | table         |                                                                                              |                                               |                                                                                                      |
 | chsql_openssl_version  | scalar        |                                                                                              |                                               |                                                                                                      |
+| system_functions       | table         |                                                                                              |                                               |                                                                                                      |
+| uptime                 | scalar        |                                                                                              |                                               |                                                                                                      |
+| url_flock              | table         |                                                                                              |                                               |                                                                                                      |
+| system_disks           | table         |                                                                                              |                                               |                                                                                                      |
+| system_tables          | table         |                                                                                              |                                               |                                                                                                      |
 | chsql                  | scalar        |                                                                                              |                                               |                                                                                                      |
+| system_databases       | table         |                                                                                              |                                               |                                                                                                      |
 
 
diff --git a/community_extensions/extensions/chsql_native.md b/community_extensions/extensions/chsql_native.md
@@ -104,8 +104,8 @@ docs:
 
 extension_star_count: 4
 extension_star_count_pretty: 4
-extension_download_count: 319
-extension_download_count_pretty: 319
+extension_download_count: 335
+extension_download_count_pretty: 335
 image: '/images/community_extensions/social_preview/preview_community_extension_chsql_native.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/cronjob.md b/community_extensions/extensions/cronjob.md
@@ -59,8 +59,8 @@ docs:
 
 extension_star_count: 26
 extension_star_count_pretty: 26
-extension_download_count: 349
-extension_download_count_pretty: 349
+extension_download_count: 367
+extension_download_count_pretty: 367
 image: '/images/community_extensions/social_preview/preview_community_extension_cronjob.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/crypto.md b/community_extensions/extensions/crypto.md
@@ -64,8 +64,8 @@ repo:
 
 extension_star_count: 11
 extension_star_count_pretty: 11
-extension_download_count: 358
-extension_download_count_pretty: 358
+extension_download_count: 370
+extension_download_count_pretty: 370
 image: '/images/community_extensions/social_preview/preview_community_extension_crypto.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/datasketches.md b/community_extensions/extensions/datasketches.md
@@ -85,8 +85,8 @@ repo:
 
 extension_star_count: 8
 extension_star_count_pretty: 8
-extension_download_count: 113
-extension_download_count_pretty: 113
+extension_download_count: 172
+extension_download_count_pretty: 172
 image: '/images/community_extensions/social_preview/preview_community_extension_datasketches.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/duckpgq.md b/community_extensions/extensions/duckpgq.md
@@ -62,7 +62,7 @@ docs:
 
 extension_star_count: 99
 extension_star_count_pretty: 99
-extension_download_count: 2378
+extension_download_count: 2371
 extension_download_count_pretty: 2.4k
 image: '/images/community_extensions/social_preview/preview_community_extension_duckpgq.png'
 layout: community_extension_doc

diff --git a/community_extensions/extensions/evalexpr_rhai.md b/community_extensions/extensions/evalexpr_rhai.md
@@ -96,8 +96,8 @@ repo:
 
 extension_star_count: 14
 extension_star_count_pretty: 14
-extension_download_count: 358
-extension_download_count_pretty: 358
+extension_download_count: 371
+extension_download_count_pretty: 371
 image: '/images/community_extensions/social_preview/preview_community_extension_evalexpr_rhai.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/faiss.md b/community_extensions/extensions/faiss.md
@@ -44,8 +44,8 @@ docs:
 
 extension_star_count: 8
 extension_star_count_pretty: 8
-extension_download_count: 338
-extension_download_count_pretty: 338
+extension_download_count: 348
+extension_download_count_pretty: 348
 image: '/images/community_extensions/social_preview/preview_community_extension_faiss.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/flockmtl.md b/community_extensions/extensions/flockmtl.md
@@ -55,8 +55,8 @@ docs:
 
 extension_star_count: 89
 extension_star_count_pretty: 89
-extension_download_count: 346
-extension_download_count_pretty: 346
+extension_download_count: 353
+extension_download_count_pretty: 353
 image: '/images/community_extensions/social_preview/preview_community_extension_flockmtl.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/fuzzycomplete.md b/community_extensions/extensions/fuzzycomplete.md
@@ -184,8 +184,8 @@ repo:
 
 extension_star_count: 8
 extension_star_count_pretty: 8
-extension_download_count: 345
-extension_download_count_pretty: 345
+extension_download_count: 348
+extension_download_count_pretty: 348
 image: '/images/community_extensions/social_preview/preview_community_extension_fuzzycomplete.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/gsheets.md b/community_extensions/extensions/gsheets.md
@@ -65,8 +65,8 @@ docs:
 
 extension_star_count: 198
 extension_star_count_pretty: 198
-extension_download_count: 442
-extension_download_count_pretty: 442
+extension_download_count: 595
+extension_download_count_pretty: 595
 image: '/images/community_extensions/social_preview/preview_community_extension_gsheets.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/h3.md b/community_extensions/extensions/h3.md
@@ -28,8 +28,8 @@ docs:
 
 extension_star_count: 176
 extension_star_count_pretty: 176
-extension_download_count: 5850
-extension_download_count_pretty: 5.8k
+extension_download_count: 4861
+extension_download_count_pretty: 4.9k
 image: '/images/community_extensions/social_preview/preview_community_extension_h3.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/hostfs.md b/community_extensions/extensions/hostfs.md
@@ -60,8 +60,8 @@ docs:
     For more information, please see the [HostFS documentation](https://github.com/gropaul/hostFS).
 extension_star_count: 11
 extension_star_count_pretty: 11
-extension_download_count: 343
-extension_download_count_pretty: 343
+extension_download_count: 359
+extension_download_count_pretty: 359
 image: '/images/community_extensions/social_preview/preview_community_extension_hostfs.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/http_client.md b/community_extensions/extensions/http_client.md
@@ -97,10 +97,10 @@ docs:
   extended_description: |
     The HTTP Client Extension is experimental, use at your own risk!
 
-extension_star_count: 44
-extension_star_count_pretty: 44
-extension_download_count: 606
-extension_download_count_pretty: 606
+extension_star_count: 45
+extension_star_count_pretty: 45
+extension_download_count: 657
+extension_download_count_pretty: 657
 image: '/images/community_extensions/social_preview/preview_community_extension_http_client.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/httpserver.md b/community_extensions/extensions/httpserver.md
@@ -61,8 +61,8 @@ docs:
 
 extension_star_count: 139
 extension_star_count_pretty: 139
-extension_download_count: 365
-extension_download_count_pretty: 365
+extension_download_count: 373
+extension_download_count_pretty: 373
 image: '/images/community_extensions/social_preview/preview_community_extension_httpserver.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/lindel.md b/community_extensions/extensions/lindel.md
@@ -119,8 +119,8 @@ repo:
 
 extension_star_count: 37
 extension_star_count_pretty: 37
-extension_download_count: 354
-extension_download_count_pretty: 354
+extension_download_count: 369
+extension_download_count_pretty: 369
 image: '/images/community_extensions/social_preview/preview_community_extension_lindel.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/magic.md b/community_extensions/extensions/magic.md
@@ -40,8 +40,8 @@ docs:
 
 extension_star_count: 4
 extension_star_count_pretty: 4
-extension_download_count: 354
-extension_download_count_pretty: 354
+extension_download_count: 392
+extension_download_count_pretty: 392
 image: '/images/community_extensions/social_preview/preview_community_extension_magic.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/open_prompt.md b/community_extensions/extensions/open_prompt.md
@@ -63,10 +63,10 @@ docs:
   extended_description: |      
     For examples and instructions check out the `open_prompt` [README](https://github.com/quackscience/duckdb-extension-openprompt)
 
-extension_star_count: 28
-extension_star_count_pretty: 28
-extension_download_count: 350
-extension_download_count_pretty: 350
+extension_star_count: 29
+extension_star_count_pretty: 29
+extension_download_count: 360
+extension_download_count_pretty: 360
 image: '/images/community_extensions/social_preview/preview_community_extension_open_prompt.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/pcap_reader.md b/community_extensions/extensions/pcap_reader.md
@@ -42,8 +42,8 @@ docs:
 
 extension_star_count: 8
 extension_star_count_pretty: 8
-extension_download_count: 321
-extension_download_count_pretty: 321
+extension_download_count: 336
+extension_download_count_pretty: 336
 image: '/images/community_extensions/social_preview/preview_community_extension_pcap_reader.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/pivot_table.md b/community_extensions/extensions/pivot_table.md
@@ -27,8 +27,8 @@ docs:
 
 extension_star_count: 8
 extension_star_count_pretty: 8
-extension_download_count: 520
-extension_download_count_pretty: 520
+extension_download_count: 477
+extension_download_count_pretty: 477
 image: '/images/community_extensions/social_preview/preview_community_extension_pivot_table.png'
 layout: community_extension_doc
 ---

diff --git a/community_extensions/extensions/prql.md b/community_extensions/extensions/prql.md
@@ -51,8 +51,8 @@ docs:
 
 extension_star_count: 269
 extension_star_count_pretty: 269
-extension_download_count: 350
-extension_download_count_pretty: 350
+extension_download_count: 358
+extension_download_count_pretty: 358
 image: '/images/community_extensions/social_preview/preview_community_extension_prql.png'
 layout: community_extension_doc
 ---