Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.

# CHARINDEX 함수
<a name="r_CHARINDEX"></a>

문자열 내에서 지정한 하위 문자열의 위치를 반환합니다.

유사한 함수는 [POSITION 함수](r_POSITION.md) 및 [STRPOS 함수](r_STRPOS.md) 섹션을 참조하세요.

## 구문
<a name="r_CHARINDEX-synopsis"></a>

```
CHARINDEX( substring, string )
```

## 인수
<a name="charindex-arguments"></a>

 *substring*   
*string* 내에서 검색할 하위 문자열입니다.

 *문자열*()   
검색할 문자열 또는 열입니다.

## 반환 타입
<a name="charindex-return-type"></a>

 INTEGER   
CHARINDEX 함수는 하위 문자열의 위치에 해당하는 `INTEGER`를 반환합니다(0이 아닌 1부터 시작). 이 위치는 바이트가 아닌 문자 수를 기준으로 하기 때문에 멀티바이트 문자도 단일 문자로 계산됩니다. 문자열 내에서 하위 문자열을 찾을 수 없는 경우 CHARINDEX는 `0`을 반환합니다.

## 예제
<a name="sub-charindex-usage-notes-examples"></a>

`dog`이라는 단어 내에서 문자열 `fish`의 위치를 반환하려면 다음 예제를 사용합니다.

```
SELECT CHARINDEX('fish', 'dog');

+-----------+
| charindex |
+-----------+
|         0 |
+-----------+
```

`dogfish`이라는 단어 내에서 문자열 `fish`의 위치를 반환하려면 다음 예제를 사용합니다.

```
SELECT CHARINDEX('fish', 'dogfish');

+-----------+
| charindex |
+-----------+
|         4 |
+-----------+
```

 다음 예제에서는 TICKIT 샘플 데이터베이스의 SALES 테이블을 사용합니다. 자세한 내용은 [샘플 데이터베이스](c_sampledb.md) 섹션을 참조하세요.

SALES 테이블에서 999.00 이상의 수수료를 받는 고유 판매 거래 수를 반환하려면 다음 예제를 사용합니다. 이 명령은 커미션 값의 시작 부분에서 소수점이 4자리 이상인지 확인하여 999.00보다 큰 커미션을 계산합니다.

```
SELECT DISTINCT CHARINDEX('.', commission), COUNT (CHARINDEX('.', commission))
FROM sales 
WHERE CHARINDEX('.', commission) > 4 
GROUP BY CHARINDEX('.', commission)
ORDER BY 1,2;

+-----------+-------+
| charindex | count |
+-----------+-------+
|         5 |   629 |
+-----------+-------+
```