查看外部表列表(SHOW EXTERNAL TABLES)

功能概述

通过

SHOW TABLES
SHOW TABLES
命令加
WHERE is_external=true
WHERE is_external=true
条件,可以列出指定 schema 下的所有外部表。

语法

SHOW TABLES [ IN schema_name ] [ WHERE is_external=true ] [ LIMIT num ]

参数说明

参数是否必填说明
IN schema_name
IN schema_name
指定要查询的 schema 名称。如果未指定,默认使用当前 schema
WHERE is_external=true
WHERE is_external=true
筛选条件,仅显示外部表
LIMIT num
LIMIT num
限制返回的记录数量

返回列说明

列名类型说明
schema_name
schema_name
string外部表所在的 schema 名称
table_name
table_name
string外部表名称
is_view
is_view
boolean是否为普通视图,外部表时为
false
false
is_materialized_view
is_materialized_view
boolean是否为物化视图,外部表时为
false
false
is_external
is_external
boolean是否为外部表,外部表时为
true
true
is_dynamic
is_dynamic
boolean是否为动态表,外部表时为
false
false

使用示例

示例 1:列出当前 schema 下的所有外部表

SHOW TABLES WHERE is_external=true;

示例 2:列出指定 schema 下的所有外部表

SHOW TABLES IN doc_test WHERE is_external=true;

返回结果示例:

+-------------+-----------------+---------+----------------------+-------------+------------+ | schema_name | table_name | is_view | is_materialized_view | is_external | is_dynamic | +-------------+-----------------+---------+----------------------+-------------+------------+ | doc_test | ext_orders_v2 | false | false | true | false | +-------------+-----------------+---------+----------------------+-------------+------------+

示例 3:限制返回数量

SHOW TABLES IN doc_test WHERE is_external=true LIMIT 10;

注意事项

  • SHOW TABLES
    SHOW TABLES
    返回的结果包含所有类型的表对象,通过
    WHERE is_external=true
    WHERE is_external=true
    可以只显示外部表。
  • 外部表的数据存储在外部存储(如 OSS、S3)中,删除外部表不会删除底层数据文件。
  • 要查看外部表的详细创建语句(包括
    LOCATION
    LOCATION
    CONNECTION
    CONNECTION
    信息),使用
    SHOW CREATE TABLE <table_name>
    SHOW CREATE TABLE <table_name>

相关命令

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