使用限制

• 使用IMPORT FOREIGN SCHEMA語句時，建議您添加LIMIT TO限制，并使用括號將需要添加限制的表名稱括起來。如果不添加該限制，系統(tǒng)則將目標MaxCompute工作空間中的所有表批量創(chuàng)建至Hologres中。

• 僅Hologres V1.1.26及以上版本支持對使用IMPORT FOREIGN SCHEMA創(chuàng)建的外部表名稱增加前綴和后綴，如果您的實例是V1.1.26以下版本，請您使用自助升級或加入Hologres釘釘交流群反饋，詳情請參見如何獲取更多的在線支持？。

• 僅Hologres V1.3及以上版本支持MaxCompute的三層模型模式（即在原先的Project和Table之間增加了一層Schema的概念），更多描述請參見Schema操作。如果您想在Hologres中使用MaxCompute的三層模型的項目創(chuàng)建外部表，且您的Hologres版本較低，請您使用自助升級或加入Hologres釘釘交流群反饋，詳情請參見如何獲取更多的在線支持？。

命令格式

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

參數(shù)說明

使用示例

• MaxCompute兩層模型。

  示例選取MaxCompute公共數(shù)據(jù)集public_data中的表，在Hologres中批量創(chuàng)建外部表。您可以參照使用公開數(shù)據(jù)集描述，登錄并查詢數(shù)據(jù)集 。

  • 示例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批量創(chuàng)建外部表，已有外表則報錯。

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

  • 示例5：在public Schema中批量創(chuàng)建外部表，已有外表則跳過該外部表。

    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表創(chuàng)建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可視化批量創(chuàng)建外部表

HoloWeb提供可視化批量創(chuàng)建外部表功能，無需寫SQL命令就能創(chuàng)建外部表，步驟如下。

1. 進入HoloWeb頁面，詳情請參見連接HoloWeb。

2. 在HoloWeb開發(fā)頁面的頂部菜單欄，選擇元數(shù)據(jù)管理 > MaxCompute加速，單擊批量創(chuàng)建外部表。

   您也可以在元數(shù)據(jù)管理界面的已登錄實例列表。單擊目標數(shù)據(jù)庫，鼠標右擊數(shù)據(jù)庫下已創(chuàng)建的目標模式，選擇批量創(chuàng)建外部表。

   

3. 在批量創(chuàng)建外部表頁面，配置各項參數(shù)。

   類別	參數(shù)	描述
   MaxCompute 數(shù)據(jù)源	項目名	MaxCompute的項目名稱。
   	Schema Name	MaxCompute的Schema名稱，對于使用兩層模型的MaxCompute項目，默認不展示；對于使用三層模型的MaxCompute項目，此處可下拉選擇當(dāng)前項目下有權(quán)限的所有Schema。
   目標表位置	Schema Name	模式名稱。 您可以選擇默認創(chuàng)建的public模式，也可以選擇新建的模式名稱。
   高級選項	選擇要直接加速的表	整庫加速：批量創(chuàng)建所選項目或Schema下的所有表。 部分加速：您可以通過搜索表名稱或關(guān)鍵字，選擇需要創(chuàng)建的表。 說明 部分加速最多支持顯示200張表，超出部分將不顯示，但是也會創(chuàng)建成功。 例如，目標項目中共有203個名稱中包含test的表，搜索test時，此處最多只會顯示200個相關(guān)的表，但實際上203個表都會創(chuàng)建成功。
   	表名沖突	忽略，繼續(xù)創(chuàng)建其他表：創(chuàng)建表時，如果數(shù)據(jù)庫中已存在當(dāng)前創(chuàng)建的表名稱，則忽略當(dāng)前創(chuàng)建的表，繼續(xù)創(chuàng)建其他表。 更新，修改同名表：創(chuàng)建表時，如果數(shù)據(jù)庫中已存在當(dāng)前創(chuàng)建的表名稱，則更新已有表的數(shù)據(jù)。 報錯，不再重復(fù)創(chuàng)建：創(chuàng)建表時，如果數(shù)據(jù)庫中已存在當(dāng)前創(chuàng)建的表名稱，則發(fā)送報錯，不再重復(fù)創(chuàng)建。
   	數(shù)據(jù)類型不支持	報錯，導(dǎo)入失敗：如果創(chuàng)建表時存在不支持的數(shù)據(jù)類型，則產(chǎn)生報錯，導(dǎo)入數(shù)據(jù)失敗。 忽略，跳過不支持字段：如果創(chuàng)建表時存在不支持的數(shù)據(jù)類型，則忽略不支持的字段，繼續(xù)導(dǎo)入數(shù)據(jù)。

4. 單擊運行，批量創(chuàng)建外部表。