USE

説明

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

構文

USE [<catalog_name>.]<db_name>

パラメータ

パラメータ	必須	説明
catalog_name	いいえ	カタログ名。 このパラメータが指定されていない場合、default_catalog のデータベースがデフォルトで使用されます。 外部カタログのデータベースを使用する場合は、このパラメータを指定する必要があります。詳細は、例2を参照してください。 異なるカタログ間でデータベースを切り替える場合は、このパラメータを指定する必要があります。詳細は、例3を参照してください。 カタログの詳細については、 概要 を参照してください。
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;