本小节将会为您介绍在交互式分析(Hologres)中import foreign schema的用法

命令介绍

import foreign schema:批量新建外部表(当前仅支持MaxCompute表)。

阿里云2000元代金券免费领,最新优惠1折抢购,2核4G云服务器仅799元/3年,新老用户同享,立即抢购>>>

说明 新建的外部表名将会同MaxCompute表名一致。

命令格式

在交互式分析中import foreign schema的命令格式如下:

IMPORT FOREIGN SCHEMA remote_schema     [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ]     FROM SERVER server_name     INTO local_schema      [ OPTIONS ( option 'value' [, ... ] ) ]

参数说明

  • remote_schema : 要导入的MaxCompute表所在的project name。
  • table_name: 要导入的MaxCompute表。
  • server_name: MaxCompute外部server名称。
  • local_schema: 外部表要导入到交互式分析的schema名称(默认为public,也可以自己新建schema)。
  • options: 交互式分析当前版本支持两个option:
    1. if_table_exist:表示当import时已经存在该表,可以有三种选择:
      1. ‘error’ : default value,表示已有同名外部表。
      2. ‘ignore’ : 忽略同名表的存在, 跳过该表的导入,不重复。
      3. ‘update’: 更新该同名表,会重新导入该表。
    2. if_unsupported_type, 表示import 时候外部表中存在交互式分析不支持的数据类型,可以有两种选择:
      1. ‘error’ :报错, import失败, 同时会提示哪些表存在不支持的类型。
      2. ‘skip’ :default value,表示跳过那些存在不支持类型表的导入,同时提示哪些表被跳过。

使用示例

在交互式分析中批量新建外部表import foreign schema的示例用法如下:

//为public schema新建一张外部表  import foreign schema <odpsproject_name> limit to (bank_data) from server odps_server into PUBLIC;  //新建一个holotest schema,并批量新建外部表  create schema testdemo; import foreign schema odps_4_holoworkshop limit to (customer,lightning_cat_industry) from server odps_server into testdemo; set search_path to testdemo; d  //设定option import foreign schema <odpsproject_name> limit to (customer) from server odps_server into testdemo options( if_table_exist 'error');   import foreign schema <odpsproject_name> limit to (customer) from server odps_server into testdemo options( if_table_exist 'ignore');   import foreign schema <odpsproject_name> limit to (customer) from server odps_server into testdemo options( if_table_exist 'update'); IMPORT FOREIGN SCHEMA

IMPORT FOREIGN SCHEMA_SCHEMA_DDL_SQL参考_交互式分析HologresIMPORT FOREIGN SCHEMA_SCHEMA_DDL_SQL参考_交互式分析Hologres

使用限制

import foreign schema最好加上limit to 限制,并且limit的表名需要用括号括起来。如果不加,将会将指定的MaxCompute工作空间所有表都批量新建至交互式分析中。