跳到主要内容
版本:2.5

Default catalog

本文介绍什么是 Default Catalog,以及如何使用 Default Catalog 查询 StarRocks 内部数据。

StarRocks 2.3 及以上版本提供了 Internal Catalog(内部数据目录),用于管理 StarRocks 的内部数据。每个 StarRocks 集群都有且只有一个 Internal Catalog,名为 default_catalog。StarRocks 暂不支持修改 Internal Catalog 的名称,也不支持创建新的 Internal Catalog。

查询内部数据

  1. 连接 StarRocks。

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

    SHOW DATABASES;

    SHOW DATABASES FROM default_catalog;
  3. (可选)执行如下语句切换到指定数据库。有关参数说明和示例,请参见 USE

    USE db_name;

    USE default_catalog.db_name;
  4. 查询内部数据。更多 SELECT 的使用方法,请参见 SELECT

    SELECT * FROM table_name;

    如在以上步骤中未指定数据库,则可以在查询语句中直接指定。

    SELECT * FROM db_name.table_name;

    SELECT * FROM default_catalog.db_name.table_name;

示例

如要查询 olap_db.olap_table 中的数据,操作如下:

USE olap_db;
SELECT * FROM olap_table limit 1;

SELECT * FROM olap_db.olap_table limit 1;   

SELECT * FROM default_catalog.olap_db.olap_table limit 1;

更多操作

如要查询外部数据,请参见查询外部数据