ALTER EXTERNAL SCHEMA

功能描述

修改EXTERNAL SCHEMA。

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

语法格式

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;