大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:Default catalog

· 52CE 我爱测

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

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. (可选)通过 SHOW DATABASES 查看数据库:

    SHOW DATABASES;
    

    或

    SHOW DATABASES FROM default_catalog;
    
  3. (可选)通过 SET CATALOG 切换当前会话生效的 Catalog:

    SET CATALOG <catalog_name>;
    

    再通过 USE 指定当前会话生效的数据库:

    USE <db_name>;
    

    或者,也可以通过 USE 直接将会话切换到目标 Catalog 下的指定数据库:

    USE <catalog_name>.<db_name>;
    
  4. 通过 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;

更多操作

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

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。