配列aから特定の要素を削除します。
構文
array<T> array_remove(array<T> <a>, T <element>)パラメーター
a: 必須です。 このパラメーターは、配列を指定します。
array<T>のTは、配列内の要素のデータ型を指定します。 次のデータ型がサポートされています。TINYINT、SMALLINT、INT、およびBIGINT
フロートとダブル
BOOLEAN
デシマルとデシマル
DATE、DATETIME、TIMESTAMP、IntervalDayTime、およびIntervalYearMonth
STRING、BINARY、VARCHAR、CHAR
アレイ、STRUCT、マップ
element: 必須です。 削除する要素。The element that you want to remove. このパラメーターのデータ型は、配列aの要素のデータ型と同じである必要があります。
戻り値
ARRAY型の値が返されます。 戻り値は、次のルールによって異なります。
配列aの要素がnullの場合、null要素は操作に含まれません。
Array aまたはelementがnullの場合、nullが返されます。
Array aに指定された要素が含まれていない場合、Array aが返されます。
例
実施例1:
アレイ (3、2、1)から1を除去する。 例：-- The return value is [3,2]. select array_remove(array(3, 2, 1), 1);例2: 指定された要素はnullです。 例：
-- The return value is null. select array_remove(array(3, 1, null), null);例3:
アレイ (3、1、ヌル)から2を除去する。 例：-- The return value is [3,1,null]. select array_remove(array(3, 1, null), 2);
関連関数
ARRAY_REMOVEは複合型関数です。 ARRAY、MAP、STRUCT、JSONなどの複雑なデータ型のデータを処理するために使用される関数の詳細については、複合型関数.