

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
<a name="Oracle.BedrockIntegration"></a>

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.

**Topics**
+ [Anforderungen für die Bedrock-Integration](#Oracle.BedrockIntegration.requirements)
+ [Konfiguration der Bedrock-Integration](#Oracle.BedrockIntegration.Configuring)
+ [Verwenden Sie die Bedrock-Integration](#Oracle.BedrockIntegration.Using)

## Anforderungen für die Bedrock-Integration
<a name="Oracle.BedrockIntegration.requirements"></a>

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

### Datenbankanforderungen
<a name="Oracle.BedrockIntegration.requirements.Database"></a>
+ 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](#Oracle.BedrockIntegration.Configuring).

### AWS Anforderungen an die Anmeldeinformationen
<a name="Oracle.BedrockIntegration.requirements.Credentials"></a>
+ 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 optional`bedrock: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](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) 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
<a name="Oracle.BedrockIntegration.requirements.Network"></a>

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`.

1. 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).

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

1. 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.

1. 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.

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

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

1. 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
<a name="Oracle.BedrockIntegration.Configuring"></a>

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
<a name="Oracle.BedrockIntegration.Configuring.Step1"></a>

Stellen Sie sicher, dass Ihre DB-Instance den Bedrock-Laufzeitendpunkt erreichen kann, indem Sie eine der unter beschriebenen Netzwerkoptionen verwenden. [Amazon VPC-Netzwerkanforderungen](#Oracle.BedrockIntegration.requirements.Network) 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
<a name="Oracle.BedrockIntegration.Configuring.Step2"></a>

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
<a name="Oracle.BedrockIntegration.Configuring.Step3"></a>

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
<a name="Oracle.BedrockIntegration.Configuring.Step4"></a>

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;
/
```

{{region}}Ersetzen 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
<a name="Oracle.BedrockIntegration.Configuring.Step5"></a>

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
<a name="Oracle.BedrockIntegration.Configuring.Step6"></a>

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 verwenden`us-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 festlegen`region`, 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` oder`runsql`.

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 verwendet`bedrock-runtime.us-east-1.amazonaws.com`.

**Anmerkung**  
`region`Aufgrund 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:
+ Basismodelle: [Amazon Bedrock-Basismodell-IDs](https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html).
+ Cross-Region Inferenzprofile: [Unterstützte Regionen und Modelle für regionsübergreifende](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference-support.html) Inferenz.
+ Bereitgestellter Durchsatz: Geben Sie den ARN des bereitgestellten Durchsatzes an.
+ Benutzerdefinierte Modelle: Erwerben Sie Provisioned Throughput und geben Sie dann den ARN des resultierenden bereitgestellten Modells an.

### Überprüfung Ihrer Bedrock-Integration
<a name="Oracle.BedrockIntegration.Configuring.Verifying"></a>

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
<a name="Oracle.BedrockIntegration.Using"></a>

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`,,, und`explainsql`)`showsql`, der `DBMS_CLOUD_AI.GENERATE` Funktion `narrate``chat`, Multi-Turn-Konversationen und Retrieval Augmented Generation (RAG) — finden Sie in der folgenden Oracle-Dokumentation:
+ [Beispiel: Wählen Sie KI mit AWS](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/select-ai-examples.html#GUID-A2B7D8BB-5CBF-49D4-B12C-8AB54BA7D0A2)
+ [KI-Profile verwalten — Verwenden AWS](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/select-ai-manage-profiles.html#GUID-B71D2617-F079-4982-A979-6C1C8C58B577)
+ [DBMS\_CLOUD\_AI Paketreferenz](https://docs.oracle.com/en/database/oracle/oracle-database/26/arpls/dbms_cloud_ai1.html)