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

権限の説明

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

• データ標準セットのメンテナーは、自身が参加しているルックアップテーブルを編集または削除できます。

制限

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

• すべての階層にわたるルックアップテーブルディレクトリの総数は 1,000 を超えられません。

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

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

ルックアップテーブル一覧

ルックアップテーブル一覧は、[編集] と [表示] の 2 つの表示モードに対応しています。[Reference Tables] ページで、右上隅のアイコン をクリックしてモードを切り替えます。

表示モードでは、ルックアップテーブルのディレクトリとその情報を閲覧できますが、操作は実行できません。

編集モードでは、参照の表示、ルックアップテーブルとディレクトリの編集、エクスポート、削除ができます。このモードは、ルックアップテーブルの管理権限を持つユーザーのみがアクセスできます。

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

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

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

   操作項目		説明
   ルックアップテーブルディレクトリ	ルックアップテーブルの作成	ディレクトリの横にある [ルックアップテーブルの作成] アイコンをクリックして、そのディレクトリに新しいルックアップテーブルを作成します。[All Lookup Tables] ディレクトリでは、新しいテーブルが直接追加されます。
   	テンプレートライブラリからルックアップテーブルをインポート	ディレクトリ行の右側にある [テンプレートライブラリからルックアップテーブルをインポート] アイコンをクリックするか、ルックアップテーブル作成ボタンにカーソルを合わせ、ドロップダウンメニューから [テンプレートライブラリからルックアップテーブルをインポート] を選択します。
   ルックアップテーブル一覧	詳細の表示	操作列の [詳細の表示] をクリックして、ルックアップテーブルの詳細と参照情報を表示します。
   	編集	操作列の [編集] をクリックして、ルックアップテーブルの設定を変更します。 定義方法、ソーステーブル、またはフィールドを変更した場合、既存の設定はデータ取得が成功し、変更が保存・公開された後にのみ更新されます。それ以外の場合は、既存の設定が保持されます。
   	エクスポート	操作列の [エクスポート] をクリックするか、一覧からルックアップテーブルを選択し、下部にある [一括エクスポート] をクリックして、ルックアップテーブルとコード値の情報を Excel ファイルとしてエクスポートします。詳細については、「ルックアップテーブルの一括インポートとエクスポート」をご参照ください。
   	コード値の更新	定義方法が「テーブルからインポート」の場合にのみ使用可能です。操作列の [その他] をクリックし、[コード値の更新] を選択します。システムはインポート設定に基づいて最新のコード値データを取得します。取得が成功した後、保存して公開すると、コード値の設定が更新されます。
   	コード値の編集	定義方法が「カスタム」の場合にのみ使用可能です。操作列の [その他] をクリックし、[コード値の編集] を選択して、コード値の定義を直接変更します。
   	参照の表示	操作列の [その他] をクリックし、[参照の表示] を選択して、どの標準テンプレートがこのルックアップテーブルを参照しているかを確認します。[標準テンプレート] 名をクリックすると、そのプロパティ情報、参照、およびバージョン履歴が表示されます。
   	削除	操作列の [その他] をクリックし、[削除] を選択します。削除は元に戻せないため、慎重に実行してください。

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

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

2. 左側メニューで、[参照データ] > [標準コード (ルックアップテーブル)] を選択します。[ルックアップテーブルディレクトリ] タブで、[編集] アイコンをクリックします。

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

   操作	説明
   [作成]	同じ階層内で一意のフォルダー名を入力します。名前は 128 文字以下で、スラッシュ (/) 文字を含めることはできません。 親フォルダーの下に新しいフォルダーを追加できます。親フォルダーを選択しない場合、新しいフォルダーはルックアップテーブルのルートディレクトリに配置されます。
   [編集]	フォルダーの名前を変更します。
   [移動]	フォルダーを別の親フォルダーに移動します。
   [削除]	フォルダーにサブディレクトリまたはルックアップテーブルが含まれている場合、そのフォルダーは削除できません。

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

1. [Reference Tables] 一覧ページで、[+ ルックアップテーブルの作成] ボタンをクリックします。

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

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

次のステップ

ルックアップテーブルを作成した後、それを使用して標準テンプレートのプロパティの値の制約を設定できます。詳細については、「標準テンプレートの作成と管理」をご参照ください。