IMPORT FOREIGN SCHEMA

使用限制

• 使用IMPORT FOREIGN SCHEMA语句时，建议您添加LIMIT TO限制，并使用括号将需要添加限制的表名称括起来。如果不添加该限制，系统则将目标MaxCompute工作空间中的所有表批量创建至Hologres中。

• 仅Hologres V1.1.26及以上版本支持对使用IMPORT FOREIGN SCHEMA创建的外部表名称增加前缀和后缀，如果您的实例是V1.1.26以下版本，请您使用自助升级或加入Hologres钉钉交流群反馈，详情请参见如何获取更多的在线支持？。

• 仅Hologres V1.3及以上版本支持MaxCompute的三层模型模式（即在原先的Project和Table之间增加了一层Schema的概念），更多描述请参见Schema操作。如果您想在Hologres中使用MaxCompute的三层模型的项目创建外部表，且您的Hologres版本较低，请您使用自助升级或加入Hologres钉钉交流群反馈，详情请参见如何获取更多的在线支持？。

命令格式

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

参数说明

使用示例

• MaxCompute两层模型。

  示例选取MaxCompute公共数据集public_data中的表，在Hologres中批量创建外部表。您可以参照使用公开数据集描述，登录并查询数据集 。

  • 示例1：为public schema新建一张外部表，若表存在则更新表。

    IMPORT FOREIGN SCHEMA public_data LIMIT to
    (customer) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'update');

  • 示例2：为public schema批量新建外部表。

     IMPORT FOREIGN SCHEMA public_data LIMIT to(
      customer,
      customer_address,
      customer_demographics,
      inventory,item,
      date_dim,
      warehouse) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'update');

  • 示例3：新建一个testdemo schema并批量新建外部表。

    create schema testdemo;
    
    IMPORT FOREIGN SCHEMA public_data LIMIT to(
      customer,
      customer_address,
      customer_demographics,
      inventory,item,
      date_dim,
      warehouse) 
      FROM server odps_server INTO testdemo options(if_table_exist 'update');
      
    set search_path to testdemo;

  • 示例4：在public schema批创建外部表，已有外表则报错。

    IMPORT FOREIGN SCHEMA public_data LIMIT to
    (customer,
      customer_address) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'error');

  • 示例5：在public schema批量创建外部表，已有外表则跳过该外部表。

    IMPORT FOREIGN SCHEMA public_data LIMIT to
    (customer,
      customer_address) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'ignore');

• MaxCompute三层模型。

  基于MaxComputeodps_hologres项目的tpch_10g这个Schema中的odps_region_10g表创建Hologres中的外部表。

  IMPORT FOREIGN SCHEMA "odps_hologres#tpch_10g" LIMIT to
  (
      odps_region_10g
  )
  FROM SERVER odps_server INTO public OPTIONS(if_table_exist 'error',if_unsupported_type 'error');

HoloWeb可视化批量创建外部表

HoloWeb提供可视化批量创建外部表功能，无需写SQL命令就能创建外部表，步骤如下。

1. 进入HoloWeb页面，详情请参见连接HoloWeb。

2. 在HoloWeb开发页面的顶部菜单栏，选择元数据管理 > MaxCompute加速，单击批量创建外部表。

   您也可以在元数据管理界面的已登录实例列表。单击目标数据库，鼠标右击数据库下已创建的目标模式，选择批量创建外部表。

   

3. 在批量创建外部表页面，配置各项参数。

   类别	参数	描述
   基本属性	实例名	已登录的实例名称。
   	数据库	存放新创建外部表的Hologres数据库名称。
   目标位置	模式	模式名称。 您可以选择默认创建的public模式，也可以选择新建的模式名称。
   来源	类型	目前仅支持MaxCompute外部表。
   	服务器列表	您可以直接调用Hologres底层已创建的名为odps_server的外部表服务器。详细原理请参见Postgres FDW。
   	远程库	MaxCompute的项目名称。
   	选择要直接加速的表	整库加速：批量创建所选项目下的所有表。 部分加速：您可以通过搜索表名称或关键字，选择需要创建的表。 说明 部分加速最多支持显示200张表，超出部分将不显示，但是也会创建成功。 例如，目标项目中共有203个名称中包含test的表，搜索test时，此处最多只会显示200个相关的表，但实际上203个表都会创建成功。
   高级选项	表名冲突	忽略，继续创建其他表：创建表时，如果数据库中已存在当前创建的表名称，则忽略当前创建的表，继续创建其他表。 更新，修改同名表：创建表时，如果数据库中已存在当前创建的表名称，则更新已有表的数据。 报错，不再重复创建：创建表时，如果数据库中已存在当前创建的表名称，则发送报错，不再重复创建。
   	数据类型不支持	报错，导入失败：如果创建表时存在不支持的数据类型，则产生报错，导入数据失败。 忽略，跳过不支持字段：如果创建表时存在不支持的数据类型，则忽略不支持的字段，继续导入数据。

4. 单击运行，批量创建外部表。