メインコンテンツまでスキップ
バージョン: 26.x

ARRAY_POSITION

array_position​

デスクリプション​

配列内の指定された要素が最初に出現する位置のインデックス（1から開始）を見つけます。この関数は配列を左から右に走査し、最初に一致する要素を見つけてその位置のインデックスを返します。

Syntax​

array_position(ARRAY<T> arr, T element)

パラメータ​

  • arr：ARRAY型、検索対象の配列
  • element：T型、検索する要素

Tでサポートされる型：

  • 数値型：TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
  • 文字列型：CHAR、VARCHAR、STRING
  • 日付・時刻型：DATE、DATETIME、DATEV2、DATETIMEV2
  • 真偽値型：BOOLEAN
  • IP型：IPV4、IPV6

戻り値​

戻り値の型：BIGINT

戻り値の意味：

  • 指定された要素が配列内で最初に出現する位置のインデックスを返します。戻り値は0からではなく1から始まります。検索する要素が配列の最初の要素である場合、この関数は0ではなく1を返します
  • 0：一致する要素が見つからない場合、または入力配列がNULLの場合
  • NULL：入力配列がNULLの場合

使用上の注意：

  • 関数は配列を左から右に走査し、最初に一致する要素を見つけます。一致する要素が見つからない場合は0を返します
  • 空の配列は0を返します
  • 配列要素内のnull値について：null要素は通常通りマッチングできます

クエリ例：

配列内の文字列の位置を検索：

SELECT array_position(['apple', 'banana', 'cherry', 'apple'], 'apple');
+-----------------------------------------------------------------+
| array_position(['apple', 'banana', 'cherry', 'apple'], 'apple') |
+-----------------------------------------------------------------+
|                                                               1 |
+-----------------------------------------------------------------+

配列内の浮動小数点数の位置を見つける：

SELECT array_position([1.1, 2.2, 3.3, 4.4, 5.5], 3.3);
+------------------------------------------------+
| array_position([1.1, 2.2, 3.3, 4.4, 5.5], 3.3) |
+------------------------------------------------+
|                                              3 |
+------------------------------------------------+

存在しない要素を見つける：

SELECT array_position([1, 2, 3, 4, 5], 10);
+-------------------------------------+
| array_position([1, 2, 3, 4, 5], 10) |
+-------------------------------------+
|                                   0 |
+-------------------------------------+

null要素を見つける：

SELECT array_position([1, null, 3, null, 5], null);
+---------------------------------------------+
| array_position([1, null, 3, null, 5], null) |
+---------------------------------------------+
|                                           2 |
+---------------------------------------------+

空の配列は0を返します：

SELECT array_position([], 1);
+-----------------------+
| array_position([], 1) |
+-----------------------+
|                     0 |
+-----------------------+

入力配列がNULLの場合、NULLを返します：

SELECT array_position(NULL, 1);
+-------------------------+
| array_position(NULL, 1) |
+-------------------------+
|                    NULL |
+-------------------------+

Date型検索:

SELECT array_position(cast(['2023-01-01', '2022-12-31', '2023-06-15'] as array<datetime>), '2023-01-01');
+---------------------------------------------------------------------------------------------------+
| array_position(cast(['2023-01-01', '2022-12-31', '2023-06-15'] as array<datetime>), '2023-01-01') |
+---------------------------------------------------------------------------------------------------+
|                                                                                                 1 |
+---------------------------------------------------------------------------------------------------+

IPアドレス検索:

SELECT array_position(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>), '192.168.1.2');
+---------------------------------------------------------------------------------------------------+
| array_position(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.3'] AS ARRAY<IPV4>), '192.168.1.2') |
+---------------------------------------------------------------------------------------------------+
|                                                                                                 2 |
+---------------------------------------------------------------------------------------------------+

SELECT array_position(CAST(['2001:db8::1', '2001:db8::2', '2001:db8::0'] AS ARRAY<IPV6>), '2001:db8::0');
+---------------------------------------------------------------------------------------------------+
| array_position(CAST(['2001:db8::1', '2001:db8::2', '2001:db8::0'] AS ARRAY<IPV6>), '2001:db8::0') |
+---------------------------------------------------------------------------------------------------+
|                                                                                                 3 |
+---------------------------------------------------------------------------------------------------+

複雑型の例：

ネストした配列型はサポートされておらず、エラーになります：

SELECT array_position([[1,2], [3,4], [5,6]], [3,4]);
ERROR 1105 (HY000): errCode = 2, detailMessage = array_position does not support type ARRAY<ARRAY<TINYINT>>, expression is array_position([[1, 2], [3, 4], [5, 6]])

Map type検索:

SELECT array_position([{'k':1}, {'k':2}, {'k':3}], {'k':2});
ERROR 1105 (HY000): errCode = 2, detailMessage = array_position does not support type ARRAY<MAP<VARCHAR(1),TINYINT>>, expression is array_position([map('k', 1), map('k', 2), map('k', 3)])

パラメータ数が間違っている場合のエラー:

SELECT array_position([1,2,3]);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_position' which has 1 arity. Candidate functions are: [array_position(Expression, Expression)]

非配列型を渡した場合のエラー:

SELECT array_position('not_an_array', 1);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_position(VARCHAR(12), TINYINT)

Keywords​

ARRAY、POSITION、ARRAY_POSITION