Cette page explique comment utiliser le type de données JSONB
avec Spanner.
JSONB
est un type de données PostgreSQL utilisé pour conserver les données semi-structurées dans le dialecte PostgreSQL de Spanner. JSONB
contient les données au format JSON (JavaScript Object Notation), qui suit la spécification décrite dans le document RFC 7159.
Spécifications
Le type de données JSONB
de Spanner stocke une représentation normalisée du document d'entrée. Cela implique ce qui suit:
- Les guillemets et les espaces blancs ne sont pas conservés.
- Les commentaires ne sont pas acceptés. Les transactions ou les requêtes avec commentaires échouent.
- Les clés d'objet sont d'abord triées par longueur de clé, puis lexicographiquement selon la longueur de clé d'objet équivalente. S'il existe des clés d'objet en double, seule la dernière est conservée.
- Le type et la valeur des types primitifs (
string
,boolean
,number
etnull
) sont conservés.- Les valeurs de type
string
sont conservées exactement. - Les zéros de fin sont conservés. Le format de sortie des valeurs de type
number
n'utilise pas la notation scientifique.
- Les valeurs de type
Les valeurs
JSONB
null
sont traitées comme des valeurs SQL nonNULL
. Exemple:SELECT null::jsonb IS NULL; -- Returns true SELECT 'null'::jsonb IS NULL; -- Returns false SELECT '{"a":null}'::jsonb -> 'a' IS NULL; -- Returns false SELECT '{"a":null}'::jsonb -> 'b' IS NULL; -- Returns true SELECT '{"a":null}'::jsonb -> 'a'; -- Returns a JSONB 'null' SELECT '{"a":null}'::jsonb -> 'b'; -- Returns a SQL NULL
L'ordre des éléments de tableau JSONB est conservé.
Restrictions
Les restrictions suivantes s'appliquent à Spanner JSONB
:
- Les arguments de la fonction
to_jsonb
ne peuvent provenir que des types de données PostgreSQL compatibles avec Spanner. - Les valeurs des types de nombres peuvent comporter 4 932 chiffres avant la virgule et 16 383 chiffres après la virgule.
- La taille maximale autorisée pour le format de stockage normalisé est de 10 Mo.
- Les documents
JSONB
doivent être encodés au format UTF-8. Les transactions ou les requêtes avec des documentsJSONB
encodés dans d'autres formats renvoient une erreur.
Créer une table avec des colonnes JSONB
Vous pouvez ajouter une colonne JSONB
à une table lorsque vous la créez.
CREATE TABLE Venues (
VenueId BIGINT PRIMARY KEY,
VenueName VARCHAR(1024),
VenueAddress VARCHAR(1024),
VenueFeatures JSONB,
DateOpened TIMESTAMPTZ
);
Voici un exemple d'objet JSONB
VenueFeatures
:
{
"rating": 4.5,
"capacity":"1500",
"construction":"brick",
"tags": [
"multi-cuisine",
"open-seating",
"stage",
"public address system"
]
}
Ajouter et supprimer des colonnes JSONB dans des tables existantes
Vous pouvez ajouter une colonne JSONB
et la supprimer à l'aide d'instructions ALTER
comme suit:
ALTER TABLE Venues ADD COLUMN VenueDetails JSONB;
ALTER TABLE Venues DROP COLUMN VenueDetails;
L'exemple suivant montre comment ajouter une colonne JSONB
appelée VenueDetails
à la table Venues
à l'aide des bibliothèques clientes Spanner.
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
Modifier les données JSONB
Vous pouvez modifier une colonne JSONB
comme n'importe quelle autre colonne.
Voici un exemple:
UPDATE Venues SET VenueFeatures = '{"rating": 4.5, "tags":["multi-cuisine", "open-seating"] }'
WHERE VenueId = 1;
L'exemple suivant montre comment mettre à jour des données JSONB
à l'aide des bibliothèques clientes Spanner.
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Interroger les données JSONB
Vous pouvez interroger des colonnes JSONB
en fonction des valeurs des champs sous-jacents. L'exemple suivant extrait VenueId
et VenueName
de Venues
, où VenueFeatures
a une valeur rating
supérieure à 3.5
.
SELECT VenueId, VenueName FROM Venues WHERE (VenueFeatures->>'rating')::FLOAT8 > 3.5;
L'exemple suivant montre comment interroger des données JSONB
à l'aide des bibliothèques clientes Spanner.
C++
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.
Pour vous authentifier auprès de Spanner, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Fonctionnalités PostgreSQL JSONB non compatibles
Les fonctionnalités PostgreSQL JSONB
suivantes ne sont pas compatibles avec Spanner JSONB
:
- Classement, comparaison et agrégation
- PrimaryKey et ForeignKey
- Indexation, y compris l'indice GIN Pour en savoir plus, consultez la section Indexation.
- Changer le type de données d'une colonne
JSONB
- Utilisation de requêtes paramétrées avec des paramètres JSONB non typés dans les outils qui utilisent le protocole filaire PostgreSQL
Coercition dans le moteur de requêtes Contrairement à la version standard de PostgreSQL, la coercition de
JSONB
en texte n'est pas prise en charge. Seules les chaînesJSON
valides sont forcées en typeJSONB
pour correspondre aux signatures de fonction. Exemples :SELECT concat('abc'::text, '{"key1":1}'::jsonb); -- Returns error SELECT concat('abc'::text, CAST('{"key1":1}'::jsonb AS TEXT)); -- This works
Indexer des images
Les colonnes JSONB
ne sont pas compatibles avec l'indexation. Toutefois, vous pouvez créer un index sur une colonne générée pour extraire une valeur scalaire d'une colonne JSONB
.
CREATE TABLE Venues (
VenueId BIGINT PRIMARY KEY,
VenueName VARCHAR(1024),
VenueAddress VARCHAR(1024),
VenueFeatures JSONB,
TotalCapacity BIGINT GENERATED ALWAYS AS ((VenueFeatures->>'capacity')::BIGINT) STORED,
DateOpened TIMESTAMPTZ
);
CREATE INDEX VenuesByCapacity ON Venues(TotalCapacity);