diff --git a/CHANGELOG.md b/CHANGELOG.md index e3fd8e4..3170f26 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -80,6 +80,7 @@ needing to `ALTER EXTENSION UPDATE`. "ClickHouse/pg_chdb#91 Restore `MAX_CONCURRENT_TESTS`, fix macOS" [#96]: https://github.com/ClickHouse/pg_chdb/pull/96 "ClickHouse/pg_chdb#96 Update pg-clickhouse-c & add encoding_check option" + [COPY docs](doc/chdb_hook.md#copy-overloading) "chdb_hook docs: COPY Overloading" [Interval]: https://clickhouse.com/docs/reference/data-types/special-data-types/interval "ClickHouse Docs: Interval" [composite type]: https://www.postgresql.org/docs/current/rowtypes.html diff --git a/META.json b/META.json index 34e4dee..e8ae6a7 100644 --- a/META.json +++ b/META.json @@ -2,7 +2,7 @@ "name": "chdb", "abstract": "Execute queries in chDB.", "description": "Execute queries in chDB.", - "version": "0.1.1", + "version": "0.1.2", "maintainer": "David E. Wheeler ", "license": "apache_2_0", "provides": { @@ -10,13 +10,13 @@ "abstract": "Execute queries in chDB.", "file": "chdb.control", "docfile": "doc/chdb.md", - "version": "0.1.1" + "version": "0.1.2" }, "chdb_hook": { "abstract": "Hook into PostgreSQL commands to execute chDB queries.", "file": "src/hook/hook.c", "docfile": "doc/chdb_hook.md", - "version": "0.1.1" + "version": "0.1.2" } }, "prereqs": { diff --git a/README.md b/README.md index 1332631..7df2955 100644 --- a/README.md +++ b/README.md @@ -79,10 +79,11 @@ After which the `times` table contains the records from each file it loaded: ``` A [CREATE TABLE] may also derive its columns, and load its rows, from such a -URL: +URL (beware: this public data file holds 41m rows): ```sql CREATE TABLE reviews () WITH ( + encoding_check = 'replace', copy_from = 'https://datasets-documentation.s3.eu-west-3.amazonaws.com/amazon_reviews/amazon_reviews_2015.snappy.parquet' ); ``` diff --git a/doc/chdb.md b/doc/chdb.md index 90a807b..5b3ab86 100644 --- a/doc/chdb.md +++ b/doc/chdb.md @@ -1,4 +1,4 @@ -chdb 0.1.1 +chdb 0.1.2 ========== ## Synopsis diff --git a/doc/chdb_hook.md b/doc/chdb_hook.md index 2390422..6f70bfd 100644 --- a/doc/chdb_hook.md +++ b/doc/chdb_hook.md @@ -1,4 +1,4 @@ -chdb_hook 0.1.1 +chdb_hook 0.1.2 =============== ## Synopsis @@ -358,10 +358,12 @@ chdb_hook also hooks into [CREATE TABLE], so that a table can derive its columns, and load its rows, from a URL. To create a table with the structure derived from a URL, pass the URL in the -`structure_from` option and leave the column list empty: +`structure_from` option and leave the column list empty (beware: this public +data file holds 41m rows): ```sql CREATE TABLE reviews () WITH ( + encoding_check = 'replace', structure_from = 's3://datasets-documentation/amazon_reviews/amazon_reviews_2015.snappy.parquet' ); ``` @@ -370,6 +372,7 @@ Use `copy_from` to load the rows as well as the columns: ```sql CREATE TABLE reviews () WITH ( + encoding_check = 'replace', copy_from = 's3://datasets-documentation/amazon_reviews/amazon_reviews_2015.snappy.parquet' ); ``` @@ -631,6 +634,7 @@ Input-compatible types can read strings using their PostgreSQL input function. Composite types must have matching fields in matching order. To read a tuple as an array, each field must convert to the array's element type, and no field can itself be an array. + When read as an array, `Map` uses one row per key-value pair and `Nested` uses one row per nested row. To read a tuple as `box`, provide two points; for `circle`, provide a point and radius; for `line`, provide three coefficients.