更新时间:2024-06-19 GMT+08:00

ALTER EXTERNAL SCHEMA

功能描述

修改EXTERNAL SCHEMA。

ALTER EXTERNAL SCHEMA语法仅云原生数仓3.0版本支持。

语法格式

根据指定的名字修改EXTERNAL SCHEMA。
1
2
3
4
5
6
ALTER EXTERNAL SCHEMA schema_name 
    WITH SOURCE source_type
    DATABASE 'db_name'
    SERVER srv_name
    METAADDRESS 'address'
    CONFIGURATION 'confpath';

参数说明

  • schema_name

    外部模式名字。

    取值范围:字符串,要符合标识符的命名规范。

    • 模式名不能和当前数据库里其他的模式重名。
    • 模式的名字不可以“pg_”开头。
  • SOURCE

    外部元数据存储引擎的类型,当前source_type仅支持Hive。

  • DATABASE

    指定外部SCHEMA所对应的hive中数据库。

    external schema与hive中的数据库是多对一的对应关系。

  • SERVER

    取值范围:已存在的FOREIGN SERVER。

    通过external schema关联foreign server以达到访问外部数据的目的。

  • METAADDRESS

    表示hivemetastore通讯接口。

  • CONFIGURATION

    表示hivemetastore相关配置文件存放路径。

如果当前搜索路径上的模式中存在同名对象时,需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。

示例

修改名称为ex1的EXTERNAL SCHEMA的数据库和FOREIGN SERVER:

1
2
3
ALTER EXTERNAL SCHEMA ex1
    WITH DATABASE 'hms'
         SERVER obs_server;