Commit Graph

81 Commits

Author SHA1 Message Date
Denny Crane
95b701a37c
Update table.md 2023-02-24 13:17:30 -04:00
Denny Crane
9974f45ab0
Update table.md 2023-02-24 13:15:35 -04:00
Dan Roscigno
9ada816d5a
Update table.md 2023-01-31 10:59:08 -05:00
Robert Schulze
574cab5d7e
Remove transitory parameter 2023-01-24 11:05:29 +00:00
Robert Schulze
aaf7653108
Merge remote-tracking branch 'origin/master' into block-non-float-gorilla-v2 2023-01-24 10:14:10 +00:00
Robert Schulze
e6167d6b36
Deprecate Gorilla compression of non-float columns
Reasons:

1. The original Gorilla paper proposed a compression schema for pairs of
   time stamps and double-precision FP values. ClickHouse's Gorilla
   codec only implements compression of the latter and it does not
   impose any data type restrictions.
   - Data types != Float* or (U)Int* (e.g. Decimal, Point etc.) are
     definitely not supposed to be used with Gorilla.
   - (U)Int* types are debatable. The paper only considers
     integers-stored-as-FP-values, a practical use case for which
     Gorilla works well. Standalone integers are not considered which
     makes them at least suspicious.

2. Achieve consistency with FPC, another specialized floating-point
   timeseries codec, which rejects non-float data.

3. On practical datasets, ZSTD is often "good enough" (**) so it should
   be okay to disincentive non-ZSTD codecs a little bit. If needed,
   Delta and DoubleDelta codecs are viable alternative for slowly
   changing (time-series-like) integer sequences.

Since on-prem and hosted users may still have Gorilla-compressed
non-float data, this combination is only deprecated for now. No warning
or error will be emitted. Users are encouraged to migrate
Gorilla-compressed non-float data to an alternative codec. It is planned
to treat Gorilla-compressed non-float columns as "suspicious" six months
after this commit (i.e. in v23.6). Even then, it will still be possible
to set "allow_suspicious_codecs = true" and read and write
Gorilla-compressed non-float data.

(*) Sec. 4.1.2, "Gorilla restricts the value element in its tuple to a
    double floating point type.", https://doi.org/10.14778/2824032.2824078

(**) https://clickhouse.com/blog/optimize-clickhouse-codecs-compression-schema
2023-01-20 17:31:16 +00:00
Dale Mcdiarmid
9c4d3e0ffb link docs to blogs 2023-01-17 15:38:10 +00:00
Dan Roscigno
d8d364914d
Merge pull request #43774 from ClickHouse/DanRoscigno-patch-2
Clarify CREATE TABLE AS SELECT docs
2022-11-29 07:52:34 -05:00
Camden Cheek
92c9ebe4ee
Update documentation example for REPLACE TABLE
The example statement for `REPLACE TABLE` using a `SELECT` query does not run as written. The example was missing a query engine, engine options, and the `AS` keyword, all of which seem required to replace a table with the output of some query.
2022-11-28 17:41:52 -07:00
DanRoscigno
bad28f4a25 fix highlight 2022-11-28 14:19:00 -05:00
Dan Roscigno
4ab04d6461
Update table.md 2022-11-28 14:08:08 -05:00
DanRoscigno
c4b8137d31 replace symlinks 2022-08-29 12:19:50 -04:00
DanRoscigno
5b5fcc56aa add slugs 2022-08-28 10:53:34 -04:00
Robert Schulze
2785783def
Mark DEFLAPT_QPL as 'experimental' codec + cosmetics 2022-07-24 20:10:11 +00:00
jinjunzh
d3d0605c00 add words of caution into documentation 2022-07-15 14:33:51 -04:00
DanRoscigno
aafe91a8ca add H3 tages for Algolia search 2022-06-22 14:48:18 -04:00
Robert Schulze
a0d936cc9f
Small follow-up for FPC codec
- add paper reference + doxygen

- remove endianness handling (ClickHouse assumes little endian)

- documentation

- other minor stuff
2022-06-15 14:21:28 +02:00
rfraposa
869967de41 Remove H1 anchor tags from docs 2022-06-02 04:55:18 -06:00
rfraposa
8f01fe9c49 Revised /en folder 2022-04-09 07:34:21 -06:00
rfraposa
5250d9ad11 Removed /ja folder, cleaned up /ru markdown 2022-04-09 07:29:05 -06:00
Alexey Milovidov
9854b55835
Revert "Format changes for new docs" 2022-04-04 02:05:35 +03:00
rfraposa
72a00e2c62 Fixed broken links 2022-04-02 17:38:54 -06:00
Rich Raposa
e6191511cf
Merge branch 'ClickHouse:master' into master 2022-04-01 11:43:48 -06:00
rfraposa
e5ee39541e Fixing conflicts with source repo 2022-04-01 11:34:35 -06:00
rfraposa
560471f991 Update /sql-reference docs 2022-03-29 22:06:21 -06:00
Yakov Olkhovskiy
de58f5988d
Update table.md
allow EPHEMERAL without expression
2022-03-29 04:01:20 -04:00
yakov-olkhovskiy
465dee928c
Update table.md 2022-02-08 21:09:52 -05:00
yakov-olkhovskiy
42ea826acb
Update table.md
EPHEMERAL specifier is added
2022-02-08 11:35:14 -05:00
mergify[bot]
5ef5e1d558
Merge branch 'master' into karnevil-DOCSUP-18631 2022-01-24 12:09:59 +00:00
靳阳
14ca6aa92b
name -> table_name
fix possible wrong word
2021-12-14 19:21:12 +08:00
karnevil13
77df8ce0dd DOCSUP-18631: Edit and translate 2021-11-23 00:44:08 +03:00
Filatenkov Artur
963ece5d6a
Update table.md 2021-10-20 15:13:12 +03:00
Filatenkov Artur
24d3209f60
Update table.md 2021-10-20 15:08:50 +03:00
Ivan Blinkov
a7cbad50ed fixes and cleanup 2021-09-20 11:08:21 +03:00
Artur Filatenkov
31c7e22bd6 correct style 2021-08-25 18:29:25 +03:00
Filatenkov Artur
3a32aa0dff
Update table.md 2021-08-12 16:03:35 +03:00
Artur Filatenkov
d8434539a7 comment docs 2021-08-09 17:17:22 +03:00
PHO
6425dd001a
Add a codec AES_128_GCM_SIV for encrypting columns on disk (#19896)
* Add a codec Encrypted() for encrypting columns on disk

While this is implemented as a compression codec, it does not actually compress data. It instead encrypts data on disk. The key is obtained by executing a user-specified command at the server startup, or if it's not specified the codec refuses to process any data. For now the only supported cipher is 'AES-128-GCM-SIV'.
2021-07-30 12:12:33 +03:00
Alexey Milovidov
df3be36758 Remove trailing whitespaces from docs 2021-07-29 18:27:50 +03:00
Andy Liang
cbdcfaaee7
table.md compression codec example sql
The example SQL is missing a comma ","
2021-07-18 11:06:08 -04:00
Kseniia Sumarokova
67e2695e8b
Merge pull request #24548 from kirillikoff/DOCSUP-9474-document-table-comments
Docsup 9474: document table comments
2021-05-31 11:11:27 +03:00
kirillikoff
fa8a0ca69d
Update table.md 2021-05-31 10:00:19 +03:00
kirillikoff
0ca47b2d1a
Update docs/en/sql-reference/statements/create/table.md
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
2021-05-29 18:23:59 +03:00
kirillikoff
33ec902597
Update docs/en/sql-reference/statements/create/table.md
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
2021-05-29 18:23:49 +03:00
Tatiana Kirillova
ee049678a1 Translation into Russian and system.tables 2021-05-29 16:42:21 +03:00
kirillikoff
d537da1871
Update docs/en/sql-reference/statements/create/table.md
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
2021-05-28 11:30:24 +03:00
kirillikoff
693df20ccc
Update docs/en/sql-reference/statements/create/table.md
Co-authored-by: olgarev <56617294+olgarev@users.noreply.github.com>
2021-05-28 11:30:19 +03:00
Romain Neutron
7b515c7235
Avoid short syntax 2021-05-27 21:44:11 +02:00
Tatiana Kirillova
a134507492 Document table comments update 2021-05-26 21:36:38 +03:00
Tatiana Kirillova
ea16fb3c8a Document table comments 2021-05-26 21:12:52 +03:00