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 prend en charge le stockage et l'interrogation de documents JSON de manière native. Les collections de documents SODA sont soutenues par des tables et des vues de base de données ordinaires. Vous pouvez tirer parti des fonctionnalités de base de données pour les utiliser avec le contenu des documents SODA.
Les pilotes SODA sont disponibles pour plusieurs langages et structures, notamment Java, Node.js, Python, C (à l'aide d'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 qu'elles puissent être utilisées avec la plupart des langages de programmation.
Pour commencer à utiliser SODA, reportez-vous aux sections suivantes :
Selon l'API SODA avec laquelle vous voulez travailler, reportez-vous aux sections suivantes :
Si vous utilisez Always Free Autonomous Database avec Oracle Database 23ai, pour éviter les problèmes de compatibilité des pilotes SODA, Oracle recommande les éléments suivants :
-
Utilisez les versions de pilote nécessaires pour utiliser le type
JSONcomme indiqué dans les pilotes SODA. Pour plus d'informations, reportez-vous à Pilotes SODA. -
Pour les projets qui ont été 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 dans les pilotes SODA. Pour les projets qui commencent à utiliser la version Oracle Database 21c ou une version ultérieure, utilisez simplement les métadonnées par défaut. Pour plus d'informations, reportez-vous à Pilotes SODA.
| API SODA | Téléchargement et installation | Plus d'informations |
|---|---|---|
|
SODA pour Java |
Versions : 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 conjointement avec Autonomous Database ne prend pas en charge le générateur de métadonnées. 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 : Pour SODA pour C, les bibliothèques client Oracle doivent être versions 19.6 et supérieures. Vous pouvez obtenir Oracle Instant Client à partir d'Oracle Instant Client Downloads. |
|
|
SODA pour PL/SQL |
Aucun téléchargement nécessaire. Il est inclus dans Autonomous Database. |
|
|
SODA pour Node.js |
Plusieurs téléchargements décrits dans les instructions d'installation : Installation de node-oracledb de démarrage rapide 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 et supérieures. Vous pouvez obtenir Oracle Instant Client à partir d'Oracle Instant Client Downloads. |
|
|
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 et supérieures. Vous pouvez obtenir Oracle Instant Client à partir d'Oracle Instant Client Downloads. |
- Notes SODA
Lorsque vous utilisez SODA avec Autonomous Database, les restrictions suivantes s'appliquent :
Rubrique parent : Utilisation des documents JSON avec Autonomous Database
Notes SODA
Lorsque vous utilisez SODA avec Autonomous Database, les restrictions suivantes s'appliquent :
-
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.