实时数仓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命令创建子表。

• 不要求与父表一致：即对应的属性分区子表可以与父表不一致，如果子表没有显式指定属性，则会继承父表的属性，若是子表显式指定属性，则会保留子表的属性。

• 索引列必须包含父表的索引列：即分区子表的索引列必须包含父表的索引列，还能显式再指定其他列。