HG_SHARD_ID_FOR_DISTRIBUTION_KEY - 实时数仓Hologres

HG_SHARD_ID_FOR_DISTRIBUTION_KEY用于获取指定键或组合键的数据片ID（Shard ID）。本文为您介绍在交互式分析Hologres中HG_SHARD_ID_FOR_DISTRIBUTION_KEY的用法。

命令语法

SELECT HG_SHARD_ID_FOR_DISTRIBUTION_KEY ( 'schemaname.tablename' , columnname [...] ] ) 
FROM schemaname.tablename

参数说明

参数说明如下表所示。


参数	描述
schemaname	对应schema名称。
tablename	需要获取Shard ID的表名称。
columnname	单column或组合column的表名，作为计算所落到的数据分片ID（Shard ID）上。

使用示例

您可以使用如下示例步骤获取指定键或组合键的数据片ID（Shard ID）。

安装插件。您可以执行以下语句安装插件。该命令是DB级别的，在一个DB内执行一次即可。切换到新的DB需要再次执行。
```
create extension hg_toolkit;
```

获取lineitem表中l_shipmode列的Shard ID。

SELECT  HG_SHARD_ID_FOR_DISTRIBUTION_KEY ( 'public.lineitem', l_shipmode)
FROM public.lineitem ;

获取执行结果。

 hg_shard_id_for_distribution_key 
----------------------------------
                               24
                               24
                               24
                               24
                               31
                               24
                               12
                               25
                               25
                               25
(10 rows)