USE

説明

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

構文

USE [<catalog_name>.]<db_name>

パラメータ

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