Default catalog
本文介绍什么是 Default Catalog,以及如何使用 Default Catalog 查询 StarRocks 内部数据。
StarRocks 2.3 及以上版本提供了 Internal Catalog(内部数据目录),用于管理 StarRocks 的内部数据。每个 StarRocks 集群都有且只有一个 Internal Catalog,名为 default_catalog
。StarRocks 暂不支持修改 Internal Catalog 的名称,也不支持创建新的 Internal Catalog。
查询内部数据
-
连接 StarRocks。
- 如从 MySQL 客户端连接到 StarRocks。连接后,默认进入到
default_catalog
。 - 如使用 JDBC 连接到 StarRocks,连接时即可通过
default_catalog.db_name
的方式指定要连接的数据库。
- 如从 MySQL 客户端连接到 StarRocks。连接后,默认进入到
-
(可选)通过 SHOW DATABASES 查看数据库:
SHOW DATABASES;
或
SHOW DATABASES FROM default_catalog;
-
(可选)通过 SET CATALOG 切换当前会话生效的 Catalog:
SET CATALOG <catalog_name>;
再通过 USE 指定当前会话生效的数据库:
USE <db_name>;
或者,也可以通过 USE 直接将会话切换到目标 Catalog 下的指定数据库:
USE <catalog_name>.<db_name>;
-
通过 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;
更多操作
如要查询外部数据,请参见查询外部数据。