

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

# STL\_S3CLIENT\_ERROR
<a name="r_STL_S3CLIENT_ERROR"></a>

Amazon S3에서 파일을 로드하는 동안 조각에서 발생한 오류를 기록합니다.

STL\_S3CLIENT\_ERROR는 COPY 명령을 실행하면서 Amazon S3에서 데이터를 전송하는 동안 발생한 오류 정보를 확인하는 데 사용됩니다.

STL\_S3CLIENT\_ERROR는 모든 사용자에게 표시됩니다. 수퍼유저는 모든 행을 볼 수 있지만 일반 사용자는 자체 데이터만 볼 수 있습니다. 자세한 내용은 [시스템 테이블 및 뷰에 있는 데이터의 가시성](cm_chap_system-tables.md#c_visibility-of-data) 섹션을 참조하세요.

## 테이블 열
<a name="r_STL_S3CLIENT_ERROR-table-columns2"></a>


| 열 이름  | 데이터 유형  | 설명  | 
| --- | --- | --- | 
| userid | 정수 | 항목을 생성한 사용자의 ID. | 
| 쿼리  | 정수 | 쿼리 ID. 쿼리 열을 사용하여 다른 시스템 테이블 및 보기를 조인할 수 있습니다. 쿼리 ID -1은 내부용입니다. | 
| sliceid | 정수 | 쿼리가 실행 중인 슬라이스를 식별하는 번호. | 
| recordtime  | timestamp | 레코드가 기록된 시간  | 
| pid  | 정수  | 프로세스 ID. 한 세션의 모든 쿼리는 동일 프로세스에서 실행되므로 동일 세션에서 일련의 쿼리를 실행하는 경우, 이 값은 항상 같은 값을 유지합니다. | 
| http\_method  | character(64)  | Amazon S3 요청에 해당하는 HTTP 메서드 이름. | 
| 버킷  | character(64)  | Amazon S3 버킷 이름입니다. | 
| 키  | character(256)  | Amazon S3 객체에 해당하는 키입니다. | 
| 오류 | character(1024) | 오류 메시지. | 
| is\_partial | 정수 | true(1)인 경우 COPY 작업 중에 입력 파일이 범위로 분할됨을 나타내는 값입니다. 이 값이 false(0)이면 입력 파일이 분할되지 않습니다. | 
| start\_offset | bigint | COPY 작업 중에 입력 파일이 분할되는 경우 분할의 오프셋 값(바이트 단위)을 나타내는 값입니다. 파일이 분할되지 않은 경우 이 값은 0입니다. | 

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

"Connection timed out" 오류가 다수 발생한 경우에는 네트워킹 문제를 의심해볼 수 있습니다. Enhanced VPC Routing 기능을 사용하는 경우에는 클러스터의 VPC와 데이터 리소스 사이의 네트워크 경로가 유효한지 확인하세요. 자세한 내용은 [Amazon Redshift Enhanced VPC Routing](https://docs.aws.amazon.com/redshift/latest/mgmt/enhanced-vpc-routing.html)을 참조하세요.

## 샘플 쿼리
<a name="w2aac59c29b9c97c13"></a>

다음은 현재 세션에서 COPY 명령을 완료하면서 발생한 오류를 반환하는 쿼리입니다.

```
select query, sliceid, substring(key from 1 for 20) as file, 
substring(error from 1 for 35) as error  
from stl_s3client_error 
where pid = pg_backend_pid()
order by query desc;
```

결과

```
 query  | sliceid |     file           |              error                             
--------+---------+--------------------+------------------------------------
 362228 |      12 | part.tbl.25.159.gz | transfer closed with 1947655 bytes 
 362228 |      24 | part.tbl.15.577.gz | transfer closed with 1881910 bytes 
 362228 |       7 | part.tbl.22.600.gz | transfer closed with 700143 bytes r 
 362228 |      22 | part.tbl.3.34.gz   | transfer closed with 2334528 bytes 
 362228 |      11 | part.tbl.30.274.gz | transfer closed with 699031 bytes r
 362228 |      30 | part.tbl.5.509.gz  | Unknown SSL protocol error in conne
 361999 |      10 | part.tbl.23.305.gz | transfer closed with 698959 bytes r
 361999 |      19 | part.tbl.26.582.gz | transfer closed with 1881458 bytes 
 361999 |       4 | part.tbl.15.629.gz | transfer closed with 2275907 bytes 
 361999 |      20 | part.tbl.6.456.gz  | transfer closed with 692162 bytes r
(10 rows)
```