View a markdown version of this page

Amazon Bedrock-Integration für RDS für Oracle - Amazon Relational Database Service

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.

Amazon Bedrock-Integration für RDS für Oracle

RDS for Oracle unterstützt die Integration mit Amazon Bedrock, sodass Sie Foundation-Modelle mithilfe von SQL direkt aus Ihrer Oracle-Datenbank aufrufen können. Mit dieser Integration können Sie generative KI-Funktionen wie Textgenerierung, Zusammenfassung und Einbettung nutzen, ohne Daten aus Ihrer Datenbank verschieben zu müssen.

Anmerkung

Die Amazon Bedrock-Integration wird nur für Oracle Database 26ai unterstützt.

Anforderungen für die Bedrock-Integration

Um die Amazon Bedrock-Integration mit RDS for Oracle zu verwenden, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind.

Datenbankanforderungen

  • Auf Ihrer DB-Instance muss Oracle Database 26ai (26.0.0.0) oder höher ausgeführt werden.

  • Der Datenbankbenutzer, der Bedrock-Modelle aufruft, muss über die EXECUTE Rechte für die Pakete und verfügen. DBMS_CLOUD DBMS_CLOUD_AI

  • Die Datenbank muss mit Zugriffskontrolleinträgen (ACEs) konfiguriert sein, die ausgehenden HTTPS-Zugriff auf den Bedrock-Laufzeitendpunkt ermöglichen. Weitere Informationen finden Sie unter Konfiguration der Bedrock-Integration.

AWS Anforderungen an die Anmeldeinformationen

  • Sie benötigen einen IAM-Benutzer oder eine IAM-Rolle mit Berechtigungen zum Aufrufen der gewünschten Amazon Bedrock Foundation-Modelle (die Aktionen bedrock:InvokeModel und optionalbedrock:InvokeModelWithResponseStream).

  • Sie müssen über die Amazon Bedrock-Konsole Zugriff auf die gewünschten Foundation-Modelle beantragt und erhalten haben. Weitere Informationen finden Sie unter Zugriff auf Amazon Bedrock Foundation-Modelle im Amazon Bedrock-Benutzerhandbuch.

  • Sie benötigen AWS Zugriffsschlüssel (eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel), mit denen Sie Ihre IAM-Identität in der Datenbank speichern können. DBMS_CLOUD.CREATE_CREDENTIAL

Amazon VPC-Netzwerkanforderungen

Die RDS for Oracle DB-Instance muss in der Lage sein, den Amazon Bedrock-Laufzeitendpunkt (bedrock-runtime.region.amazonaws.com) auf Port 443 (HTTPS) zu erreichen. Sie können dies auf eine der folgenden Arten erreichen.

Option 1: Endpunkt der Amazon VPC-Schnittstelle (AWS PrivateLink) — empfohlen

Erstellen Sie einen Amazon VPC-Schnittstellenendpunkt für den Amazon Bedrock Runtime-Service. Dadurch bleibt der gesamte Datenverkehr innerhalb des AWS Netzwerks privat und es ist kein Internetzugang erforderlich.

  1. Erstellen Sie einen Amazon VPC-Schnittstellenendpunkt mit dem Servicenamen:com.amazonaws.region.bedrock-runtime.

  2. Platzieren Sie den Endpunkt in derselben Amazon VPC und denselben Subnetzen wie Ihre Amazon RDS-DB-Instance (oder in Subnetzen mit Konnektivität zu den DB-Instance-Subnetzen).

  3. Fügen Sie dem Endpunkt eine Sicherheitsgruppe hinzu, die eingehendes HTTPS (Port 443) aus der Sicherheitsgruppe der DB-Instance zulässt.

  4. Aktivieren Sie Private DNS für den Endpunkt, sodass der Standard-Hostname in die private Endpunkt-IP-Adresse bedrock-runtime.region.amazonaws.com aufgelöst wird.

  5. Stellen Sie sicher, dass die Sicherheitsgruppe der DB-Instance ausgehendes HTTPS (Port 443) zur Sicherheitsgruppe des Endpunkts (oder zu den privaten IP-Adressen des Endpunkts) zulässt.

Option 2: NAT-Gateway (Internetroute)

Wenn Sie keinen Amazon VPC-Endpunkt verwenden, muss das Subnetz der DB-Instance eine Route zum Internet über ein NAT-Gateway haben.

  1. Stellen Sie sicher, dass sich die DB-Instance in einem privaten Subnetz mit einer Route zu einem NAT-Gateway befindet.

  2. Das NAT-Gateway muss sich in einem öffentlichen Subnetz mit einer Route zu einem Internet-Gateway befinden.

  3. Die Sicherheitsgruppe der DB-Instance muss ausgehendes HTTPS (Port 443) zulassen. bedrock-runtime.region.amazonaws.com

  4. Alle Amazon VPC-Netzwerk-ACLs im Subnetz der DB-Instance müssen ausgehenden TCP 443 und den entsprechenden kurzlebigen eingehenden Rückverkehr (TCP-Ports 1024—65535) zulassen.

In der folgenden Tabelle sind die Netzwerkpfade zusammengefasst.

Netzwerkpfade für die Bedrock-Integration
Ansatz Internetzugang erforderlich Verkehrspfad

Amazon VPC-Endpunkt ()AWS PrivateLink

Nein

DB-Instance → Amazon VPC-Endpunkt → Bedrock-Service

NAT-Gateway

Ja (nur ausgehender Versand)

DB-Instance → NAT-Gateway → Internet-Gateway → Bedrock-Dienst

Konfiguration der Bedrock-Integration

Gehen Sie wie folgt vor, um die Amazon Bedrock-Integration für Ihre RDS for Oracle DB-Instance zu konfigurieren.

Schritt 1: Amazon VPC-Netzwerkkonnektivität konfigurieren

Stellen Sie sicher, dass Ihre DB-Instance den Bedrock-Laufzeitendpunkt erreichen kann, indem Sie eine der unter beschriebenen Netzwerkoptionen verwenden. Amazon VPC-Netzwerkanforderungen Um die Konnektivität nach der Konfiguration zu überprüfen, können Sie in einem späteren Schritt Tests in der Datenbank durchführen.

Schritt 2: Besorgen AWS Anmeldeinformationen mit Bedrock-Berechtigungen

Erstellen Sie einen IAM-Benutzer oder eine IAM-Rolle mit der folgenden Richtlinie (oder fügen Sie sie einer vorhandenen Identität hinzu).

{ "Version": "2012-10-17", "Statement": [ { "Sid": "BedrockInvoke", "Effect": "Allow", "Action": [ "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream" ], "Resource": [ "arn:aws:bedrock:region::foundation-model/*" ] } ] }

Um den Zugriff auf bestimmte Modelle einzuschränken, ersetzen Sie den Platzhalter durch spezifische Modell-ARNs, zum Beispiel:

"arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-sonnet-4-5-20250929-v1:0"

Generieren Sie von der IAM-Konsole aus Zugriffsschlüssel für diesen IAM-Benutzer. Für den nächsten Schritt benötigen Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel.

Schritt 3: Gewähren Sie Datenbankberechtigungen

Stellen Sie eine Connect als DBA her und gewähren Sie dem Anwendungsbenutzer die erforderlichen Rechte.

-- Grant EXECUTE on DBMS_CLOUD and DBMS_CLOUD_AI GRANT EXECUTE ON DBMS_CLOUD TO db_user; GRANT EXECUTE ON DBMS_CLOUD_AI TO db_user;

Schritt 4: Gewähren Sie Netzwerk-ACL-Zugriff für den Bedrock-Endpunkt

Gewähren Sie dem Datenbankbenutzer Netzwerk-ACL-Zugriff auf den Bedrock-Laufzeitendpunkt.

BEGIN DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE( host => 'bedrock-runtime.region.amazonaws.com', ace => xs$ace_type( privilege_list => xs$name_list('http'), principal_name => 'db_user', principal_type => xs_acl.ptype_db) ); END; /

regionErsetzen Sie es durch Ihre AWS Region (z. B.us-east-1) und db_user durch den Oracle-Datenbankbenutzer, der Bedrock-Modelle aufruft.

Schritt 5: Erstellen Sie einen Berechtigungsnachweis in der Datenbank

Stellen Sie eine Connect als Anwendungsbenutzer her und erstellen Sie ein Anmeldeinformationsobjekt mithilfe DBMS_CLOUD von.

BEGIN DBMS_CLOUD.CREATE_CREDENTIAL( credential_name => 'AWS_BEDROCK_CRED', username => 'your_AWS_access_key_id', password => 'your_AWS_secret_access_key' ); END; /

Schritt 6: Erstellen Sie ein KI-Profil für Bedrock

Erstellen Sie ein KI-Profil, indem Sie DBMS_CLOUD_AI es verwenden, das auf Ihre Anmeldeinformationen verweist und AWS als Anbieter angibt.

BEGIN DBMS_CLOUD_AI.CREATE_PROFILE( profile_name => 'BEDROCK_PROFILE', attributes => '{"provider": "aws", "credential_name": "AWS_BEDROCK_CRED", "model": "us.anthropic.claude-sonnet-4-5-20250929-v1:0", "object_list": [{"owner": "schema", "name": "table1"}, {"owner": "schema", "name": "table2"}] }' ); END; /

Um einen Amazon Bedrock-Laufzeitendpunkt in einer anderen Region als zu verwendenus-east-1, fügen Sie die target_language Attribute region und in die Profilattribute JSON ein. Stellen Sie region die Region ein, in der sich Ihr Amazon Bedrock-Laufzeitendpunkt befindet (z. B.us-west-2).

Wenn Sie festlegenregion, müssen Sie auch target_language oder source_language angeben. Sie müssen beide Attribute zusammen festlegen, auch für Aktionen, die keine Übersetzung verwenden, wie z. B. chat oderrunsql.

Der target_language Wert wirkt sich nur auf die translate Aktion aus. Wenn Sie nur target_language ohne Angabe region angeben, wird das Profil weiterhin verwendetbedrock-runtime.us-east-1.amazonaws.com.

Anmerkung

regionAufgrund einer bekannten Beschränkung des DBMS_CLOUD_AI Oracle-Pakets müssen Sie diese Option angeben. target_language

Im folgenden Beispiel wird ein Profil erstellt, das die us-west-2 Region verwendet.

BEGIN DBMS_CLOUD_AI.CREATE_PROFILE( profile_name => 'BEDROCK_PROFILE_USW2', attributes => '{"provider": "aws", "credential_name": "AWS_BEDROCK_CRED", "region": "us-west-2", "target_language": "en", "model": "us.anthropic.claude-sonnet-4-5-20250929-v1:0", "object_list": [{"owner": "schema", "name": "table1"}, {"owner": "schema", "name": "table2"}] }' ); END; /

Sie müssen das model Attribut explizit angeben. Für den AWS Anbieter ist kein Standardmodell vorgesehen. Modell-IDs finden Sie in den folgenden Referenzen:

Überprüfung Ihrer Bedrock-Integration

Testen Sie die Konnektivität mit einer einfachen Aufforderung.

EXEC DBMS_CLOUD_AI.SET_PROFILE('BEDROCK_PROFILE'); SELECT AI chat what is Amazon RDS;

Wenn die Antwort erfolgreich zurückgegeben wird, ist Ihre Bedrock-Integration korrekt konfiguriert.

Verwenden Sie die Bedrock-Integration

Nachdem Sie die Integration konfiguriert haben, können Sie Amazon Bedrock Foundation-Modelle mithilfe von SQL mit Select AI aus Ihrer Oracle-Datenbank aufrufen.

Vollständige Anwendungsbeispiele mit Amazon Bedrock — einschließlich SELECT AI Aktionen (runsql,,, undexplainsql)showsql, der DBMS_CLOUD_AI.GENERATE Funktion narratechat, Multi-Turn-Konversationen und Retrieval Augmented Generation (RAG) — finden Sie in der folgenden Oracle-Dokumentation: