錯誤如下：
```SQL
ERROR:  cannot create constraint on "test"
DETAIL:  Distributed relations cannot have UNIQUE, EXCLUDE, or PRIMARY KEY constraints that do not include the partition column (with an equality operator if EXCLUDE).
```
建立測試表
```SQL
lightdb@test=# create table test(id bigint,name varchar(100));
CREATE TABLE
lightdb@test=# alter table test add primary key (id);
ALTER TABLE
lightdb@test=# select create_distributed_table('test','name');
ERROR:  cannot create constraint on "test"
DETAIL:  Distributed relations cannot have UNIQUE, EXCLUDE, or PRIMARY KEY constraints that do not include the partition column (with an equality operator if EXCLUDE).
```
## 原因如下
**唯一約束必須包含分片鍵**
這個錯誤提示在 Citus 中建立了一個分散式表，並且在表上定義了 UNIQUE、EXCLUDE 或 PRIMARY KEY 約束，但約束中沒有包含分割槽列（或分割槽列的一部分），因此 Citus 無法在分散式環境中正確地強制執行這些約束。

在 Citus 中，資料通常被分割槽並儲存在不同的節點上，每個節點上儲存的資料子集只能部分地表示分散式表的完整資料集。這就需要 Citus 在整個分散式叢集上保證資料一致性和正確性，因此 Citus 需要在分散式表上使用分割槽鍵或分割槽鍵的一部分來定義這些約束。

例如，假設我們有一個表 orders，其分割槽鍵為 order_id，並且我們想在該表上定義一個唯一約束，以確保每個訂單 ID 都是唯一的。在 Citus中，我們應該將分割槽鍵 order_id 包含在唯一約束中，這樣 Citus 才能確保唯一性約束適用於整個分散式表的所有節點，從而避免重複資料在不同的節點上出現。

因此，當您在 Citus 中建立分散式表並定義 UNIQUE、EXCLUDE 或 PRIMARY KEY 約束時，請確保這些約束包括分割槽鍵或分割槽鍵的一部分，以確保約束可以在整個分散式叢集上正確地強制執行。如果沒有包含分割槽鍵或分割槽鍵的一部分，則會出現您所描述的錯誤提示。

LightDB Canopy 常見報錯問題分析（二）DETAIL: Distributed relations cannot have

相關文章