跳到主要内容
版本:Latest-3.3

SHOW CREATE TABLE

功能

查看指定表的建表语句。

自 3.0 版本起支持使用该语句查看 External Catalog 下的表,包括 Apache Hive™ 、Apache Iceberg、Apache Hudi、Delta Lake 表。

自 2.5.7 版本起,StarRocks 支持在建表和新增分区时自动设置分桶数量 (BUCKETS),您无需手动设置分桶数量。更多信息,请参见 设置分桶数量

  • 如果您在建表时指定了分桶数,SHOW CREATE TABLE 会显示分桶数。

  • 如果您在建表时没有指定分桶数,SHOW CREATE TABLE 不会显示分桶数,您可以通过 SHOW PARTITIONS 查看分区的分桶数。

2.5.7 之前的版本在建表时必须设置分桶数,因此 SHOW CREATE TABLE 会显示分桶数。

注意

  • 3.0 版本之前,只有拥有该表 SELECT_PRIV 权限的用户才可以查看。
  • 自 3.0 版本起,只有拥有该表 SELECT 权限的用户才可以查看。

语法

SHOW CREATE TABLE [db_name.]table_name

参数说明

参数必选说明
db_name数据库名称。如指定,则查看指定数据库中某张表的建表语句。
table_name表名。

返回结果说明

+-----------+----------------+
| Table | Create Table |
+-----------+----------------+

返回结果中的参数说明如下:

参数说明
Table表名。
Create Table建表语句。

示例

建表时未指定分桶数

创建一个表 example_table,DISTRIBUTED BY 中未指定分桶数。

CREATE TABLE example_table
(
k1 TINYINT,
k2 DECIMAL(10, 2) DEFAULT "10.5",
v1 CHAR(10) REPLACE,
v2 INT SUM
)
ENGINE = olap
AGGREGATE KEY(k1, k2)
COMMENT "my first starrocks table"
DISTRIBUTED BY HASH(k1);

查看表 example_table 的建表语句,结果中不显示分桶数。注意建表时如果未指定 PROPERTIES,SHOW CREATE TABLE 语句会显示默认的 PROPERTIES。

SHOW CREATE TABLE example_table\G
*************************** 1. row ***************************
Table: example_table
Create Table: CREATE TABLE `example_table` (
`k1` tinyint(4) NULL COMMENT "",
`k2` decimal64(10, 2) NULL DEFAULT "10.5" COMMENT "",
`v1` char(10) REPLACE NULL COMMENT "",
`v2` int(11) SUM NULL COMMENT ""
) ENGINE=OLAP
AGGREGATE KEY(`k1`, `k2`)
COMMENT "my first starrocks table"
DISTRIBUTED BY HASH(`k1`)
PROPERTIES (
"replication_num" = "3",
"in_memory" = "false",
"enable_persistent_index" = "false",
"replicated_storage" = "true",
"compression" = "LZ4"
);

建表时指定了分桶数

创建一个表 example_table1,DISTRIBUTED BY 中指定分桶数为 10。

CREATE TABLE example_table1
(
k1 TINYINT,
k2 DECIMAL(10, 2) DEFAULT "10.5",
v1 CHAR(10) REPLACE,
v2 INT SUM
)
ENGINE = olap
AGGREGATE KEY(k1, k2)
COMMENT "my first starrocks table"
DISTRIBUTED BY HASH(k1) BUCKETS 10;

查看表 example_table 的建表语句,结果中显示分桶数。注意建表时如果未指定 PROPERTIES,SHOW CREATE TABLE 语句会显示默认的 PROPERTIES。

SHOW CREATE TABLE example_table1\G
*************************** 1. row ***************************
Table: example_table1
Create Table: CREATE TABLE `example_table1` (
`k1` tinyint(4) NULL COMMENT "",
`k2` decimal64(10, 2) NULL DEFAULT "10.5" COMMENT "",
`v1` char(10) REPLACE NULL COMMENT "",
`v2` int(11) SUM NULL COMMENT ""
) ENGINE=OLAP
AGGREGATE KEY(`k1`, `k2`)
COMMENT "my first starrocks table"
DISTRIBUTED BY HASH(`k1`) BUCKETS 10
PROPERTIES (
"replication_num" = "3",
"in_memory" = "false",
"enable_persistent_index" = "false",
"replicated_storage" = "true",
"compression" = "LZ4"
);