Mit Simple Oracle Document Access (SODA) in einer autonomen KI-Datenbank arbeiten
Simple Oracle Document Access (SODA) ist ein Set von APIs im NoSQL-Stil, mit dem Sie Collections von JSON-Dokumenten in Autonomous AI Database verwenden, sie abrufen und abfragen, ohne dass Sie Structured Query Language (SQL) oder die Art und Weise kennen müssen, wie die Dokumente in der Datenbank gespeichert werden.
Autonomous AI Database unterstützt das native Speichern und Abfragen von JSON-Dokumenten. SODA-Dokumentensammlungen werden durch gewöhnliche Datenbanktabellen und -Views unterstützt. Sie können die Datenbankfunktionen für den Inhalt von SODA-Dokumenten nutzen.
SODA-Treiber sind für mehrere Sprachen und Frameworks verfügbar, darunter: Java, Node.js, Python, C (mit Oracle Call Interface) und PL/SQL sowie SODA for REST. SODA for REST ordnet SODA-Vorgänge URL-Mustern (Uniform Resource Locator) zu, sodass sie mit den meisten Programmiersprachen verwendet werden können.
Die ersten Schritte mit SODA finden Sie in den folgenden Abschnitten:
Je nach SODA-API, mit der Sie arbeiten möchten, finden Sie folgende Informationen:
Hinweis: Wenn Sie eine autonome KI-Datenbank vom Typ "Immer kostenlos" mit Oracle AI Database 26ai verwenden, empfiehlt Oracle, zur Vermeidung von Kompatibilitätsproblemen mit SODA-Treibern die Treiberversionen zu verwenden, die für die Arbeit mit dem Typ JSON wie in SODA-Treibern angegeben erforderlich sind. Weitere Informationen finden Sie unter SODA-Treiber.
Hinweis
Geben Sie bei Projekten, die mit einem Datenbankrelease vor Oracle Database 21c gestartet wurden, explizit die Metadaten für die Standarderfassung an, wie im Beispiel unter "SODA-Treiber" angegeben. Für Projekte, die mit Release Oracle Database 21c oder höher gestartet wurden, verwenden Sie einfach die Standardmetadaten. Weitere Informationen finden Sie unter SODA-Treiber.
| SODA API | Download und Installation | Weitere Informationen |
|---|---|---|
| SODA für Java | Voraussetzungen für SODA für Java Versionen: SODA für Java wird empfohlen, die neueste Version zu verwenden. Die minimal unterstützte Version ist: 1.1.4. Verwenden Sie SODA für Java in Verbindung mit Autonomous AI Database unterstützt den Metadaten-Builder nicht. Um Collection-Metadaten anzupassen, übergeben Sie Collection-Metadatenzeichenfolgen direkt an die Methode createCollection. Weitere Informationen finden Sie unter SODA-Collection-Metadaten zur autonomen KI-Datenbank. |
SODA für Java |
| SODA for REST | Auf RESTful Services und SODA for REST zugreifen | SODA for REST mit Autonomous AI Database verwenden |
| SODA für C | Oracle Instant Client-Downloads Versionen: Bei SODA für C müssen Oracle-Clientbibliotheken 19.6 und höher sein. Sie können Oracle Instant Client über Oracle Instant Client-Downloads erhalten. |
SODA für C |
| SODA für PL/SQL | Kein Download erforderlich. Dies ist in der autonomen KI-Datenbank enthalten. | SODA für PL/SQL |
| SODA für Node.js | In den Installationsanweisungen werden mehrere Downloads beschrieben: Quick Start node-oracledb-Installation Versionen: SODA-Unterstützung wurde in Version 3.0 eingeführt. Es wird empfohlen, die neueste Version zu verwenden. Die empfohlene Mindestversion ist 4.0. Oracle-Clientbibliotheken müssen Version 19.6 und höher sein. Sie können Oracle Instant Client über Oracle Instant Client-Downloads erhalten. |
Node-oracledb SODA-Anforderungen |
| SODA für Python | In den Installationsanweisungen werden mehrere Downloads beschrieben: Versionen: SODA-Unterstützung wurde in Version 7.0 eingeführt. Es wird empfohlen, die neueste Version zu verwenden. Die empfohlene Mindestversion ist 7.1. Oracle-Clientbibliotheken müssen Version 19.6 und höher sein. Sie können Oracle Instant Client über Oracle Instant Client-Downloads erhalten. |
Einführung in cx_Oracle |
SODA-Notizen
Wenn Sie SODA mit einer autonomen KI-Datenbank verwenden, gelten die folgenden Einschränkungen:
-
Die automatische Indexierung wird für SQL- und PL/SQL-Code, der die SQL/JSON-Funktion
json_existsverwendet, nicht unterstützt. Weitere Informationen finden Sie unter SQL/JSON-Bedingung JSON_EXISTS. -
Automatische Indexierung wird für SODA-Query-by-Example (QBE) nicht unterstützt.