TRUNCATE_SET関数

TRUNCATE_SET行関数は、設定および整数を取得し、指定された数以下の要素を持つセットのコピーを返します。

TRUNCATE_SET関数の構文は、次のとおりです:

TRUNCATE_SET(<set>, <max-size>)

説明:

setは、任意のセット・データ型(mdex:string-setまたはmdex:long-setなど)です。たとえば、setは複数割当文字列属性にすることができます。
max-sizeは、切り捨てられるセットの最大サイズを指定する整数です。 max-sizeがセット内の要素数より少ない場合、Dgraphでは破棄する要素を任意に選択します。この選択は、問合せの複数の実行にわたって安定しています。 max-sizeが0 (ゼロ)または負の数の場合は、空のセットが返されます。

結果の例は次のとおりです({ }は空のセットを示します):

TRUNCATE_SET({ }, 2) = { }
TRUNCATE_SET({ 'a', 'b' }, 2) = { 'a', 'b' }
TRUNCATE_SET({ 'a', 'b', 'c' }, 2) = { 'b', 'c' }
TRUNCATE_SET({ 1, 2 }, 20) = { 1, 2 }
TRUNCATE_SET({ 1, 2 }, -3) = { }

TRUNCATE_SETは、セットの最終結果が、フロントエンドUIに対して妥当で管理しやすいサイズであることを確認する場合に役立ちます。

TRUNCATE_SETの例

この例では、Flavorsは複数割当文字列属性で、WineIDはレコードの主キーです:

RETURN results AS
SELECT
   WineID AS id,
   Flavors AS fullFlavors,
   TRUNCATE_SET(fullFlavors, 1) AS truncFlavors
FROM WineState
WHERE WineID BETWEEN 15 AND 19
ORDER BY id

この文の結果は次のようになります:

fullFlavors                           id     truncFlavors
-------------------------------------------------------------
| { Blackberry, Oaky, Strawberry }  | 15 | { Blackberry }   |
| { Currant, Licorice, Tobacco }    | 16 | { Licorice }     |
| { Cedar, Cherry, Spice }          | 17 | { Cherry }       |
| { Black Cherry, Cedar, Fruit }    | 18 | { Black Cherry } |
| { Herbal, Strawberry, Vanilla }   | 19 | { Herbal }       |
-------------------------------------------------------------

fullFlavorsセットには、5つの選択されたレコードのそれぞれにフラットなセットのアサイメントが表示されます。それでfullFlavorsセットが1つの要素セットに切り捨てられます。