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

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

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

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

4. Clustering Key為數(shù)據(jù)在文件內(nèi)的排序，可以通過Clustering Key快速定位到所在的文件塊。

5. 位圖索引Bitmap是文件內(nèi)的索引，可以通過Bitmap快速定位到符合條件的數(shù)據(jù)所在的行號。

索引適用的場景如下。

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

• 命令格式

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

  說明

  set_table_property的調(diào)用需要與create table在同一事務(wù)中執(zhí)行。

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

  • 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;

• 參數(shù)說明

  具體參數(shù)和相關(guān)內(nèi)容如下表所示：

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

  • orientation

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

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

  • table_group

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

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

  • distribution_key

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

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

  • clustering_key

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

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

  • event_time_column

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

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

  • bitmap_columns

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

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

  • dictionary_encoding_columns

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

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

  • time_to_live_in_seconds（不建議使用）

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

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

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

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

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

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

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

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

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

   您也可以在元數(shù)據(jù)管理界面的已登錄實例列表。單擊目標數(shù)據(jù)庫，鼠標右擊數(shù)據(jù)庫下已創(chuàng)建的目標模式，選擇新建內(nèi)部表。

3. 在新建內(nèi)部表頁面，配置各項參數(shù)。

   參數(shù)說明（單擊展開）

   類別	參數(shù)	描述
   基本屬性	模式	模式名稱。 您可以選擇默認創(chuàng)建的public模式，也可以選擇新建的模式名稱。
   	表名	新建的Hologres內(nèi)部表名稱。
   	描述	新建的Hologres內(nèi)部表描述。
   字段	字段名	表中每一列的標識。
   	數(shù)據(jù)類型	字段取值的類型。
   	主鍵	表中每條數(shù)據(jù)的唯一標識。
   	可空	字段是否可以設(shè)置為空。
   	數(shù)組	有序的元素序列。
   	描述	字段的描述信息。
   	操作	包括刪除、上移和下移。
   屬性	存儲模式	包括列存、行存和行列共存三種存儲模式。 默認為列存。
   	表數(shù)據(jù)生命周期（秒）	數(shù)據(jù)第一次寫入的時間開始計算，當?shù)竭_生命周期后，表數(shù)據(jù)會在某一段時間內(nèi)被清除（沒有固定時間段）。 默認生命周期為永久。
   	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。
   分區(qū)表	無	選擇分區(qū)字段。

4. 在頁面右上角，單擊提交。提交之后，您可以在左側(cè)對應(yīng)模式下，刷新出新建的內(nèi)部表。

其他相關(guān)操作：

• 編輯內(nèi)部表

  1. 在元數(shù)據(jù)管理界面的已登錄實例列表，雙擊目標內(nèi)部表。

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

  3. 單擊提交。

• 刪除內(nèi)部表

  1. 在元數(shù)據(jù)管理界面的已登錄實例列表，鼠標右擊目標內(nèi)部表，選擇刪除表。

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

• 表數(shù)據(jù)預(yù)覽

  1. 在已登錄實例列表，雙擊目標內(nèi)部表。

  2. 進入表信息頁簽，單擊數(shù)據(jù)預(yù)覽，則可以預(yù)覽表數(shù)據(jù)。

• DDL預(yù)覽

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