默认 Catalog

本文档介绍默认 Catalog 是什么，以及如何通过默认 Catalog 查询 StarRocks 的内部数据。

StarRocks 2.3 及更高版本提供了一个内部 Catalog 来管理 StarRocks 的内部数据。每个 StarRocks 集群只有一个名为 default_catalog 的内部 Catalog。目前，您不能修改内部 Catalog 的名称或创建新的内部 Catalog。

查询内部数据

1. 连接您的 StarRocks 集群。

   • 如果您使用 MySQL 客户端连接 StarRocks 集群，则默认情况下连接后会进入 default_catalog。
   • 如果您使用 JDBC 连接 StarRocks 集群，您可以通过在连接时指定 default_catalog.db_name 直接进入默认 Catalog 中的目标数据库。

2. （可选）使用 SHOW DATABASES 查看数据库

   SHOW DATABASES;

   或

   SHOW DATABASES FROM <catalog_name>;

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 查询中指定

   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;      

参考

要查询外部数据源中的数据，请参见查询外部数据。