跳到主要内容
版本:Latest-3.3

查询外部数据

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

前提条件

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

操作步骤

  1. 连接 StarRocks。

    • 如从 MySQL 客户端连接到 StarRocks。连接后,默认进入到 default_catalog
    • 如使用 JDBC 连接到 StarRocks,连接时即可通过 default_catalog.db_name 的方式指定要连接的数据库。
  2. (可选)执行以下语句查看当前 StarRocks 集群中的所有 Catalog 并找到指定的 External Catalog。有关返回值说明,请参见 SHOW CATALOGS

    SHOW CATALOGS;
  3. (可选)执行以下语句查看指定 external catalog 中的数据库。有关参数和返回值说明,请参见 SHOW DATABASES

    SHOW DATABASES FROM catalog_name;
  4. (可选)执行以下语句将当前会话切换到指定 external catalog 的指定数据库。有关参数说明和示例,请参见 USE

    USE catalog_name.db_name;
  5. 查询外部数据。更多 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 的内部数据,请参见查询内部数据