SELECT FROM CATALOG

功能概述

通过三层命名结构（

catalog.schema.table

）查询 External Catalog 中的表，支持与 Lakehouse 本地表进行联合查询。

语法

SELECT <expr> FROM catalog_name.schema_name.table_name [WHERE ...];

参数说明

• catalog_name

  catalog_name
  ：Catalog 名称，必须已通过

  CREATE EXTERNAL CATALOG

  CREATE EXTERNAL CATALOG
  注册。

• schema_name

  schema_name
  ：Schema 名称。

• table_name

  table_name
  ：表名。
• 查询 External Catalog 下的表必须使用三层结构，不能省略

  catalog_name

  catalog_name
  。

示例

查询共享 Catalog 中的地区表：

SELECT * FROM clickzetta_sample_data.tpch_100g.region LIMIT 3; +-------------+----------+----------------------------------------------------+ | r_regionkey | r_name | r_comment | +-------------+----------+----------------------------------------------------+ | 0 | AFRICA | lar deposits. blithely final packages cajole. r... | | 1 | AMERICA | hs use ironic, even requests. s | | 2 | ASIA | ges. thinly even pinto beans ca | +-------------+----------+----------------------------------------------------+

与 Lakehouse 本地表进行联合查询：

SELECT e.name, r.r_name AS region FROM doc_test.employees e JOIN clickzetta_sample_data.tpch_100g.region r ON r.r_regionkey = 0 WHERE e.dept = 'Engineering' LIMIT 3;

注意事项

• 查询外部 Catalog 时，读取权限由对应的 STORAGE CONNECTION 控制。
• 外部 Catalog 的数据不在 Lakehouse 本地存储，每次查询都会通过网络访问外部数据源，注意网络延迟和访问费用。
• 如需查看 Catalog 列表，使用

  SHOW CATALOGS

  SHOW CATALOGS
  ；查看 Schema 下的表，使用

  SHOW TABLES IN catalog_name.schema_name

  SHOW TABLES IN catalog_name.schema_name
  。