default_catalog を使用して StarRocks の内部データをクエリする - E-MapReduce (EMR)

各 StarRocks クラスター (バージョン 2.3 以降) には、default_catalog という名前の組み込み内部カタログが必ず 1 つ存在します。これを使用して、Hive や Iceberg などの外部ソースのデータとは対照的に、StarRocks クラスターに直接保存されているデータをクエリします。

仕組み

StarRocks は、catalog.database.table という 3 層の命名階層を使用します。default_catalog は、すべての内部データベースとテーブルの最上位のルートです。例えば、default_catalog.sales_db.orders は、内部カタログの sales_db データベース内の orders テーブルを指します。

default_catalog の名前は固定されており、名前の変更や追加の内部カタログの作成はできません。

内部データのクエリ

説明

<db_name> と <table_name> を実際の値に置き換えてください。

StarRocks クラスターに接続します。詳細については、「クイックスタート」をご参照ください。
- MySQL クライアント：接続後、デフォルトで default_catalog がアクティブになります。
- Java Database Connectivity (JDBC)：接続文字列で、default_catalog.<db_name> フォーマットを使用してデータベースを指定します。

(任意) クラスター内のすべてのデータベースをリスト表示します。

SHOW DATABASES;
-- または、カタログを明示的に指定します
SHOW DATABASES FROM default_catalog;

(任意) データベースを切り替えます。

USE <db_name>;
-- または、カタログを明示的に指定します
USE default_catalog.<db_name>;

内部データをクエリします。

SELECT * FROM <table_name>;

ステップ 3 をスキップした場合は、クエリにデータベース名を含めます：

-- カタログを指定しない場合
SELECT * FROM <db_name>.<table_name>;
-- カタログを指定する場合
SELECT * FROM default_catalog.<db_name>.<table_name>;