ADD_ELEMENT関数

ADD_ELEMENT行関数は、要素をセットに追加します。

ADD_ELEMENTは、アトミック値と集合を取得し、その集合にアトミック値を追加した状態で戻します。アトミック値は、セット内の現在の要素と同じデータ型にする必要があります。重複する値がセット内にすでに存在する場合、アトミック値はセットに追加されません。アトミック値は、Dgraph内のセットには追加されず、ADD_ELEMENT関数で作成された新しい一時セットにのみ追加されることに注意してください。

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

ADD_ELEMENT(<atomic-value>, <set>)

説明:

atomic-valueは、整数セットの場合は50、文字列セットの場合は50などのアトミック値です。単一割当て属性である場合もあります。atomic-valueはsetに追加されます。アトミック値の型は、集合要素の型と一致している必要があります。
setは、atomic-valueが追加されるセットです。 setの要素は、atomic-valueと同じセット・データ型である必要があります。たとえば、atomic-valueが単一割当てのdouble属性の場合、setの要素も文字列である必要があります。

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

ADD_ELEMENT(1, { 2, 3 }) = { 1, 2, 3 }
ADD_ELEMENT(1, { 1, 2 }) = { 1, 2 }
ADD_ELEMENT(NULL, { 1, 2 }) = { 1, 2 }
ADD_ELEMENT(1, { 'a', 'b' }) yields a checking error because the atomic value and the set elements are not of the same data type

ADD_ELEMENTの例

この例では、100の数字がスコアの整数セットに追加されます(現在、値が100ではありません):

RETURN results AS
SELECT 
   WineID AS idRec,
   ADD_ELEMENT(100, Score) AS addAttrs
FROM WineState
WHERE WineID BETWEEN 10 AND 14
ORDER BY idRec

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

addAttrs              idRec
----------------------------
| { 100, 83, 85, 86 } | 10 |
| { 100, 82, 83 }     | 11 |
| { 100, 81, 89 }     | 12 |
| { 100, 73, 75 }     | 13 |
| { 100, 72, 74, 75 } | 14 |
----------------------------

結果には、数値100がセットに追加されたことが示されています。たとえば、以前にレコード12のスコア・セットの要素が81と89であったが、要素値が81、89および100であるとします。