Utiliser des documents JSON avec le service de base de données autonome sur une infrastructure Exadata dédiée

Autonomous Database sur une infrastructure Exadata dédiée prend en charge les données JavaScript Object Notation (JSON) de manière native avec des fonctions de base de données relationnelle, notamment les transactions, l'indexation, l'interrogation déclarative et les vues. Dans les bases de données autonomes, les documents JSON peuvent coexister avec les données relationnelles.

Contrairement aux données relationnelles, les données JSON peuvent être stockées dans la base de données, indexées et interrogées sans qu'un schéma définissant les données soit requis. En général, vous effectuez les tâches suivantes lors de l'utilisation de données JSON dans une base de données autonome :
  1. Créer une colonne JSON avec une contrainte de vérification is json format oson
  2. Insérer les données JSON dans la colonne, et
  3. Interroger les données JSON
Voir Utiliser des documents JSON dans Autonomous Database dans Oracle Database 19c JSON Developer's Guide ou Oracle Database 23ai JSON Developer's Guide pour des instructions détaillées avec des exemples de code.

Note :

Si vous utilisez SODA pour accéder aux collections dans Oracle Database 19c, Oracle vous recommande d'utiliser Instant Client pour Oracle Database 21c ou version ultérieure, afin de faciliter la migration vers l'utilisation du type de données JSON lors de la mise à niveau de votre base de données vers la version 21 ou supérieure.

API SQL et PL/SQL

Lorsque vous utilisez une base de données Autonomous Database pour stocker des données JSON, vous pouvez tirer parti de toutes les fonctions disponibles dans votre base de données Autonomous Database. Vous pouvez combiner vos données JSON avec des données non JSON. Vous pouvez accéder aux données JSON stockées dans la base de données de la même manière qu'aux autres données, y compris en utilisant l'interface d'appel Oracle, Microsoft .NET Framework et Java Database Connectivity (JDBC). Voir JSON dans Oracle Database 19c ou Oracle Database 23ai pour apprendre à utiliser les API SQL et PL/SQL pour travailler avec des documents JSON.

API Oracle pour la prise en charge de MongoDB

L'API Oracle Database pour MongoDB traduit le protocole de connexion MongoDB en énoncés SQL exécutés par Oracle Database. Il permet aux développeurs disposant de jeux de compétences MongoDB d'écrire des applications de magasin de documents JSON pour Oracle Database qui utilisent des pilotes et des outils qui comprennent le protocole MongoDB. Pour un aperçu détaillé de cette API, voir Aperçu de l'API Oracle Database pour MongoDB dans l'API Oracle Database pour MongoDB.

Voir Utiliser l'API MongoDB avec Oracle Autonomous Database pour obtenir des instructions sur l'activation et l'utilisation de l'API MongoDB avec Autonomous Database.

Simple Oracle Document Access (SODA)

Oracle fournit également une famille d'API Simple Oracle Document Access (SODA) pour l'accès aux données JSON stockées dans la base de données. SODA est conçu pour le développement d'applications sans schéma, sans connaissance préalable des fonctionnalités des bases de données relationnelles ou des langages tels que SQL et PL/SQL. Il vous permet de créer et de stocker des collections de documents dans Oracle Database, de les extraire et de les interroger, même si vous ne savez pas comment les documents sont stockés dans la base de données. Pour plus d'informations sur SODA, voir Oracle en tant que magasin de documents et Aperçu de SODA.

Il existe plusieurs mises en oeuvre de l'architecture SODA :
  • SODA pour REST : Les demandes REST exécutent des opérations sur les collections et les documents, à l'aide de tout langage capable d'effectuer des appels HTTP.
  • SODA pour Java : Les classes et interfaces Java représentent des bases de données, des collections et des documents.
  • SODA pour PL/SQL : Les types d'objet PL/SQL représentent des collections et des documents.
  • SODA pour C : Les descripteurs Oracle Call Interface (OCI) représentent des collections et des documents.
  • SODA pour Node.js : Les API SODA de type NoSQL sont utilisées pour insérer, interroger et extraire des documents SODA. Les objets SodaDatabase, SodaCollection, SodaDocument, SodaDocumentCursor et SodaOperation représentent les bases de données, les collections, les documents, le curseur de document et les opérations de lecture-écriture, respectivement.
  • SODA pour Python : Les méthodes cx_Oracle de type NoSQL sont utilisées pour insérer, interroger et extraire des documents SODA. Les objets SodaDatabase, SodaCollection, SodaDocument, SodaDocumentCursor et SodaOperation représentent les bases de données, les collections, les documents, le curseur de document et les opérations de lecture-écriture, respectivement.
Vous pouvez télécharger les pilotes SODA à partir de la page Détails d'une base de données Autonomous Database.
  • Allez à la page Détails de Autonomous Database. Voir Voir les détails d'une base de données autonome dédiée.
  • Ouvrez l'onglet Outils.
  • Localisez la vignette Pilotes SODA et cliquez sur Télécharger les pilotes SODA.
  • Téléchargez les pilotes SODA de votre choix à partir de la liste affichée.

Métadonnées de collection SODA

Une collection SODA est un jeu de documents étayé par une table ou une vue de base de données autonome. Par défaut, la création d'une collection de documents SODA crée les éléments suivants dans Oracle Database :
  • Métadonnées de collection par défaut persistante.
  • Table permettant de stocker la collection dans le schéma de base de données auquel votre client SODA est connecté.
Vous pouvez adapter les métadonnées de la collection pour définir un comportement différent de celui par défaut. Les seules métadonnées que vous pouvez personnaliser dans une base de données autonome sont la méthode de génération des clés de document et le type de média du contenu. En particulier, vous ne pouvez pas modifier le type de données SQL de la colonne utilisée pour stocker du contenu JSON (la colonne de contenu). Voir Métadonnées de collection SODA pour une base de données autonome pour savoir comment utiliser les métadonnées de collection par défaut et personnalisées.

Limites relatives à l'utilisation de SODA et de JSON

Autonomous Database prend en charge SODA et JSON, avec les restrictions suivantes :
  • 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 dans Oracle Database 19c ou Oracle Database 23ai.
  • L'indexation automatique n'est pas prise en charge pour l'interrogation par l'exemple (QBE) SODA.

Rubriques connexes