View a markdown version of this page

SYS_LUDF_DETAIL - Amazon Redshift
Colunas da tabelaConsultas de exemplo

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

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 em milissegundos.
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.
query_uuid character(36) O identificador globalmente exclusivo (UUID) da consulta.

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)