temporal_analyze.h

Go to the documentation of this file.

/*****************************************************************************
 *
 * This MobilityDB code is provided under The PostgreSQL License.
 *
 * Copyright (c) 2016-2021, Université libre de Bruxelles and MobilityDB
 * contributors
 *
 * MobilityDB includes portions of PostGIS version 3 source code released
 * under the GNU General Public License (GPLv2 or later).
 * Copyright (c) 2001-2021, PostGIS contributors
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation for any purpose, without fee, and without a written
 * agreement is hereby granted, provided that the above copyright notice and
 * this paragraph and the following two paragraphs appear in all copies.
 *
 * IN NO EVENT SHALL UNIVERSITE LIBRE DE BRUXELLES BE LIABLE TO ANY PARTY FOR
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
 * LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION,
 * EVEN IF UNIVERSITE LIBRE DE BRUXELLES HAS BEEN ADVISED OF THE POSSIBILITY
 * OF SUCH DAMAGE.
 *
 * UNIVERSITE LIBRE DE BRUXELLES SPECIFICALLY DISCLAIMS ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON
 * AN "AS IS" BASIS, AND UNIVERSITE LIBRE DE BRUXELLES HAS NO OBLIGATIONS TO
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 
 *
 *****************************************************************************/

#ifndef __TEMPORAL_ANALYZE_H__
#define __TEMPORAL_ANALYZE_H__

#include <postgres.h>
#include <catalog/pg_type.h>
#include <commands/vacuum.h>
#include <utils/rangetypes.h>
#include <parser/parse_oper.h>
#include <statistics/extended_stats_internal.h>

/*
 * Extra data for compute_stats function
 * Structure based on the ArrayAnalyzeExtraData from file array_typanalyze.c
 */
typedef struct
{
  /* Information about array element type */
  Oid type_id;         
  Oid eq_opr;          
  Oid lt_opr;          
  bool typbyval;       
  int16 typlen;
  char typalign;

  /* Information about the value part of array element */
  Oid value_type_id;   
  Oid value_eq_opr;    
  Oid value_lt_opr;    
  bool value_typbyval; 
  int16 value_typlen;
  char value_typalign;

  /* Information about the temporal part of array element */
  Oid time_type_id;    
  Oid time_eq_opr;     
  Oid time_lt_opr;     
  bool time_typbyval;  
  int16 time_typlen;
  char time_typalign;

  /*
   * Lookup data for element type's comparison and hash functions (these are
   * in the type's typcache entry, which we expect to remain valid over the
   * lifespan of the ANALYZE run)
   */
  FmgrInfo *cmp;
  FmgrInfo *hash;
  FmgrInfo *value_cmp;
  FmgrInfo *value_hash;
  FmgrInfo *time_cmp;
  FmgrInfo *time_hash;

  /* Saved state from std_typanalyze() */
  AnalyzeAttrComputeStatsFunc std_compute_stats;
  void *std_extra_data;
} TemporalAnalyzeExtraData;

/*
 * Extra information used by the default analysis routines
 */
typedef struct
{
  int count;    
  int first;    
} ScalarMCVItem;

typedef struct
{
  SortSupport ssup;
  int *tupnoLink;
} CompareScalarsContext;

/*****************************************************************************
 * Statistics information for temporal types
 *****************************************************************************/

extern void temporal_extra_info(VacAttrStats *stats);

extern void tinstant_compute_stats(VacAttrStats *stats, AnalyzeAttrFetchFunc fetchfunc,
  int samplerows, double totalrows);

extern void tsequenceset_compute_stats(VacAttrStats *stats, AnalyzeAttrFetchFunc fetchfunc,
  int samplerows, double totalrows);

/*****************************************************************************/

extern Datum temporal_analyze(PG_FUNCTION_ARGS);
extern Datum tnumber_analyze(PG_FUNCTION_ARGS);

extern Datum generic_analyze(FunctionCallInfo fcinfo,
  void (*functemp)(VacAttrStats *, AnalyzeAttrFetchFunc, int, double));

/*****************************************************************************/

#endif