システム管理機能は、データモデル設計中に必要なテーブル作成ポリシーとコード生成ポリシーを管理するために使用されます。テーブル作成ポリシーまたはコード生成ポリシーを有効にすると、関連する操作はポリシーに基づいて厳密に管理されます。これにより、テーブルが標準的な方法で作成され、特定の種類の計算エンジンの表示される DDL ステートメントがビジネス要件を満たすことが保証されます。このトピックでは、DataWorksコンソールの [システム管理] ページでテーブル作成ポリシーとコード生成ポリシーを設定する方法について説明します。
背景情報
テーブル作成ポリシー管理: テーブル作成ポリシーは、モデルを持たないユーザーが DataStudio で MaxCompute 物理テーブルを作成できるかどうかを定義します。テーブル作成ポリシーを有効にすると、DataStudio で作成または変更された MaxCompute 物理テーブルをユーザーが送信または公開するときに、ポリシーがトリガーされます。テーブルがデータモデリングを使用して公開されていない場合、システムは送信または公開操作をブロックすることがあります。
コード生成ポリシー管理: コード生成ポリシーは、DDL ステートメントのテーブルとフィールドのコメントと、視覚化されたモデリング UI のテーブルとフィールドの表示名または説明との間のマッピングを定義します。[スクリプト] モードでのデータモデリング中および[エクスポート] モードでの[次元モデリング] のモデル設定のエクスポート中に生成される DDL ステートメントのテーブルとフィールドのコメントは、コード生成ポリシーで定義されたマッピングに基づいて表示されます。データマップのテーブル詳細ページでテーブルに対して生成される DDL ステートメントのテーブルとフィールドのコメントも、マッピングに基づいて表示されます。
次の表は、スクリプトモードと視覚化モデリングモードのパラメータマッピングを示しています。
スクリプトモード
視覚化モデリングモード
コメント(テーブル)
テーブルの設定タブの [基本情報] セクションの [表示名] または [説明]
コメント(フィールド)
テーブルの設定タブの [フィールド管理] セクションのフィールドの [表示名] または [説明]
公開ポリシー管理: 公開ポリシーは、モデルを公開するときに使用されます。
制限事項
テーブル作成ポリシー管理:
テーブル作成ポリシーを使用して、MaxCompute 物理テーブルの作成のみを管理できます。テーブル作成ポリシーは、作成された MaxCompute 物理テーブルを送信または公開するときにのみトリガーされます。
テーブル作成ポリシーを使用して、API 操作の呼び出しによって作成されたテーブルに対して実行される送信または公開操作を管理することはできません。
コード生成ポリシー管理: MaxCompute、Hive、MySQL、または Hologres の計算エンジンを使用する場合にのみ、コード生成ポリシーを使用して DDL ステートメントのテーブルとフィールドのコメントのマッピングを定義できます。
注意事項
テーブル作成ポリシー管理: DataStudio を使用して、テーブル作成ポリシーが有効になっているワークスペースでテーブルを作成または変更できます。作成または変更操作がテーブル作成ポリシーで定義されている条件を満たしていない場合、テーブルに対して実行される送信または公開操作がブロックされる可能性があります。モデル設計ワークスペース、またはモデル設計ワークスペースに関連付けられているデータ開発ワークスペースに対してテーブル作成ポリシーを有効にすることができます。
解決策:
テーブル作成ポリシーを表示します。
次の表に記載されているいずれかの方法を使用して、テーブル作成をブロックしているポリシーを表示できます。テーブル作成ポリシーに基づいてテーブルを再作成できます。
方法
操作
方法 1
[不合格] にポインターを移動してブロックの原因を表示し、画面の指示に従って現在のワークスペースのテーブル作成ポリシーを表示します。
方法 2
[dataworks コンソール] の[データウェアハウス計画] の [システム管理] ページに移動して、現在のワークスペースのテーブル作成ポリシーを表示します。現在のワークスペースが別のモデル設計ワークスペースのデータ開発ワークスペースとして指定されている場合は、モデル設計ワークスペースにアクセスしてテーブル作成ポリシーを表示する必要があります。
データモデリングでテーブルと同じ名前のモデルを作成し、モデルを物理テーブルとして公開します。
送信と公開がブロックされているテーブルの送信と公開を続行する場合は、データモデリングでテーブルと同じ名前のモデルを作成し、モデルを物理テーブルとして公開する必要があります。
説明モデルの作成方法については、「ディメンションモデリング」をご参照ください。
同じ名前の物理テーブルが計算エンジンインスタンスに既に存在する場合、テーブル情報を変更するとテーブル作成ポリシーがトリガーされます。この場合、リバースモデリング 機能を使用して物理テーブルでリバースモデリングを実行し、物理テーブルに基づいてモデルを生成し、モデル情報を変更してから、モデルを物理テーブルとして公開する必要があります。
[システム管理] ページに移動する
[データモデリング] ページに移動します。
DataWorks コンソール にログオンします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションペインで、 を選択します。表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[データモデリングに移動] をクリックします。
[データモデリング] ページの上部ナビゲーションバーで、[データウェアハウス計画] をクリックします。[データレイヤー] ページが表示されます。
左側のナビゲーションペインで、[システム管理] をクリックして [システム管理] ページに移動します。
[システム管理] ページでは、次のポリシーを設定できます。
テーブル作成ポリシー管理
テーブル作成ポリシーを設定して有効にする
[システム管理] ページの [テーブル作成ポリシー管理] タブで、[モード] を [視覚化モード] に設定し、DataStudio でのテーブルの作成を管理するポリシーを設定します。次の図は、設定の詳細を示しています。次の項目に注意してください。
ポリシー
ユーザーが DataStudio で物理テーブルを直接作成することを禁止するポリシー、またはユーザーが指定された形式で物理テーブルを作成することを禁止するポリシーを設定できます。
ポリシーを有効にすると、ポリシーがトリガーされ、データモデリングでモデルを公開することによって生成されていない物理テーブルがチェックされます。テーブル作成操作がポリシーによってブロックされている場合は、データモデリングに移動し、物理テーブルに基づいてモデルを作成してから、モデルを必要な名前の物理テーブルとして公開する必要があります。
ポリシーの詳細
設定項目
説明
[ルール]
DataStudio で作成する物理テーブルの名前付けルール。各名前付けルールで、テーブル名が特定の形式のコンテンツで始まるかどうかを指定できます。
説明テーブル名が開始されるコンテンツに対してのみ、名前付けルールを設定できます。
[グループ]
ルールグループ。前の図の 3 でマークされた領域は、ルールのグループを示しています。複数のルールグループを追加できます。
ルール間のロジック
[または] または [および] をルール間で使用できます。
[または]: ルールのいずれか 1 つだけを満たす必要があります。
[および]: 複数のルールを満たす必要があります。
ポリシーの発効方法
テーブル作成ポリシーを設定した後、ポリシーを DataStudio で有効にするには、手動で有効にする必要があります。
サンプルシナリオ
DataStudio で dim
または dws
で始まる名前のテーブルを作成すると、テーブルを送信または公開するときにエラーが報告されます。 dim または dws で始まる名前のテーブルを作成するには、[dataworks コンソール] の [次元モデリング] ページに移動し、テーブルに基づいてモデルを作成してから、モデルを物理テーブルとして公開する必要があります。
次の図は、テーブル作成ポリシーの設定例を示しています。
コード生成ポリシー管理
コード生成ポリシーを設定する
[システム管理] ページの [コード生成管理] タブで、コード生成ポリシーを設定し、DDL ステートメントのテーブルとフィールドのコメントと、視覚化されたモデリング UI のテーブルとフィールドの表示名または説明との間のマッピングを定義できます。ポリシーを有効にすると、次の操作を実行するときに生成される DDL ステートメントの [コメント] フィールドは、[システム管理] ページの設定に基づいて表示されます。
スクリプトモードでデータモデリングを実行する: モデルの計算エンジンインスタンスによって生成される DDL ステートメントの [コメント] フィールドは、ポリシーで定義されたマッピングに基づいて表示されます。
モデルの設定をエクスポートする: モデルの設定を特定の計算エンジンインスタンスの DDL ステートメントとしてエクスポートすると、DDL ステートメントの [コメント] フィールドは、ポリシーで定義されたマッピングに基づいて表示されます。
MaxComputeテーブルデータ: データマップのテーブルの詳細ページの [詳細] タブで [DDL ステートメントの生成] をクリックすると、DDL ステートメントの [コメント] フィールドは、ポリシーで定義されたマッピングに基づいて表示されます。
サンプルシナリオ
次の図は、テーブルの基本情報とテーブル内のフィールドを示しています。[基本情報 - テーブル表示名] と [フィールド管理 - フィールド表示名] が選択されているコード生成ポリシーが設定されています。次元モデリングでの表示結果:
スクリプトモードでデータモデリングを実行する
次の図は、モデルの設定タブで [スクリプトモード] をクリックし、特定の種類の計算エンジンの DDL ステートメントを選択した後に表示される DDL ステートメントを示しています。
モデルの設定をエクスポートする
次の図は、モデルの設定タブの上部ツールバーで [エクスポート] をクリックしてモデルの設定をエクスポートした後に表示される DDL ステートメントを示しています。
公開ポリシー管理
[公開ポリシー管理] タブで、ビジネス要件に基づいてモデルの公開ポリシーを定義できます。公開ポリシーを有効にすると、モデルを公開するときに、ポリシーの設定に基づいてビジネス要件を満たす公開モードを選択できます。
有効な値: 選択できる公開モード。両方の公開モードを同時に選択できます。
デフォルト設定: デフォルトの公開モード。デフォルトの公開モードは、有効な値列に表示される選択オプションである必要があります。
公開モードの説明:
[増分公開]: モデルを公開すると、モデルに加えられた変更のみが関連する計算エンジンインスタンスに公開されます。
[削除して再作成]: モデルを公開すると、システムはモデルに基づいて既に生成されている既存の物理テーブルを関連する計算エンジンインスタンスから削除し、モデルに基づいて物理テーブルを再作成します。
モデルの公開方法の詳細については、「テーブルを計算エンジンにマテリアライズする」をご参照ください。