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

DataWorks:MaxCompute データ管理

最終更新日:Nov 20, 2025

データカタログは、MaxCompute メタデータを管理し、操作を実行するための統一されたインターフェイスを提供します。このトピックでは、データカタログでテーブル、ビュー、外部テーブル、リソース、関数などのデータオブジェクトを作成および管理する方法について説明します。

制限事項

Resource Access Management (RAM) ユーザーまたは RAM ロールを使用してデータカタログで MaxCompute データを表示する場合、まず必要な MaxCompute 権限を取得する必要があります。MaxCompute データソースまたはプロジェクトでレイヤー 3 モデルが有効になっている場合は、スキーマメタデータを表示するための権限を RAM ユーザーまたは RAM ロールに付与する必要もあります。

説明

MaxCompute プロジェクトに複数のスキーマが含まれている場合、データカタログのプロジェクト詳細ページで完全なスキーマリストを表示するには、すべてのスキーマのメタデータ権限を付与する必要があります。

  • RAM ユーザーへの権限付与:

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER RAM$<Alibaba_Cloud_Account_Name>:<RAM_User_Name>;
  • RAM ロールへの権限付与:

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER `RAM$<Alibaba_Cloud_Account_Name>:role/<RAM_Role_Name>`;
  • MaxCompute プロジェクトでスキーマ機能を有効にすると、スキーマを管理したり、オブジェクトテーブルを管理したりできます。

MaxCompute データカタログページに移動

  1. DataWorks コンソールの [ワークスペース] ページに移動します。上部のナビゲーションバーで、目的のリージョンを選択します。目的のワークスペースを見つけ、[アクション] 列で [ショートカット] > [Data Studio] を選択します。

  2. 左側のナビゲーションウィンドウで、image アイコンをクリックします。[DATA][CATALOG] ツリーで、[MaxCompute] をクリックして MaxCompute データカタログ管理ページに移動します。

MaxCompute データカタログの作成

MaxCompute データカタログ管理ページでは、既存の MaxCompute プロジェクトをデータセットとしてデータカタログに追加できます。

  1. MaxCompute データカタログの横にある image アイコンをクリックします。

  2. 次のいずれかの方法で MaxCompute プロジェクトを追加できます。

    ターゲットソース

    メソッド

    現在のワークスペースで作成された MaxCompute データソース

    [DataWorks データソース] タブで、ターゲットデータソースを見つけて [追加] をクリックします。一度に複数のデータソースを追加するには、それらを選択して [一括追加] をクリックします。

    MaxCompute コンソールで作成された MaxCompute プロジェクト

    [MaxCompute-Project] タブで、ターゲットプロジェクトを見つけて [追加] をクリックします。一度に複数のプロジェクトを追加するには、それらを選択して [一括追加] をクリックします。また、[プロジェクトの作成] をクリックして、新しい MaxCompute プロジェクトを手動で追加することもできます。

    内部プロジェクトの設定項目については、「MaxCompute プロジェクトの構成パラメーター」をご参照ください。外部プロジェクトの操作については、「MaxCompute データレイクハウス」をご参照ください。
    重要

    メタデータの同期には 10〜20 秒の遅延があります。プロジェクトを作成した後、しばらく待ってからリストを手動でリフレッシュして最新情報を表示してください。

MaxCompute データカタログの管理

MaxCompute データカタログで、スキーマ、テーブル、ビューなどのデータオブジェクトを追加および管理できます。

MaxCompute オブジェクト

表示

作成

スキーマ

サポート

サポート

テーブル

サポート

サポート

外部テーブル

サポート

サポート

オブジェクトテーブル

サポート

サポート

表示

サポート

サポート

マテリアライズドビュー

サポート

サポート

Delta Live マテリアライズドビュー

サポート

サポート

リソース

サポート

サポートされていません

関数

サポート

サポートされていません

説明

スキーマレベルは、MaxCompute のスキーマ機能を有効にした後にのみデータカタログに表示されます。詳細については、「スキーマ操作」をご参照ください。

スキーマの管理

  1. スキーマを作成します。

    MaxCompute プロジェクトの右側にある image アイコンをクリックします。表示される [スキーマの作成] ダイアログボックスで、名前を入力して Enter キーを押します。

  2. スキーマを表示します。

    MaxCompute プロジェクトにスキーマを追加した後、プロジェクトの左側にある image アイコンをクリックして、追加されたスキーマを表示できます。

  3. スキーマを削除します。

    スキーマを管理する必要がなくなった場合は、ターゲットスキーマを右クリックして [削除] を選択します。

    重要
    • この操作は元に戻せません。注意して実行してください。

    • スキーマを削除する前に、テーブルやビューなどのスキーマ内のデータオブジェクトを削除する必要があります。

テーブルの管理

テーブルの作成

  1. スキーマの右側で、image > [テーブルの作成] をクリックして [テーブルの作成] ページに移動します。

  2. 次のいずれかの方法でテーブルを作成できます。

    • Copilot を使用してテーブルを作成する:

      1. ページ上部のツールバーで、[Copilot を使用してテーブルを作成] をクリックして Copilot Chat インターフェイスに移動します。

      2. テーブルを作成するための命令を入力します。たとえば、製品売上の日次集計テーブルを作成する などです。

      3. [生成して置換] をクリックします。システムは、命令に基づいてデフォルトのテーブル名とフィールド情報を生成します。

      4. テーブル名とフィールドが期待どおりの場合は、[承諾] をクリックします。

        説明

        テーブル情報を変更するには、[承諾] をクリックしてから、システムが生成したテーブル情報を手動で編集します。

    • テーブルを手動で作成する:

      パラメーターの説明に基づいてテーブルを作成します。

      パラメーター

      説明

      基本情報

      カスタムの [テーブル名][ライフサイクル]、およびその他の情報を指定します。

      フィールド情報

      フィールドとフィールドの注釈情報を編集します。

      • 手動編集: フィールド情報リストの上にある [挿入] ボタンをクリックします。挿入する行数を手動で指定し、フィールドとその注釈情報を編集します。

      • Copilot によるインテリジェント編集: フィールド情報リストの上にある [フィールドの生成] または [フィールドの説明の生成] をクリックします。システムは、設定したテーブル名と説明に基づいて、関連するフィールドとコメントを生成できます。

      詳細設定

      [テーブルタイプ] はデフォルトで [内部テーブル] に設定されています。[クラスタープロパティ] を構成できます。

  3. 構成が完了したら、上部のツールバーで [公開] をクリックし、公開プロセスを完了してテーブルを作成します。

テーブルの管理

  1. テーブルを表示します。

    MaxCompute プロジェクトでテーブルを作成した後、プロジェクトの左側にある image アイコンをクリックし、[テーブル] をクリックしてテーブルの基本情報を表示できます。また、特定のテーブル名をクリックして、その [フィールド][DDL] などの詳細を表示することもできます。

  2. テーブルの操作。

    1. 操作を実行する内部テーブルを右クリックします。[SQL クエリ文の生成][データのインポート][権限の要求]Hologres へのメタデータマッピング、または Hologres へのデータ同期 を選択できます。

    2. 操作を実行する内部テーブルをダブルクリックして詳細ページに移動します。右上隅の [編集] ボタンをクリックします。テーブル編集ページで、[ライフサイクル][テーブルの説明] を変更したり、フィールドを追加、変更、または削除したりできます。

      重要
      • フィールド名の変更、フィールドの削除、またはフィールドタイプの変更を行う前に、MaxCompute SQL ノードで次のコマンドを実行してスキーマ進化を有効にします: setproject odps.schema.evolution.enable=true

      • フィールドを削除するには、対応する行を選択し、右クリックして [削除] を選択します。

      • テーブル情報を更新した後、再度 [公開] をクリックする必要があります。そうしないと、操作は有効になりません。

  3. テーブルを削除します。

    削除する内部テーブルを右クリックして [削除] を選択します。

    重要

    この操作は元に戻せません。注意して実行してください。

外部テーブルの管理

外部テーブルの作成

  1. スキーマの右側で、image > [外部テーブルの作成] をクリックして、[外部] テーブルの作成ページに移動します。

  2. 次のいずれかの方法で外部テーブルを作成できます。

    • Copilot を使用してテーブルを作成する:

      1. ツールバーで、[Copilot を使用してテーブルを作成] をクリックして Copilot Chat インターフェイスに移動します。

      2. テーブルを作成するための命令を入力します。たとえば、製品売上の日次集計テーブルを作成する などです。

      3. [生成して置換] をクリックします。システムは、命令に基づいてデフォルトのテーブル名とフィールド情報を生成します。

      4. テーブル名とフィールドが期待どおりの場合は、[承諾] をクリックします。

        説明

        テーブル情報を変更するには、[承諾] をクリックしてから、システムが生成したテーブル情報を手動で編集します。

    • テーブルを手動で作成する:

      パラメーターの説明に基づいて外部テーブルを作成できます。

      パラメーター

      説明

      基本情報

      カスタムの [テーブル名][ライフサイクル]、およびその他の情報を指定します。

      フィールド情報

      フィールドとフィールドの注釈情報を編集します。

      • 手動編集: フィールド情報リストの上にある [挿入] ボタンをクリックします。挿入する行数を手動で指定し、フィールドとその注釈情報を編集します。

      • Copilot によるインテリジェント編集: フィールド情報リストの上にある [フィールドの生成] または [フィールドの説明の生成] をクリックします。システムは、設定したテーブル名と説明に基づいて、関連するフィールドとコメントを生成できます。

      詳細設定

      [テーブルタイプ] はデフォルトで [外部テーブル] に設定されています。OSS の [ストレージの場所][ストレージフォーマット] を構成する必要があります。

      • ストレージロケーション: oss://<OSS_Bucket_Name>/

        説明

        OSS バケット名は、「バケットの概要」から取得できます。

      • [ストレージフォーマット]: CSV、ORC、TEXTFILE など、複数のフォーマットがサポートされています。

  3. 構成が完了したら、ツールバーの [公開] をクリックしてテーブルを作成します。

外部テーブルの管理

  1. 外部テーブルを表示します。

    MaxCompute プロジェクトで外部テーブルを作成した後、プロジェクトの左側にある image アイコンをクリックし、[外部テーブル] をクリックしてその基本情報を表示できます。また、特定のテーブル名をクリックして、その [フィールド][DDL] などの詳細を表示することもできます。

  2. 外部テーブルの操作。

    変更する外部テーブルをダブルクリックして詳細ページを開きます。右上隅の [編集] ボタンをクリックします。テーブル編集ページで、[ライフサイクル][テーブルの説明] を変更したり、フィールドを追加、変更、または削除したりできます。

    重要
    • フィールド名の変更、フィールドの削除、またはフィールドタイプの変更を行う前に、MaxCompute SQL ノードで次のコマンドを実行してスキーマ進化を有効にします: setproject odps.schema.evolution.enable=true

    • フィールドを削除するには、対応する行を選択し、右クリックして [削除] を選択します。

    • テーブル情報を更新した後、再度 [公開] をクリックする必要があります。そうしないと、操作は有効になりません。

  3. 外部テーブルを削除します。

    削除する外部テーブルを右クリックして [削除] を選択します。

オブジェクトテーブルの管理

スキーマ機能が有効になっている MaxCompute プロジェクトでのみオブジェクトテーブルを管理できます。

オブジェクトテーブルの管理

  1. オブジェクトテーブルを表示します。

    MaxCompute プロジェクトでOBJECT TABLE を作成した後、プロジェクトの左側にある image アイコンをクリックし、[オブジェクトテーブル] をクリックしてオブジェクトテーブルの基本情報を表示できます。また、特定のテーブル名をクリックして、その [フィールド][DDL] などの詳細を表示することもできます。

  2. オブジェクトテーブルを操作します。

    管理するオブジェクトテーブルを右クリックします。[SQL クエリ文の生成][権限の要求]MaxCompute メタデータを Hologres 外部テーブルにマッピングする、または MaxCompute データを Hologres 内部テーブルに同期する を選択できます。

  3. オブジェクトテーブルを削除します。

    削除するオブジェクトテーブルを右クリックして [削除] を選択します。

    重要

    この操作は元に戻せません。注意して実行してください。

ビューの管理

ビューの作成

  1. スキーマの右側で、image > [ビューの作成] をクリックして [ビューの作成] ページを開きます。

  2. ビューの作成または更新」の説明に従ってコマンドを変更します。view_name を作成するビューの名前に変更します。AS キーワードの後に、ビューのデータソースのクエリ文を追加します。

  3. ページ上部の [公開] をクリックしてビューを作成します。

ビューの管理

  1. ビューの詳細を表示する

    MaxCompute プロジェクトでビューを作成した後、プロジェクトの左側にある image アイコンをクリックし、[ビュー] をクリックしてその基本情報を表示できます。また、特定のビュー名をクリックして、その [フィールド][DDL] などの詳細を表示することもできます。

  2. ビューの操作

    編集するビューをダブルクリックして詳細ページを開きます。右上隅の [編集] ボタンをクリックします。ビュー編集ページで、AS キーワードの後のデータソースクエリ文を変更することでビューを変更できます。

  3. ビューを削除する

    削除するビューを右クリックして [削除] を選択します。

マテリアライズドビューの管理

マテリアライズドビューの作成

  1. スキーマの右側で、image > [マテリアライズドビューの作成] をクリックして [マテリアライズドビューの作成] ページを開きます。

  2. マテリアライズドビューの作成」の説明に従ってコマンドを変更します。view_name を作成するマテリアライズドビューの名前に置き換えます。AS 文の後に、マテリアライズドビューのデータソースのクエリ文を追加します。

  3. ページ上部の [公開] をクリックしてマテリアライズドビューを作成します。

マテリアライズドビューの管理

  1. マテリアライズドビューを表示します。

    MaxCompute プロジェクトでマテリアライズドビューが作成された後、その基本情報を表示できます。プロジェクトの左側にある image アイコンをクリックし、[マテリアライズドビュー] をクリックします。また、特定のマテリアライズドビュー名をクリックして、その [フィールド][DDL] などの詳細を表示することもできます。

  2. マテリアライズドビューを削除します。

    削除するマテリアライズドビューを右クリックして [削除] を選択します。

Delta Live マテリアライズドビューの管理

動的マテリアライズドビューの作成

  1. スキーマの右側で、image > [Delta Live マテリアライズドビューの作成] をクリックして [Delta Live マテリアライズドビューの作成] ページを開きます。主要な構成パラメーターは次のとおりです:

    パラメーター

    説明

    データ生成 SQL

    動的マテリアライズドビュー のコマンドに基づいて [データ生成 SQL] を入力します。[プリコンパイル] ボタンをクリックして、入力した SQL の構文を確認します。

    重要

    非パーティションテーブルにはプライマリキーが必要です。

    フィールド詳細

    プリコンパイルが成功した後に解析されたフィールドの詳細。

    プライマリキーフィールド情報

    データ生成 SQL がプリコンパイルされると、システムはプライマリキーとして使用できるフィールドを読み取り、プライマリキーフィールドのドロップダウンリストに表示します。複数のプライマリキーフィールドを選択できます。

    パーティションフィールド情報

    データ生成 SQL がプリコンパイルされると、パーティションフィールドはパーティション分割できるフィールドを読み取り、パーティションフィールドのドロップダウンリストに表示します。パーティションフィールドを選択して、動的マテリアライズドビューをパーティション分割するかどうかを決定できます。複数のパーティションフィールドを選択できます。

    チューニングパラメーター

    複数のパラメーターのキーと値のペアを構成できます。これらのキーと値のペアは、DDL の TBLPROPERTIES テーブルプロパティに生成する必要があります。

    データリフレッシュポリシー

    • 非パーティション Delta Live マテリアライズドビューのリフレッシュ構成: パーティションフィールドを指定しない場合、非パーティションの動的マテリアライズドビューが作成されます。

      • MaxCompute の動的マテリアライズドビューでは、リフレッシュモードはデフォルトで増分更新に設定されます。テーブルプロパティは TBLPROPERTIES("refresh_mode"="incremental") です。

      • サポートされているリフレッシュスケジューリングメソッドは、MaxCompute 自動更新DataWorks 定期更新です。

    • パーティション化された Delta Live マテリアライズドビューのリフレッシュ構成: パーティションフィールドを指定すると、パーティション化された動的マテリアライズドビューが作成されます。

      • パーティションリフレッシュ: リフレッシュスケジューリングメソッド、データの自動更新の有無、スケジューリングエポック、リフレッシュ期間などの設定を構成します。

      • 履歴パーティションデータのリフレッシュ: リフレッシュサイクルが完了したパーティションのデータをリフレッシュするかどうかを構成します。

  2. ページ上部の [公開] をクリックして、動的マテリアライズドビューを作成します。

動的マテリアライズドビューの管理

  1. 開発環境または本番環境への公開: 標準モードのワークスペースでは、オブジェクトを別の環境に公開できます。

  2. 動的マテリアライズドビューを表示します。

    MaxCompute プロジェクトで動的マテリアライズドビューを作成した後、プロジェクト名の左側にある image アイコンをクリックし、[Delta Live マテリアライズドビュー] をクリックしてその基本情報を表示できます。また、特定のマテリアライズドビュー名をクリックして、その [フィールド][DDL] 文などの詳細を表示することもできます。

  3. 動的マテリアライズドビューを削除します。

    削除する動マテリアライズドビューを右クリックして [削除] を選択します。

リソースデータオブジェクトの管理

リソースの管理

DataWorks Resource Management でリソースを作成した後、MaxCompute プロジェクトの左側にある image アイコンをクリックし、[リソース] をクリックしてリソースの基本情報を表示できます。また、特定のリソース名をクリックして、そのストレージサイズなどの詳細情報を表示することもできます。

関数の管理

DataWorks Resource Management で関数を作成した後、MaxCompute プロジェクトの左側にある image アイコンをクリックし、[関数] をクリックして関数の基本情報を表示できます。また、特定の関数名をクリックして、そのストレージサイズなどの詳細情報を表示することもできます。

MaxCompute データカタログの表示と削除

MaxCompute データカタログを使用する必要がなくなった場合は、表示して削除できます。

  1. プロジェクトを表示します。

    1. MaxCompute データカタログにプロジェクトを追加した後、データカタログの左側にある image アイコンをクリックしてプロジェクトを表示できます。

    2. MaxCompute プロジェクトにマウスポインターを合わせると、そのストレージ使用量やその他の関連情報が表示されます。

  2. プロジェクトを削除します。

    MaxCompute プロジェクトを管理する必要がなくなった場合は、ターゲットプロジェクトを右クリックして [削除] を選択します。