Hologres:CREATE FOREIGN TABLE

制限事項

Hologres V1.3 以降のバージョンのみが、MaxCompute の 3レイヤーモデルをサポートしています。3レイヤーモデルでは、プロジェクトとテーブルの間にスキーマレイヤーが追加されます。詳細については、「スキーマ操作」をご参照ください。3レイヤーモデルを使用する MaxCompute プロジェクトに対して外部テーブルを作成する場合、Hologres インスタンスのバージョンが V1.3 より前であれば、アップグレードが必要です。アップグレードに失敗した場合は、「アップグレード準備時の一般的なエラー」をご参照ください。また、Hologres の DingTalk グループに参加してフィードバックを投稿することもできます。詳細については、「オンラインサポートの利用方法」をご参照ください。

構文

CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [
  { column_name data_type }
  [, ... ]
  ] )
SERVER odps_server
[ OPTIONS ( option 'value' [, ... ] ) ]

次の表にパラメーターを示します。

failed to import foreign schema:Table not found - table_xxx

例

• 外部テーブルから直接データをクエリする

  Hologres で外部テーブルを作成すると、MaxCompute 外部テーブルから直接データをクエリできます。次の SQL 文に例を示します。

  -- 2レイヤーモデル
  CREATE FOREIGN TABLE src_pt(
    id text, 
    pt text) 
  SERVER odps_server 
  OPTIONS(project_name '<odps_project>', table_name '<odps_table>');
  
  -- 3レイヤーモデル
  CREATE FOREIGN TABLE src_pt(
    id text,
    pt text)
  SERVER odps_server
  OPTIONS(project_name '<odps_project>#<odps_schema>', table_name '<odps_table>');
  
  SELECT * FROM src_pt;

  詳細については、「外部テーブルに基づく MaxCompute データのクエリ高速化」をご参照ください。

• 外部テーブルからデータをインポートしてからクエリする

  データをクエリする前に、MaxCompute から Hologres にデータをインポートできます。次の文に例を示します。

  CREATE FOREIGN TABLE src_pt_odps(
    id text,
    pt text) 
  SERVER odps_server 
  OPTIONS (project_name'<odps_project>', table_name'<odps_table>');
  
  BEGIN;
  CREATE TABLE src_pt(
   id text, 
    pt text);
  COMMIT;
  
  INSERT INTO src_pt SELECT * FROM src_pt_odps;

  詳細については、「SQL ステートメントを実行して MaxCompute から Hologres にデータをインポートする」をご参照ください。

MaxCompute と Hologres のデータ型のマッピング