mirror of
https://github.com/postgres/postgres.git
synced 2025-11-19 13:42:17 +03:00
e76defbcf0
The existing format of pg_dependencies uses a single-object JSON
structure, with each key value embedding all the knowledge about the
set attributes tracked, like:
{"1 => 5": 1.000000, "5 => 1": 0.423130}
While this is a very compact format, it is confusing to read and it is
difficult to manipulate the values within the object, particularly when
tracking multiple attributes.
The new output format introduced in this commit is a JSON array of
objects, with:
- A key named "degree", with a float value.
- A key named "attributes", with an array of attribute numbers.
- A key named "dependency", with an attribute number.
The values use the same underlying type as previously when printed, with
a new output format that shows now as follows:
[{"degree": 1.000000, "attributes": [1], "dependency": 5},
{"degree": 0.423130, "attributes": [5], "dependency": 1}]
This new format will become handy for a follow-up set of changes, so as
it becomes possible to inject extended statistics rather than require an
ANALYZE, like in a dump/restore sequence or after pg_upgrade on a new
cluster.
This format has been suggested by Tomas Vondra. The key names are
defined in the header introduced by 1f927cce44, to ease the
integration of frontend-specific changes that are still under
discussion. (Again a personal note: if anybody comes up with better
name for the keys, of course feel free.)
The bulk of the changes come from the regression tests, where
jsonb_pretty() is now used to make the outputs generated easier to
parse.
Author: Corey Huinker <corey.huinker@gmail.com>
Reviewed-by: Jian He <jian.universality@gmail.com>
Reviewed-by: Michael Paquier <michael@paquier.xyz>
Discussion: https://postgr.es/m/CADkLM=dpz3KFnqP-dgJ-zvRvtjsa8UZv8wDAQdqho=qN3kX0Zg@mail.gmail.com
106 lines
2.8 KiB
C
106 lines
2.8 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* pg_dependencies.c
|
|
* pg_dependencies data type support.
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* IDENTIFICATION
|
|
* src/backend/utils/adt/pg_dependencies.c
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
|
|
#include "postgres.h"
|
|
|
|
#include "lib/stringinfo.h"
|
|
#include "statistics/extended_stats_internal.h"
|
|
#include "statistics/statistics_format.h"
|
|
#include "utils/fmgrprotos.h"
|
|
|
|
/*
|
|
* pg_dependencies_in - input routine for type pg_dependencies.
|
|
*
|
|
* pg_dependencies is real enough to be a table column, but it has no operations
|
|
* of its own, and disallows input too
|
|
*/
|
|
Datum
|
|
pg_dependencies_in(PG_FUNCTION_ARGS)
|
|
{
|
|
/*
|
|
* pg_node_list stores the data in binary form and parsing text input is
|
|
* not needed, so disallow this.
|
|
*/
|
|
ereport(ERROR,
|
|
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
|
|
errmsg("cannot accept a value of type %s", "pg_dependencies")));
|
|
|
|
PG_RETURN_VOID(); /* keep compiler quiet */
|
|
}
|
|
|
|
/*
|
|
* pg_dependencies_out - output routine for type pg_dependencies.
|
|
*/
|
|
Datum
|
|
pg_dependencies_out(PG_FUNCTION_ARGS)
|
|
{
|
|
bytea *data = PG_GETARG_BYTEA_PP(0);
|
|
MVDependencies *dependencies = statext_dependencies_deserialize(data);
|
|
StringInfoData str;
|
|
|
|
initStringInfo(&str);
|
|
appendStringInfoChar(&str, '[');
|
|
|
|
for (int i = 0; i < dependencies->ndeps; i++)
|
|
{
|
|
MVDependency *dependency = dependencies->deps[i];
|
|
|
|
if (i > 0)
|
|
appendStringInfoString(&str, ", ");
|
|
|
|
if (dependency->nattributes <= 1)
|
|
elog(ERROR, "invalid zero-length nattributes array in MVDependencies");
|
|
|
|
appendStringInfo(&str, "{\"" PG_DEPENDENCIES_KEY_ATTRIBUTES "\": [%d",
|
|
dependency->attributes[0]);
|
|
|
|
for (int j = 1; j < dependency->nattributes - 1; j++)
|
|
appendStringInfo(&str, ", %d", dependency->attributes[j]);
|
|
|
|
appendStringInfo(&str, "], \"" PG_DEPENDENCIES_KEY_DEPENDENCY "\": %d, "
|
|
"\"" PG_DEPENDENCIES_KEY_DEGREE "\": %f}",
|
|
dependency->attributes[dependency->nattributes - 1],
|
|
dependency->degree);
|
|
}
|
|
|
|
appendStringInfoChar(&str, ']');
|
|
|
|
PG_RETURN_CSTRING(str.data);
|
|
}
|
|
|
|
/*
|
|
* pg_dependencies_recv - binary input routine for type pg_dependencies.
|
|
*/
|
|
Datum
|
|
pg_dependencies_recv(PG_FUNCTION_ARGS)
|
|
{
|
|
ereport(ERROR,
|
|
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
|
|
errmsg("cannot accept a value of type %s", "pg_dependencies")));
|
|
|
|
PG_RETURN_VOID(); /* keep compiler quiet */
|
|
}
|
|
|
|
/*
|
|
* pg_dependencies_send - binary output routine for type pg_dependencies.
|
|
*
|
|
* Functional dependencies are serialized in a bytea value (although the type
|
|
* is named differently), so let's just send that.
|
|
*/
|
|
Datum
|
|
pg_dependencies_send(PG_FUNCTION_ARGS)
|
|
{
|
|
return byteasend(fcinfo);
|
|
}
|