Default catalog
デフォルトカタログ
このトピックでは、デフォルトカタログについて説明し、デフォルトカ タログを使用してStarRocksの内部データをクエリする方法について説明します。
StarRocks 2.3以降では、内部データを管理するための内部カタログが提供されます。各StarRocksクラスタには、default_catalog
という名前の内部カタログが1つだけあります。現在は内部カタログの名前を変更したり、新しい内部カタログを作成することはできません。
内部データのクエリ
-
StarRocksクラスタに接続します。
- StarRocksクラスタにMySQLクライアントを使用して接続する場合は、接続後にデフォルトで
default_catalog
に移動します。 - JDBCを使用してStarRocksクラスタに接続する場合は、接続時に
default_catalog.db_name
を指定することでデフォルトカタログ内の目的のデータベースに直接アクセスできます。
- StarRocksクラスタにMySQLクライアントを使用して接続する場合は、接続後にデフォルトで
-
(任意) SHOW DATABASESを使用してデータベースを表示します:
SHOW DATABASES;
または
SHOW DATABASES FROM <catalog_name>;
-
(任意) SET CATALOGを使用して現在のセッションで目的のカタログに切り替えます:
SET CATALOG <catalog_name>;
次に、USEを使用して現在のセッションでアクティブなデータベースを指定します:
USE <db_name>;
または、USEを使用して、目的のカタログ内のアクティブなデータベースに直接移動することもできます:
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;
参考
外部のデータソースからデータをクエリするには、外部データのクエリを参照してください。