Utiliser l'accès simple aux documents Oracle (SODA) dans Autonomous AI Database
SODA (Simple Oracle Document Access) est un jeu d'API de type NoSQL qui vous permet d'utiliser des collections de documents JSON dans Autonomous AI Database, de les extraire et de les interroger, sans avoir à connaître le langage SQL (Structured Query Language) ou la façon dont les documents sont stockés dans la base de données.
Autonomous AI 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 fonctions 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) et PL/SQL et SODA pour REST. SODA pour REST mappe les opérations SODA aux modèles Uniform Resource Locator (URL), de sorte qu'il peut être utilisé avec la plupart des langages de programmation.
Pour commencer avec SODA, voir :
Selon l'API SODA avec laquelle vous souhaitez travailler, voir les informations suivantes :
Si vous utilisez une base de données d'IA autonome de type Toujours gratuit avec Oracle AI Database 26ai, pour éviter les problèmes de compatibilité des pilotes SODA, Oracle recommande ce qui suit :
-
Utilisez les versions de pilote nécessaires pour utiliser le type
JSON, comme indiqué dans les pilotes SODA. Pour plus d'informations, voir 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, spécifiez explicitement les métadonnées pour la collection par défaut, comme indiqué dans l'exemple des pilotes SODA. Pour les projets démarrés à l'aide de la version Oracle Database 21c ou ultérieure, il suffit d'utiliser les métadonnées par défaut. Pour plus d'informations, voir Pilotes SODA.
| API SODA | Téléchargement et installation | Informations supplémentaires |
|---|---|---|
|
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 en conjonction avec La base de données autonome d'IA 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, voir Métadonnées de collection SODA sur la base de données d'IA autonome. |
|
|
SODA pour REST |
||
|
SODA pour C |
Téléchargements Oracle Instant Client Versions : Pour la SODA pour C, les bibliothèques du client Oracle doivent être 19.6 et supérieures. Vous pouvez obtenir Oracle Instant Client à partir des téléchargements Oracle Instant Client. |
|
|
SODA pour PL/SQL |
Pas besoin de télécharger. Cela est inclus avec Autonomous AI Database. |
|
|
SODA pour Node.js |
Plusieurs téléchargements décrits dans les instructions d'installation : Démarrage rapide de l'installation de node-oracledb Versions : La prise en charge de la 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 du client Oracle doivent être au format 19.6 et supérieur. Vous pouvez obtenir Oracle Instant Client à partir des 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 la 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 du client Oracle doivent être au format 19.6 et supérieur. Vous pouvez obtenir Oracle Instant Client à partir des téléchargements Oracle Instant Client. |
- Notes SODA
Lorsque vous utilisez SODA avec Autonomous AI Database, les restrictions suivantes s'appliquent :
Notes SODA
Lorsque vous utilisez SODA avec Autonomous AI 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, voir Condition SQL/JSON JSON_EXISTS. -
L'indexation automatique n'est pas prise en charge pour l'interrogation par l'exemple (QBE) SODA.