Objets JSON textuels représentant des valeurs scalaires étendues

Les données JSON binaires natives (au format OSON) étendent le langage JSON en ajoutant des types scalaires (comme une date) qui correspondent aux types SQL et ne font pas partie de la norme JSON. Oracle Database prend également en charge l'utilisation d'objets JSON textuels qui représentent des valeurs scalaires JSON, y compris ces valeurs non standard.

Lorsque vous créez des données JSON binaires natives à partir de données JSON textuelles contenant de tels objets étendus, vous pouvez éventuellement les remplacer par des valeurs scalaires JSON (binaires natives) correspondantes.

{"$numberDecimal":31} est un exemple d'objet étendu. Il représente une valeur scalaire JSON du type non standard nombre décimal. Lorsqu'il est interprété comme tel, il est remplacé par un nombre décimal au format binaire natif.

Par exemple, lorsque vous utilisez le constructeur de type de données JSON, JSON, si vous utilisez le mot-clé EXTENDED, les objets étendus reconnus dans l'entrée textuelle sont remplacés par les valeurs scalaires correspondantes dans le résultat JSON binaire natif. Si vous n'incluez pas le mot-clé EXTENDED, aucun remplacement de ce type ne se produit. Les objets JSON étendus textuels sont simplement convertis tels quels en objets JSON au format binaire natif.

A l'inverse, lorsque vous utilisez la fonction SQL/JSON json_serialize pour sérialiser des données JSON binaires en tant que données JSON texte (VARCHAR2, CLOB ou BLOB), vous pouvez utiliser le mot-clé EXTENDED pour remplacer les valeurs scalaires JSON (binaires natives) par les objets JSON étendus texte correspondants.

Remarque

Si la base de données que vous utilisez est une instance Oracle Autonomous Database, vous pouvez utiliser la procédure PL/SQL DBMS_CLOUD.copy_collection pour créer une collection de documents JSON à partir d'un fichier de données JSON tel que celui produit par les bases de données NoSQL communes, y compris Oracle NoSQL Database.

Si vous utilisez ejson comme valeur du paramètre type de la procédure, les objets JSON étendus reconnus dans le fichier d'entrée sont remplacés par les valeurs scalaires correspondantes dans la collection JSON binaire native générée. De l'autre côté, vous pouvez utiliser la fonction json_serialize avec le mot-clé EXTENDED pour remplacer les valeurs scalaires par des objets JSON étendus dans les données JSON texte obtenues.

Voici les deux principaux cas d'emploi des objets étendus :

Echange (import/export) :
- Incluez des données JSON existantes (à partir d'un emplacement) contenant des objets étendus.
- Sérialiser des données JSON binaires natives en tant que données JSON textuelles avec des objets étendus, pour une utilisation en dehors de la base de données.
Inspection des données JSON binaires natives : découvrez ce dont vous disposez en consultant les objets étendus correspondants.

À des fins d'échange, vous pouvez inclure des données JSON à partir d'un fichier produit par des bases de données NoSQL courantes, y compris Oracle NoSQL Database, en convertissant des objets étendus en valeurs scalaires JSON binaires natives. Dans l'autre sens, vous pouvez exporter des données JSON binaires natives en tant que données textuelles, ce qui remplace les valeurs JSON scalaires propres à Oracle par les objets JSON étendus textuels correspondants.

Conseil :

Voici un exemple d'inspection : prenons un objet tel que {"dob" : "2000-01-02T00:00:00"} comme résultat de la sérialisation des données JSON native. "2000-01-02T00:00:00" est-il le résultat de la série d'une valeur binaire native de type date ou la valeur binaire native n'est-elle qu'une chaîne ? L'utilisation de json_serialize avec le mot-clé EXTENDED vous permet de le savoir.

La mise en correspondance de champs d'objet étendus avec des types JSON scalaires est, en général, de type n à un : plusieurs types d'objet JSON étendus peuvent être mis en correspondance avec une valeur scalaire donnée. Par exemple, les objets JSON étendus {"$numberDecimal":"31"} et {"$numberLong:"31"} sont tous deux convertis en valeur 31 du type scalaire numéro en langage JSON, et la méthode d'élément type() renvoie "number" pour chacune de ces valeurs scalaires JSON.

La méthode d'élément type() indique le type de valeur cible en langage JSON (chaîne JSON). Certaines valeurs scalaires peuvent être distinguées en interne, même si elles ont le même type scalaire. Cela permet généralement à la fonction json_serialize (avec le mot-clé EXTENDED) de reconstruire l'objet JSON étendu d'origine. Ces valeurs scalaires se distinguent en interne par l'utilisation de différents types SQL pour les implémenter ou par le balisage de ces valeurs avec le type d'objet JSON étendu dont elles sont dérivées.

Lorsque json_serialize reconstruit l'objet JSON étendu original, le résultat n'est pas toujours textuellement identique à l'original, mais il est toujours sémantiquement équivalent. Par exemple, {"$numberDecimal":"31"} et {"$numberDecimal":31} sont sémantiquement équivalents, même si les valeurs de champ diffèrent par leur type (chaîne et nombre). Ils sont convertis en la même valeur interne et chacun est balisé comme étant dérivé d'un objet étendu $numberDecimal (balise identique). Mais en cas de série, le résultat pour les deux est {"$numberDecimal":31}. Oracle utilise toujours le type le plus approprié directement pour la valeur de champ, qui est dans ce cas la valeur en langage JSON 31, de type de valeur scalaire nombre.

Le tableau 3-1 présente les correspondances entre les différents types utilisés. Il met en correspondance (1) les types d'objet étendu utilisés en tant qu'entrées, (2) les types signalés par la méthode d'élément type(), (3) les types SQL utilisés en interne, (4) les types en langage JSON standard utilisés en tant que sortie par la fonction json_serialize et (5) les types d'objet étendu générés par json_serialize lorsque le mot-clé EXTENDED est indiqué.

Tableau 3. 1 Relations des types d'objet JSON étendu

^{Note de bas de page 1}Les valeurs de chaîne sont interprétées sans casse. Par exemple, "NAN" "nan" et "nAn" sont acceptés et équivalents, de même pour "INF", "inFinity" et "iNf". Les nombres infiniment grands ("Infinity" ou "Inf") et petits ("-Infinity" ou "-Inf") sont acceptés avec le mot complet ou l'abréviation.

^{Note de bas de page 2}Sur la sortie, seules les valeurs de chaîne suivantes sont utilisées : pas le mot entier Infinity ni de variantes de casse.

Voir aussi :

Norme de l'IEEE sur l'arithmétique à point flottant (IEEE 754)

Rubrique parent : Chargement de données JSON dans Autonomous Database

Type d'objet étendu (entrée)	Type de scalaire JSON Oracle (déclaré par type())	Type de valeur scalaire SQL	Type de valeur scalaire JSON standard (sortie)	Type d'objet étendu (sortie)
`$numberDouble` avec comme valeur un nombre JSON, une chaîne représentant le nombre ou l'une des chaînes suivantes : `"Infinity"`, `"-Infinity"`, `"Inf"`, `"-Inf"`, `"Nan"`^{Foot 1}	double	`BINARY_DOUBLE`	nombre	`$numberDouble` avec comme valeur un nombre JSON ou l'une des chaînes suivantes : `"Inf"`, `"-Inf"`, `"Nan"`^{Foot 2}
`$numberFloat` avec la même valeur que pour `$numberDouble`	float	`BINARY_FLOAT`	nombre	`$numberFloat` avec la même valeur que pour `$numberDouble`
`$numberDecimal` avec la même valeur que pour `$numberDouble`	nombre	`NUMBER`	nombre	`$numberDecimal` avec la même valeur que pour `$numberDouble`
`$numberInt` avec comme valeur un entier signé sur 32 bits ou une chaîne représentant le nombre	nombre	`NUMBER`	nombre	`$numberInt` avec la même valeur que pour `$numberDouble`
`$numberLong` avec comme valeur un nombre JSON ou une chaîne représentant le nombre	nombre	`NUMBER`	nombre	`$numberLong` avec la même valeur que pour `$numberDouble`
`$binary` avec comme valeur l'une des suivantes : une chaîne de 64 caractères de base Objet avec les champs `base64` et `subType`, dont les valeurs sont une chaîne de 64 caractères de base et le nombre `0` (binaire arbitraire) ou `4` (UUID), respectivement Lorsque la valeur est une chaîne de 64 caractères de base, l'objet étendu peut également avoir le champ `$subtype` avec la valeur 0 ou 4, exprimé sous la forme d'un entier d'un octet (0-255) ou d'une chaîne hexadécimale de 2 caractères. représentant un tel entier	binaire	`BLOB` ou `RAW`	chaîne Une conversion équivaut à l'utilisation de la fonction SQL `rawtohex`.	Valeurs possibles : `$binary` avec la valeur une chaîne de 64 caractères de base `$rawid` avec comme valeur une chaîne de 32 caractères hexadécimaux, si l'entrée a une valeur `subType` de `4` (UUID)
`$oid` avec comme valeur une chaîne de 24 caractères hexadécimaux	binaire	`RAW(12)`	chaîne Une conversion équivaut à l'utilisation de la fonction SQL `rawtohex`.	`$rawid` avec comme valeur une chaîne de 24 caractères hexadécimaux
`$rawhex` avec comme valeur une chaîne avec un nombre pair de caractères hexadécimaux	binaire	`RAW`	chaîne Une conversion équivaut à l'utilisation de la fonction SQL `rawtohex`.	`$binary` avec la valeur une chaîne de 64 caractères de base, complétée à droite par des caractères `=`
`$rawid` avec pour valeur une chaîne de 24 ou 32 caractères hexadécimaux	binaire	`RAW`	chaîne Une conversion équivaut à l'utilisation de la fonction SQL `rawtohex`.	`$rawid`
`$oracleDate` avec comme valeur une chaîne de date au format ISO 8601	date	`DATE`	chaîne	`$oracleDate` avec comme valeur une chaîne de date au format ISO 8601
`$oracleTimestamp` fournit une valeur sous la forme d'une chaîne d'horodatage au ISO 8601.	horodatage	`TIMESTAMP`	chaîne	`$oracleTimestamp` fournit une valeur sous la forme d'une chaîne d'horodatage au ISO 8601.
`$oracleTimestampTZ` avec pour valeur une chaîne d'horodatage au sens de la norme ISO 8601 avec décalage de fuseau horaire numérique ou avec `Z`	horodatage avec fuseau horaire	`TIMESTAMP WITH TIME ZONE`	chaîne	`$oracleTimestampTZ` avec pour valeur une chaîne d'horodatage au sens de la norme ISO 8601 avec décalage de fuseau horaire numérique ou avec `Z`
`$date` avec comme valeur l'un des éléments suivants : Un nombre entier de millisecondes depuis le 1er janvier 1990 une chaîne d'horodatage au format ISO 8601 un objet avec le champ `numberLong` et avec comme valeur un nombre entier de millisecondes depuis le 1er janvier 1990	horodatage avec fuseau horaire	`TIMESTAMP WITH TIME ZONE`	chaîne	`$oracleTimestampTZ` avec pour valeur une chaîne d'horodatage au sens de la norme ISO 8601 avec décalage de fuseau horaire numérique ou avec `Z`
`$intervalDaySecond` avec pour valeur une chaîne d'intervalle au format ISO 8601 telle qu'indiquée pour la fonction SQL `to_dsinterval`	daysecondInterval	`INTERVAL DAY TO SECOND`	chaîne	`$intervalDaySecond` avec pour valeur une chaîne d'intervalle au format ISO 8601 telle qu'indiquée pour la fonction SQL `to_dsinterval`
`$intervalYearMonth` avec pour valeur une chaîne d'intervalle au format ISO 8601 telle qu'indiquée pour la fonction SQL `to_yminterval`	yearmonthInterval	`INTERVAL YEAR TO MONTH`	chaîne	`$intervalYearMonth` avec pour valeur une chaîne d'intervalle au format ISO 8601 telle qu'indiquée pour la fonction SQL `to_yminterval`
Deux champs : Champ `$vector` avec la valeur un tableau dont les éléments sont des nombres ou les chaînes `"Nan"`, `"Inf"` et `"-Inf"` (représentant des valeurs non numériques et infinies). Champ `$vectorElementType` avec la valeur de chaîne `"float32"` ou `"float64"`. Ceux-ci correspondent respectivement aux numéros IEEE 32 bits et IEEE 64 bits.	vectoriel	`VECTOR`	tableau de nombres	Deux champs : Champ `$vector` avec la valeur un tableau dont les éléments sont des nombres ou les chaînes `"Nan"`, `"Inf"` et `"-Inf"` (représentant des valeurs non numériques et infinies). Champ `$vectorElementType` avec la valeur de chaîne `"float32"` ou `"float64"`.

Documentation Oracle Cloud Infrastructure

Objets JSON textuels représentant des valeurs scalaires étendues