查看对象创建语句(SHOW CREATE TABLE)

功能概述

SHOW CREATE TABLE
SHOW CREATE TABLE
命令用于获取指定 Lakehouse 对象的 DDL 创建语句,支持普通表、外部表、物化视图、动态表和视图。

语法

SHOW CREATE TABLE [schema_name.]<object_name>

参数说明

参数是否必填说明
schema_name
schema_name
指定 schema 名称。如果未指定,默认使用当前 schema
object_name
object_name
要查询的对象名称,可以是表、外部表、物化视图、动态表或视图

返回列说明

列名说明
sql
sql
对象的完整 DDL 创建语句,包含 workspace 和 schema 前缀

使用示例

示例 1:查看外部表的创建语句

SHOW CREATE TABLE doc_test.ext_orders_v2;

返回结果:

+------------------------------------------------------------------+ | sql | +------------------------------------------------------------------+ | CREATE EXTERNAL TABLE quick_start.doc_test.ext_orders_v2( | | `order_id` int, | | `customer_id` int, | | `amount` decimal(10,2)) | | USING PARQUET | | LOCATION "oss://czlakehouse/doc_test/orders/" | | CONNECTION quick_start.oss_sh_conn_ak | | COMMENT 'External orders table' | | TBLPROPERTIES( | | 'key1'='value1'); | +------------------------------------------------------------------+

示例 2:查看物化视图的创建语句

SHOW CREATE TABLE doc_test.mv_test_sales;

返回结果:

+------------------------------------------------------------------+ | sql | +------------------------------------------------------------------+ | CREATE MATERIALIZED VIEW quick_start.doc_test.mv_test_sales( | | `id` , | | `name` ) | | REFRESH ON DEMAND | | USING PARQUET | | AS SELECT id, name FROM doc_test.employees; | +------------------------------------------------------------------+

示例 3:查看普通视图的创建语句

SHOW CREATE TABLE doc_test.v_test_employees;

返回结果:

+------------------------------------------------------------------+ | sql | +------------------------------------------------------------------+ | CREATE VIEW quick_start.doc_test.v_test_employees( | | `id` , | | `name` ) | | AS SELECT 1 AS id, 'Alice' AS name | | ; | +------------------------------------------------------------------+

注意事项

  • 返回的 DDL 语句包含完整的
    workspace.schema.object_name
    workspace.schema.object_name
    三级命名,可直接用于在其他工作空间或 schema 中重建对象(需修改对应的命名空间)。
  • 对于外部表,返回语句包含
    LOCATION
    LOCATION
    CONNECTION
    CONNECTION
    信息,迁移时需确保目标环境中存在对应的连接配置。
  • 该命令不支持查看普通内部表的创建语句,仅支持外部表、视图、物化视图和动态表。

相关命令

联系我们
预约咨询
微信咨询
电话咨询
邮件咨询