查询外部数据
本文介绍如何通过 External Catalog 查询外部数据。External Catalog 方便您轻松访问并查询存储在各类外部源的数据,无需创建外部表。
前提条件
根据数据源已创建不同类型的 External Catalog。关于当前支持的 External Catalog 类型,请参见 Catalog。
操作步骤
-
连接 StarRocks。
- 如从 MySQL 客户端连接到 StarRocks。连接后,默认进入到
default_catalog
。 - 如使用 JDBC 连接到 StarRocks,连接时即可通过
default_catalog.db_name
的方式指定要连接的数据库。
- 如从 MySQL 客户端连接到 StarRocks。连接后,默认进入到
-
(可选)执行以下语句查看当前 StarRocks 集群中的所有 Catalog 并找到指定的 External Catalog。有关返回值说明,请参见 SHOW CATALOGS。
SHOW CATALOGS;
-
(可选)执行以下语句查看指定 external catalog 中的数据库。有关参数和返回值说明,请参见 SHOW DATABASES。
SHOW DATABASES FROM catalog_name;
-
(可选)执行以下语句将当前会话切换到指定 external catalog 的指定数据库。有关参数说明和示例,请参见 USE。
USE catalog_name.db_name;
-
查询外部数据。更多 SELECT 的使用方法,请参见 SELECT。
SELECT * FROM table_name;
如在以上步骤中未指定 external catalog 和数据库,则可以在查询语句中直接指定。示例:
SELECT * FROM catalog_name.db_name.table_name;
示例
创建一个名为 hive1
的 Hive catalog。如需通过 hive1
查询 Apache Hive™ 集群中 hive_db.hive_table
的数据,操作如下:
USE hive1.hive_db;
SELECT * FROM hive_table limit 1;
或
SELECT * FROM hive1.hive_db.hive_table limit 1;
更多操作
如要查询 StarRocks 的内部数据,请参见查询内部数据。