文档

Default Catalog

更新时间:

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

查询内部数据

  1. 连接StarRocks实例,详情请参见连接实例

  2. (可选)查看与选择数据库。

    1. 查看Catalog中的数据库。

      SHOW DATABASES;

      您也可以指定默认目录。

      SHOW DATABASES FROM default_catalog;
    2. 切换当前会话的Catalog和数据库。

      SET CATALOG <catalog_name>;
      USE <db_name>;

      您也可以直接使用USE来切换。

      USE <catalog_name>.<db_name>;
  3. 查询外部数据。

    SELECT * FROM <table_name>;

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

    SELECT * FROM <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;