USE

説明

セッションのアクティブなデータベースを指定します。その後、テーブルの作成やクエリの実行などの操作を行うことができます。

構文

USE [<catalog_name>.]<db_name>

パラメータ

パラメータ	必須	説明
catalog_name	いいえ	catalog 名。 このパラメータが指定されていない場合、default_catalog のデータベースがデフォルトで使用されます。 external catalog のデータベースを使用する場合、このパラメータを指定する必要があります。詳細は、例 2 を参照してください。 異なる catalog 間でデータベースを切り替える場合、このパラメータを指定する必要があります。詳細は、例 3 を参照してください。 catalog についての詳細は、概要を参照してください。
db_name	はい	データベース名。データベースは存在している必要があります。

例

例 1: default_catalog の example_db をセッションのアクティブなデータベースとして使用します。

USE default_catalog.example_db;

または

USE example_db;

例 2: hive_catalog の example_db をセッションのアクティブなデータベースとして使用します。

USE hive_catalog.example_db;

例 3: セッションのアクティブなデータベースを hive_catalog.example_table1 から iceberg_catalog.example_table2 に切り替えます。

USE iceberg_catalog.example_table2;