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

DataWorks:カスタム属性

最終更新日:Mar 14, 2026

DataWorks データマップでは、ワークスペースおよびデータセットのビジネスメタデータを拡張するための「カスタム属性」機能を提供しています。この機能には、ビジネスメタデータの管理およびガバナンスを効率化する「属性の継承」メカニズムが含まれています。

概要

DataWorks のカスタム属性機能により、お客様の具体的なビジネス要件に応じたビジネスメタデータでワークスペースおよびデータセットを強化できます。組み込みの継承機構により、大規模なメタデータを一元的に管理でき、メタデータ管理の効率性が大幅に向上します。

重要

現在、カスタム属性は ワークスペース および データセット に対してのみ設定可能です。テーブル、コード、API などの他のオブジェクトには、この機能はまだ対応していません。これらのオブジェクトに対してもカスタム属性を適用したい場合は、チケットを送信してください。

カスタム属性は、以下の課題を解決します:

  • ビジネス文脈の欠如:技術的メタデータでは、「ビジネスオーナーは誰か?」や「このメトリックの定義は何か?」といった重要なビジネス質問に答えることができません。

  • 構成作業の非効率性:数千のテーブルまたはデータセットが、統一された承認プロセスなどの同一のガバナンス基準を満たす必要がある場合、各項目ごとに手動で構成を行うと、時間と労力がかかり、ミスが発生しやすく、保守も困難になります。

カスタム属性の主な機能は以下のとおりです:

  • カスタム属性の定義:管理者が属性の名前、識別子(Identifier)、データ型(例:テキスト、列挙型)を定義し、特定のエンティティタイプに紐付けます。

  • 属性値の構成:ユーザーが、紐付けられたエンティティ上でカスタム属性の値を表示および編集できます。

  • 属性の継承:属性値をオブジェクトの階層間で継承可能であり、繰り返しの構成作業を削減します。

利用シーン

  • データセットにビジネスドメインやデータ所有者などのビジネス情報をタグ付けし、Data Map 上での検索および管理を容易にします。

  • ワークスペースに対して統一されたデータ承認リンクを構成します。そのワークスペース内のすべてのデータセットは、自動的にこのリンクを継承するため、個別に構成する必要がありません。

制限事項

  • カスタム属性の名前は、テナント内で一意である必要があります。

  • カスタム属性の識別子(Identifier)は、テナント内で一意である必要があり、作成後に変更できません。

  • カスタム属性のデータ型は、作成後に変更できません。

権限

以下の表は、カスタム属性関連操作に必要な権限を示しています。Alibaba Cloud アカウントはデフォルトで全権限を持ちます。この表では、RAM ユーザーおよび RAM ロールに必要な権限のみを記載しています。

操作

権限の説明

カスタム属性の作成および管理

以下のいずれかのロールまたは権限が必要です:

  • テナントオーナー

  • テナント管理者

  • テナントデータガバナンス管理者

  • DataWorksFullAccess 権限を持つ RAM ユーザー

ワークスペースに対するカスタム属性の構成

以下のいずれかのロールが必要です:

テナントレベル:テナントオーナー、テナント管理者、またはテナントデータガバナンス管理者

ワークスペースレベル:ワークスペースオーナーまたはワークスペース管理者

データセットに対するカスタム属性の構成

以下のいずれかのロールが必要です:

テナントレベル:テナントオーナー、テナント管理者、またはテナントデータガバナンス管理者

ワークスペースレベル:ワークスペースオーナー、ワークスペース管理者、またはワークスペース開発者

カスタム属性、ワークスペースの詳細、データセットの詳細の表示

制限はありません。

カスタム属性の作成

管理者は、以下の手順に従ってカスタム属性を作成できます。

  1. DataWorks コンソールにログインします。左側のナビゲーションウィンドウで、データマップ をクリックします。

  2. 左側のナビゲーションウィンドウで、Configuration Management アイコンにカーソルを合わせ、Custom Property Configuration を選択します。

  3. カスタム属性管理ページで、+ 追加 をクリックします。

  4. Create Custom Property ダイアログボックスで、パラメーターを構成します。以下の表にパラメーターを示します。

    カテゴリ

    パラメーター

    説明

    属性の構成

    識別子

    カスタム属性の固有識別子(キー)。API 呼び出し等のシナリオで使用されます。識別子には英字、数字、アンダースコア(_)のみ使用可能です。作成後は変更できません。

    Name

    カスタム属性の表示名です。テナント内で一意である必要があり、最大 128 文字まで指定できます。

    Type

    属性値のデータ型です。作成後は変更できません。以下の型がサポートされています:

    • Enum Value:属性値は事前に定義された選択肢から選択されます。

    • Text:属性値は自由入力のテキスト文字列です。

    • Link:属性値はユーザーが指定するハイパーリンクであり、Link TitleURL を含みます。

    Enum Value

    属性の型として Enum Value を選択した場合、選択可能な列挙項目のリストを構成する必要があります。

    Description

    カスタム属性の説明です。

    適用範囲

    Applicable Entity Type

    このカスタム属性が適用されるエンティティタイプです。サポートされるオブジェクトタイプには、ワークスペースおよびデータセットがあります。

    Inherit

    このオプションは、ワークスペース タイプのオブジェクトでのみサポートされます。

    このオプションを有効にすると、属性の継承が可能になります。ワークスペースに関連付けられたデータセットは、自動的に属性値を継承します。

    たとえば、ワークスペースの「環境タイプ」属性を「本番環境」と設定すると、そのワークスペースに関連付けられたすべてのデータセットは、自動的に同じ属性値を受け取ります。親オブジェクトの属性値が更新されると、継承された値も更新されます。

    Allow Overwrite

    このオプションを有効にすると、子オブジェクトが継承された属性値を上書きできます。上書きされた値はローカル値となり、親オブジェクトの値が変更されても更新されません。

    Enable as a Filter

    Enum Value 型の属性にのみ利用可能です。このオプションを有効にすると、カスタム属性を検索フィルターとして使用できます。

    Show on Details Page

    このカスタム属性をオブジェクトの詳細ページに表示するかどうかを指定します。

  5. Confirm をクリックします。カスタム属性が作成されると、カスタム属性管理リストに表示されます。このリストから、属性の編集または削除が可能です。

説明
  • 属性の編集:カスタム属性を作成した後、名前、説明、列挙項目、関連付けられたオブジェクト、継承ルールを変更できます。ただし、属性の識別子(Identifier)および型(Type)は変更できません。

  • 属性の削除:カスタム属性がデータオブジェクトにアタッチされている場合、その属性を削除すると、対応する属性値もオブジェクトから削除されます。この操作は元に戻せません。実行には十分ご注意ください。

カスタム属性値の構成および表示

カスタム属性を作成した後、ワークスペースおよびデータセットに対して特定の属性値を構成できます。

ワークスペースに対するカスタム属性の構成

  1. データマップ ページで、左側のナビゲーションウィンドウにある image アイコンをクリックし、Data Catalog ページに移動します。

  2. データセット を展開します。右側にワークスペースの一覧が表示されます。

  3. 対象のワークスペースを見つけ、そのカスタム属性値を編集します。以下の図では、例として「Test-Attribute」を使用しています。

    image

  4. 構成が完了したら、ワークスペースの詳細 ページでもカスタム属性値を表示できます。

    image

データセットに対するカスタム属性の構成

  1. データマップ ページで、左側のナビゲーションウィンドウにある image アイコンをクリックし、Data Catalog ページに移動します。

  2. 以下のいずれかの操作を実行して、データセットのカスタム属性値を構成します:

    1. 新規データセットの場合:

      データセットの作成プロセス中にカスタム属性値を構成できます。

      image

    2. 既存のデータセットの場合:

      1. データカタログページで データセット を展開し、対象のワークスペースを選択してから、対象のデータセットをクリックします。

      2. データセットの詳細ページで、そのカスタム属性値を編集します。

  3. 構成したカスタム属性値は、データセットの詳細ページで表示できます。

    image

カスタム属性によるフィルター処理

Enum Value 型のカスタム属性で、Enable as a Filter オプションが有効になっている場合、検索時にワークスペースまたはデータセットをフィルター処理できます。

ワークスペースのフィルター処理

ワークスペースをカスタム属性でフィルター処理する方法は、以下の 2 通りあります:

方法 1:左側のナビゲーションウィンドウで検索アイコン image をクリックし、詳細検索ページに移動します。「タイプ」に Workspace を選択し、カスタム属性のフィルター条件を設定します。詳細については、「多次元フィルター処理およびブラウズ」をご参照ください。

方法 2:左側のナビゲーションウィンドウで image アイコンをクリックし、Data Catalog ページに移動します。データセット を展開し、カスタム属性の列挙項目に基づいてフィルター処理します。

image

データセットのフィルター処理

データセットをカスタム属性でフィルター処理する方法は、以下の 2 通りあります:

方法 1:左側のナビゲーションウィンドウで検索アイコン image をクリックし、詳細検索ページに移動します。「タイプ」に Dataset を選択し、カスタム属性のフィルター条件を設定します。詳細については、「多次元フィルター処理およびブラウズ」をご参照ください。

方法 2:左側のナビゲーションウィンドウで image をクリックし、Data Catalog ページに移動します。データセット を展開してワークスペースの一覧を表示し、Dataset をクリックして、カスタム属性の列挙値に基づいて結果をフィルター処理します。

image

属性の継承

カスタム属性は、オブジェクトの階層間で継承をサポートしており、子オブジェクトが親オブジェクトの属性値を継承できます。

  • 継承チェーン:カスタム属性の継承階層は、Workspace > データセット です。

    たとえば、ワークスペースレベルでカスタム属性値を構成すると、そのワークスペース内のすべてのデータセットが自動的にその値を継承します。

  • 継承ポリシー:カスタム属性の作成時に構成できる Allow Overwrite オプションにより、継承動作が定義されます。

    • 上書きを許可する場合:子オブジェクト(データセット)は、デフォルトで親オブジェクト(ワークスペース)から属性値を継承しますが、子オブジェクト上で異なる値を設定して継承値を上書きできます。たとえば、ワークスペースには標準的な承認リンクが設定されており、その大部分のデータセットがこれを継承します。ただし、機密情報を含む特定のデータセットについては、より厳格な承認プロセスを用いたリンクに上書きできます。

    • 上書きを許可しない場合:子オブジェクトは親オブジェクトの属性値を必ず継承しなければならず、変更することはできません。

  • 親オブジェクトの値の変更:親オブジェクトの属性値が変更されると、新しい値はそれを継承するすべての子オブジェクトに反映されます。ただし、上書きされた値を持つ子オブジェクトには影響しません。

  • 継承インジケーター:データセットの詳細ページでは、ワークスペースから継承されたカスタム属性の横にヒントアイコンが表示されます。このアイコンにカーソルを合わせると、継承元および上書きポリシーを確認できます。

    image

関連ドキュメント