Hologres：CREATE PARTITION TABLE

文法說明

建立分區表的命令格式如下。

--建立分區父表語句
CREATE TABLE [IF NOT EXISTS] [<schema_name>.]<table_name>  ([
  {
   <column_name> <column_type> [ <column_constraints>, [...]]
   | <table_constraints>
   [, ...]
  }
])
PARTITION BY LIST(<column_name>);

--建立分區子表語句
CREATE TABLE [IF NOT EXISTS] [<schema_name>.]<table_name> PARTITION OF <parent_table>
  FOR VALUES IN (<string_literal>);

使用樣本

• 樣本1：在public schema下建立不帶主鍵的分區父表和對應的分區子表。

  • V2.1版本起支援的文法：

    BEGIN;
    CREATE TABLE public.hologres_parent (
        a TEXT,
        b INT,
        c TIMESTAMP,
        d TEXT
    )
    PARTITION BY LIST (a) 
    WITH (orientation = 'column');
    CREATE TABLE public.hologres_child1 PARTITION OF public.hologres_parent FOR VALUES IN ('v1');
    CREATE TABLE public.hologres_child2 PARTITION OF public.hologres_parent FOR VALUES IN ('v2');
    CREATE TABLE public.hologres_child3 PARTITION OF public.hologres_parent FOR VALUES IN ('v3');
    COMMIT;

  • 所有版本支援的文法：

    BEGIN;
    CREATE TABLE public.hologres_parent(
      a TEXT, 
      b INT, 
      c TIMESTAMP, 
      d TEXT
    ) 
      PARTITION BY LIST(a);
    CALL set_table_property('public.hologres_parent', 'orientation', 'column');           
    CREATE TABLE public.hologres_child1 PARTITION OF public.hologres_parent FOR VALUES IN('v1');
    CREATE TABLE public.hologres_child2 PARTITION OF public.hologres_parent FOR VALUES IN('v2');
    CREATE TABLE public.hologres_child3 PARTITION OF public.hologres_parent FOR VALUES IN('v3');
    COMMIT;

• 樣本2：在public schema下建立帶主鍵的分區父表和對應的分區子表。

  V2.1版本起支援的文法：

  BEGIN;
  CREATE TABLE public.hologres_parent_2 (
      a TEXT,
      b INT,
      c TIMESTAMP,
      d TEXT,
      ds TEXT,
      PRIMARY KEY (ds, b)
  )
  PARTITION BY LIST (ds) 
  WITH (orientation = 'column');
  CREATE TABLE public.holo_child_1 PARTITION OF public.hologres_parent_2 FOR VALUES IN ('20201215');
  CREATE TABLE public.holo_child_2 PARTITION OF public.hologres_parent_2 FOR VALUES IN ('20201216');
  CREATE TABLE public.holo_child_3 PARTITION OF public.hologres_parent_2 FOR VALUES IN ('20201217');
  COMMIT;

  所有版本支援的文法：

  BEGIN;
  CREATE TABLE public.hologres_parent_2(
    a TEXT , 
    b INT, 
    c TIMESTAMP, 
    d TEXT,
    ds TEXT,
    primary key(ds,b)
    )
    PARTITION BY LIST(ds);
  CALL set_table_property('public.hologres_parent_2', 'orientation', 'column');
  CREATE TABLE public.holo_child_1 PARTITION OF public.hologres_parent_2 FOR VALUES IN('20201215');
  CREATE TABLE public.holo_child_2 PARTITION OF public.hologres_parent_2 FOR VALUES IN('20201216');
  CREATE TABLE public.holo_child_3 PARTITION OF public.hologres_parent_2 FOR VALUES IN('20201217');
  COMMIT;

您可以通過如下兩種方法查看當前分區父表下所有的分區子表：

• 通過HoloWeb可視化查看，HoloWeb會展示分區父表下面的所有分區子表。

• 通過執行如下命令語句，查看當前分區父表下所有的分區子表。其中，您可以將parent_table_name修改為實際的父表名稱。

  SELECT
      nmsp_parent.nspname AS parent_schema,
      parent.relname      AS parent,
      nmsp_child.nspname  AS child_schema,
      child.relname       AS child
  FROM pg_inherits
      JOIN pg_class parent            ON pg_inherits.inhparent = parent.oid
      JOIN pg_class child             ON pg_inherits.inhrelid   = child.oid
      JOIN pg_namespace nmsp_parent   ON nmsp_parent.oid  = parent.relnamespace
      JOIN pg_namespace nmsp_child    ON nmsp_child.oid   = child.relnamespace
  WHERE parent.relname='parent_table_name'; 

分區子表在綁定父表時，其約束關係如下表所示。其中：

• 與父表保持一致：即對應的屬性分區子表必須和父表保持一致。若不一致，在分區子表綁定（ATTACH）父表時會報錯。此時，推薦您使用CREATE TABLE LIKE命令建立子表。

• 不要求與父表一致：即對應的屬性分區子表可以與父表不一致，如果子表沒有顯式指定屬性，則會繼承父表的屬性，若是子表顯式指定屬性，則會保留子表的屬性。

• 索引列必須包含父表的索引列：即分區子表的索引列必須包含父表的索引列，還能顯式再指定其他列。