Default catalog

このトピックでは、default catalog とは何か、そして default catalog を使用して StarRocks の内部データをクエリする方法について説明します。

StarRocks 2.3 以降では、StarRocks の内部データを管理するための internal catalog が提供されています。各 StarRocks クラスターには default_catalog という名前の internal catalog が1つだけあります。現在、internal catalog の名前を変更したり、新しい internal catalog を作成したりすることはできません。

内部データのクエリ

1. StarRocks クラスターに接続します。

   • MySQL クライアントを使用して StarRocks クラスターに接続する場合、接続後にデフォルトで default_catalog に移動します。
   • JDBC を使用して StarRocks クラスターに接続する場合、接続時に default_catalog.db_name を指定することで、default 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;      

参考

外部データソースからデータをクエリするには、Query external data を参照してください。