版本：Latest-3.2

查询外部数据

本文介绍如何通过 External Catalog 查询外部数据。External Catalog 方便您轻松访问并查询存储在各类外部源的数据，无需创建外部表。

前提条件

根据数据源已创建不同类型的 External Catalog。关于当前支持的 External Catalog 类型，请参见 Catalog。

连接 StarRocks。
- 如从 MySQL 客户端连接到 StarRocks。连接后，默认进入到 default_catalog。
- 如使用 JDBC 连接到 StarRocks，连接时即可通过 default_catalog.db_name 的方式指定要连接的数据库。
（可选）执行以下语句查看当前 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;  