Utilisation de SODA (Simple Oracle Document Access) dans Autonomous Database
SODA ( Simple Oracle Document Access) est un ensemble d'API de type NoSQL qui vous permettent d'utiliser des collections de documents JSON dans Autonomous Database, de les extraire et de les interroger, sans avoir besoin de connaître le langage SQL ou la façon dont les documents sont stockés dans la base de données.
Autonomous Database permet de stocker et d'interroger les documents JSON de façon native. Les collections de documents SODA s'appuient sur des vues et des tables de base de données ordinaires. Vous pouvez tirer parti des fonctionnalités de base de données à utiliser avec le contenu des documents SODA.
Les pilotes SODA sont disponibles pour plusieurs langages et structures, y compris Java, Node.js, Python, C (avec Oracle Call Interface), PL/SQL et SODA pour REST. SODA pour REST met en correspondance les opérations SODA avec des modèles d'URL (Uniform Resource Locator) afin de pouvoir les utiliser avec la plupart des langages de programmation.
Pour commencer à utiliser SODA, reportez-vous aux sections suivantes :
Selon l'API SODA que vous voulez utiliser, reportez-vous aux sections suivantes :
Si vous utilisez Autonomous Database Toujours gratuit avec Oracle Database 23ai, Oracle recommande d'effectuer les opérations suivantes pour éviter les problèmes de compatibilité des pilotes SODA :
-
Utilisez les versions de pilote nécessaires pour utiliser le type
JSONcomme indiqué dans Pilotes SODA. Pour plus d'informations, reportez-vous à Pducteurs SODA. -
Pour les projets démarrés à l'aide d'une version de base de données antérieure à Oracle Database 21c, indiquez explicitement les métadonnées de la collection par défaut comme indiqué dans l'exemple de pilotes SODA. Pour les projets démarrés à l'aide d'Oracle Database 21c ou version ultérieure, il suffit d'utiliser les métadonnées par défaut. Pour plus d'informations, reportez-vous à Pilotes SODA.
| SODA API | Téléchargement et installation | Plus d'informations |
|---|---|---|
|
SODA pour Java |
Téléchargement de SODA pour Java Versions : avec SODA pour Java, l'utilisation de la dernière version est recommandée. La version minimale prise en charge est 1.1.4. Utilisez SODA pour Java en conjonction avec Autonomous Database ne prend pas en charge Metadata Builder. Pour personnaliser les métadonnées de collection, transmettez les chaînes de métadonnées de collection directement à la méthode createCollection. Pour plus d'informations, reportez-vous à Métadonnées de collection SODA sur Autonomous Database. |
|
|
SODA pour REST |
||
|
SODA pour C |
Téléchargements Oracle Instant Client Versions : avec SODA pour C, les bibliothèques client Oracle doivent être de version 19.6 ou supérieure. Vous pouvez obtenir Oracle Instant Client à partir de la page Téléchargements Oracle Instant Client. |
|
|
SODA pour PL/SQL |
Aucun téléchargement nécessaire. Inclus avec Autonomous Database. |
|
|
SODA pour Node.js |
Plusieurs téléchargements décrits dans les instructions d'installation : Démarrage rapide - Installation de node-oracledb Versions : la prise en charge de SODA a été introduite dans la version 3.0. L'utilisation de la dernière version est recommandée. La version minimale recommandée est 4.0. Les bibliothèques client Oracle doivent être de version 19.6 ou supérieure. Vous pouvez obtenir Oracle Instant Client à partir de la page Téléchargements Oracle Instant Client. |
|
|
SODA pour Python |
Plusieurs téléchargements décrits dans les instructions d'installation : Versions : la prise en charge de SODA a été introduite dans la version 7.0. L'utilisation de la dernière version est recommandée. La version minimale recommandée est 7.1. Les bibliothèques client Oracle doivent être de version 19.6 ou supérieure. Vous pouvez obtenir Oracle Instant Client à partir de la page Téléchargements Oracle Instant Client. |
- Remarques SODA
Lorsque vous utilisez SODA avec Autonomous Database, les restrictions suivantes s'appliquent :
Rubrique parent : Utilisation de documents JSON avec Autonomous Database
Remarques relatives à SODA
Les restrictions suivantes s'appliquent lorsque vous utilisez SODA avec Autonomous Database :
-
L'indexation automatique n'est pas prise en charge pour le code SQL et PL/SQL qui utilise la fonction SQL/JSON
json_exists. Pour plus d'informations, reportez-vous à Condition SQL/JSON JSON_EXISTS. -
L'indexation automatique n'est pas prise en charge pour les requêtes par l'exemple SODA.