Commit 654754b5 authored by Jason Fox's avatar Jason Fox
Browse files

Tweak text - explain shallower depth

parent cdaa3166
Loading
Loading
Loading
Loading
Loading
+9 −9
Original line number Diff line number Diff line
@@ -1995,15 +1995,15 @@ 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 have a _Relationships_ to [Linked
Entities]{.HTML-Keyboard} which may in turn have a _Relationships_, to further
[Linked Entities]{.HTML-Keyboard}. Complete traversal of a densely or
recursively linked Entity graph would result in payloads of an excessive length.
Therefore to mitigate this, the default depth of retrieval (or _`joinLevel`_)
shall be set to one, though this may be overridden on request. Furthermore,
whenever a [Linked Entity]{.HTML-Keyboard} has already been encountered during
graph traversal, its [Linked Entities]{.HTML-Keyboard} shall not undergo further
expansion.
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,
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