View a markdown version of this page

Invocare un AWS Lambda funzione da un RDS per istanza DB PostgreSQL - Amazon Relational Database Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Invocare un AWS Lambda funzione da un RDS per istanza DB PostgreSQL

AWS Lambda è un servizio di elaborazione basato sugli eventi che consente di eseguire codice senza effettuare il provisioning o la gestione dei server. È disponibile per l'uso con molti AWS servizi, tra cui RDS per PostgreSQL. Ad esempio, è possibile utilizzare le funzioni Lambda per elaborare le notifiche di eventi da un database o per caricare dati da file ogni volta che un nuovo file viene caricato su Amazon S3. Per saperne di più su Lambda, vedi Che cos'è AWS Lambda? nel AWS Lambda Guida per gli sviluppatori.

Nota

Invocando un AWS Lambda la funzione è supportata in queste versioni di RDS per PostgreSQL:

  • Tutte le versioni di PostgreSQL 18

  • Tutte le versioni di PostgreSQL 17

  • Tutte le versioni di PostgreSQL 16

  • Tutte le versioni di PostgreSQL 15

  • PostgreSQL 14.1 e versioni secondarie successive

  • PostgreSQL 13.2 e versioni secondarie successive

  • PostgreSQL 12.6 e versioni secondarie successive

Configurazione RDS per PostgreSQL lavorare con le funzioni Lambda è un processo in più fasi che prevede AWS Lambda, IAM, il tuo VPC e il tuo RDS per istanza DB PostgreSQL. Di seguito sono riportati i riepiloghi dei passaggi necessari.

Per ulteriori informazioni sulle funzioni Lambda, consulta Nozioni di base su Lambda e Fondamenti di AWS Lambda nella Guida per gli sviluppatori di AWS Lambda .

Passaggio 1: configura il tuo RDS per istanza DB PostgreSQL per connessioni in uscita a AWS Lambda

Le funzioni Lambda vengono sempre eseguite all'interno di un Amazon VPC di proprietà di AWS Lambda servizio. Lambda applica le regole di accesso alla rete e di sicurezza a questo VPC e mantiene e monitora il VPC automaticamente. L'istanza database RDS per PostgreSQL deve inviare traffico di rete al VPC del servizio Lambda. La modalità di configurazione dipende dal fatto che l'istanza database sia pubblica o privata.

  • Pubblico RDS per istanza DB PostgreSQL — UN Istanza DB è pubblica se si trova in una sottorete pubblica del tuo VPC e se l'istanza è»PubliclyAccessiblela proprietà «è true. Per trovare il valore di questa proprietà, puoi usare describe-db-instances AWS CLI comando. In alternativa, puoi utilizzare la Console di gestione AWS per aprire la scheda Connectivity & security (Connettività e sicurezza) e controllare che l’opzione Publicly accessible (Accessibile pubblicamente) sia impostata su Yes (Sì). Per verificare se l'istanza si trova nella sottorete pubblica del VPC, puoi utilizzare la Console di gestione AWS o la AWS CLI.

    Per configurare l'accesso a Lambda, usi il Console di gestione AWS o il AWS CLI per creare una regola in uscita sul gruppo di sicurezza del tuo VPC. La regola in uscita specifica che TCP può utilizzare la porta 443 per inviare pacchetti a qualsiasi indirizzo IPv4 (0.0.0).0/0).

  • Privato RDS per istanza DB PostgreSQL — In questo caso, l'istanza»PubliclyAccessible«la proprietà è false o si trova in una sottorete privata. Per consentire all'istanza di funzionare con Lambda, è possibile utilizzare un gateway Network Address Translation (NAT). Per ulteriori informazioni, consulta Gateway NAT. In alternativa, puoi configurare il VPC con un endpoint VPC per Lamda. Per ulteriori informazioni, consultare Endpoint VPC nella Guida per l'utente di Amazon VPC. L'endpoint risponde alle chiamate effettuate dall'istanza database RDS per PostgreSQL alle funzioni Lambda. L'endpoint VPC utilizza la propria risoluzione DNS privata. RDS for PostgreSQL non può utilizzare l'endpoint VPC di Lambda fino a quando non modifichi il valore di rds.custom_dns_resolution dal valore predefinito di 0 (non abilitato) a 1. A tale scopo:

    • Crea un gruppo parametri del database personalizzato.

    • Cambia il valore del parametro rds.custom_dns_resolution da 0 (valore predefinito) a 1.

    • Modifica l'istanza database per utilizzare il gruppo parametri del database personalizzato.

    • Affinché il parametro modificato abbia effetto, riavvia l'istanza.

Il tuo VPC può ora interagire con AWS Lambda VPC a livello di rete. Configura quindi le autorizzazioni utilizzando IAM.

La risoluzione DNS è in conflitto con l'autenticazione Kerberos e gli endpoint Lambda VPC

Invocazioni Lambda dal tuo istanza DB potrebbe fallire se abiliti l'autenticazione Kerberos e configuri gli endpoint Lambda VPC nel tuo AWS Managed Microsoft AD VPC.

Quando abiliti l'autenticazione Kerberos, il tuo istanza DB dà priorità AWS Managed Microsoft AD Server DNS tramite il resolver DNS VPC. Se i record degli endpoint Lambda sono presenti nel tuo AWS Managed Microsoft AD DNS, gli endpoint possono trasformarsi in indirizzi IP nel tuo VPC di Active Directory anziché nel tuo VPC del database. Questa configurazione impedisce il successo delle invocazioni Lambda.

Per ulteriori informazioni, consulta Usare l'autenticazione Kerberos con Amazon RDS per PostgreSQL.

Passaggio 2: configura IAM per il tuo RDS per istanza DB PostgreSQL and AWS Lambda

Il richiamo di funzioni Lambda dall'istanza database RDS for PostgreSQL richiede determinati privilegi. Per configurare i privilegi necessari, si consiglia di creare una policy IAM che consenta di richiamare le funzioni Lambda, assegnare tale policy a un ruolo e quindi applicare il ruolo all'istanza database. Questo approccio fornisce all'istanza database privilegi per richiamare la funzione Lambda specificata per tuo conto. La procedura seguente mostra come eseguire questa operazione in AWS CLI.

Per configurare le autorizzazioni IAM per l'utilizzo del tuo Istanza Amazon RDS con Lambda
  1. Usa il cree-policy AWS CLI comando per creare una policy IAM che consenta di RDS per istanza DB PostgreSQL per richiamare la funzione Lambda specificata. (L'ID dichiarazione (Sid) è una descrizione facoltativa per la dichiarazione di policy e non ha alcun effetto sull'utilizzo). Questa policy fornisce all'istanza database le autorizzazioni minime necessarie per richiamare la funzione Lambda specificata.

    aws iam create-policy --policy-name rds-lambda-policy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowAccessToExampleFunction", "Effect": "Allow", "Action": "lambda:InvokeFunction", "Resource": "arn:aws:lambda:aws-region:444455556666:function:my-function" } ] }'

    In alternativa, puoi utilizzare la policy AWSLambdaRole predefinita che ti consente di richiamare una qualsiasi delle tue funzioni Lambda. Per ulteriori informazioni, vedere Identity-based Politiche IAM per Lambda

  2. Usa il create-role AWS CLI comando per creare un ruolo IAM che la policy può assumere in fase di esecuzione.

    aws iam create-role --role-name rds-lambda-role --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "rds.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }'
  3. Applica la policy al ruolo utilizzando attach-role-policy AWS CLI comando.

    aws iam attach-role-policy \ --policy-arn arn:aws:iam::444455556666:policy/rds-lambda-policy \ --role-name rds-lambda-role --region aws-region
  4. Applica il ruolo al tuo RDS per istanza DB PostgreSQL utilizzando aggiungi ruolo all'istanza db AWS CLI comando. Quest'ultimo passaggio consente agli utenti dell'istanza database di richiamare le funzioni Lambda.

    aws rds add-role-to-db-instance \ --db-instance-identifier my-instance-name \ --feature-name Lambda \ --role-arn arn:aws:iam::444455556666:role/rds-lambda-role \ --region aws-region

Con le configurazioni di VPC e IAM completate, puoi ora installare l'estensione aws_lambda. (Puoi installare l'estensione in qualsiasi momento, ma fino a quando non configuri il supporto VPC e i privilegi IAM corretti, l'estensione aws_lambdanon aggiunge nulla alle funzionalità dell'istanza database RDS for PostgreSQL).

Fase 3: Installare aws_lambda estensione per un RDS per istanza DB PostgreSQL

Da usare AWS Lambda con il tuo RDS per istanza DB PostgreSQL, aggiungi aws_lambda estensione PostgreSQL al tuo RDS per istanza DB PostgreSQL. Questa estensione fornisce all’istanza database RDS for PostgreSQL la possibilità di chiamare le funzioni Lambda da PostgreSQL.

Per installare aws_lambda estensione nel tuo RDS per istanza DB PostgreSQL

Utilizza la riga di comando PostgreSQL psql o lo strumento pgAdmin per connetterti al all'istanza database RDS for PostgreSQL.

  1. Connettiti all'istanza database RDS for PostgreSQL come utente con privilegi rds_superuser. L'utente postgres predefinito viene visualizzato nell'esempio.

    psql -h instance.444455556666.aws-region.rds.amazonaws.com -U postgres -p 5432
  2. Installa l’estensione aws_lambda. Anche l'estensione aws_commons è obbligatoria. Fornisce funzioni di supporto ad aws_lambda e molte altre estensioni Aurora per PostgreSQL. Se non si trova già nella tua istanza database RDS for PostgreSQL, viene installata con aws_lambda come mostrato di seguito.

    CREATE EXTENSION IF NOT EXISTS aws_lambda CASCADE; NOTICE: installing required extension "aws_commons" CREATE EXTENSION

L'estensione aws_lambda è installata nell'istanza database principale . Ora puoi creare strutture utili per richiamare le tue funzioni Lambda.

Passaggio 4: utilizza le funzioni di supporto Lambda con il tuo RDS per istanza DB PostgreSQL (Facoltativo)

Puoi utilizzare le funzioni di supporto nell'estensione aws_commons per preparare entità che è possibile richiamare più facilmente da PostgreSQL. Per farlo, devi disporre delle seguenti informazioni sulle funzioni Lambda:

  • Nome funzione: il nome, l'Amazon Resource Name (ARN), la versione o l'alias della funzione Lambda. La policy IAM creata in Fase 2: configurazione di IAM per l'istanza e Lambda richiede l'ARN, quindi ti consigliamo di utilizzare l'ARN della tua funzione.

  • AWS Regione — (Facoltativo) Il AWS Regione in cui si trova la funzione Lambda se non si trova nella stessa regione della tua RDS per istanza DB PostgreSQL.

Per mantenere le informazioni sul nome della funzione Lambda, puoi utilizzare la funzione aws_commons.create_lambda_function_arn. Questa funzione di supporto crea una struttura composita aws_commons._lambda_function_arn_1 con i dettagli necessari alla funzione di richiamo. Di seguito, puoi trovare tre approcci alternativi per l'impostazione di questa struttura composita.

SELECT aws_commons.create_lambda_function_arn( 'my-function', 'aws-region' ) AS aws_lambda_arn_1 \gset
SELECT aws_commons.create_lambda_function_arn( '111122223333:function:my-function', 'aws-region' ) AS lambda_partial_arn_1 \gset
SELECT aws_commons.create_lambda_function_arn( 'arn:aws:lambda:aws-region:111122223333:function:my-function' ) AS lambda_arn_1 \gset

Ognuno di questi valori può essere utilizzato nelle chiamate alla funzione aws_lambda.invoke. Per alcuni esempi, consulta Passaggio 5: richiama una funzione Lambda dal tuo RDS per istanza DB PostgreSQL.

Passaggio 5: richiama una funzione Lambda dal tuo RDS per istanza DB PostgreSQL

La funzione aws_lambda.invoke si comporta in modo sincrono o asincrono, a seconda del invocation_type. Le due alternative per questo parametro sono RequestResponse (il valore predefinito) e Event, come di seguito riportato.

  • RequestResponse: questo tipo di richiamo è sincrono. Questo è il comportamento predefinito quando viene effettuata la chiamata senza specificare un tipo di chiamata. Il payload di risposta include i risultati della funzione aws_lambda.invoke. Utilizza questo tipo di chiamata quando il flusso di lavoro richiede la ricezione dei risultati della funzione Lambda prima di procedere.

  • Event: questo tipo di richiamo è asincrono. La risposta non include un payload contenente i risultati. Utilizza questo tipo di richiamo quando il flusso di lavoro non ha bisogno di un risultato della funzione Lambda per continuare l'elaborazione.

Come semplice test della configurazione, puoi connetterti all'istanza database utilizzando psql e richiamare una funzione di esempio dalla riga di comando. Supponiamo di avere una delle funzioni di base impostate sul tuo servizio Lambda, come la semplice funzione Python mostrata nello screenshot di seguito.

Esempio di funzione Lambda mostrata nel AWS CLI per AWS Lambda.
Per richiamare una funzione di esempio
  1. Connettiti all’istanza database utilizzando psql o pgAdmin.

    psql -h instance.444455556666.aws-region.rds.amazonaws.com -U postgres -p 5432
  2. Richiama la funzione utilizzando il relativo ARN.

    SELECT * from aws_lambda.invoke(aws_commons.create_lambda_function_arn('arn:aws:lambda:aws-region:444455556666:function:simple', 'us-west-1'), '{"body": "Hello from Postgres!"}'::json );

    La risposta è la seguente.

    status_code | payload | executed_version | log_result -------------+-------------------------------------------------------+------------------+------------ 200 | {"statusCode": 200, "body": "\"Hello from Lambda!\""} | $LATEST | (1 row)

Se il tuo tentativo di richiamo non ha esito positivo, vedi Messaggi di errore della funzione Lambda.

Fase 6: concessione delle autorizzazioni ad altri utenti per richiamare le funzioni Lambda

A questo punto della procedura, solo tu in qualità di rds_superuser puoi richiamare le funzioni Lambda. Per consentire ad altri utenti di richiamare le funzioni che crei, è necessario concedere loro l'autorizzazione.

Per concedere ad altri utenti l'autorizzazione per richiamare le funzioni Lambda
  1. Connettiti all’istanza database utilizzando psql o pgAdmin.

    psql -h instance.444455556666.aws-region.rds.amazonaws.com -U postgres -p 5432
  2. Esegui i seguenti comandi SQL:

    postgres=> GRANT USAGE ON SCHEMA aws_lambda TO db_username; GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA aws_lambda TO db_username;