Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Aufrufen eines AWS Lambda Funktion von einem RDS für PostgreSQL-DB-Instance
AWS Lambda ist ein ereignisgesteuerter Rechendienst, mit dem Sie Code ausführen können, ohne Server bereitstellen oder verwalten zu müssen. Er ist für die Verwendung mit vielen verfügbar AWS Dienstleistungen, einschließlich RDS für PostgreSQL. Sie können beispielsweise Lambda-Funktionen verwenden, um Ereignisbenachrichtigungen aus einer Datenbank zu verarbeiten oder Daten aus Dateien zu laden, wann immer eine neue Datei in Amazon S3 hochgeladen wird. Weitere Informationen zu Lambda finden Sie unter Was ist AWS Lambda? in der AWS Lambda Leitfaden für Entwickler.
Aufrufen eines AWS Lambda Die Funktion wird in diesen RDS für PostgreSQL-Versionen unterstützt:
Alle PostgreSQL 18-Versionen
Alle PostgreSQL 17-Versionen
Alle PostgreSQL 16-Versionen
Alle PostgreSQL 15-Versionen
PostgreSQL 14.1 und höhere Unterversionen
-
PostgreSQL 13.2 und höhere Unterversionen
-
PostgreSQL 12.6 und höhere Unterversionen
Einrichtung RDS für PostgreSQL Die Arbeit mit Lambda-Funktionen ist ein mehrstufiger Prozess, der Folgendes beinhaltet AWS Lambda, IAM, Ihre VPC und Ihre RDS für PostgreSQL-DB-Instance. Im Folgenden finden Sie Zusammenfassungen der notwendigen Schritte.
Weitere Informationen über Lambda-Funktionen finden Sie unter Erste Schritte mit Lambda und Grundlagen von AWS Lambda im AWS Lambda -Entwicklerhandbuch.
Themen
Schritt 2: Konfigurieren Sie IAM für RDS für PostgreSQL-DB-Instance und AWS Lambda
Schritt 3: Installieren Sie den aws_lambda Erweiterung für eine RDS für PostgreSQL-DB-Instance
Schritt 4: Verwenden Sie Lambda-Hilfsfunktionen mit Ihrem RDS für PostgreSQL-DB-Instance (Optional)
Schritt 5: Rufen Sie eine Lambda-Funktion von Ihrem auf RDS für PostgreSQL-DB-Instance
Schritt 6: Erteilen der Berechtigung, Lambda-Funktionen aufzurufen, für andere Benutzer
Beispiele: Aufrufen von Lambda-Funktionen von Ihrer RDS-for-PostgreSQL-DB-Instance
Schritt 1: Konfiguriere deine RDS für PostgreSQL-DB-Instance für ausgehende Verbindungen zu AWS Lambda
Lambda-Funktionen werden immer in einer Amazon-VPC ausgeführt, die dem gehört AWS Lambda Dienst. Lambda wendet Netzwerkzugriffs- und Sicherheitsregeln auf diese VPC an und pflegt und überwacht die VPC automatisch. Ihre DB-Instance von RDS für PostgreSQL muss Netzwerkdatenverkehr an die VPC des Lambda-Services senden. Wie Sie dies konfigurieren, hängt davon ab, ob die primäre DB-Instance Ihres öffentlich oder privat ist.
Öffentlich RDS für PostgreSQL-DB-Instance — EIN DB-Instanz ist öffentlich, wenn sie sich in einem öffentlichen Subnetz auf Ihrer VPC befindet und wenn die Instance“PubliclyAccessible„Eigentum ist
true. Um den Wert dieser Eigenschaft zu ermitteln, können Sie den describe-db-instances AWS CLI Befehl. Alternativ können Sie über die AWS-Managementkonsole die Registerkarte Connectivity & security (Konnektivität und Sicherheit) öffnen und prüfen, ob Publicly accessible (Öffentlich zugänglich) auf Yes (Ja) eingestellt ist. Wenn Sie überprüfen möchten, ob sich die Instance im öffentlichen Subnetz Ihrer VPC befindet, können Sie die AWS-Managementkonsole oder die AWS CLI verwenden.Um den Zugriff auf Lambda einzurichten, verwenden Sie den AWS-Managementkonsole oder die AWS CLI um eine ausgehende Regel für die Sicherheitsgruppe Ihrer VPC zu erstellen. Die Regel für ausgehenden Datenverkehr gibt an, dass TCP Port 443 verwenden kann, um Pakete an beliebige IPv4-Adressen zu senden (0.0.0.0/0).
Privat RDS für PostgreSQL-DB-Instance — In diesem Fall ist die Instanz“PubliclyAccessible„Eigentum ist
falseoder es ist in einem privaten Subnetz. Damit die Instance mit Lambda arbeiten kann, können Sie ein Network Address Translation (NAT)-Gateway verwenden. Weitere Informationen finden Sie unter NAT-Gateways. Sie können Ihre VPC auch mit einem VPC-Endpunkt für Lambda konfigurieren. Weitere Informationen finden Sie unter VPC-Endpunkte im Amazon-VPC-Benutzerhandbuch. Der Endpunkt gibt Antworten auf Aufrufe Ihrer Lambda-Funktionen von Ihrer DB-Instance von RDS für PostgreSQL zurück. Der VPC-Endpunkt verwendet seine eigene private DNS-Auflösung. RDS für PostgreSQL kann den Lambda-VPC-Endpunkt erst verwenden, wenn Sie den Wert vonrds.custom_dns_resolutionvon seinem Standardwert 0 (nicht aktiviert) zu 1 ändern. Gehen Sie hierzu wie folgt vor:Erstellen Sie eine benutzerdefinierte DB-Parametergruppe.
Ändern Sie den Wert des Parameters
rds.custom_dns_resolutionvon seinem Standardwert0zu1.Ändern Sie Ihre DB-Instance, um Ihre benutzerdefinierte DB-Parametergruppe zu verwenden.
Starten Sie die DB-Instance neu, damit der bearbeitete Parameter in Kraft tritt.
Ihre VPC kann jetzt mit dem interagieren AWS Lambda VPC auf Netzwerkebene. Als Nächstes konfigurieren Sie die Berechtigungen mithilfe von IAM.
Lambda-Aufrufe von Ihrem DB-Instanz schlägt möglicherweise fehl, wenn Sie die Kerberos-Authentifizierung aktivieren und Lambda-VPC-Endpunkte in Ihrem AWS Managed Microsoft AD VPC.
Wenn Sie die Kerberos-Authentifizierung aktivieren, wird Ihr DB-Instanz priorisiert AWS Managed Microsoft AD DNS-Server gegenüber dem VPC-DNS-Resolver. Wenn Lambda-Endpunkteinträge in Ihrem vorhanden sind AWS Managed Microsoft AD DNS, die Endpunkte werden möglicherweise in IP-Adressen in Ihrer Active Directory-VPC und nicht in Ihrer Datenbank-VPC aufgelöst. Diese Konfiguration verhindert erfolgreiche Lambda-Aufrufe.
Weitere Informationen finden Sie unter Verwenden der Kerberos-Authentifizierung mit Amazon RDS für PostgreSQL.
Schritt 2: Konfigurieren Sie IAM für RDS für PostgreSQL-DB-Instance und AWS Lambda
Das Aufrufen von Lambda-Funktionen von Ihrer RDS-for-PostgreSQL-DB-Instance erfordert bestimmte Berechtigungen. Um die erforderlichen Berechtigungen zu konfigurieren, empfehlen wir Ihnen, eine IAM-Richtlinie zu erstellen, die es ermöglicht, Lambda-Funktionen aufzurufen, diese Richtlinie einer Rolle zuzuweisen und die Rolle dann auf Ihre DB-Instance anzuwenden. Dieser Ansatz gewährt der DB-Instance Berechtigungen zum Aufrufen der angegebenen Lambda-Funktion in Ihrem Namen. Nachfolgend wird beschrieben, wie Sie dazu die AWS CLI verwenden können.
So konfigurieren Sie IAM-Berechtigungen für die Verwendung Ihrer Amazon RDS-Instanz mit Lambda
Benutze das create-policy
AWS CLI Befehl zum Erstellen einer IAM-Richtlinie, die Folgendes ermöglicht RDS für PostgreSQL-DB-Instance um die angegebene Lambda-Funktion aufzurufen. (Die Anweisungs-ID (Sid) ist eine optionale Beschreibung für Ihre Richtlinienanweisung und hat keine Auswirkungen auf die Verwendung.) Diese Richtlinie gewährt Ihrer DB-Instance die Mindestberechtigungen zum Aufrufen der angegebenen Lambda-Funktion. aws iam create-policy --policy-namerds-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-functionAlternativ können Sie die vordefinierte
AWSLambdaRole-Richtlinie verwenden, mit der Sie alle Ihre Lambda-Funktionen aufrufen können. Weitere Informationen finden Sie unter Identity-based IAM-Richtlinien für LambdaVerwenden Sie das Rolle erstellen
AWS CLI Befehl zum Erstellen einer IAM-Rolle, die die Richtlinie zur Laufzeit übernehmen kann. aws iam create-role --role-namerds-lambda-role--assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "rds.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }'Wenden Sie die Richtlinie auf die Rolle an, indem Sie den Richtlinie anhängen
AWS CLI Befehl. aws iam attach-role-policy \ --policy-arn arn:aws:iam::444455556666:policy/rds-lambda-policy\ --role-namerds-lambda-role--regionaws-regionWenden Sie die Rolle auf Ihre an RDS für PostgreSQL-DB-Instance durch die Verwendung der Rolle zur DB-Instanz hinzufügen
AWS CLI Befehl. Dieser letzte Schritt erlaubt den Datenbankbenutzern Ihrer DB-Instances, Lambda-Funktionen aufzurufen. aws rds add-role-to-db-instance \ --db-instance-identifiermy-instance-name\ --feature-name Lambda \ --role-arn arn:aws:iam::444455556666:role/rds-lambda-role\ --regionaws-region
Wenn die VPC- und die IAM-Konfigurationen abgeschlossen sind, können Sie jetzt die aws_lambda-Erweiterung installieren. (Beachten Sie, dass Sie die Erweiterung jederzeit installieren können, bis Sie jedoch die richtige VPC-Unterstützung und IAM-Berechtigungen eingerichtet haben, hat die aws_lambda-Erweiterung keinerlei Auswirkungen auf die Funktionen Ihrer RDS-for-PostgreSQL-DB-Instances.)
Schritt 3: Installieren Sie den aws_lambda Erweiterung für eine RDS für PostgreSQL-DB-Instance
Zu verwenden AWS Lambda mit deinem RDS für PostgreSQL-DB-Instance, füge das hinzu aws_lambda PostgreSQL-Erweiterung zu Ihrem RDS für PostgreSQL-DB-Instance. Diese Erweiterung bietet Ihrer RDS-for-PostgreSQL-DB-Instance die Möglichkeit, Lambda-Funktionen von PostgreSQL aus aufzurufen.
Um das zu installieren aws_lambda Erweiterung in Ihrem RDS für PostgreSQL-DB-Instance
Verwenden Sie die PostgreSQL-psql-Befehlszeile oder das pgAdmin-Tool, um Ihre RDS-for-PostgreSQL-DB-Instance zu verbinden.
Verbinden Sie Ihren Ihre RDS-for-PostgreSQL-DB-Instance als Benutzer mit
rds_superuser-Berechtigungen. Im Beispiel wird derpostgres-Standardbenutzer dargestellt.psql -hinstance.444455556666..rds.amazonaws.com -U postgres -p 5432aws-region-
Installieren Sie die
aws_lambda-Erweiterung. Dieaws_commons-Erweiterung ist auch erforderlich. Sie bietet Hilfsfunktionen füraws_lambdaund viele andere Aurora-Erweiterungen für PostgreSQL. Wenn Sie noch nicht auf Ihrer RDS-for-PostgreSQL-DB-Instance installiert ist, wird sie mitaws_lambdawie folgt installiert.CREATE EXTENSION IF NOT EXISTS aws_lambda CASCADE;NOTICE: installing required extension "aws_commons" CREATE EXTENSION
Die aws_lambda-Erweiterung wird in Ihrer DB-Instance installiert. Sie können jetzt praktische Strukturen für den Aufruf Ihrer Lambda-Funktionen erstellen.
Schritt 4: Verwenden Sie Lambda-Hilfsfunktionen mit Ihrem RDS für PostgreSQL-DB-Instance (Optional)
Sie können die Hilfsfunktionen in der aws_commons-Erweiterung verwenden, um Entitäten vorzubereiten, die sich einfacher über PostgreSQL aufrufen lassen. Hierzu sind die folgenden Informationen zu Ihren Lambda-Funktionen erforderlich:
-
Funktionsname – Der Name, der Amazon-Ressourcenname (ARN), die Version oder der Alias der Lambda-Funktion. Die in Schritt 2: Konfigurieren von IAM für Ihre Instance und Lambda erstellte IAM-Richtlinie benötigt den ARN, daher empfehlen wir Ihnen, den ARN Ihrer Funktion zu verwenden.
-
AWS Region — (Optional) Die AWS Region, in der sich die Lambda-Funktion befindet, wenn sie sich nicht in derselben Region wie Ihre befindet RDS für PostgreSQL-DB-Instance.
Um die Daten zum Lambda-Funktionsnamen zu speichern, verwenden Sie die aws_commons.create_lambda_function_arn-Funktion. Diese Hilfsfunktion erstellt eine zusammengesetzte aws_commons._lambda_function_arn_1-Struktur mit den Details, die von der Aufruffunktion benötigt werden. Im Folgenden finden Sie drei alternative Ansätze zum Einrichten dieser zusammengesetzten Struktur.
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
Jeder dieser Werte kann in Aufrufen der aws_lambda.invoke-Funktion verwendet werden. Beispiele finden Sie unter Schritt 5: Rufen Sie eine Lambda-Funktion von Ihrem auf RDS für PostgreSQL-DB-Instance.
Schritt 5: Rufen Sie eine Lambda-Funktion von Ihrem auf RDS für PostgreSQL-DB-Instance
Die aws_lambda.invoke-Funktion verhält sich synchron oder asynchron, je nach invocation_type. Die beiden Alternativen für diesen Parameter sind RequestResponse (der Standardwert) und Event, wie folgt.
-
RequestResponse– Dieser Aufrufstyp ist synchron. Dies ist das Standardverhalten, wenn der Aufruf erfolgt, ohne einen Aufruftyp anzugeben. Die Antwort-Nutzlast beinhaltet die Ergebnisse deraws_lambda.invoke-Funktion. Verwenden Sie diesen Aufruftyp, wenn Ihr Workflow Ergebnisse von der Lambda-Funktion erhalten muss, bevor er fortfährt. -
Event– Dieser Aufrufstyp ist asynchron. Die Antwort umfasst keine Nutzlast, die Ergebnisse enthält. Verwenden Sie diesen Aufruftyp, wenn Ihr Workflow kein Ergebnis der Lambda-Funktion benötigt, um die Verarbeitung fortzusetzen.
Als einfacher Test Ihres Setups können Sie mittels psql eine Verbindung mit Ihrer DB-Instance herstellen und eine Beispielfunktion über die Befehlszeile aufrufen. Angenommen, Sie haben eine der Grundfunktionen Ihres Lambda-Services eingerichtet, z. B. die einfache Python-Funktion, die im folgenden Screenshot gezeigt wird.
Beispielfunktion aufrufen
Stellen Sie per
psqloder pgAdmin eine Verbindung zu Ihrer DB-Instance her.psql -hinstance.444455556666..rds.amazonaws.com -U postgres -p 5432aws-regionRufen Sie die Funktion mit ihrem ARN auf.
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 );Die Antwort sieht wie folgt aus.
status_code | payload | executed_version | log_result -------------+-------------------------------------------------------+------------------+------------ 200 | {"statusCode": 200, "body": "\"Hello from Lambda!\""} | $LATEST | (1 row)
Schlägt der Aufruf fehl, siehe Fehlermeldungen von Lambda-Funktionen.
Schritt 6: Erteilen der Berechtigung, Lambda-Funktionen aufzurufen, für andere Benutzer
An dieser Stelle in den Prozeduren können nur Sie als rds_superuser Ihre Lambda-Funktionen aufrufen. Damit andere Benutzer alle von Ihnen erstellten Funktionen aufrufen können, müssen Sie ihnen die entsprechende Berechtigung erteilen.
Gewähren der Berechtigung zum Aufrufen von Lambda-Funktionen
Stellen Sie per
psqloder pgAdmin eine Verbindung zu Ihrer DB-Instance her.psql -hinstance.444455556666..rds.amazonaws.com -U postgres -p 5432aws-regionFühren Sie die folgenden SQL-Befehle aus:
postgres=>GRANT USAGE ON SCHEMA aws_lambda TOdb_username; GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA aws_lambda TOdb_username;