更新时间:2026-11-06 GMT+08:00
分享

USE语句

概述

USE语句用于切换当前会话的默认Catalog。切换后,后续SQL中引用表时可以省略Catalog名称前缀,直接使用表名即可。

适用场景

  • 多Catalog操作:在HiveCatalog和默认Catalog之间切换,访问不同元数据源。
  • 多租户场景:不同数据库隔离不同业务的数据,通过USE快速切换工作上下文。

约束与限制

  • USE CATALOG要求目标Catalog已通过CREATE CATALOG注册。
  • USE仅影响当前会话,不影响其他会话或全局配置。

语法结构

-- 切换当前Catalog

USE CATALOG catalog_name;

使用示例

示例:USE CATALOG切换Catalog

CREATE TABLE test_kafka (
  user_id varchar,
  item_id varchar,
  cat_id varchar,
  test_time timestamp
) WITH (
  'properties.bootstrap.servers' = 'Kafka的Broker实例业务IP:Kafka端口号',
  'format' = 'json',
  'topic' = 'zw_test_kafka',
  'connector' = 'kafka',
  'scan.startup.mode' = 'latest-offset'
);
CREATE CATALOG myhive
WITH
  (
    'type' = 'hive',
    'metastore' = 'lakeformation'
  );
use catalog myhive;
CREATE TABLE IF NOT EXISTS `default`.user_behavior_hive_tbl (
    user_id STRING,
    item_id STRING,
    cat_id STRING,
    ts timestamp,
    dy STRING, 
    ho STRING, 
    mi STRING
  ) PARTITIONED BY (dy, ho, mi) with (
    'connector' = 'hive',
    'partition.time-extractor.timestamp-pattern' = '$dy $ho:$mi:00',
    'sink.partition-commit.trigger' = 'process-time',
    'sink.partition-commit.delay' = '0S',
    'sink.partition-commit.policy.kind' = 'metastore,success-file',
    'hive.storage.file-format'='parquet'
);

INSERT into
  `default`.user_behavior_hive_tbl
SELECT
  user_id,
  item_id,
  cat_id,
  test_time,
  DATE_FORMAT(test_time, 'yyyy-MM-dd'),
  DATE_FORMAT(test_time, 'HH'),
  DATE_FORMAT(test_time, 'mm')
FROM
  default_catalog.default_database.test_kafka;

相关文档