본문으로 건너뛰기
최종 수정: 에

ARRAY_JOIN

array_join​

SinceVersion 2.0.0

설명​

배열의 요소를 하나의 문자열로 연결합니다. 이 함수는 배열의 모든 요소를 문자열로 변환한 다음 지정된 구분자로 연결합니다.

구문​

array_join(ARRAY<T> arr, STRING separator [, STRING null_replacement])

매개변수​

  • arr：ARRAY 타입, 연결할 배열
  • separator：STRING 타입, 필수 매개변수, 배열 요소를 구분하는 데 사용하는 구분자
  • null_replacement：STRING 타입, 선택적 매개변수, 배열의 null 값을 대체하는 문자열. 이 매개변수를 지정하지 않으면 null 값은 건너뜁니다

T에 지원되는 타입:

  • 숫자 타입: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 문자열 타입: CHAR, VARCHAR, STRING
  • 날짜 및 시간 타입: DATE, DATETIME, DATEV2, DATETIMEV2, TIMESTAMP_NS
  • Boolean 타입: BOOLEAN
  • IP 타입: IPV4, IPV6
  • UUID: UUID; 요소는 표준 텍스트 형식으로 변환됩니다

반환 값​

반환 타입: STRING

반환 값의 의미:

  • 배열의 모든 요소를 구분자로 연결한 문자열을 반환합니다
  • NULL: 입력 배열이 NULL인 경우

사용 시 참고 사항:

  • 이 함수는 배열의 각 요소를 문자열로 변환하고 지정된 구분자로 연결합니다
  • 배열 요소 중 null 값 처리:
    • null_replacement 매개변수를 지정하면 null 요소를 해당 문자열로 대체합니다
    • null_replacement 매개변수를 지정하지 않으면 null 요소는 건너뜁니다
  • 빈 배열은 빈 문자열을 반환합니다

쿼리 예제:

구분자로 배열 요소 연결:

SELECT array_join([1, 2, 3, 4, 5], ',');
+--------------------------------------+
| array_join([1, 2, 3, 4, 5], ',')    |
+--------------------------------------+
| 1,2,3,4,5                           |
+--------------------------------------+

공백 구분자로 문자열 배열 요소 연결:

SELECT array_join(['hello', 'world', 'doris'], ' ');
+--------------------------------------------------+
| array_join(['hello', 'world', 'doris'], ' ')    |
+--------------------------------------------------+
| hello world doris                                |
+--------------------------------------------------+

null 값이 포함된 배열의 요소 연결(null 값은 건너뜀):

SELECT array_join([1, null, 3, null, 5], '-');
+--------------------------------------------+
| array_join([1, null, 3, null, 5], '-')    |
+--------------------------------------------+
| 1-3-5                                      |
+--------------------------------------------+

null_replacement 매개변수를 사용하여 null 값 대체:

SELECT array_join([1, null, 3, null, 5], '-', 'NULL');
+--------------------------------------------------+
| array_join([1, null, 3, null, 5], '-', 'NULL')  |
+--------------------------------------------------+
| 1-NULL-3-NULL-5                                 |
+--------------------------------------------------+

부동소수점 배열의 요소 연결:

SELECT array_join([1.1, 2.2, 3.3], ' | ');
+------------------------------------------+
| array_join([1.1, 2.2, 3.3], ' | ')      |
+------------------------------------------+
| 1.1 | 2.2 | 3.3                         |
+------------------------------------------+

날짜 배열의 요소 연결:

SELECT array_join(CAST(['2023-01-01', '2023-06-15', '2023-12-31'] AS ARRAY<DATETIME>), ' to ');
+-----------------------------------------------------------------------------------------+
| array_join(CAST(['2023-01-01', '2023-06-15', '2023-12-31'] AS ARRAY<DATETIME>), ' to ') |
+-----------------------------------------------------------------------------------------+
| 2023-01-01 00:00:00 to 2023-06-15 00:00:00 to 2023-12-31 00:00:00                       |
+-----------------------------------------------------------------------------------------+

IP 주소 배열의 요소 연결:

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

빈 배열은 빈 문자열을 반환합니다:

SELECT array_join([], ',');
+----------------------+
| array_join([], ',')  |
+----------------------+
|                      |
+----------------------+

NULL 배열은 NULL을 반환합니다:

SELECT array_join(NULL, ',');
+----------------------+
| array_join(NULL, ',') |
+----------------------+
| NULL                 |
+----------------------+

복합 타입을 전달하면 오류가 발생합니다:

SELECT array_join([{'name':'Alice','age':20}, {'name':'Bob','age':30}], '; ');
ERROR 1105 (HY000): errCode = 2, detailMessage = can not cast from origin type ARRAY<MAP<TEXT,TEXT>> to target type=ARRAY<VARCHAR(65533)>

매개변수 개수가 잘못되면 오류가 발생합니다:

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

배열이 아닌 타입을 전달하면 오류가 발생합니다:

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

키워드​

ARRAY, JOIN, ARRAY_JOIN

Report issue