版本: 最新版本-3.5

查询外部数据

本主题将指导您通过使用外部 Catalog 查询来自外部数据源的数据。

前提条件

外部 Catalog 基于外部数据源创建。有关支持的外部 Catalog 类型的信息，请参见Catalog。

连接您的 StarRocks 集群。
- 如果您使用 MySQL 客户端连接 StarRocks 集群，则默认连接后会进入 default_catalog。
- 如果您使用 JDBC 连接 StarRocks 集群，您可以通过在连接时指定 default_catalog.db_name 直接进入默认 Catalog 中的目标数据库。
(可选) 执行以下语句以查看所有 Catalog，并找到您已创建的外部 Catalog。有关此语句的输出，请参见SHOW CATALOGS。
```
SHOW CATALOGS;
```
(可选) 执行以下语句以查看外部 Catalog 中的所有数据库。有关此语句的输出，请参见SHOW DATABASES。
```
SHOW DATABASES FROM catalog_name;
```
(可选) 执行以下语句以进入外部 Catalog 中的目标数据库。
```
USE catalog_name.db_name;
```
查询外部数据。有关 SELECT 语句的更多用法，请参见SELECT。
```
SELECT * FROM table_name;
```
如果您未在前面的步骤中指定外部 Catalog 和数据库，则可以直接在 SELECT 查询中指定它们。
```
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 集群的数据，请参见默认 Catalog。