Função do AWS Lambda e referência de parâmetros

Veja a seguir a referência para as funções e os parâmetros a serem usados para invocar o Lambda com o Aurora PostgreSQL .

aws_lambda.invoke

Executa uma função do Lambda para um cluster de bancos de dados Aurora PostgreSQL .

Para obter mais detalhes sobre invocar funções Lambda, consulte também Invocar no Guia do desenvolvedor do AWS Lambda.

Sintaxe

JSON

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSON,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSON,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSON DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSON,
OUT executed_version TEXT,
OUT log_result TEXT)

JSONB

aws_lambda.invoke(
IN function_name TEXT,
IN payload JSONB,
IN region TEXT DEFAULT NULL,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT)

aws_lambda.invoke(
IN function_name aws_commons._lambda_function_arn_1,
IN payload JSONB,
IN invocation_type TEXT DEFAULT 'RequestResponse',
IN log_type TEXT DEFAULT 'None',
IN context JSONB DEFAULT NULL,
IN qualifier VARCHAR(128) DEFAULT NULL,
OUT status_code INT,
OUT payload JSONB,
OUT executed_version TEXT,
OUT log_result TEXT
)

Parâmetros de entrada

function_name

O nome de identificação da função Lambda. O valor pode ser o nome da função, um ARN ou um ARN parcial. Para obter uma lista de formatos possíveis, consulte Formatos de nome da função Lambda no Guia do desenvolvedor do AWS Lambda.

payload

A entrada para a função Lambda. O formato pode ser JSON ou JSONB. Para obter mais informações, consulte Tipos JSON na documentação do PostgreSQL.

região

(Opcional) A Lambda Região da função. Por padrão, o Aurora resolve a região da AWS a partir do ARN completo na function_name ou usa a região da instância de banco de dados Aurora PostgreSQL. Se este valor de região entrar em conflito com o fornecido no ARN de function_name, um erro será gerado.

invocation_type

O tipo de invocação da função do Lambda. O valor diferencia letras maiúsculas de minúsculas. Os valores possíveis incluem o seguinte:

• RequestResponse – O padrão. Esse tipo de invocação para uma função Lambda é síncrona e retorna uma carga útil de resposta no resultado. Use o tipo de invocação de RequestResponse quando seu fluxo de trabalho depende de receber o resultado da função Lambda imediatamente.

• Event – Esse tipo de invocação para uma função Lambda é assíncrono e retorna imediatamente sem uma carga devolvida. Use o tipo de invocação deEvent quando não precisar de resultados da função Lambda antes de seu fluxo de trabalho prosseguir.

• DryRun – Este tipo de invocação testa o acesso sem executar a função Lambda.

log_type

O tipo de log Lambda a ser retornado no parâmetro de saída de log_result. O valor diferencia letras maiúsculas de minúsculas. Os valores possíveis incluem o seguinte:

• Cauda – O parâmetro de saída log_result devolvido incluirá os últimos 4 KB do log de execução.

• Nenhuma – Nenhuma informação de log Lambda é devolvida.

context

Contexto do cliente no formato JSON ou JSONB. Os campos a serem usados incluem que custom e env.

qualifier

Um qualificador que identifica a versão de uma função Lambda a ser invocada. Se esse valor entrar em conflito com um fornecido no ARN do function_name, gera um erro.

Parâmetros de saída

status_code

Um código de resposta de status HTTP. Para obter mais informações, consulte Elementos de resposta de invocação do Lambda no Guia do desenvolvedor do AWS Lambda.

payload

As informações devolvidas da função Lambda executada. O formato está em JSON ou JSONB.

executed_version

A versão da função Lambda executada.

log_result

As informações do log de execução devolvidas se o valor log_type é Tail quando a função Lambda for invocada. O resultado contém os últimos 4 KB do log de execução codificado em Base64.

aws_commons.create_lambda_function_arn

Cria uma estrutura aws_commons._lambda_function_arn_1 para manter as informações do nome da função Lambda. Você pode usar os resultados da função aws_commons.create_lambda_function_arn no parâmetro function_name da função aws_lambda.invoke aws_lambda.invoke.

Sintaxe

aws_commons.create_lambda_function_arn(
    function_name TEXT,
    region TEXT DEFAULT NULL
    )
    RETURNS aws_commons._lambda_function_arn_1

Parâmetros de entrada

function_name

Uma string de texto necessária que contém o nome da função Lambda. O valor pode ser um nome de função, um ARN parcial ou um ARN completo.

região

Uma string de texto opcional que contém a região da AWS na qual a função Lambda está inserida. Para obter uma listagem de nomes de regiões da e os valores associados, consulte Regiões e zonas de disponibilidade.

Parâmetros aws_lambda

Na tabela, é possível encontrar parâmetros associados à função do aws_lambda.

Parâmetro	Descrição
aws_lambda.connect_timeout_ms	É um parâmetro dinâmico e define o tempo máximo de espera durante a conexão com o AWS Lambda. O valor padrão é 1000. Os valores permitidos para esse parâmetro são de 1 a 900000.
aws_lambda.request_timeout_ms	É um parâmetro dinâmico e define o tempo máximo de espera enquanto aguarda a resposta do AWS Lambda. O valor padrão é 3000. Os valores permitidos para esse parâmetro são de 1 a 900000.
aws_lambda.endpoint_override	Especifica o endpoint que pode ser usado para se conectar ao AWS Lambda. Uma string vazia seleciona o endpoint padrão do AWS Lambda para a região. É necessário reiniciar o banco de dados para esse parâmetro ter efeito.