I MariaDB, JSON_TYPE()
är en inbyggd funktion som returnerar typen av ett JSON-värde, som en sträng.
Syntax
Syntaxen ser ut så här:
JSON_TYPE(json_val)
Där json_val
är värdet för vilket typen ska returneras.
Objekttyper
De möjliga returtyperna listas i följande tabell:
Returtyp | Värde | Exempel |
---|---|---|
ARRAY | JSON-array. | [1, 2, 3] |
OBJECT | JSON-objekt. | {"a":"1"} |
BOOLEAN | JSON true/false literal. | true eller false |
DOUBLE | Ett tal med minst en decimal med flyttal. | 1.2 |
INTEGER | Ett tal utan en decimal med flyttal. | 1 |
NULL | JSON null bokstavlig. Detta returneras som en sträng och ska inte förväxlas med SQL NULL värde. | null |
STRING | JSON-sträng. | "bird" |
Exempel
Här är ett exempel att visa.
SET @json = '
{
"name" : "Fluffy",
"type" : "Cat"
}
';
SELECT JSON_TYPE(@json);
Resultat:
+------------------+ | JSON_TYPE(@json) | +------------------+ | OBJECT | +------------------+
I det här exemplet skickade jag ett helt JSON-dokument, som har en typ av OBJECT
.
Här är fler exempel:
SELECT
JSON_TYPE('[1, 2, 3]'),
JSON_TYPE('{ "a" : 1 }'),
JSON_TYPE('true'),
JSON_TYPE('false'),
JSON_TYPE(10.59),
JSON_TYPE(10),
JSON_TYPE(null),
JSON_TYPE('"Fuzzy Smith"');
Resultat (med vertikal utdata):
JSON_TYPE('[1, 2, 3]'): ARRAY JSON_TYPE('{ "a" : 1 }'): OBJECT JSON_TYPE('true'): BOOLEAN JSON_TYPE('false'): BOOLEAN JSON_TYPE(10.59): DOUBLE JSON_TYPE(10): INTEGER JSON_TYPE(null): NULL JSON_TYPE('"Fuzzy Smith"'): STRING
Extrahera värdet från ett JSON-dokument
I de tidigare exemplen skickade jag varje värde direkt till funktionen som en bokstavlig.
Vi kan kombinera JSON_TYPE()
med andra funktioner, såsom JSON_EXTRACT()
för att ta reda på typen av ett värde i ett större JSON-dokument. Här är ett exempel på att extrahera ett värde från ett JSON-dokument för att ta reda på dess typ:
SET @json = '
{
"name" : "Wag",
"scores" : [8, 0, 9]
}
';
SELECT
JSON_TYPE(JSON_EXTRACT(@json, '$.name')) AS Result;
Resultat:
+--------+ | Result | +--------+ | STRING | +--------+
Här är ett annat exempel som returnerar fler typer:
SET @json = '
{
"name" : "Wag",
"scores" : [8, 0, 9],
"weight" : 10.50,
"height" : null,
"age" : 4
}
';
SELECT
JSON_TYPE(
JSON_EXTRACT(@json, '$.name')
) AS a,
JSON_TYPE(
JSON_EXTRACT(@json, '$.scores')
) AS b,
JSON_TYPE(
JSON_EXTRACT(@json, '$.scores[0]')
) AS c,
JSON_TYPE(
JSON_EXTRACT(@json, '$.weight')
) AS d,
JSON_TYPE(
JSON_EXTRACT(@json, '$.height')
) AS e,
JSON_TYPE(
JSON_EXTRACT(@json, '$.age')
) AS f;
Resultat:
+--------+-------+---------+--------+------+---------+ | a | b | c | d | e | f | +--------+-------+---------+--------+------+---------+ | STRING | ARRAY | INTEGER | DOUBLE | NULL | INTEGER | +--------+-------+---------+--------+------+---------+
Nollargument
Om argumentet är null
, sedan null
returneras.
SELECT JSON_TYPE(null);
Resultat:
+-----------------+ | JSON_TYPE(null) | +-----------------+ | NULL | +-----------------+
Felaktig parameterräkning
Anropar JSON_TYPE()
utan argument resulterar i ett fel:
SELECT JSON_TYPE();
Resultat:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_TYPE'
Det är samma sak när för många argument skickas:
SELECT JSON_TYPE(1, 2);
Resultat:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'JSON_TYPE'