COUNTEQUAL

기능

배열 내에서 지정한 대상 값과 같은 요소의 개수를 셉니다.

구문

• COUNTEQUAL(arr, target)

매개변수

• arr: ARRAY<T>, numeric, boolean, string, datetime 및 IP 타입의 요소를 지원합니다.
• target: arr의 요소와 같은 타입입니다.

반환값

• BIGINT를 반환하며, 값이 같은 요소의 개수를 나타냅니다.

사용 시 참고 사항

• 이 함수에서는 NULL을 NULL과 같은 값으로 간주하며 개수에 포함합니다.

예제

• 기본

  • COUNTEQUAL([1,2,3,2], 2) -> 2
  • COUNTEQUAL(['a','b','a'], 'a') -> 2
  • COUNTEQUAL([true,false,false], false) -> 2

• NULL도 같은 값으로 간주하여 개수에 포함합니다

  • COUNTEQUAL([1,NULL,2,NULL], NULL) -> 2
  • COUNTEQUAL([1,NULL,1], 1) -> 2
  • COUNTEQUAL([1, 2], NULL) -> 0

• 배열이 NULL이면 NULL을 반환합니다

  • COUNTEQUAL(NULL, 1) -> NULL