PostGIS  3.3.9dev-r@@SVN_REVISION@@

◆ _postgis_gserialized_sel()

Datum _postgis_gserialized_sel ( PG_FUNCTION_ARGS  )

Definition at line 2098 of file gserialized_estimate.c.

2099 {
2100  Oid table_oid = PG_GETARG_OID(0);
2101  text *att_text = PG_GETARG_TEXT_P(1);
2102  Datum geom_datum = PG_GETARG_DATUM(2);
2103  GBOX gbox; /* search box read from gserialized datum */
2104  float8 selectivity = 0;
2105  ND_STATS *nd_stats;
2106  int mode = 2; /* 2D mode by default */
2107 
2108  /* Check if we've been asked to not use 2d mode */
2109  if ( ! PG_ARGISNULL(3) )
2110  mode = text_p_get_mode(PG_GETARG_TEXT_P(3));
2111 
2112  /* Retrieve the stats object */
2113  nd_stats = pg_get_nd_stats_by_name(table_oid, att_text, mode, false);
2114 
2115  if ( ! nd_stats )
2116  elog(ERROR, "stats for \"%s.%s\" do not exist", get_rel_name(table_oid), text_to_cstring(att_text));
2117 
2118  /* Calculate the gbox */
2119  if ( ! gserialized_datum_get_gbox_p(geom_datum, &gbox) )
2120  elog(ERROR, "unable to calculate bounding box from geometry");
2121 
2122  POSTGIS_DEBUGF(3, " %s", gbox_to_string(&gbox));
2123 
2124  /* Do the estimation */
2125  selectivity = estimate_selectivity(&gbox, nd_stats, mode);
2126 
2127  pfree(nd_stats);
2128  PG_RETURN_FLOAT8(selectivity);
2129 }
char * gbox_to_string(const GBOX *gbox)
Allocate a string representation of the GBOX, based on dimensionality of flags.
Definition: gbox.c:392
static ND_STATS * pg_get_nd_stats_by_name(const Oid table_oid, const text *att_text, int mode, bool only_parent)
Pull the stats object from the PgSQL system catalogs.
static float8 estimate_selectivity(const GBOX *box, const ND_STATS *nd_stats, int mode)
This function returns an estimate of the selectivity of a search GBOX by looking at data in the ND_ST...
static int text_p_get_mode(const text *txt)
Utility function to see if the first letter of the mode argument is 'N'.
int gserialized_datum_get_gbox_p(Datum gsdatum, GBOX *gbox)
Given a GSERIALIZED datum, as quickly as possible (peaking into the top of the memory) return the gbo...
N-dimensional statistics structure.

References estimate_selectivity(), gbox_to_string(), gserialized_datum_get_gbox_p(), pg_get_nd_stats_by_name(), and text_p_get_mode().

Here is the call graph for this function: