関連性の読み込み操作
関連性の読み込み操作は、Data Hub モデル内にある関連性のプロパティ値を返します。
HTTP GET URL 形式
このリクエストは次のように指定します。Spectrum サーバーは HTTP と HTTPS の両方をサポートしています。
GET http://server_name:port/rest/DataHub/operations/modelName/relationships/relationshipLabel?query_parameters
URL パス要素
- modelName
- Data Hub モデルの名前。
- relationshipLabel
- モデル内にある 2 つのエンティティを接続する関連性ラベルの名前。
クエリ パラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| sourceID | string | はい | 関連性をつなげるエンティティのソース ID。このパラメータは entityType:entityLabel 値のペアを指定します。 |
| targetID | string | はい | 関連性をつなげるエンティティのターゲット ID。このパラメータは entityType:entityLabel 値のペアを指定します。 |
| uniqueID | string | いいえ | 2 つのエンティティを接続する関連性がモデル内に複数あってそれらが同じラベルを持つ場合に、関連性を識別する値。 |
応答
操作が成功するとステータス コード "200 OK" を返します。操作が失敗するとステータス コード 500 (エラー) を返します。
このレスポンスは、関連性に N 個のプロパティがある場合に関連性プロパティごとに名前と値のペアを次の形式で返します。
{"result":{
"Property1":"Value1",
"Property2":"Value2",
...
"PropertyN":"ValueN"
}}JSON レスポンスによる関連性の読み込み
次のリクエストは、2 つの person (人物) エンティティ間にある "911" モデルの Roomate (同室者) 関連性ラベルからプロパティを読み取ります。
GET http://localhost:8080/rest/DataHub/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah結果として次のレスポンスが生成されます。
{"result":{
"Date":1275782400000,
"Rank":"0"
}} 注: 日付、時刻、日時のプロパティ値は、リクエストとレスポンスのどちらでも、long データ タイプ形式の UNIX エポック時間の値です。
同じラベルを持つ関連性の読み込み
次のリクエストは、2 つの person (人物) エンティティ間の関連性 ID が "4" である、"911" モデルの Roomate (同室者) 関連性ラベルからプロパティを読み取ります。
GET http://localhost:8080/rest/DataHub/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah&uniqueID=4