From f73c93d6afdaa948cd703178c0ec02dd4cd8875c Mon Sep 17 00:00:00 2001 From: atovpeko Date: Mon, 17 Mar 2025 11:48:46 +0200 Subject: [PATCH 1/5] added a troubleshooting entry --- .../compression-inefficient-chunk-interval.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 _troubleshooting/compression-inefficient-chunk-interval.md diff --git a/_troubleshooting/compression-inefficient-chunk-interval.md b/_troubleshooting/compression-inefficient-chunk-interval.md new file mode 100644 index 0000000000..ac9ef85aa8 --- /dev/null +++ b/_troubleshooting/compression-inefficient-chunk-interval.md @@ -0,0 +1,15 @@ +--- +title: Inefficient `compress_chunk_time_interval` configuration +section: troubleshooting +products: [cloud, mst, self_hosted] +topics: [compression] +errors: + - language: text + message: |- + compress_chunk_time_interval configured and primary dimension not first column in compress_orderby. consider setting "" as first compress_orderby column +keywords: [compression, alter_table] +tags: [compression, alter_table] +--- + +When `compress_chunk_time_interval` is configured but `compress_orderby` does not have the primary dimension as the first column, chunk merging is less efficient as chunks have to be decompressed to be merged. + From e490d55e599860fc495b7b4b6138dd1042d2915f Mon Sep 17 00:00:00 2001 From: atovpeko Date: Mon, 17 Mar 2025 12:53:17 +0200 Subject: [PATCH 2/5] update --- _troubleshooting/compression-inefficient-chunk-interval.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_troubleshooting/compression-inefficient-chunk-interval.md b/_troubleshooting/compression-inefficient-chunk-interval.md index ac9ef85aa8..7b645fa017 100644 --- a/_troubleshooting/compression-inefficient-chunk-interval.md +++ b/_troubleshooting/compression-inefficient-chunk-interval.md @@ -6,7 +6,8 @@ topics: [compression] errors: - language: text message: |- - compress_chunk_time_interval configured and primary dimension not first column in compress_orderby. consider setting "" as first compress_orderby column + compress_chunk_time_interval configured and primary dimension not first column in compress_orderby. + consider setting "" as first compress_orderby column keywords: [compression, alter_table] tags: [compression, alter_table] --- From 58326f33c92e964d9981c17abffd3b6853560fa1 Mon Sep 17 00:00:00 2001 From: atovpeko Date: Thu, 3 Apr 2025 15:41:51 +0300 Subject: [PATCH 3/5] update --- _troubleshooting/chunk-temp-file-limit.md | 2 +- _troubleshooting/compression-alter-hypertable.md | 2 +- _troubleshooting/compression-dml-tuple-limit.md | 2 +- _troubleshooting/compression-inefficient-chunk-interval.md | 6 ++++-- _troubleshooting/compression-userperms.md | 2 +- _troubleshooting/invalid-attribute-reindex-hypertable.md | 2 +- _troubleshooting/scheduled-jobs-stop-running.md | 2 +- use-timescale/page-index/page-index.js | 5 +++++ 8 files changed, 15 insertions(+), 8 deletions(-) diff --git a/_troubleshooting/chunk-temp-file-limit.md b/_troubleshooting/chunk-temp-file-limit.md index e1582582ad..a196fae1d5 100644 --- a/_troubleshooting/chunk-temp-file-limit.md +++ b/_troubleshooting/chunk-temp-file-limit.md @@ -2,7 +2,7 @@ title: Temporary file size limit exceeded when compressing chunks section: troubleshooting products: [cloud, mst, self_hosted] -topics: [hypertables, distributed hypertables, compression] +topics: [hypertables, distributed hypertables, compression, hypercore] errors: - language: text message: |- diff --git a/_troubleshooting/compression-alter-hypertable.md b/_troubleshooting/compression-alter-hypertable.md index e7ae4b99df..452e6bb564 100644 --- a/_troubleshooting/compression-alter-hypertable.md +++ b/_troubleshooting/compression-alter-hypertable.md @@ -2,7 +2,7 @@ title: Cannot add column to a compressed hypertable section: troubleshooting products: [cloud, mst, self_hosted] -topics: [hypertables, compression] +topics: [hypertables, compression, hypercore] errors: - language: text message: |- diff --git a/_troubleshooting/compression-dml-tuple-limit.md b/_troubleshooting/compression-dml-tuple-limit.md index 466267c962..a4516ed41e 100644 --- a/_troubleshooting/compression-dml-tuple-limit.md +++ b/_troubleshooting/compression-dml-tuple-limit.md @@ -2,7 +2,7 @@ title: Tuple decompression limit exceeded by operation section: troubleshooting products: [cloud, mst, self_hosted] -topics: [hypertables, compression] +topics: [hypertables, compression, hypercore] errors: - language: text message: |- diff --git a/_troubleshooting/compression-inefficient-chunk-interval.md b/_troubleshooting/compression-inefficient-chunk-interval.md index 7b645fa017..79d77b94e8 100644 --- a/_troubleshooting/compression-inefficient-chunk-interval.md +++ b/_troubleshooting/compression-inefficient-chunk-interval.md @@ -2,7 +2,7 @@ title: Inefficient `compress_chunk_time_interval` configuration section: troubleshooting products: [cloud, mst, self_hosted] -topics: [compression] +topics: [compression, hypercore] errors: - language: text message: |- @@ -12,5 +12,7 @@ keywords: [compression, alter_table] tags: [compression, alter_table] --- -When `compress_chunk_time_interval` is configured but `compress_orderby` does not have the primary dimension as the first column, chunk merging is less efficient as chunks have to be decompressed to be merged. +When you configure `compress_chunk_time_interval` but do not set the primary dimension as the first column in `compress_orderby`, $COMPANY decompresses chunks before merging. This makes merging less efficient. Set the primary dimension of the chunk as the first column in `compress_orderby` to improve efficiency. + + diff --git a/_troubleshooting/compression-userperms.md b/_troubleshooting/compression-userperms.md index 71098006e7..54c9fdbf23 100644 --- a/_troubleshooting/compression-userperms.md +++ b/_troubleshooting/compression-userperms.md @@ -2,7 +2,7 @@ title: User permissions do not allow chunks to be compressed or decompressed section: troubleshooting products: [cloud, mst, self_hosted] -topics: [hypertables, compression, configuration] +topics: [hypertables, compression, configuration, hypercore] errors: - language: text message: |- diff --git a/_troubleshooting/invalid-attribute-reindex-hypertable.md b/_troubleshooting/invalid-attribute-reindex-hypertable.md index bad92c6bb9..129ad8d64e 100644 --- a/_troubleshooting/invalid-attribute-reindex-hypertable.md +++ b/_troubleshooting/invalid-attribute-reindex-hypertable.md @@ -2,7 +2,7 @@ title: Reindex hypertables to fix large indexes section: troubleshooting products: [cloud, mst, self_hosted] -topics: [hypertables, distributed hypertables, schema management, data retention, compression] +topics: [hypertables, distributed hypertables, schema management, data retention, compression, hypercore] errors: - language: bash message: |- diff --git a/_troubleshooting/scheduled-jobs-stop-running.md b/_troubleshooting/scheduled-jobs-stop-running.md index 76b7fc128a..9e70965450 100644 --- a/_troubleshooting/scheduled-jobs-stop-running.md +++ b/_troubleshooting/scheduled-jobs-stop-running.md @@ -2,7 +2,7 @@ title: Scheduled jobs stop running section: troubleshooting products: [cloud, mst, self_hosted] -topics: [jobs, continuous aggregates, data retention, compression] +topics: [jobs, continuous aggregates, data retention, compression, hypercore] apis: - [continuous aggregates, add_continuous_aggregate_policy()] - [continuous aggregates, add_policies()] diff --git a/use-timescale/page-index/page-index.js b/use-timescale/page-index/page-index.js index 08c9c3d383..99fbf3ddd8 100644 --- a/use-timescale/page-index/page-index.js +++ b/use-timescale/page-index/page-index.js @@ -213,6 +213,11 @@ module.exports = [ href: "secondary-indexes", excerpt: "Automate", }, + { + title: "Troubleshooting", + href: "troubleshooting", + type: "placeholder", + }, ], }, { From 515b6c2266f8496c744cd5ea157b76d95900925e Mon Sep 17 00:00:00 2001 From: atovpeko Date: Thu, 3 Apr 2025 15:44:44 +0300 Subject: [PATCH 4/5] update --- use-timescale/page-index/page-index.js | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/use-timescale/page-index/page-index.js b/use-timescale/page-index/page-index.js index c0f9ac9804..712ef949a9 100644 --- a/use-timescale/page-index/page-index.js +++ b/use-timescale/page-index/page-index.js @@ -76,6 +76,11 @@ module.exports = [ href: "secondary-indexes", excerpt: "Automate", }, + { + title: "Troubleshooting", + href: "troubleshooting", + type: "placeholder", + }, ], }, { From af0448c8ba0c89c0db39860f3d4e07910d015e37 Mon Sep 17 00:00:00 2001 From: atovpeko Date: Tue, 8 Apr 2025 15:28:07 +0300 Subject: [PATCH 5/5] review --- _troubleshooting/compression-inefficient-chunk-interval.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_troubleshooting/compression-inefficient-chunk-interval.md b/_troubleshooting/compression-inefficient-chunk-interval.md index 79d77b94e8..b3e2ce4d27 100644 --- a/_troubleshooting/compression-inefficient-chunk-interval.md +++ b/_troubleshooting/compression-inefficient-chunk-interval.md @@ -12,7 +12,7 @@ keywords: [compression, alter_table] tags: [compression, alter_table] --- -When you configure `compress_chunk_time_interval` but do not set the primary dimension as the first column in `compress_orderby`, $COMPANY decompresses chunks before merging. This makes merging less efficient. Set the primary dimension of the chunk as the first column in `compress_orderby` to improve efficiency. +When you configure `compress_chunk_time_interval` but do not set the primary dimension as the first column in `compress_orderby`, $TIMESCALE_DB decompresses chunks before merging. This makes merging less efficient. Set the primary dimension of the chunk as the first column in `compress_orderby` to improve efficiency.