Mit Simple Oracle Document Access (SODA) in Autonomous Database arbeiten
Simple Oracle Document Access (SODA) ist ein Set von APIs im Stil von NoSQL, mit denen Sie Collections von JSON-Dokumenten in Autonomous Database verwenden, abrufen und abfragen können, ohne dass Sie SQL (Structured Query Language) oder die Art und Weise, wie die Dokumente in der Datenbank gespeichert werden, wissen müssen.
Autonomous Database unterstützt das native Speichern und Abfragen von JSON-Dokumenten. SODA-Dokumentsammlungen werden durch gewöhnliche Datenbanktabellen und -Views unterstützt. Sie können Datenbankfeatures mit dem Inhalt von SODA-Dokumenten verwenden.
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 Uniform Resource Locator-(URL-)Mustern zu und kann daher mit den meisten Programmiersprachen verwendet werden.
Informationen zu den ersten Schritten mit SODA finden Sie unter:
Je nach der SODA-API, mit der Sie arbeiten möchten, finden Sie weitere Informationen unter:
Wenn Sie Autonomous Database mit Oracle Database 23ai vom Typ "Immer kostenlos" verwenden, empfiehlt Oracle Folgendes, um Kompatibilitätsprobleme mit SODA-Treibern zu vermeiden:
-
Verwenden Sie die Treiberversionen, die für die Arbeit mit dem Typ
JSONerforderlich sind, wie unter "SODA-Treiber" angegeben. Weitere Informationen finden Sie unter SODA-Treiber. -
Geben Sie für Projekte, die mit einem älteren Datenbankrelease als Oracle Database 21c gestartet wurden, explizit die Metadaten für die Standard-Collection an, wie in dem Beispiel unter "SODA-Treiber" angegeben. Verwenden Sie für Projekte, die mit Release Oracle Database 21c oder höher gestartet wurden, 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: Bei SODA für Java wird empfohlen, die neueste Version zu verwenden. Die niedrigste unterstützte Version ist: 1.4. Verwenden Sie SODA für Java in Verbindung mit Autonomous 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 in Autonomous Database. |
|
|
SODA for REST |
||
|
SODA für C |
Oracle Instant Client-Downloads Versionen: Für SODA für C müssen Oracle-Client-Librarys die Version 19.6 oder höher aufweisen. Sie können Oracle Instant Client über Oracle Instant Client-Downloads abrufen. |
|
|
SODA für PL/SQL |
Muss nicht heruntergeladen werden. Ist in Autonomous Database enthalten. |
|
|
SODA für Node.js |
Mehrere Downloads werden in den Anweisungen beschrieben: Schnellstartinstallation von node-oracledb Versionen: SODA-Unterstützung wurde in Version 3.0 eingeführt. Die Verwendung der neuesten Version wird empfohlen. Die mindestens empfohlene Version ist 4.0. Oracle-Client-Library muss mindestens die Version 19.6 aufweisen. Sie können Oracle Instant Client über Oracle Instant Client-Downloads abrufen. |
|
|
SODA für Python |
Mehrere Downloads werden in den Anweisungen beschrieben: Versionen: SODA-Unterstützung wurde in Version 7.0 eingeführt. Die Verwendung der neuesten Version wird empfohlen. Die mindestens empfohlene Version ist 7.1. Oracle-Client-Library muss mindestens die Version 19.6 aufweisen. Sie können Oracle Instant Client über Oracle Instant Client-Downloads abrufen. |
- SODA-Hinweise
Bei der Verwendung von SODA mit Autonomous Database gelten die folgenden Einschränkungen:
Übergeordnetes Thema: JSON-Dokumente mit Autonomous Database verwenden
Hinweise zu SODA
Wenn Sie SODA mit Autonomous Database 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.
Übergeordnetes Thema: Mit Simple Oracle Document Access (SODA) in Autonomous Database arbeiten