Dataphin:標準コード (ルックアップテーブル) の作成と管理

権限の説明

• スーパー管理者とデータ標準管理者は、すべてのルックアップテーブル、ルックアップテーブルディレクトリ、およびインポートテンプレートライブラリを作成および管理する権限を持っています。

• データ標準セット保守担当者は、参加しているルックアップテーブルを編集または削除する権限を持っています。

制限事項

• ルックアップテーブルディレクトリの階層は 10 レベルを超えることはできません。

• ルックアップテーブルディレクトリの総数は、すべてのレベルで 1000 を超えてはなりません。

• 最大 100,000 個のルックアップテーブルを作成できます。

• 各ルックアップテーブルには、最大 10,000 のコード値を含めることができ、テーブル内で一意である必要があります。

ルックアップテーブルリスト

ルックアップテーブルリストには、編集と表示の 2 つの表示モードがあります。 [参照テーブル] ページで、右上隅にあるアイコン をクリックしてビューを切り替えます。

[表示] モードでは、ルックアップテーブルディレクトリとその情報を参照できますが、操作は許可されていません。このモードは、表示専用に最適です。

[編集] モードでは、参照の表示、編集、ルックアップテーブルのエクスポート、削除などの操作を表示および実行できます。ルックアップテーブルディレクトリも、このモードで編集および削除できます。編集モードは、ルックアップテーブル管理権限を持つユーザーのみがアクセスできます。

1. [参照テーブル] リストページでは、左側のディレクトリは、ビジネスまたは組織の観点からルックアップテーブルを分類および管理します。 ディレクトリレベルを選択すると、対応するルックアップテーブルが右側に表示されます。これには、名前、ディレクトリ、説明、ステータス、定義方法、コード値の数、所有者、最終更新者/時刻が含まれます。 [すべてのルックアップテーブル] をクリックして、すべてのルックアップテーブルを表示します。

2. (オプション) 名前またはコードでルックアップテーブルを検索するか、ディレクトリ、所有者などでフィルタリングします。

3. 選択したルックアップテーブルディレクトリまたはテーブルで次の操作を実行します。

   操作項目		説明
   ルックアップテーブルディレクトリ	ルックアップテーブルの作成	新しいルックアップテーブルを作成するには、ディレクトリの横にある [ルックアップテーブルの作成] アイコンをクリックします。[すべてのルックアップテーブル] ディレクトリ内にいる場合は、新しいテーブルがそこに直接追加されます。
   	テンプレートライブラリからルックアップテーブルをインポートする	現在のディレクトリにルックアップテーブルテンプレートをインポートするには、ディレクトリの行の右側にある[テンプレートライブラリからルックアップテーブルをインポート] アイコンをクリックするか、ルックアップテーブル作成ボタンにカーソルを合わせ、ドロップダウンメニューから[テンプレートライブラリからルックアップテーブルをインポート] を選択します。
   ルックアップテーブルリスト	詳細の表示	操作列の [詳細の表示] をクリックして、ルックアップテーブルとリファレンス情報の詳細を表示します。
   	編集	操作列の [編集] をクリックして、ルックアップテーブルの構成を変更します。 定義方法、ソーステーブル、またはフィールドが変更された場合、データ検索が成功し、変更が保存および公開された後にのみ、既存の構成が更新されます。 それ以外の場合、既存の構成は保持されます。
   	エクスポート	操作列の [エクスポート] をクリックするか、リストからルックアップテーブルを選択して、下部にある [一括エクスポート] をクリックして、ルックアップテーブルとコード値の情報を Excel ファイルとしてエクスポートします。 これは、メンテナンスやビジネス担当者との共有に役立ちます。 エクスポートの詳細については、「ルックアップテーブルの一括インポートとエクスポート」をご参照ください。
   	コード値の更新	この操作は、定義方法が「テーブルからインポート」の場合にのみ使用できます。操作列の [詳細] をクリックし、[コード値を更新] を選択します。システムは、インポート構成に従って最新のコード値データを自動的に取得します。取得が成功したら、保存して公開し、既存のコード値構成を更新する必要があります。
   	コード値の編集	この操作は、定義方法が「テーブルからインポート」の場合にのみ使用できます。 操作列の [詳細] をクリックし、[コード値の編集] を選択して、コード値の定義を直接変更します。 これは、テーブルからインポートされた元のコード値情報に簡単な変更を加える必要があるシナリオに適しています。
   	参照の表示	操作列の [詳細] をクリックし、[参照の表示] を選択して、どの標準テンプレートがルックアップテーブルを参照しているかを確認します。[標準テンプレート] 名をクリックすると、プロパティ情報、参照、履歴バージョンなどの詳細が表示されます。
   	削除	操作列の [詳細] をクリックし、[削除] を選択します。削除操作は元に戻せません。ご注意ください。

ルックアップテーブルディレクトリの管理

1. Dataphin ホームページに移動し、トップメニューバーから [管理] > [標準] を選択します。

2. 左側のナビゲーションウィンドウで、[リファレンスデータ] > [標準コード (ルックアップテーブル)] を選択します。[ルックアップテーブルディレクトリ] タブで、[編集] アイコンをクリックします。

3. [ルックアップテーブルディレクトリ管理] パネルでは、ルックアップテーブルディレクトリの作成、移動、編集、および削除を行うことができます。

   操作項目	説明
   [作成]	ディレクトリを作成する場合は、名前が同じディレクトリ内で一意であり、 128 文字を超えないようにしてください。スラッシュ (/) などの文字の使用は避けてください。 新しいディレクトリは、既存の階層内にネストできます。親ディレクトリが選択されていない場合、新しいディレクトリはルックアップテーブルのルートディレクトリの下に直接配置されます。
   [編集]	これにより、既存のディレクトリの名前を変更できます。
   [移動]	このオプションを使用すると、ルックアップテーブルの親ディレクトリを変更できます。
   [削除]	ディレクトリにサブディレクトリまたはルックアップテーブルが含まれている場合、削除はできません。

ルックアップテーブルの作成

1. [参照テーブル] リストページで、[+ ルックアップテーブルの作成] ボタンをクリックします。

2. [カスタムルックアップテーブルの作成] ダイアログボックスで、必須パラメーターを入力します。

   パラメーター	説明
   [ルックアップテーブル名]	ルックアップテーブル名を指定します。親ディレクトリ内で一意であり、 128 文字を超えないようにしてください。例：国地域コードテーブル。
   [ルックアップテーブルコード]	ルックアップテーブルの一意の識別子を入力します。 128 文字までに制限されています。使用できる文字は、英字、数字、および半角記号です。例：DQ001。
   [ディレクトリ]	ルックアップテーブルのディレクトリを選択します。すでにルックアップテーブルディレクトリにいる場合は、新しいルックアップテーブルを作成するときにこのディレクトリが自動的に選択されます。ディレクトリが選択されていない場合、ルックアップテーブルはデフォルトでルートディレクトリになります。新しいディレクトリの作成手順については、「ルックアップテーブルディレクトリの管理」をご参照ください。
   [所有者]	ユーザーリストからルックアップテーブルの所有者を割り当てます。
   [説明]	ルックアップテーブルの説明を 1000 文字以内で入力し、その目的と範囲を詳しく説明します。
   [コード情報]	[カスタム] と [テーブルからインポート] の 2 つの定義方法がサポートされています。 カスタムルックアップテーブルの作成 ルックアップテーブルの情報を入力します。コード情報を編集および削除することもできます。[コード値の追加] ボタンをクリックして、さらにコード値を追加します。また、[一括入力] ボタンをクリックしてコード値を一括で追加したり、[すべて削除] ボタンをクリックしてすべてのコード値をクリアしたりすることもできます。 一括入力: [一括入力] ダイアログボックスで、コード値情報を入力または貼り付けできます。システムは最大 10,000 行を解析します。各行は、コード値、コード名、英語コード名、コード説明の順に解析されます。タブ文字 (\t) またはスペース文字 (\s) を使用して、列であるパラメーターを区切ります。改行文字 (\n) または Shift+Enter を使用して新しい行を開始します。 入力例：コード値： 2900 、コード名：上海市、コード英語名：Shanghai、コードの説明：上海市を識別します。 コード値: 必須。 ルックアップテーブル内で一意である必要があります。 最大 64 文字。 コード名: 必須。 最大 64 文字。 コード英語名: 任意。名前は最大 64 文字で、大文字と小文字の英字、数字、および次の特殊文字を含めることができます: ()^~`!@#$%&*_+\-=[]{}|;':",./<>·?。 コードの説明: オプション。最大 256 文字まで入力できます。 [保存して公開] をクリックして、ルックアップテーブルの作成を完了します。 テーブルからインポート 説明 コード値データを検索する場合、システムは行レベルの権限に基づいてフィルタリングしたり、機密解除されたクエリを実行したりしません。 公開アクセスできるデータソースを選択してください。 ルックアップテーブルの定義方法が「テーブルからインポート」の場合、パーティションテーブルの使用は推奨されません。 必要な場合は、各パーティションに完全データが格納されているテーブルを使用してください。 各ルックアップテーブルには最大 10,000 個のコード値を含めることができるため、条件を満たす最初の 10,000 レコードのみがクエリされます。 現在のオペレーターは、選択したソーステーブルフィールドに対する選択権限を持っている必要があります。 システムは、ソーステーブルから読み取られたデータを文字列型に自動的に変換して格納します。 コード名とコード値のソースフィールド型を変換できない場合、レコード全体の追加は失敗します。 英語名と説明のソースフィールドを変換できない場合、対応する設定項目は空のままになり、レコード全体の追加には影響しません。 さまざまなデータテーブルを参照してルックアップテーブルをすばやく作成し、構成コストを削減できます。 コード情報エリアで、次の情報を構成します。 [ソーステーブル] (必須): Dataphin テーブル (メタテーブルと画像テーブルを除く) と、データプレビュー をサポートするデータソーステーブルの参照をサポートします。 テーブルのフルネームまたはテーブルの説明に基づいてあいまい検索を実行するか、フィルターアイコンをクリックして、モジュール/プロジェクト/データソースまたはテーブルタイプ別に必要なデータテーブルをすばやくフィルタリングできます。 [コード値] (必須): ソーステーブルからフィールドを選択します。 コード値は、ルックアップテーブル内で一意である必要があります。 ソースフィールド値が重複している場合、システムは最初のレコードに対応するデータを自動的に取得します。 ソースデータが 64 文字を超える場合、レコード全体の追加は失敗します。 [コード名] (必須): ソーステーブルからフィールドを選択します。 ソースデータが 64 文字を超える場合、レコード全体の追加は失敗します。 コード英語名 (任意): ソーステーブルからフィールドを選択します。名前には、大文字と小文字の英字、数字、および次の特殊文字を含めることができます: ()^~`!@#$%&*_+\-=[]{}|;':",./<>·?。ソースデータが 64 文字を超える場合、システムはデータを自動的に切り捨てるか、フィールドを空のままにします。 [コードの説明] (オプション): ソーステーブルからフィールドを選択します。 ソースデータが 256 文字を超える場合、システムは自動的に切り捨てるか、空のままにします。 [データフィルタリング] (オプション): 選択したテーブルフィールドに基づいて、パーティション、NULL 値、重複値などのフィルター条件を追加することで、ソースデータをフィルタリングできます。 テーブルが MaxCompute コンピューティングソーステーブルまたは Dataphin 論理テーブルの場合、システムはパーティションフィルター条件を自動的に有効にして入力します。 他のソースタイプの場合は、必要に応じてこれを有効にできます。 構成が完了したら、[データのプレビュー] ボタンをクリックして、パラメーター、権限、および構文を確認します。 パラメーター: すべての必須パラメーターが入力されていることを確認します。 権限: 現在のオペレーターがルックアップテーブルを作成する権限を持っていることを確認します。 フィルター条件: フィルター条件ステートメントが正しいことを確認します。 検証に合格したら、ルックアップテーブルデータを取得し、ルックアップテーブルを Dataphin に追加します。 ルックアップテーブルデータの取得中は、[キャンセル] をクリックするか、ダイアログボックスを閉じてクエリを終了し、終了できます。 構成されたデータは保存されません。 [前へ] をクリックすると、前の手順に戻り、クエリが終了します。 データを再度取得する必要があります。 ルックアップテーブルデータの取得に失敗した場合は、[再試行] をクリックしてデータを再度取得するか、[ログの表示] をクリックして失敗の理由を確認できます。 ルックアップテーブルデータが正常に取得されると、コード値情報をプレビューできます。 [保存して公開] をクリックして、ルックアップテーブルを Dataphin に追加します。 一部のレコードの取得に失敗した場合、例外リストが表示され、具体的な理由が示されます。

次の手順

ルックアップテーブルが確立されたら、適切なルックアップテーブルを選択して、標準テンプレート内のプロパティの値の制約を設定できます。詳細については、「標準テンプレートの作成と管理」をご参照ください。