すべてのプロダクト
Search
ドキュメントセンター

DataWorks:Hologres外部テーブルの作成

最終更新日:Mar 17, 2025

DDLステートメントを実行することで、Hologres外部テーブルを作成できます。また、DataWorksコンソールでHologres外部テーブルを作成することもできます。このトピックでは、DataWorksコンソールでHologres外部テーブルを作成する方法について説明します。

前提条件

背景情報

Hologresテーブルは、Hologres内部テーブルとHologres外部テーブルに分類されます。

  • Hologres内部テーブル:このタイプのHologresテーブルは、ソースMaxComputeデータを格納できます。ソースMaxComputeテーブルからHologres内部テーブルにデータを同期して、迅速なクエリと分析を行うことができます。 Hologres内部テーブルを使用してMaxComputeデータをクエリするパフォーマンスは、Hologres外部テーブルを使用するよりも優れています。

  • Hologres外部テーブル:このタイプのHologresテーブルは、ソースMaxComputeデータを格納できません。 Hologres外部テーブルを使用して、ソースMaxComputeテーブルのデータをマッピングし、クエリと分析を高速化できます。 Hologres外部テーブルは、冗長なデータストレージを防ぎ、データのインポートやエクスポートを必要とせずに、効率的な方法でクエリ結果を取得できます。

DataWorksは、DataWorksコンソールでHologresテーブルを作成できるデータ処理および開発プラットフォームです。一度に複数のHologres外部テーブルを作成する方法については、「数回クリックするだけでMaxComputeテーブルのスキーマを同期するノードを作成する」をご参照ください。 DDLステートメントを実行してHologresテーブルを作成することもできます。詳細については、「CREATE FOREIGN TABLE」をご参照ください。

制限事項

  • MaxComputeに対してのみHologres外部テーブルを作成できます。

  • DataWorksコンソールでHologres外部テーブルを作成できるのは、中国(上海)リージョンと中国(北京)リージョンのみです。

手順

  1. [datastudio] ページに移動します。

    DataWorksコンソールにログオンします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションペインで、[データ開発とガバナンス] > [データ統合] を選択します。表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[データ統合に移動] をクリックします。

  2. [ワークフロー] を作成します。

    既存の [ワークフロー] がある場合は、この手順をスキップします。

    1. 新建 アイコンにポインターを移動し、[ワークフローの作成] を選択します。

    2. [ワークフローの作成] ダイアログボックスで、[ワークフロー名] パラメーターを設定します。

    3. [作成] をクリックします。

  3. Hologres外部テーブルを作成します。

    1. Create アイコンにポインターを移動し、[テーブルの作成] > [hologres] > [テーブル] を選択します。

    2. [テーブルの作成] ダイアログボックスで、[テーブルタイプ][外部テーブル] に設定し、エンジンインスタンス、パス、名前などのその他のパラメーターを設定します。

      Configure parameters

  4. Hologres外部テーブルを設定します。

    Hologres外部テーブルの設定タブで、パラメーターを設定します。

    1. 基本属性セクションのパラメーターを設定します。

      Basic attribute section次の表に、基本属性セクションのパラメーターを示します。

      パラメーター

      説明

      タイプ

      Hologres外部テーブルのタイプ。

      説明

      MaxComputeに対してのみHologres外部テーブルを作成できます。

      サーバーリスト

      ソースMaxComputeテーブルが存在するサーバー。

      説明

      Hologresの基盤となるレイヤーで作成された odps_server サーバーを使用できます。詳細については、「postgres_fdw」をご参照ください。

      テーブル

      Hologres外部テーブルの作成元となるソースMaxComputeテーブル。作成されたHologres外部テーブルは、今後、ソースMaxComputeテーブルからデータをクエリするために使用されます。

      MaxComputeプロジェクトのモデルタイプに基づいて、次のパラメーターを設定する必要があります:

      • 2層モデル

        • project_name:MaxComputeプロジェクトの名前。

        • table_name:ソースMaxComputeテーブルの名前。

      • 3層モデル

        • project_name:MaxComputeプロジェクトの名前と、ソースMaxComputeテーブルが属するスキーマの名前。 odps_project_name#odps_schema_name 形式で名前を指定します。

        • table_name:ソースMaxComputeテーブルの名前。

      説明

      上記の パラメーターの設定が特定のモデルタイプのMaxComputeプロジェクトの要件を満たしていない場合、エラーが報告されます。エラー例:failed to import foreign schema:Table not found - table_xxx

    2. 物理モデルセクションのパラメーターを設定します。

      説明

      物理モデルセクションのパラメーター設定は、ビジネス要件に基づいたテーブル管理を容易にするためだけに使用され、基盤となるロジックを実装するためには使用されません。

      业务描述

      パラメーター

      説明

      テーマ

      Hologres内部テーブルが属するレベル 1 フォルダーとレベル 2 フォルダー。これらのパラメーターを使用して、ビジネスカテゴリに基づいてテーブルを分類できます。同じビジネスカテゴリのテーブルを同じフォルダーに格納できます。

      説明

      レベル 1 フォルダーとレベル 2 フォルダーは、DataWorksのフォルダーです。フォルダー内のテーブルを簡単に管理できます。

      レイヤー

      Hologres内部テーブルが属する物理データレイヤー。データレイヤリングは、データレイヤーを定義および管理するために使用されます。ほとんどの場合、データレイヤーは、データインポートレイヤー、データ共有レイヤー、およびデータ分析レイヤーに分類されます。ビジネスカテゴリに基づいて、特定のデータレイヤーにテーブルを格納できます。

      説明

      新建 アイコンをクリックして、データレイヤーを作成できます。詳細については、「テーブルの設定の管理」をご参照ください。

      カテゴリ

      Hologres内部テーブルの物理カテゴリ。このパラメーターは、ビジネスディメンションからよりきめ細かくテーブルを分類するために使用されます。ほとんどの場合、テーブルは、基本サービスレベルのテーブル、高度なサービスレベルのテーブル、およびその他のレベルのテーブルに分類されます。

      説明

      新建 アイコンをクリックして、物理カテゴリを作成できます。詳細については、「テーブルの設定の管理」をご参照ください。

    3. テーブル構造設計セクションのパラメーターを設定します。

      Table structure design section手順 4 の 基本属性 セクションで設定した

      説明

      ソース MaxCompute テーブルと Hologres 外部テーブルの間には、フィールドタイプのマッピングが存在します。 ソース MaxCompute テーブルと Hologres 外部テーブルの間で 1 対 1 のマッピングが確立されていることを確認してください。MaxCompute と Hologres 間のデータ型マッピングについては、MaxCompute と Hologres 間のデータ型マッピング をご参照ください。

      パラメーターの設定により、テーブル構造設計セクションのテーブルスキーマが決まります。テーブルスキーマは、ソースMaxComputeテーブルから自動的にデータを読み取るために使用されるHologres外部テーブルを作成するために使用されます。テーブルスキーマは変更できません。

  5. Hologres外部テーブルをコミットしてデプロイします。

    Hologres内部テーブルの設定が完了したら、テーブルを開発環境と本番環境にコミットできます。テーブルがコミットされると、関連環境の計算エンジンインスタンスでテーブルをクエリできます。

    説明

    基本モードのワークスペースを使用している場合は、本番環境にのみテーブルをコミットする必要があります。基本モードと標準モードのワークスペースについては、「基本モードのワークスペースと標準モードのワークスペースの違い」をご参照ください。

    操作

    説明

    開発環境からロード

    開発環境からテーブル情報をロードし、現在のページにテーブル情報を表示します。

    説明

    この操作は、テーブルが開発環境にコミットされた後にのみ実行できます。この操作を実行すると、開発環境のテーブル情報によって現在のページのテーブル情報が上書きされます。

    開発環境にコミット

    開発環境にテーブルをコミットします。これにより、現在のテーブルが開発環境のHologresデータベースに作成されます。

    テーブルがコミットされると、DataStudioの関連ワークフローのHologresフォルダーでテーブルスキーマを表示できます。フォルダーは、テーブルの作成時に指定したフォルダーです。

    本番環境からロード

    本番環境からテーブル情報をロードし、現在のページにテーブル情報を表示します。

    説明

    この操作は、テーブルが本番環境にコミットされた後にのみ実行できます。この操作を実行すると、本番環境のテーブル情報によって現在のページのテーブル情報が上書きされます。

    本番環境にコミット

    本番環境にテーブルをコミットします。これにより、現在のテーブルが本番環境のHologresデータベースに作成されます。

次のステップ

Hologres外部テーブルが作成された後、そのテーブルを使用して、MaxComputeデータをHologres内部テーブルに定期的にインポートできます。