エクスプローラ用のデータの設定

モデルドリブンの視覚化

データハブエクスプローラを利用することで、エンティティモデルを表示し、また各エンティティモデルに関連付けられたハーモナイズ済みドキュメントをブラウズできます。エンティティモデルの詳細については、「エンティティ」を参照してください。

エンティティモデルのサンプルを表示します。
   {
    "info": {
      "title": "EmployeeDetail",
      "version": "0.0.1",
      "baseUri": "http://example.org/"
    },
    "definitions": {
      "Department": {
        "required": [
          "dept_no"
        ],
        "pii": [],
        "elementRangeIndex": [
          "dept_no"
        ],
        "rangeIndex": [],
        "wordLexicon": [],
        "properties": {
          "dept_no": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          },
          "dept_name": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          }
        }
      },
      "EmployeeDetail": {
        "required": [
          "emp_no",
          "first_name",
          "last_name"
        ],
        "pii": [
          "birth_date"
        ],
        "elementRangeIndex": [
          "emp_no",
          "birth_date"
        ],
        "rangeIndex": [],
        "wordLexicon": [],
        "properties": {
          "emp_no": {
            "datatype": "long"
          },
          "birth_date": {
            "datatype": "date"
          },
          "first_name": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          },
          "last_name": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          },
          "gender": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          },
          "hire_date": {
            "datatype": "date"
          },
          "work_exp": {
            "datatype": "array",
            "items": {
              "$ref": "#/definitions/WorkExperience"
            }
          }
        }
      },
      "Title": {
        "required": [
          "emp_no",
          "title"
        ],
        "pii": [],
        "elementRangeIndex": [
          "emp_no",
          "from_date",
          "to_date"
        ],
        "rangeIndex": [],
        "wordLexicon": [],
        "properties": {
          "emp_no": {
            "datatype": "long"
          },
          "title": {
            "datatype": "string",
            "collation": "http://marklogic.com/collation/codepoint"
          },
          "from_date": {
            "datatype": "date"
          },
          "to_date": {
            "datatype": "date"
          }
        }
      },
      "WorkExperience": {
        "required": [
          "emp_no",
          "dept_no"
        ],
        "pii": [],
        "elementRangeIndex": [
          "emp_no",
          "dept_no"
        ],
        "rangeIndex": [],
        "wordLexicon": [],
        "properties": {
          "emp_no": {
            "datatype": "long"
          },
          "dept_no": {
            "datatype": "string"
          },
          "from_date": {
            "datatype": "date"
          },
          "to_date": {
            "datatype": "date"
          },
          "dept_name": {
            "$ref": "#/definitions/Department"
          },
          "titles": {
            "datatype": "array",
            "items": {
              "$ref": "#/definitions/Title"
            }
          }
        }
      }
    }
  }
ハーモナイズ済みドキュメントのサンプルを表示します。このハーモナイズ済みドキュメントは、上述のエンティティモデルのサンプルに基づいています。
   {
    "envelope": {
      "headers": {
        "sources": [
          {
            "name": "EmployeeDetail"
          }
        ],
        "createdOn": "2019-10-09T18:10:47.033043-07:00",
        "createdBy": "admin"
      },
      "triples": [],
      "instance": {
        "EmployeeDetail": {
          "emp_no": 12345,
          "birth_date": "1962-10-12",
          "first_name": "David",
          "last_name": "Smith",
          "gender": "M",
          "hire_date": "1990-03-12",
          "work_exp": {
            "emp_no": 12345,
            "dept_no": "d007",
            "dept_name": "Sales",
            "titles": [
              {
                "title": {
                  "title": "Staff",
                  "from_date": "1990-04-26",
                  "to_date": "1997-04-25"
                }
              },
              {
                "title": {
                  "title": "Senior Staff",
                  "from_date": "1992-04-25",
                  "to_date": "9999-01-01"
                }
              }
            ]
          }
        },
        "info": {
          "title": "EmployeeDetail",
          "version": "0.0.1"
        }
      },
      "attachments": {
        "emp_no": 12345,
        "birth_date": "1962-10-12",
        "first_name": "David",
        "last_name": "Smith",
        "gender": "M",
        "hire_date": "1990-03-12"
      }
    }
  }

データハブエクスプローラのロール

MarkLogicデータハブでは、データハブエクスプローラプロジェクトのデフォルトロールが以下のように提供されています。

ロール名 ロールの説明
flowDeveloper
注:データハブサービスのロール名。
  • エンティティモデル(エンティティおよびプロパティ)を見ることができます。
  • 各エンティティモデルに関連付けられたドキュメントをブラウズできます。

詳細については、「インスタンスセキュリティロール」を参照してください。

flowOperator
注:データハブサービスのロール名。
  • エンティティモデル(エンティティおよびプロパティ)を見ることができます。
  • 各エンティティモデルに関連付けられたドキュメントをブラウズできます。

詳細については、「インスタンスセキュリティロール」を参照してください。

data-hub-explorer-architect
  • エンティティモデル(エンティティおよびプロパティ)を見ることができます。

しかしながらこのロールでは、

  • 各エンティティモデルに関連付けられたドキュメントをブラウズできません。

データハブサービスにおいてユーザーを作成し、事前定義されたロールをユーザーに割り当てる方法については、「DHSインスタンスユーザーアカウントを作成する」を参照してください。

環境

データハブエクスプローラは、MarkLogicデータハブサービス(DHS)の未認証(non-certified)の開発環境で利用できます。

バージョンによる違い

5.0以前のバージョンからアップグレードしている場合、データハブ5.0以前のバージョンのフローで生成したドキュメントではファセットが利用できないことに注意してください。データハブエクスプローラにおけるファセットの利用の詳細については、「データハブエクスプローラにおけるファセットの使用」を参照してください。

バージョン5.0以前

データハブ5.0以前のフローで生成されたドキュメントでは、ファセットでドキュメントをフィルタリングできません。一方、あらゆるステップ(読み込みステップを除く)で生成されたドキュメントのブラウズができます。

ステップ ファセットによるフィルタリング ドキュメントのブラウズ
Ingestion
Mapping
Matching N/A N/A
Merging N/A N/A
Mastering
Custom
注:マッチングおよびマージングステップはデータハブ5.0以前のバージョンには存在しません。
バージョン5.1以降

データハブ5.1以降のフローで生成されたドキュメントでは、ファセットでドキュメントをフィルタリングしたり、あらゆるステップ(読み込みステップを除く)で生成されたドキュメントのブラウズができます。

ステップ ファセットによるフィルタリング ドキュメントのブラウズ
Ingestion
Mapping
Matching
Merging
Mastering
Custom
重要:カスタムステップが生成するドキュメントは、データハブ5.1以降のエンベロープパターンに準拠している必要があります。詳細は、「エンベロープパターン」を参照してください。