aqo--1.2--1.3.sql

ALTER TABLE public.aqo_data ADD COLUMN oids OID [] DEFAULT NULL;

--
-- Remove data, related to previously dropped tables, from the AQO tables.
--
CREATE OR REPLACE FUNCTION public.clean_aqo_data() RETURNS void AS $$
DECLARE
    aqo_data_row aqo_data%ROWTYPE;
    aqo_queries_row aqo_queries%ROWTYPE;
    aqo_query_texts_row aqo_query_texts%ROWTYPE;
    aqo_query_stat_row aqo_query_stat%ROWTYPE;
    oid_var oid;
    fspace_hash_var int;
    delete_row boolean DEFAULT false;
BEGIN
  RAISE NOTICE 'Cleaning aqo_data records';

  FOR aqo_data_row IN (SELECT * FROM aqo_data)
  LOOP
    delete_row = false;
    SELECT aqo_data_row.fspace_hash INTO fspace_hash_var FROM aqo_data;

    IF (aqo_data_row.oids IS NOT NULL) THEN
      FOREACH oid_var IN ARRAY aqo_data_row.oids
      LOOP
        IF NOT EXISTS (SELECT relname FROM pg_class WHERE oid = oid_var) THEN
          delete_row = true;
        END IF;
      END LOOP;
    END IF;

    FOR aqo_queries_row IN (SELECT * FROM aqo_queries)
    LOOP
      IF (delete_row = true AND fspace_hash_var <> 0 AND
          fspace_hash_var = aqo_queries_row.fspace_hash AND
          aqo_queries_row.fspace_hash = aqo_queries_row.query_hash) THEN
        DELETE FROM aqo_data WHERE aqo_data = aqo_data_row;
        DELETE FROM aqo_queries WHERE aqo_queries = aqo_queries_row;

        FOR aqo_query_texts_row IN (SELECT * FROM aqo_query_texts)
        LOOP
          DELETE FROM aqo_query_texts
          WHERE aqo_query_texts_row.query_hash = fspace_hash_var AND
				aqo_query_texts = aqo_query_texts_row;
        END LOOP;

        FOR aqo_query_stat_row IN (SELECT * FROM aqo_query_stat)
        LOOP
          DELETE FROM aqo_query_stat
          WHERE aqo_query_stat_row.query_hash = fspace_hash_var AND
				aqo_query_stat = aqo_query_stat_row;
        END LOOP;
      END IF;
    END LOOP;
  END LOOP;
END;
$$ LANGUAGE plpgsql;

CREATE OR REPLACE FUNCTION array_avg(arr double precision[]) RETURNS double precision as $$
BEGIN
    RETURN (SELECT AVG(a) FROM UNNEST(arr) AS a);
END;
$$ LANGUAGE plpgsql;

CREATE OR REPLACE FUNCTION array_mse(arr double precision[]) RETURNS double precision as $$
DECLARE
    mean double precision;
BEGIN
    mean = array_avg(arr);
    RETURN (SELECT AVG(POWER(a - mean, 2)) FROM UNNEST(arr) AS a);
END;
$$ LANGUAGE plpgsql;


--
-- Show top N of 'bad' queries.
--
-- The AQO extension must be installed, but disabled.
-- Strictly speaking, these functions shows 'query classes' that includes all
-- queries of the same structure. An query example of a class can be found in the
-- aqo_query_texts table.
-- This functions can be used to gentle search of 'bad' queries. User must set:
-- aqo.mode = 'disabled'
-- aqo.force_collect_stat = 'on'
--

--
--  Top of queries with the highest value of execution time.
--
CREATE OR REPLACE FUNCTION public.top_time_queries(n int)
  RETURNS TABLE(num bigint,
                fspace_hash int,
                query_hash int,
                execution_time float,
                deviation float
               )
AS $$
BEGIN
  RAISE NOTICE 'Top % execution time queries', n;
  RETURN QUERY
    SELECT row_number() OVER(ORDER BY execution_time_without_aqo DESC) num,
           aqo_queries.fspace_hash,
           aqo_queries.query_hash,
           to_char(array_avg(execution_time_without_aqo), '9.99EEEE')::float,
           to_char(array_mse(execution_time_without_aqo), '9.99EEEE')::float
    FROM aqo_queries INNER JOIN aqo_query_stat
    ON aqo_queries.query_hash = aqo_query_stat.query_hash
    GROUP BY (execution_time_without_aqo, aqo_queries.fspace_hash, aqo_queries.query_hash)
    ORDER BY execution_time DESC LIMIT n;
END;
$$ LANGUAGE plpgsql;

--
--  Top of queries with largest value of total cardinality error.
--
CREATE OR REPLACE FUNCTION public.top_error_queries(n int)
  RETURNS TABLE(num bigint,
                fspace_hash int,
                query_hash int,
                error float,
                deviation float
               )
AS $$
BEGIN
  RAISE NOTICE 'Top % cardinality error queries', n;
  RETURN QUERY
    SELECT row_number() OVER (ORDER BY cardinality_error_without_aqo DESC) num,
           aqo_queries.fspace_hash,
           aqo_queries.query_hash,
           to_char(array_avg(cardinality_error_without_aqo), '9.99EEEE')::float,
           to_char(array_mse(cardinality_error_without_aqo), '9.99EEEE')::float
    FROM aqo_queries INNER JOIN aqo_query_stat
    ON aqo_queries.query_hash = aqo_query_stat.query_hash
    GROUP BY (cardinality_error_without_aqo, aqo_queries.fspace_hash, aqo_queries.query_hash)
    ORDER BY error DESC LIMIT n;
END;
$$ LANGUAGE plpgsql;

--
-- Classes profiling machinery.
--
-- It is supported by two GUC's:
-- aqo.profile_classes - allocates shared memory for a profiling buffer. Can be
-- changed on startup only.
-- aqo.profile_enable - enables/disables profiling machinery. Can be changed by
-- any user.
--

--
-- Get classes profiling info. Use the aqo.profile_classes and
-- aqo.profile_enable GUC's to enable this feature.
--
CREATE OR REPLACE FUNCTION public.aqo_show_classes()
RETURNS TABLE (
  query_hash integer,	-- Query class identifier
  execution_time float,	-- Sum of execution times of all queries belong to a class.
  counter integer		-- Number of executions of queries of a class.
)
AS 'MODULE_PATHNAME', 'aqo_show_classes'
LANGUAGE C STRICT;

--
-- Clear classes profiling info.
--
CREATE OR REPLACE FUNCTION public.aqo_clear_classes()
RETURNS bigint
AS 'MODULE_PATHNAME', 'aqo_clear_classes'
LANGUAGE C STRICT;

-- Clean classes buffer on the extension creation.
SELECT public.aqo_clear_classes();