Lavorare con Simple Oracle Document Access (SODA) in Autonomous Database
Simple Oracle Document Access (SODA) è un set di API in stile NoSQL che ti consente di utilizzare raccolte di documenti JSON in Autonomous Database, recuperarli ed eseguirne query, senza dover conoscere Structured Query Language (SQL) o come vengono memorizzati i documenti nel database.
Autonomous Database supporta l'archiviazione e l'esecuzione di query sui documenti JSON in modo nativo. Le raccolte di documenti SODA sono supportate da tabelle e viste di database ordinari; è possibile utilizzare le funzioni di database per l'uso con il contenuto dei documenti SODA.
I driver SODA sono disponibili per diversi linguaggi e framework, tra cui Java, Node.js, Python, C (utilizzando Oracle Call Interface) e PL/SQL e SODA per REST. SODA per REST esegue il mapping delle operazioni SODA ai pattern Uniform Resource Locator (URL), in modo da poter essere utilizzato con la maggior parte dei linguaggi di programmazione.
Per iniziare a utilizzare SODA, vedere:
A seconda dell'API SODA da utilizzare, vedere quanto segue:
Se si utilizza Autonomous Database Sempre gratis con Oracle Database 23ai, per evitare problemi di compatibilità dei driver SODA, Oracle consiglia quanto segue:
-
Utilizzare le versioni del driver necessarie per utilizzare il tipo
JSONcome specificato nei driver SODA. Per ulteriori informazioni, vedere Driver SOA. -
Per i progetti avviati utilizzando una release di database precedente a Oracle Database 21c, specificare in modo esplicito i metadati per la raccolta predefinita come specificato nell'esempio dei driver SODA. Per i progetti che hanno iniziato a utilizzare la release 21c o successiva di Oracle Database, utilizzare solo i metadati predefiniti. Per ulteriori informazioni, vedere Driver SOA.
| API SODA | Download e installazione | Ulteriori informazioni |
|---|---|---|
|
SODA per Java |
Versioni: si consiglia di utilizzare la versione più recente di SODA per Java. La versione minima supportata è: 1.1.4. Utilizzare SODA per Java in combinazione con Autonomous Database non supporta Metadata builder. Per personalizzare i metadati di raccolta, passare le stringhe dei metadati di raccolta direttamente al metodo createCollection. Per ulteriori informazioni, vedere Metadati di raccolta SOA su Autonomous Database. |
|
|
SODA per REST |
||
|
SODA per C |
Download di Oracle Instant Client Versioni: per SODA per C, le librerie del client Oracle devono essere 19.6 e successive. È possibile ottenere Oracle Instant Client da Download di Oracle Instant Client. |
|
|
SODA per PL/SQL |
Non è necessario eseguire il download. Questo è incluso in Autonomous Database. |
|
|
SODA per Node.js |
Più download descritti nelle istruzioni di installazione: Installazione rapida di node-oracledb Versioni: il supporto SODA è stato introdotto nella versione 3.0. Si consiglia di utilizzare l'ultima versione, la versione minima consigliata è la 4.0. Le librerie client Oracle devono essere versioni 19.6 e successive. È possibile ottenere Oracle Instant Client da Download di Oracle Instant Client. |
|
|
SODA per Python |
Più download descritti nelle istruzioni di installazione: Versioni: il supporto SODA è stato introdotto nella versione 7.0. Si consiglia di utilizzare l'ultima versione, la versione minima consigliata è 7.1. Le librerie client Oracle devono essere versioni 19.6 e successive. È possibile ottenere Oracle Instant Client da Download di Oracle Instant Client. |
- Note SOA
Quando si utilizza SODA con Autonomous Database si applicano le seguenti limitazioni:
Argomento padre: Utilizzo dei documenti JSON con Autonomous Database
Note SODA
Quando si utilizza SODA con Autonomous Database, si applicano le limitazioni riportate di seguito.
-
L'indicizzazione automatica non è supportata per il codice SQL e PL/SQL che utilizza la funzione SQL/JSON
json_exists. Per ulteriori informazioni, vedere Condizione SQL/JSON JSON_EXISTS. -
L'indicizzazione automatica non è supportata per QBE (Query-by-Example) SODA.