Hologres是兼容PostgreSQL生態，建表語法與PostgreSQL相同，但是索引與PostgreSQL不同，Hologres支持的索引請參見設置表屬性和索引。建表時選擇合適的索引，能夠使SQL在執行時快速命中數據，減少IO消耗，以更少的計算資源，實現更快的查詢性能。下圖是一個SQL從發起到獲取數據的執行流程，可以通過下圖理解每個索引的作用，以方便實際業務中更加方便高效的為表選擇合適的索引。

1. SQL執行時，如果是分區表，那么會通過分區裁剪，定位到所在分區。

2. 通過Distribution Key快速定位到數據所在的數據分片（Shard）。

3. 通過Event Time Column（原Segment Key）快速定位到數據所在的文件。

4. Clustering Key為數據在文件內的排序，可以通過Clustering Key快速定位到所在的文件塊。

5. 位圖索引Bitmap是文件內的索引，可以通過Bitmap快速定位到符合條件的數據所在的行號。

索引適用的場景如下。

在Hologres中，可以通過set_table_property或create table with命令為表設置多種屬性，合理的表屬性設置可以有助于系統高效地組織和查詢數據。與數據存儲布局有關的參數需要和建表語句同時執行。

• 命令格式

  -- 2.1版本起支持
  create table <table_name> (...)
  with (property = 'value'[, ...]);
  
  -- 所有版本支持
  call set_table_property('<table_name>', property, 'value');

  說明

  set_table_property的調用需要與create table在同一事務中執行。

  Hologres支持的設置表屬性如下所示，包括但不限于以下幾種表屬性。

  • V2.1版本起支持的語法：

    CREATE TABLE <table_name> (...)
    WITH (
        orientation = '[column | row | row,column]',
        table_group = '[tableGroupName]',
        distribution_key = 'columnName[,...]]',
        clustering_key = '[columnName{:asc]} [,...]]',
        event_time_column = '[columnName [,...]]',
        bitmap_columns = '[columnName [,...]]',
        dictionary_encoding_columns = '[columnName [,...]]',
        time_to_live_in_seconds = '<non_negative_literal>'
        [,storage_mode, ...]
    );

  • 所有版本都支持的語法：

    BEGIN;
    CREATE TABLE <table_name> (...);
    call set_table_property('table_name', 'orientation', '[column | row]');
    call set_table_property('table_name', 'table_group', '[tableGroupName]');
    call set_table_property('table_name', 'distribution_key', '[columnName[,...]]');
    call set_table_property('table_name', 'clustering_key', '[columnName{:asc]} [,...]]');
    call set_table_property('table_name', 'event_time_column', '[columnName [,...]]');
    call set_table_property('table_name', 'bitmap_columns', '[columnName [,...]]');
    call set_table_property('table_name', 'dictionary_encoding_columns', '[columnName [,...]]');
    call set_table_property('table_name', 'time_to_live_in_seconds', '<non_negative_literal>');
    COMMIT;

• 參數說明

  具體參數和相關內容如下表所示：

  參數	說明	列存表	行存表	行列共存表	建議值	建表后是否可修改
  orientation	表存儲格式。	column（默認值）	row	row,column	column	否，如需修改請重新建表。
  table_group	Table Group。	默認為default table group。	默認為default table group。	默認為default table group。	默認即可。	否，如需修改請重新建表或者Resharding。
  distribution_key	分布鍵。	默認為主鍵，根據業務場景修改。	默認為主鍵。	默認為主鍵。	主鍵的子集，建議只選擇一列。	否，如需修改請重新建表。
  clustering_key	聚簇索引。	默認為空。	默認為主鍵。	默認為空。	建議最多選擇一列，且僅支持asc序。	否，如需修改請重新建表。
  event_time_column	分段鍵。	默認為第一個非空時間戳字段。	不支持。	默認為第一個非空時間戳字段。	建議時間戳字段。	否，如需修改請重新建表。
  bitmap_columns	位圖索引。	按需使用。	不支持。	按需使用。	建議用于等值比較的列，一般10列以下。	是，詳情請參見ALTER TABLE。
  dictionary_encoding_columns	比特編碼。	按需使用。	不支持。	按需使用。	建議低基數列，一般10列以下。	是，詳情請參見ALTER TABLE。
  time_to_live_in_seconds	表數據生命周期。	按需使用。	按需使用。	按需使用。	默認即可，無需設置。	是，詳情請參見ALTER TABLE。

  • orientation

    指定了數據庫表在Hologres中的存儲模式是列存還是行存，從V1.1版本開始支持行列共存的格式，命令語法如下所示。不同的存儲格式適用于不同的查詢場景，建表時默認為列存，其余存儲模式需要建表時顯式指定，詳情請參見表存儲格式：列存、行存、行列共存。

    call set_table_property('table_name', 'orientation', '[column | row |row,column]');

  • table_group

    在Hologres中，Shard是指數據分片，Table Group是Hologres中特有的邏輯存儲概念，用于管理Shard數，一個Table Group唯一對應一組Shard。新建數據庫后，如果沒有創建新的Table Group，那么創建第一個表時，會自動建立一個名稱為<db>_tg_default的默認Table Group，后續表創建時沒有指定Table Group將會被指定至默認Table Group中。一般情況下無需設置Table Group，使用默認Table Group即可，當實例規格較大（大于256 Core時），建議根據業務情況劃分不同的Table Group和Shard數，帶來更好的性能，使用詳情請參見Table Group與Shard Count操作指南。

    call set_table_property('table_name', 'table_group', '[tableGroupName]');

  • distribution_key

    設置分布鍵Distribution Key。Distribution Key指定了表的分布策略，數據根據Distribution Key被分配到各個Shard上，保證Distribution Key相同的記錄會被分配到同一個Shard上。Distribution Key是非常重要的分布式概念，合理的設置Distribution Key可以提高查詢性能和QPS等，詳情請參見分布鍵Distribution Key。

    call set_table_property('table_name', 'distribution_key', '[columnName[,...]]');

  • clustering_key

    設置聚簇索引Clustering Key，命令語法如下所示。Hologres會根據Clustering Key在文件內對數據進行排序，默認為升序（acs）排序。合理地設置Clustering Key能夠加速在索引列上的Range和Filter查詢，提升查詢性能，詳情請參見聚簇索引Clustering Key。

    call set_table_property('table_name', 'clustering_key', '[columnName{:asc} [,...]]');

  • event_time_column

    設置分段鍵Event_time_column （原Segment Key），命令語法如下所示。文件會根據Event_time_column劃分，當命中Event_time_column時，可以快速定位到數據所在的文件，Event_time_column適用于數據為單調遞增或單調遞減的有序字段，例如時間戳字段，非常適用于日志、流量等和時間強相關的數據，合理設置可極大提升查詢性能，詳情請參見Event Time Column（Segment Key）。

    call set_table_property('table_name', 'event_time_column', '[columnName [,...]]');

  • bitmap_columns

    設置位圖索引Bitmap，命令語法如下所示。Bitmap能夠快速定位到符合條件數據所在的行號，適合將等值查詢條件的數據設置為位圖索引列。默認列存表所有TEXT數據類型的字段都會被隱式地設置為位圖索引列，詳情請參見位圖索引Bitmap。

    call set_table_property('table_name', 'bitmap_columns', '[columnName{:[on|off]}[,...]]');

  • dictionary_encoding_columns

    設置字典編碼Dictionary Encoding，命令語法如下所示。Dictionary Encoding指定列的值構建字典映射。字典編碼可以將字符串的比較轉成數字的比較，加速Group By、Filter等查詢。默認列存表所有TEXT數據類型的字段都會被設置為Dictionary Encoding列 ，在Hologres V0.9及之后版本，會根據數據特征自動選擇是否創建字典編碼。

    call set_table_property('table_name', 'dictionary_encoding_columns', '[columnName{:[on|off|auto]}[,...]]');

  • time_to_live_in_seconds（不建議使用）

    設置表的數據生命周期（TTL），單位為秒，命令語法如下所示。

    • TTL過期時間是按照數據寫入的時間開始計算，不是按照數據更新時間計算。不設置TTL的時候，默認為100年，Hologres從 V1.3.24版本開始，TTL允許的最小值是一天，即86400秒。TTL的詳細使用說明請參見SQL命令列表。

    • TTL不是精確的時間，即到期了之后數據會在某一段時間（不是固定時間）刪除（只刪除數據，表還會存在），因此可能會出現PK重復的問題。生產業務不建議使用TTL來管理數據的生命周期，建議使用CREATE PARTITION TABLE。

    call set_table_property('table_name', 'time_to_live_in_seconds', '<non_negative_literal>');

您可以執行如下命令查看TABLE的具體DDL：

create extension hg_toolkit; --該命令是DB級別，一個DB執行一次即可
select hg_dump_script('[<schema_name>.]<table_name>');

HoloWeb提供可視化一鍵建表功能，無需寫SQL命令就能創建表，步驟如下。

1. 進入HoloWeb頁面，詳情請參見連接HoloWeb并執行查詢。

2. 在HoloWeb頁面頂部菜單欄，單擊元數據管理 > 表。

   您也可以在元數據管理界面的已登錄實例列表。單擊目標數據庫，鼠標右擊數據庫下已創建的目標模式，選擇新建內部表。

3. 在新建內部表頁面，配置各項參數。

   參數說明（單擊展開）

   類別	參數	描述
   基本屬性	模式	模式名稱。 您可以選擇默認創建的public模式，也可以選擇新建的模式名稱。
   	表名	新建的Hologres內部表名稱。
   	描述	新建的Hologres內部表描述。
   字段	字段名	表中每一列的標識。
   	數據類型	字段取值的類型。
   	主鍵	表中每條數據的唯一標識。
   	可空	字段是否可以設置為空。
   	數組	有序的元素序列。
   	描述	字段的描述信息。
   	操作	包括刪除、上移和下移。
   屬性	存儲模式	包括列存、行存和行列共存三種存儲模式。 默認為列存。
   	表數據生命周期（秒）	數據第一次寫入的時間開始計算，當到達生命周期后，表數據會在某一段時間內被清除（沒有固定時間段）。 默認生命周期為永久。
   	Binlog	表是否開啟Binlog，詳情請參見訂閱Hologres Binlog。
   	Binlog生命周期	Binlog的生命周期，詳情請參見訂閱Hologres Binlog。默認生命周期為永久。
   	分布列	distribution_key，使用詳情請參見分布鍵Distribution Key。
   	分段列	event_time_column ，使用詳情請參見Event Time Column（Segment Key）。
   	聚簇列	clustering_key，使用詳情請參見聚簇索引Clustering Key。
   	字典編碼列	dictionary_encoding_columns，使用詳情請參見字典編碼Dictionary Encoding。
   	位圖列	bitmap_columns，使用詳情請參見位圖索引Bitmap。
   分區表	無	選擇分區字段。

4. 在頁面右上角，單擊提交。提交之后，您可以在左側對應模式下，刷新出新建的內部表。

其他相關操作：

• 編輯內部表

  1. 在元數據管理界面的已登錄實例列表，雙擊目標內部表。

  2. 在目標內部表信息頁，單擊編輯表，可以添加字段、更改表數據周期等部分表屬性。

  3. 單擊提交。

• 刪除內部表

  1. 在元數據管理界面的已登錄實例列表，鼠標右擊目標內部表，選擇刪除表。

  2. 在刪除表對話框，單擊確認。

• 表數據預覽

  1. 在已登錄實例列表，雙擊目標內部表。

  2. 進入表信息頁簽，單擊數據預覽，則可以預覽表數據。

• DDL預覽

  在目標表信息頁簽，單擊DDL語句，則可以預覽DDL語句。