SYS_LUDF_DETAIL - Amazon Redshift
테이블 열샘플 쿼리

Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 블로그 게시물을 참조하세요.

SYS_LUDF_DETAIL

SYS_LUDF_DETAIL은 특정 쿼리에 사용된 Lambda 사용자 정의 함수(LUDF)에 대한 정보와 지표를 기록합니다.

SYS_LUDF_DETAIL은 수퍼유저에게만 표시됩니다. 자세한 내용은 시스템 테이블 및 뷰에 있는 데이터의 가시성 섹션을 참조하세요.

테이블 열

열 이름 데이터 유형 설명
user_id 정수 함수를 직접적으로 호출하는 쿼리를 제출한 사용자의 식별자입니다.
transaction_id bigint 트랜잭션 식별자입니다.
query_id bigint 사용자 쿼리 식별자입니다.
function_oid bigint 카탈로그에 있는 함수의 객체 ID입니다.
function_position 정수 단계에서 이 함수의 숫자 위치입니다. 예를 들어 쿼리의 SELECT 목록에 동일한 함수의 직접적 호출이 여러 번 있는 경우 이러한 위치 번호를 사용하여 식별할 수 있습니다.
stream_id 정수 함수 직접 호출이 수행된 스트림 식별자입니다.
segment_id 정수 함수 직접 호출이 수행된 세그먼트 식별자입니다.
step_id 정수 함수 직접 호출이 수행된 단계 식별자입니다.
lambda_function_name char(256) Lambda 함수의 이름입니다.
start_time timestamp 직접 호출이 시작된 시간입니다.
end_time timestamp 직접 호출이 종료된 시간입니다.
total_duration bigint 직접 호출의 총 지속 시간입니다.
간접 호출 정수 동시 또는 외부 간접 호출 수입니다.
total_rows bigint 직접 호출에 전달/반환된 행 수입니다.
input_bytes bigint 직접 호출에 전달된 바이트 수입니다.
output_bytes bigint 직접 호출이 생성한 바이트 수입니다.

샘플 쿼리

다음 예제에서는 쿼리에서 Lambda UDF를 사용한 다음 SYS_LUDF_DETAIL 뷰를 쿼리하여 함수 실행 세부 정보를 보는 방법을 보여줍니다.

SET SESSION AUTHORIZATION regular_user;

CREATE EXTERNAL FUNCTION exfunc_sum(INT,INT) RETURNS INT STABLE
LAMBDA 'lambda_sum'
IAM_ROLE 'arn:aws:iam::123456789012:role/Redshift-Exfunc-Test';

CREATE TABLE t_sum(c1 int, c2 int);
INSERT INTO t_sum VALUES (4,5), (6,7);
SELECT exfunc_sum(c1,c2) FROM t_sum;

-- Switch to super user in order to inspect records in the LUDF SYS view.
SET SESSION AUTHORIZATION super_user;
select * from sys_ludf_detail;

샘플 출력은 다음과 같습니다.

 user_id | transaction_id | query_id | function_oid | function_position | stream_id | segment_id | step_id | lambda_function_name |         start_time         |          end_time          | total_duration | invocations | total_rows | input_bytes | output_bytes
---------+----------------+----------+--------------+-------------------+-----------+------------+---------+----------------------+----------------------------+----------------------------+----------------+-------------+------------+-------------+--------------
     100 |           1463 |     1544 |       111055 |                 0 |         0 |          0 |       2 | lambda_sum           | 2026-01-06 17:23:25.165898 | 2026-01-06 17:23:25.165898 |            414 |           1 |          2 |         277 |           18
(1 row)