SYS_LUDF_DETAIL - Amazon Redshift
Colunas da tabelaConsultas de exemplo

O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a publicação de blog .

SYS_LUDF_DETAIL

SYS_LUDF_DETAIL registra informações e métricas para funções definidas pelo usuário do Lambda (LUDFs) que foram usadas em uma consulta específica.

SYS_LUDF_DETAIL está visível somente para superusuários. Para obter mais informações, consulte Visibilidade de dados em tabelas e visualizações de sistema.

Colunas da tabela

Nome da coluna Tipo de dados Descrição
user_id integer O identificador do usuário que enviou a consulta que está chamando a função.
transaction_id bigint O identificador da transação.
query_id bigint Identificador de consulta de usuário.
function_oid bigint ID do objeto da função no catálogo.
function_position integer Posição numérica dessa função na etapa. Por exemplo, se houver várias chamadas da mesma função na lista SELECT de uma consulta, elas poderão ser identificadas usando esses números posicionais.
stream_id integer O identificador do fluxo em que a chamada de função foi executada.
segment_id integer O identificador do segmento em que a chamada de função foi executada.
step_id integer O identificador da etapa em que a chamada de função foi executada.
lambda_function_name char(256) Nome da função do Lambda.
start_time timestamp A hora em que as chamadas começaram.
end_time timestamp A hora em que as chamadas terminaram.
total_duration bigint A duração total das chamadas.
invocações integer O número de invocações simultâneas ou externas.
total_rows bigint O número de linhas transmitidas/exibidas para/da chamada.
input_bytes bigint O número de bytes transmitidos para a chamada.
output_bytes bigint O número de bytes que a chamada produziu.

Consultas de exemplo

O exemplo a seguir usa uma UDF do Lambda em uma consulta e, em seguida, mostra como consultar a visualização SYS_LUDF_DETAIL para ver os detalhes de execução da função.

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;

Exemplo de resultado:

 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)