DataWorks:MaxCompute テーブルデータ

テーブル詳細ページのヘッダーには、テーブル名、タイプタグ、テーブルの説明、および一連のボタンが表示されます。ボタンの表示は、権限、現在のテーブルタイプ、テナントのアクティベーション状況によって異なります。

• [Request Permissions]： 現在のアカウントがこのテーブルへのアクセス権を持っていない場合に表示されます。クリックすると、セキュリティセンターに移動し、権限申請を送信できます。

• [Add to Album]： 現在のテーブルをデータアルバムに追加します。テーブルが既にアルバムに含まれている場合、ボタンは所属するアルバムを表示するエントリに変わります。

• [Favorite]/[Unfavorite]： 現在のテーブルをマイお気に入りに追加、またはお気に入りから削除します。

• [API Generation]： テーブルのクエリ機能を DataService API として公開します。サポートされているデータソースタイプ (MaxCompute、Hologres、AnalyticDB、PostgreSQL、MySQL、SQL Server、Oracle、OTS、SelectDB、MongoDB など) でのみ表示されます。レイクハウスプロジェクトのテーブルではサポートされていません。

• [DataAnalysis]： データ分析に移動し、現在のテーブル用に新しいクエリページが自動的に作成されます。MaxCompute (レイクハウス以外) やパブリッククラウド DLF などのデータソースタイプでサポートされています。

• [AI Enhancement]： Copilot を使用して、テーブルのノートをインテリジェントに生成または更新します。実行中は、ボタンに [生成中] と表示されます。AI 強化権限と、テナントで Copilot が利用可能である必要があります。

• [Refresh Metadata]： テーブルのメタデータ同期を手動でトリガーします。My Data > My Tools > Refresh Table Metadata の単一テーブルアクションと同等です。レイクハウス以外のプロジェクトの MaxCompute、E-MapReduce、パブリッククラウド DLF などのデータソースでのみ表示されます。

テーブル詳細ページの左側にある [Table Basic Information] セクションには、[Views]、[Number of Reads]、[Number of Favorites] などの情報が表示されます。

• [Views]： 過去 30 日間にデータマップでテーブル詳細ページが閲覧された回数。このデータはオフラインで収集され、T+1 の遅延があります。

• [Number of Reads]： 過去 30 日間に本番環境から MaxCompute テーブルを読み取ったタスクの数。読み取りタスクには、SQL、Tunnel Download、Data Integration、DataService Studio API 呼び出しが含まれます。現在、DataWorks のスケジュール済みタスクからの読み取りのみがカウントされます。このデータはオフラインで収集され、T+1 の遅延があります。

• [Number of Favorites]： テーブルをお気に入りに追加したユーザーの数。このデータは ほぼリアルタイム で収集されます。

• [Output Nodes]： 現在のテーブルに書き込む自動トリガー DataWorks ノードの ID。テーブルが定期的に更新されているにもかかわらずノード ID が表示されない場合、DataWorks 外のスケジュール済みノードが書き込んでいる可能性があります。詳細については、テーブル所有者にお問い合わせください。このデータはオフラインで収集され、T+1 の遅延があります。

  説明

  出力ノードのコードを表示する権限がない場合は、ノードが配置されているワークスペースの管理者に連絡して、必要な権限を付与してもらってください。詳細については、「セキュリティのためのコードとログの分離の有効化」をご参照ください。

• [Storage Capacity]： テーブルの論理ストレージサイズ。このデータはオフラインで収集され、T+1 の遅延があります。

• [Health Status]： Data Health > Data Asset Governance にあるテーブルの [Governance Health Score] の評価を表示します。このスコアを使用して、テーブルにガバナンスが必要かどうかを判断できます。

• テーブルの説明： テーブルの説明。Copilot が自動的に生成できます。

管理者がテーブルタイプのエンティティにカスタム属性を設定している場合、左側の基本情報パネルの下部に カスタム属性 カードが表示され、設定された属性の現在の値が表示されます。カスタム属性はワークスペースから継承できます。詳細については、「カスタム属性」をご参照ください。

Details をクリックすると、テーブルの Field Information、Partition Key Column、および Change Records を表示できます:

• [Field Information]

  テーブルのフィールド情報を表示できます。テーブルがパーティション分割されている場合は、[Partition Fields] も表示できます。

  [Actions]	[Description]
  [Edit]	クリックして、フィールドの Description、Business Description、Security Level、および Primary Key を編集できます。Copilot を使用して、フィールドの説明を自動的に生成できます。 説明 [スペース管理者] またはテーブル所有者のみがテーブルフィールドを編集できます。この権限を他のユーザーに付与するには、[スペース管理者] ロールを割り当ててください。詳細については、「グローバルサービスの権限の管理」をご参照ください。 [Security Level] 列は、フィールドごとにセキュリティレベルが設定されているテーブルでのみ表示されます。 MaxCompute エンジンのフィールドセキュリティレベル機能を有効にした後でのみ、テーブルフィールドのセキュリティレベルを設定できます。この機能を有効にする方法については、「ラベルベースのアクセス制御」をご参照ください。
  [Recommended Field Desc]	説明が不足している複数のフィールドの説明を生成します。
  [Batch Edit Security Level]	複数のテーブルフィールドのセキュリティレベルを一度に設定して、データセキュリティを強化します。
  [Upload]	このボタンをクリックし、アップロードするローカルファイルを Batch Upload Field Information ダイアログボックスにドラッグします。 説明 [スペース管理者] またはテーブル所有者のみが対象テーブルにデータをアップロードできます。他のユーザーにデータのアップロードを許可するには、[スペース管理者] ロールを付与してください。詳細については、「グローバルサービスの権限の管理」をご参照ください。 .xlsx ファイル (Excel 2007 形式) のみがサポートされています。[Download Template File] も可能です。 この機能は、データモデリングで作成されたモデルテーブルではサポートされていません。
  [ダウンロード]	クリックすると、現在のテーブルのフィールド情報をダウンロードできます。
  [Generate SELECT]	クリックすると、[SELECT 文の生成] ダイアログボックスで現在のテーブルの select 文を表示または Copy できます。
  DDL の生成	クリックして、Generate DDL Statement ダイアログボックスでテーブル作成ステートメントを表示またはCopyします。

  説明

  • フィールドアクセス頻度： 前日に SQL の JOIN 句でフィールドが使用された回数を示します。この数値は星評価に変換され、最大 5 つ星、最小 0 つ星で表示されます。

  • 関連メトリック： フィールドに関連付けられたモデルメトリックを表示します。関連付けを作成または更新するには、ディメンションモデリングに移動し、対象テーブルの編集ページでフィールド管理を使用してフィールドとメトリックの関連付けを管理し、モデルテーブルを公開して変更を適用します。

• [Partition Information]

  テーブルのPartition Name、Number of Records、Storage Capacityなどのパーティション情報を確認できます。

  説明

  • パーティションのレコード数とストレージサイズは参考用です。データ更新に遅延がある場合があります。コンピュートエンジン内のデータが正です。

  • MaxCompute トランザクションテーブルでは、Number of Records は利用できず、常に -1 と表示されます。SELECT COUNT(*) FROM <table_name> WHERE <partition>; コマンドの結果が正確な値です。

• 変更記録

  テーブルのDescription、Change Type、Granularity、およびその他の変更レコードを確認します。

  Change Records タブの左上隅で、ドロップダウンリストから変更タイプを選択して、その特定の変更履歴を表示できます。

リネージ情報は、ジョブスケジューリングやデータ同期などの操作における実際のデータフローから導出された、テーブルとフィールド間の関係を示します。リネージページでは、テーブルまたはテーブルフィールドの上流および下流のノードを表示し、元のデータソースを追跡し、データの最終的な宛先を確認できます。また、必要に応じて、異なるリネージレベルにわたって影響分析を実行することもできます。

• [View Table Lineage]

  

  Table Lineage タブでは、現在のテーブルのリネージの詳細を表示できます。以下の操作を実行できます:

  • リネージ内の各ノードの上流および下流のノード数を表示します。テーブルまたはノードタイプにカーソルを合わせると、その基本情報が表示されます。

  • ノードをクリックします。リネージの関連付けの下のポップアップパネルで、キーワードを入力すると、そのキーワードを含むすべての下流ノードが表示されます。また、@ユーザー名 を入力すると、指定されたユーザーが所有するすべての下流テーブルが表示されます。

  • リネージグラフの + または - アイコンをクリックして、対応する上流および下流のノードを展開または折りたたみます。

• [View Field Lineage]

  

  Field Lineage タブでは、対象フィールドのリネージの詳細を表示できます。以下の操作を実行できます。

  • Change Field エリアで、現在のテーブルのフィールドを切り替えて、対応するフィールドリネージュグラフを表示できます。

  • フィールドリネージ内の各ノードの上流および下流のノード数を表示します。フィールドまたはノードタイプにカーソルを合わせると、その基本情報が表示されます。

  • リネージグラフの + または - アイコンをクリックして、対応する上流および下流のノードを展開または折りたたみます。

• [Impact Analysis]

  テーブルの構造またはデータが変更されると、その下流のノードが影響を受けます。[Impact Analysis] を使用して、影響を受ける下流テーブルを特定できます。このページでは、リネージレベル、ノードタイプ、テーブルタイプでフィルタリングして、関連する下流テーブルを表示し、分析結果をダウンロードできます。

  説明

  影響分析は、最大 50 レベルのテーブルリネージに対応しています。

テーブルのデータガバナンスの詳細とデータ品質のステータスを表示できます。

• データガバナンスの詳細では、テーブルのガバナンスヘルススコア、ガバナンスが必要な問題の傾向、ガバナンス問題の詳細を表示できます。また、ガバナンスが必要な問題に迅速に対処することもできます。

  • [Health Score]： ストレージ、コンピューティング、開発、品質、セキュリティの 5 つの領域におけるテーブルの健全性の定量的評価。スコアは、テーブルに対するガバナンスの有効性を反映します。スコアが高いほど、ガバナンスが優れていることを示します。

  • [Trend of to-Be-Governed Issues]： 未解決のガバナンス問題の経時的な傾向を示し、テーブルのガバナンス履歴を理解するのに役立ちます。

  • [Governance Issue]: ガバナンスが必要な現在の課題のリストを表示します。Governance Issue 列の課題名または操作列のアクションボタンをクリックすると、Data Asset Governance > Overview > To-Do List ページに移動して、ガバナンス課題を処理することができます。

• データ品質の詳細では、テーブルのルールの詳細と、その結果として生じるデータ品質アラートを表示できます。

このセクションには、テーブルの Usage Records が表示され、Frequently Associated と Access Statistics に分類されています。

• [Frequently Associated]： 結合操作でテーブルが使用される頻度を示します。

  説明

  この統計は、過去 30 日間にテーブルが結合条件として使用された回数をカウントします。このデータはオフラインで収集され、T+1 の遅延があります。

• [Access Statistics]： グラフ形式でテーブルの使用記録を表示します。

  • [Trend for Reads]： 折れ線グラフの日付は、その日の読み取り回数に対応し、開発環境と本番環境からの読み取りを区別します。フィールドの使用回数は、ノードの実行回数と、フィールドがコードに出現する回数に関連しています。このデータはオフラインで収集され、T+1 の遅延があります。

    たとえば、フィールドがノードに 1 回出現し、ノードが 2 回実行された場合、カウントは 2 になります。フィールドがコードに 2 回出現する場合、1 回のノード実行でカウントは 2 になります。

  • [Field Popularity Details]： SQL 句 (WHERE、SELECT、JOIN、GROUP BY など) でフィールドが使用される回数の統計。このデータはオフラインで収集され、T+1 の遅延があります。

  • [Top 10 Readers]： 過去 30 日間に SQL でテーブルを読み取ったユーザーの統計。これには、スケジューリング用の本番アカウントと個人アカウントの両方からのアクセスが含まれます。読み取り操作には、WHERE、SELECT、JOIN、GROUP BY が含まれます。このデータはオフラインで収集され、T+1 の遅延があります。

データインサイトは、データの構造と値を分析して、統計と分布情報を表示します。現在のページで直接 [新しいデータインサイトレポートを作成] するか、データ分析モジュールに移動して データインサイト を使用できます。

Output タブでは、現在のテーブルを生成する DataWorks の定期実行タスクのリストを表示できます。これにより、データソースと最新の実行を追跡できます。

リストには通常、タスクの [ノード ID]、[ノード名]、[所有者]、[スケジュール]、[最新ステータス] が含まれます。ノード ID をクリックすると、オペレーションセンターのノード詳細ページに移動し、タスクインスタンス、スケジュール設定、実行ログをさらに確認できます。

Usage Notes タブでは、下流ユーザーがその業務上の意味、カラムの説明、使用上の注意点をすばやく理解するのに役立つ、テーブルの使用方法を表示または管理できます。

• ノートを読む： デフォルトでは、現在のノートが読み取りモードで表示されます。

• ノートを編集する： [編集] をクリックして、編集モードに入ります。テナント設定に応じて、エディタは Yuque エディタ (リッチテキストと共同編集) または DataWorks 組み込みエディタになります。

• AIによるノート生成: ページヘッダーの AI Enhancement ボタンをクリックするか、Usage Notes タブ内のエントリーを使用すると、Copilot がテーブルメタデータを分析してノートの下書きを生成します。この下書きは確認して保存できます。