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/)을 참조하세요.

# OCTET\$1LENGTH 함수
<a name="r_OCTET_LENGTH"></a>

지정된 문자열의 길이를 바이트 수대로 반환합니다.

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

```
OCTET_LENGTH(expression)
```

## 인수
<a name="r_OCTET_LENGTH-argument"></a>

 *expression*   
`CHAR` 문자열, `VARCHAR` 문자열, `VARBYTE` 표현식 또는 암시적으로 `CHAR`, `VARCHAR` 또는 `VARBYTE` 형식으로 평가되는 표현식입니다.

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

 INTEGER   
OCTET\$1LENGTH 함수는 입력 문자열의 바이트 수를 나타내는 정수를 반환합니다.  
입력 문자열이 문자열인 경우 [LEN](r_LEN.md) 함수는 바이트 수가 아닌 멀티바이트 문자열의 실제 문자 수를 반환합니다. 예를 들어 `VARCHAR(12)` 열에 4바이트 중국 문자 3개가 저장되어야 한다고 가정했을 때 OCTET\$1LENGTH 함수는 해당 문자열에 대해 `12`를 반환하고 LEN 함수는 동일한 문자열에 대해 `3`을 반환합니다.

## 사용 노트
<a name="r_OCTET_LENGTH_usage_notes"></a>

**표현식이 `CHAR` 문자열인 경우 함수는 `CHAR` 문자열의 길이를 반환합니다. 예를 들어 `CHAR(6)` 입력의 출력은 `CHAR(6)`입니다.

**표현식이 `VARCHAR` 문자열인 경우 후행 공백이 계산됩니다.

## 예제
<a name="r_OCTET_LENGTH-example"></a>

후행 공백 3개가 있는 문자열 `francais`를 `CHAR` 및 `VARCHAR` 형식으로 캐스팅할 때 바이트 수를 반환하려면 다음 예제를 사용합니다. 자세한 내용은 [CAST 함수](r_CAST_function.md)을 참조하세요.

```
SELECT OCTET_LENGTH(CAST('francais   ' AS CHAR(15))) AS octet_length_char, OCTET_LENGTH(CAST('francais   ' AS VARCHAR(15))) AS octet_length_varchar;

+-------------------+----------------------+
| octet_length_char | octet_length_varchar |
+-------------------+----------------------+
|                15 |                   11 |
+-------------------+----------------------+
```

`français` 문자열의 바이트 수와 문자 수를 반환하려면 다음 예제를 사용합니다.

```
SELECT OCTET_LENGTH('français'), LEN('français');

+--------------+-----+
| octet_length | len |
+--------------+-----+
|            9 |   8 |
+--------------+-----+
```

문자열 `français`를 `VARBYTE`로 캐스팅할 때 바이트 수를 반환하려면 다음 예제를 사용합니다.

```
SELECT OCTET_LENGTH(CAST('français' AS VARBYTE));

+--------------+
| octet_length |
+--------------+
|            9 |
+--------------+
```