Commit 0407a070 authored by Giuseppe Tropea's avatar Giuseppe Tropea
Browse files

Merge branch 'fix/joinLevel' into 'master'

DATA(25)000165r1_NGSI-LD_Core_Depth_of_Retrieval

See merge request !12
parents c12bc20b e8b706d4
Loading
Loading
Loading
Loading
+14 −0
Original line number Diff line number Diff line
@@ -1992,6 +1992,20 @@ Broker]{.HTML-Keyboard}.

An example of this representation can be found in annex C, clause C.2.2.1.3.

### 7.7.4 Depth of retrieval

When retrieving [Linked Entities]{.HTML-Keyboard}, the [Linking
Entity]{.HTML-Keyboard} may contain _Relationships_ to [Linked
Entities]{.HTML-Keyboard} which in turn may contain _Relationships_, to further
[Linked Entities]{.HTML-Keyboard}. Complete traversal of a chain of linked
Entities could result in payloads of an excessive length. Therefore to mitigate
this, the default depth of retrieval (or _`joinLevel`_) shall be set to one,
meaning that only one level of _Relationships_ are traversed, though this may be
overridden on request. Furthermore, to avoid unnecessary duplication, whenever a
[Linked Entity]{.HTML-Keyboard} has already been previously encountered during graph
traversal at a shallower depth, its [Linked Entities]{.HTML-Keyboard} shall not undergo
further expansion for a second time.

## 7.8 Tenants

#### 7.8.1 Introduction