更新时间:2024-09-24 GMT+08:00
分享

ALTER EXTERNAL SCHEMA

功能描述

修改EXTERNAL SCHEMA。该语法仅8.2.1.300及以上版本支持。

语法格式

  • 根据指定的名字修改EXTERNAL SCHEMA。
    1
    2
    3
    4
    5
    6
    7
    8
    ALTER EXTERNAL SCHEMA schema_name 
        WITH [ SOURCE source_name ]
             [ DATABASE 'database_name' ]
             [ SERVER server_name ]
             [ CATALOG 'catalog_name' ]
             [ OPTIONS ( { option_name ' value ' } [, ...] ) ]
             [ METAADDRESS 'address']
             [ CONFIGURATION 'confpath'];
    

参数说明

  • schema_name

    要修改的外部模式的名字。

  • SOURCE

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

  • DATABASE

    指定外部SCHEMA所对应的要访问的数据库。

  • SERVER

    取值范围:已存在的foreign server且type类型为lf、dli、obs或hdfs。

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

  • CATALOG

    Lakeformation中对应的要访问的catalog。

  • OPTIONS

    用于指定外表数据的各类参数,参数类型如下所示。该参数仅8.3.0及以上版本支持。

    dli_project_id

    DLI服务对应的项目编号,可在管理控制台上获取项目ID,该参数仅支持server类型为DLI时设置。

  • METAADDRESS

    表示hivemetastore通讯接口。该参数仅9.1.0及以上版本支持。

  • CONFIGURATION

    表示hivemetastore相关配置文件存放路径。该参数仅9.1.0及以上版本支持。

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

示例

修改ex1对应的数据库和FOREIGN SERVER:

1
2
3
ALTER EXTERNAL SCHEMA ex1
    WITH DATABASE 'demo'
         SERVER lf_server;

相关文档