1
0
mirror of https://github.com/postgres/postgres.git synced 2025-07-27 12:41:57 +03:00

Implement various jsonpath methods

This commit implements ithe jsonpath .bigint(), .boolean(),
.date(), .decimal([precision [, scale]]), .integer(), .number(),
.string(), .time(), .time_tz(), .timestamp(), and .timestamp_tz()
methods.

.bigint() converts the given JSON string or a numeric value to
the bigint type representation.

.boolean() converts the given JSON string, numeric, or boolean
value to the boolean type representation.  In the numeric case, only
integers are allowed. We use the parse_bool() backend function
to convert a string to a bool.

.decimal([precision [, scale]]) converts the given JSON string
or a numeric value to the numeric type representation.  If precision
and scale are provided for .decimal(), then it is converted to the
equivalent numeric typmod and applied to the numeric number.

.integer() and .number() convert the given JSON string or a
numeric value to the int4 and numeric type representation.

.string() uses the datatype's output function to convert numeric
and various date/time types to the string representation.

The JSON string representing a valid date/time is converted to the
specific date or time type representation using jsonpath .date(),
.time(), .time_tz(), .timestamp(), .timestamp_tz() methods.  The
changes use the infrastructure of the .datetime() method and perform
the datatype conversion as appropriate.  Unlike the .datetime()
method, none of these methods accept a format template and use ISO
DateTime format instead.  However, except for .date(), the
date/time related methods take an optional precision to adjust the
fractional seconds.

Jeevan Chalke, reviewed by Peter Eisentraut and Andrew Dunstan.
This commit is contained in:
Andrew Dunstan
2024-01-25 10:15:43 -05:00
parent 924d046dcf
commit 66ea94e8e6
11 changed files with 3569 additions and 30 deletions

View File

@ -17726,6 +17726,38 @@ strict $.**.HR
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>boolean()</literal>
<returnvalue><replaceable>boolean</replaceable></returnvalue>
</para>
<para>
Boolean value converted from a JSON boolean, number, or string
</para>
<para>
<literal>jsonb_path_query_array('[1, "yes", false]', '$[*].boolean()')</literal>
<returnvalue>[true, true, false]</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>string()</literal>
<returnvalue><replaceable>string</replaceable></returnvalue>
</para>
<para>
String value converted from a JSON boolean, number, string, or datetime
</para>
<para>
<literal>jsonb_path_query_array('[1.23, "xyz", false]', '$[*].string()')</literal>
<returnvalue>["1.23", "xyz", "false"]</returnvalue>
</para>
<para>
<literal>jsonb_path_query('"2023-08-15"', '$.datetime().string()')</literal>
<returnvalue>"2023-08-15"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>double()</literal>
@ -17783,6 +17815,62 @@ strict $.**.HR
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>bigint()</literal>
<returnvalue><replaceable>bigint</replaceable></returnvalue>
</para>
<para>
Big integer value converted from a JSON number or string
</para>
<para>
<literal>jsonb_path_query('{"len": "9876543219"}', '$.len.bigint()')</literal>
<returnvalue>9876543219</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>decimal( [ <replaceable>precision</replaceable> [ , <replaceable>scale</replaceable> ] ] )</literal>
<returnvalue><replaceable>decimal</replaceable></returnvalue>
</para>
<para>
Rounded decimal value converted from a JSON number or string. <literal>precision</literal> and <literal>scale</literal> must be integer values.
</para>
<para>
<literal>jsonb_path_query('1234.5678', '$.decimal(6, 2)')</literal>
<returnvalue>1234.57</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>integer()</literal>
<returnvalue><replaceable>integer</replaceable></returnvalue>
</para>
<para>
Integer value converted from a JSON number or string
</para>
<para>
<literal>jsonb_path_query('{"len": "12345"}', '$.len.integer()')</literal>
<returnvalue>12345</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>value</replaceable> <literal>.</literal> <literal>number()</literal>
<returnvalue><replaceable>numeric</replaceable></returnvalue>
</para>
<para>
Numeric value converted from a JSON number or string
</para>
<para>
<literal>jsonb_path_query('{"len": "123.45"}', '$.len.number()')</literal>
<returnvalue>123.45</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>datetime()</literal>
@ -17814,6 +17902,136 @@ strict $.**.HR
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>date()</literal>
<returnvalue><replaceable>date</replaceable></returnvalue>
</para>
<para>
Date value converted from a string
</para>
<para>
<literal>jsonb_path_query('"2023-08-15"', '$.date()')</literal>
<returnvalue>"2023-08-15"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>time()</literal>
<returnvalue><replaceable>time without time zone</replaceable></returnvalue>
</para>
<para>
Time without time zone value converted from a string
</para>
<para>
<literal>jsonb_path_query('"12:34:56"', '$.time()')</literal>
<returnvalue>"12:34:56"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>time(<replaceable>precision</replaceable>)</literal>
<returnvalue><replaceable>time without time zone</replaceable></returnvalue>
</para>
<para>
Time without time zone value converted from a string, with fractional
seconds adjusted to the given precision.
</para>
<para>
<literal>jsonb_path_query('"12:34:56.789"', '$.time(2)')</literal>
<returnvalue>"12:34:56.79"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>time_tz()</literal>
<returnvalue><replaceable>time with time zone</replaceable></returnvalue>
</para>
<para>
Time with time zone value converted from a string
</para>
<para>
<literal>jsonb_path_query('"12:34:56 +05:30"', '$.time_tz()')</literal>
<returnvalue>"12:34:56+05:30"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>time_tz(<replaceable>precision</replaceable>)</literal>
<returnvalue><replaceable>time with time zone</replaceable></returnvalue>
</para>
<para>
Time with time zone value converted from a string, with fractional
seconds adjusted to the given precision.
</para>
<para>
<literal>jsonb_path_query('"12:34:56.789 +05:30"', '$.time_tz(2)')</literal>
<returnvalue>"12:34:56.79+05:30"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>timestamp()</literal>
<returnvalue><replaceable>timestamp without time zone</replaceable></returnvalue>
</para>
<para>
Timestamp without time zone value converted from a string
</para>
<para>
<literal>jsonb_path_query('"2023-08-15 12:34:56"', '$.timestamp()')</literal>
<returnvalue>"2023-08-15T12:34:56"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>timestamp(<replaceable>precision</replaceable>)</literal>
<returnvalue><replaceable>timestamp without time zone</replaceable></returnvalue>
</para>
<para>
Timestamp without time zone value converted from a string, with
fractional seconds adjusted to the given precision.
</para>
<para>
<literal>jsonb_path_query('"2023-08-15 12:34:56.789"', '$.timestamp(2)')</literal>
<returnvalue>"2023-08-15T12:34:56.79"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>timestamp_tz()</literal>
<returnvalue><replaceable>timestamp with time zone</replaceable></returnvalue>
</para>
<para>
Timestamp with time zone value converted from a string
</para>
<para>
<literal>jsonb_path_query('"2023-08-15 12:34:56 +05:30"', '$.timestamp_tz()')</literal>
<returnvalue>"2023-08-15T12:34:56+05:30"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>string</replaceable> <literal>.</literal> <literal>timestamp_tz(<replaceable>precision</replaceable>)</literal>
<returnvalue><replaceable>timestamp with time zone</replaceable></returnvalue>
</para>
<para>
Timestamp with time zone value converted from a string, with fractional
seconds adjusted to the given precision.
</para>
<para>
<literal>jsonb_path_query('"2023-08-15 12:34:56.789 +05:30"', '$.timestamp_tz(2)')</literal>
<returnvalue>"2023-08-15T12:34:56.79+05:30"</returnvalue>
</para></entry>
</row>
<row>
<entry role="func_table_entry"><para role="func_signature">
<replaceable>object</replaceable> <literal>.</literal> <literal>keyvalue()</literal>