@l-v-yonsama/multi-platform-database-drivers 2.0.1 → 2.1.0

package/built/src/drivers/providers/performance/PostgresPerformanceTuningProvider.js

@@ -0,0 +1,328 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresPerformanceTuningProvider = void 0;
+const tslib_1 = require("tslib");
+const performanceTuningDiagnosticHelpers_1 = require("./performanceTuningDiagnosticHelpers");
+const postgresCatalogMapper_1 = require("./postgresCatalogMapper");
+const postgresPlanParser_1 = require("./postgresPlanParser");
+const schemaFilterBinds = (target) => { var _a; return (_a = target.schemaName) !== null && _a !== void 0 ? _a : ''; };
+class PostgresPerformanceTuningProvider {
+    constructor(driver) {
+        this.driver = driver;
+    }
+    checkCapabilities(params) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const capabilities = {
+                executionPlan: { available: true, source: 'EXPLAIN (FORMAT JSON)' },
+                analyzedExecutionPlan: {
+                    available: true,
+                    source: 'EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)',
+                },
+                tableDefinition: { available: true, source: 'pg_catalog / information_schema' },
+                optimizerStatistics: { available: true, source: 'pg_class / pg_stats / pg_stat_user_tables' },
+                physicalHealth: { available: true, source: 'pg_stat_user_tables' },
+            };
+            return { ok: true, message: '', result: capabilities };
+        });
+    }
+    collectExecutionPlan(params, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e;
+            const explainClause = ((_a = params.plan) === null || _a === void 0 ? void 0 : _a.mode) === 'analyze' ? 'EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON)' : 'EXPLAIN (FORMAT JSON)';
+            const binds = (_c = (_b = params.plan) === null || _b === void 0 ? void 0 : _b.binds) === null || _c === void 0 ? void 0 : _c.map((v) => String(v));
+            let rdh;
+            try {
+                rdh = yield this.driver.requestSql({
+                    sql: `${explainClause} ${params.statement.sql}`,
+                    conditions: { rawQueries: true, binds },
+                    meta: { type: 'performanceTuningContext' },
+                });
+            }
+            catch (e) {
+                const detail = e instanceof Error ? e.message : String(e);
+                return {
+                    ok: false,
+                    message: `Failed to retrieve the execution plan.${detail ? ` ${detail}` : ''}`,
+                };
+            }
+            const rawValue = (_e = (_d = rdh.rows[0]) === null || _d === void 0 ? void 0 : _d.values) === null || _e === void 0 ? void 0 : _e['QUERY PLAN'];
+            if (rawValue === undefined) {
+                return { ok: false, message: 'EXPLAIN did not return a QUERY PLAN result.' };
+            }
+            let parsed;
+            try {
+                parsed = typeof rawValue === 'string' ? JSON.parse(rawValue) : rawValue;
+            }
+            catch (_f) {
+                return { ok: false, message: 'Failed to parse the EXPLAIN JSON output.' };
+            }
+            const explainRoot = Array.isArray(parsed) ? parsed[0] : parsed;
+            let planNode;
+            let planTableMappings = [];
+            const diagnostics = [];
+            try {
+                const parsedPlan = (0, postgresPlanParser_1.parsePostgresPlan)(explainRoot);
+                planNode = parsedPlan.planNode;
+                planTableMappings = parsedPlan.mappings;
+                diagnostics.push(...parsedPlan.diagnostics);
+            }
+            catch (_g) {
+                diagnostics.push((0, performanceTuningDiagnosticHelpers_1.planUnresolvedDiagnostic)());
+            }
+            return {
+                ok: true,
+                message: '',
+                result: {
+                    raw: parsed,
+                    normalizedPlan: planNode,
+                    planningTimeMs: (0, postgresPlanParser_1.extractPlanningTimeMs)(explainRoot),
+                    executionTimeMs: (0, postgresPlanParser_1.extractExecutionTimeMs)(explainRoot),
+                    diagnostics,
+                    planTableMappings,
+                },
+            };
+        });
+    }
+    runCatalogQuery(sql, binds, sectionLabel) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                const rdh = yield this.driver.requestSql({
+                    sql,
+                    conditions: { rawQueries: true, binds },
+                    meta: { type: 'performanceTuningContext' },
+                });
+                return { ok: true, message: '', result: rdh };
+            }
+            catch (e) {
+                const detail = e instanceof Error ? e.message : String(e);
+                return {
+                    ok: false,
+                    message: `Failed to collect ${sectionLabel} for this table.${detail ? ` ${detail}` : ''}`,
+                };
+            }
+        });
+    }
+    collectTableDefinition(target, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const binds = [target.tableName, schemaFilterBinds(target)];
+            const [columnsResult, constraintsResult, indexesResult, partitioningResult] = yield Promise.all([
+                this.runCatalogQuery(COLUMNS_SQL, binds, 'columns'),
+                this.runCatalogQuery(CONSTRAINTS_SQL, binds, 'constraints'),
+                this.runCatalogQuery(INDEXES_SQL, binds, 'indexes'),
+                this.runCatalogQuery(PARTITIONING_SQL, binds, 'partitioning'),
+            ]);
+            if (!columnsResult.ok) {
+                return { ok: false, message: columnsResult.message };
+            }
+            const columns = (0, postgresCatalogMapper_1.mapColumnRows)((_b = (_a = columnsResult.result) === null || _a === void 0 ? void 0 : _a.rows.map((r) => r.values)) !== null && _b !== void 0 ? _b : []);
+            const constraints = constraintsResult.ok
+                ? (0, postgresCatalogMapper_1.mapConstraintRows)((_d = (_c = constraintsResult.result) === null || _c === void 0 ? void 0 : _c.rows.map((r) => r.values)) !== null && _d !== void 0 ? _d : [])
+                : [];
+            const indexes = indexesResult.ok
+                ? (0, postgresCatalogMapper_1.mapIndexRows)((_f = (_e = indexesResult.result) === null || _e === void 0 ? void 0 : _e.rows.map((r) => r.values)) !== null && _f !== void 0 ? _f : [])
+                : [];
+            const partitioning = partitioningResult.ok
+                ? (0, postgresCatalogMapper_1.mapPartitioningRow)((_h = (_g = partitioningResult.result) === null || _g === void 0 ? void 0 : _g.rows[0]) === null || _h === void 0 ? void 0 : _h.values)
+                : undefined;
+            const warnings = [];
+            if (!constraintsResult.ok) {
+                warnings.push(constraintsResult.message);
+            }
+            if (!indexesResult.ok) {
+                warnings.push(indexesResult.message);
+            }
+            if (!partitioningResult.ok) {
+                warnings.push(partitioningResult.message);
+            }
+            if (columns.length === 0) {
+                return {
+                    ok: false,
+                    message: `Table ${target.schemaName ? `${target.schemaName}.` : ''}${target.tableName} was not found (or is not visible to this connection).`,
+                };
+            }
+            const ddl = (0, postgresCatalogMapper_1.renderPostgresTableDdl)({
+                schemaName: target.schemaName,
+                tableName: target.tableName,
+                columns,
+                constraints,
+                indexes,
+            });
+            return {
+                ok: true,
+                message: warnings.join(' '),
+                result: { ddl, columns, constraints, indexes, partitioning },
+            };
+        });
+    }
+    collectTableStatistics(target, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const result = yield this.runCatalogQuery(TABLE_STATISTICS_SQL, [target.tableName, schemaFilterBinds(target)], 'table statistics');
+            if (!result.ok) {
+                return { ok: false, message: result.message };
+            }
+            const mapped = (0, postgresCatalogMapper_1.mapTableStatisticsRow)((_b = (_a = result.result) === null || _a === void 0 ? void 0 : _a.rows[0]) === null || _b === void 0 ? void 0 : _b.values);
+            if (!mapped) {
+                return {
+                    ok: false,
+                    message: `Table ${target.schemaName ? `${target.schemaName}.` : ''}${target.tableName} was not found (or is not visible to this connection).`,
+                };
+            }
+            return { ok: true, message: '', result: mapped };
+        });
+    }
+    collectColumnStatistics(target, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (target.columnNames.length === 0) {
+                return { ok: true, message: '', result: [] };
+            }
+            const columnPlaceholders = target.columnNames
+                .map((_, i) => `$${i + 3}`)
+                .join(', ');
+            const sql = COLUMN_STATISTICS_SQL.replace('$COLUMN_PLACEHOLDERS', columnPlaceholders);
+            const binds = [target.tableName, schemaFilterBinds(target), ...target.columnNames];
+            const result = yield this.runCatalogQuery(sql, binds, 'column statistics');
+            if (!result.ok) {
+                return { ok: false, message: result.message };
+            }
+            return {
+                ok: true,
+                message: '',
+                result: (0, postgresCatalogMapper_1.mapColumnStatisticsRows)((_b = (_a = result.result) === null || _a === void 0 ? void 0 : _a.rows.map((r) => r.values)) !== null && _b !== void 0 ? _b : []),
+            };
+        });
+    }
+    collectPhysicalHealth(target, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const result = yield this.runCatalogQuery(PHYSICAL_HEALTH_SQL, [target.tableName, schemaFilterBinds(target)], 'physical health');
+            if (!result.ok) {
+                return { ok: false, message: result.message };
+            }
+            return { ok: true, message: '', result: (0, postgresCatalogMapper_1.mapPhysicalHealthRow)((_b = (_a = result.result) === null || _a === void 0 ? void 0 : _a.rows[0]) === null || _b === void 0 ? void 0 : _b.values) };
+        });
+    }
+}
+exports.PostgresPerformanceTuningProvider = PostgresPerformanceTuningProvider;
+const COLUMNS_SQL = `
+SELECT
+  col.column_name AS name,
+  col.data_type AS data_type,
+  col.udt_name AS udt_name,
+  col.is_nullable AS is_nullable,
+  col.column_default AS column_default,
+  col.ordinal_position AS ordinal_position,
+  pg_catalog.col_description(c.oid, col.ordinal_position::int) AS comment
+FROM information_schema.columns col
+JOIN pg_catalog.pg_class c ON c.relname = col.table_name
+JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace AND n.nspname = col.table_schema
+WHERE col.table_name = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR col.table_schema = $2)
+ORDER BY col.ordinal_position`;
+const CONSTRAINTS_SQL = `
+SELECT
+  con.conname AS constraint_name,
+  con.contype AS contype,
+  -- ::text matters: pg_attribute.attname is the catalog "name" type, and
+  -- node-postgres has no default array parser for name[] (only scalar
+  -- name has one) - without the cast this array_agg comes back as its raw
+  -- Postgres text literal ("{id}") instead of a JS array.
+  (SELECT array_agg(a.attname::text ORDER BY x.n)
+     FROM unnest(con.conkey) WITH ORDINALITY AS x(attnum, n)
+     JOIN pg_attribute a ON a.attrelid = con.conrelid AND a.attnum = x.attnum
+  ) AS columns,
+  fn.nspname AS referenced_schema,
+  fc.relname AS referenced_table,
+  (SELECT array_agg(a.attname::text ORDER BY x.n)
+     FROM unnest(con.confkey) WITH ORDINALITY AS x(attnum, n)
+     JOIN pg_attribute a ON a.attrelid = con.confrelid AND a.attnum = x.attnum
+  ) AS referenced_columns,
+  pg_get_constraintdef(con.oid) AS definition
+FROM pg_constraint con
+JOIN pg_class c ON c.oid = con.conrelid
+JOIN pg_namespace n ON n.oid = c.relnamespace
+LEFT JOIN pg_class fc ON fc.oid = con.confrelid
+LEFT JOIN pg_namespace fn ON fn.oid = fc.relnamespace
+WHERE c.relname = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR n.nspname = $2)
+  AND con.contype IN ('p','u','f','c')`;
+const INDEXES_SQL = `
+SELECT
+  i.relname AS index_name,
+  ix.indisunique AS is_unique,
+  ix.indisprimary AS is_primary,
+  ix.indisvalid AS is_valid,
+  am.amname AS index_type,
+  pg_get_expr(ix.indpred, ix.indrelid) AS predicate,
+  ix.indnkeyatts AS n_key_atts,
+  (
+    SELECT json_agg(
+      json_build_object(
+        'position', gs.pos,
+        'name', CASE WHEN k0.attnum IS NOT NULL AND k0.attnum <> 0 THEN k.attname ELSE NULL END,
+        'expression', CASE WHEN k0.attnum IS NULL OR k0.attnum = 0 THEN pg_get_indexdef(ix.indexrelid, gs.pos, true) ELSE NULL END,
+        'desc', COALESCE((o.opt & 1) = 1, false)
+      ) ORDER BY gs.pos
+    )
+    FROM generate_series(1, ix.indnatts) AS gs(pos)
+    LEFT JOIN LATERAL (SELECT (string_to_array(ix.indkey::text, ' '))[gs.pos]::int2 AS attnum) k0 ON true
+    LEFT JOIN pg_attribute k ON k.attrelid = ix.indrelid AND k.attnum = k0.attnum AND k0.attnum <> 0
+    LEFT JOIN LATERAL (SELECT NULLIF((string_to_array(ix.indoption::text, ' '))[gs.pos], '')::int AS opt) o ON true
+  ) AS columns
+FROM pg_index ix
+JOIN pg_class t ON t.oid = ix.indrelid
+JOIN pg_class i ON i.oid = ix.indexrelid
+JOIN pg_am am ON am.oid = i.relam
+JOIN pg_namespace n ON n.oid = t.relnamespace
+WHERE t.relname = $1
+  AND (($2 = '' AND pg_table_is_visible(t.oid)) OR n.nspname = $2)
+ORDER BY i.relname`;
+const PARTITIONING_SQL = `
+SELECT
+  pt.partstrat AS strategy,
+  pg_get_partkeydef(pt.partrelid) AS partition_key_def,
+  (SELECT count(*) FROM pg_inherits WHERE inhparent = pt.partrelid) AS partition_count
+FROM pg_partitioned_table pt
+JOIN pg_class c ON c.oid = pt.partrelid
+JOIN pg_namespace n ON n.oid = c.relnamespace
+WHERE c.relname = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR n.nspname = $2)`;
+const TABLE_STATISTICS_SQL = `
+SELECT
+  c.reltuples AS estimated_row_count,
+  pg_table_size(c.oid) AS table_bytes,
+  pg_indexes_size(c.oid) AS index_bytes,
+  pg_total_relation_size(c.oid) AS total_bytes,
+  s.n_mod_since_analyze,
+  s.last_analyze,
+  s.last_autoanalyze
+FROM pg_class c
+JOIN pg_namespace n ON n.oid = c.relnamespace
+LEFT JOIN pg_stat_user_tables s ON s.relid = c.oid
+WHERE c.relname = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR n.nspname = $2)`;
+const COLUMN_STATISTICS_SQL = `
+SELECT ps.attname, ps.n_distinct, ps.null_frac, ps.avg_width, ps.correlation, c.reltuples
+FROM pg_stats ps
+JOIN pg_class c ON c.relname = ps.tablename
+JOIN pg_namespace n ON n.oid = c.relnamespace AND n.nspname = ps.schemaname
+WHERE ps.tablename = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR ps.schemaname = $2)
+  AND ps.attname IN ($COLUMN_PLACEHOLDERS)`;
+const PHYSICAL_HEALTH_SQL = `
+SELECT
+  s.n_live_tup,
+  s.n_dead_tup,
+  s.n_mod_since_analyze,
+  s.last_vacuum,
+  s.last_autovacuum,
+  s.last_analyze,
+  s.last_autoanalyze
+FROM pg_class c
+JOIN pg_namespace n ON n.oid = c.relnamespace
+LEFT JOIN pg_stat_user_tables s ON s.relid = c.oid
+WHERE c.relname = $1
+  AND (($2 = '' AND pg_table_is_visible(c.oid)) OR n.nspname = $2)`;
+//# sourceMappingURL=PostgresPerformanceTuningProvider.js.map

package/built/src/drivers/providers/performance/PostgresPerformanceTuningProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresPerformanceTuningProvider.js","sourceRoot":"","sources":["../../../../../src/drivers/providers/performance/PostgresPerformanceTuningProvider.ts"],"names":[],"mappings":"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"}

package/built/src/drivers/providers/performance/SQLServerPerformanceTuningProvider.d.ts

@@ -0,0 +1,29 @@
+import { ResultSetData } from '@l-v-yonsama/rdh';
+import { GeneralResult } from '../../../types/drivers/GeneralResult';
+import { ActualPlanArtifact, PerformanceTuningCallOptions, PerformanceTuningContextParams } from '../../../types/drivers/performance/PerformanceTuningContext';
+import { PerformanceTuningAvailabilityParams, PerformanceTuningCapabilities } from '../../../types/drivers/performance/PerformanceTuningCapabilities';
+import { QueryParams } from '../../../types/drivers/QueryParams';
+import { PerformanceTuningCollectionOptions, PerformanceTuningContextProvider, PerformanceTuningTableTarget, VendorColumnStatistics, VendorExecutionPlan, VendorPhysicalHealth, VendorTableDefinition, VendorTableStatistics } from './PerformanceTuningContextProvider';
+export interface SQLServerPerformanceTuningDriverAccess {
+    requestSql(params: QueryParams): Promise<ResultSetData>;
+    collectPerformanceTuningShowplan(params: QueryParams, bindMarkers?: string[]): Promise<ResultSetData>;
+    collectPerformanceTuningActualPlan(params: QueryParams, bindMarkers?: string[], options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ActualPlanArtifact>;
+}
+export declare class SQLServerPerformanceTuningProvider implements PerformanceTuningContextProvider {
+    private readonly driver;
+    constructor(driver: SQLServerPerformanceTuningDriverAccess);
+    checkCapabilities(params: PerformanceTuningAvailabilityParams): Promise<GeneralResult<PerformanceTuningCapabilities>>;
+    collectExecutionPlan(params: PerformanceTuningContextParams, options: PerformanceTuningCallOptions & {
+        timeoutMs: number;
+    }): Promise<GeneralResult<VendorExecutionPlan>>;
+    private runCatalogQuery;
+    collectTableDefinition(target: PerformanceTuningTableTarget, options: PerformanceTuningCollectionOptions): Promise<GeneralResult<VendorTableDefinition>>;
+    collectTableStatistics(target: PerformanceTuningTableTarget, options: PerformanceTuningCollectionOptions): Promise<GeneralResult<VendorTableStatistics>>;
+    collectColumnStatistics(target: PerformanceTuningTableTarget & {
+        columnNames: string[];
+    }, options: PerformanceTuningCollectionOptions): Promise<GeneralResult<VendorColumnStatistics[]>>;
+    collectPhysicalHealth(target: PerformanceTuningTableTarget, options: PerformanceTuningCollectionOptions): Promise<GeneralResult<VendorPhysicalHealth>>;
+}