@antelopejs/postgres 0.2.0 → 0.2.1

package/dist/implementations/database/external-discovery.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationName = RelationName;
+exports.ReadInfo = ReadInfo;
+exports.ReadRelationRows = ReadRelationRows;
+exports.ReadNamedRelationRows = ReadNamedRelationRows;
+exports.EstimateOf = EstimateOf;
+exports.KeyFrom = KeyFrom;
+exports.Summarize = Summarize;
+exports.ReferenceOf = ReferenceOf;
+exports.ReadReferences = ReadReferences;
+exports.DescribeRow = DescribeRow;
+const connection_1 = require("../../connection");
+const external_catalog_1 = require("./external-catalog");
+const external_declarations_1 = require("./external-declarations");
+const external_types_1 = require("./external-types");
+const identifier_1 = require("./identifier");
+const ENGINE = "postgresql";
+const SYSTEM_SCHEMAS = "('pg_catalog', 'information_schema')";
+const RELATIONS_SQL = `
+  WITH leaves AS (
+    SELECT c.oid, coalesce(sum(CASE WHEN l.reltuples >= 0 THEN l.reltuples END), 0) AS statistics,
+      coalesce(sum(s.n_live_tup), 0) AS live, bool_and(l.reltuples >= 0) AS analyzed
+    FROM pg_class c
+    JOIN LATERAL pg_partition_tree(c.oid) t ON t.isleaf
+    JOIN pg_class l ON l.oid = t.relid
+    LEFT JOIN pg_stat_all_tables s ON s.relid = l.oid
+    WHERE c.relkind = 'p'
+    GROUP BY c.oid
+  )
+  SELECT c.oid, n.nspname AS schema, c.relname AS name, c.relkind AS kind,
+    has_table_privilege(c.oid, 'SELECT') AS readable,
+    has_any_column_privilege(c.oid, 'SELECT') AS "someColumns",
+    has_table_privilege(c.oid, 'INSERT') AS insert,
+    has_table_privilege(c.oid, 'UPDATE') AS update,
+    has_table_privilege(c.oid, 'DELETE') AS delete,
+    coalesce(p.analyzed, c.reltuples >= 0) AS analyzed,
+    coalesce(p.statistics, CASE WHEN c.reltuples >= 0 THEN c.reltuples END)::float8 AS statistics,
+    coalesce(p.live, s.n_live_tup)::float8 AS "liveTuples",
+    obj_description(c.oid, 'pg_class') AS comment
+  FROM pg_class c
+  JOIN pg_namespace n ON n.oid = c.relnamespace
+  LEFT JOIN pg_stat_all_tables s ON s.relid = c.oid
+  LEFT JOIN leaves p ON p.oid = c.oid
+  WHERE c.relkind IN ${external_catalog_1.RELATION_KINDS} AND NOT c.relispartition
+    AND n.nspname NOT IN ${SYSTEM_SCHEMAS}
+    AND n.nspname NOT LIKE 'pg\\_%'
+    AND has_schema_privilege(n.oid, 'USAGE')
+    AND ($1::text[] IS NULL OR n.nspname = ANY($1::text[]))
+  ORDER BY n.nspname, c.relname`;
+const NAMED_RELATIONS_SQL = RELATIONS_SQL.replace("AND ($1::text[] IS NULL OR n.nspname = ANY($1::text[]))", "AND (n.nspname || '.' || c.relname) = ANY($1::text[])");
+const COLUMN_LIST = (relation, keys) => `ARRAY(
+      SELECT a.attname::text FROM unnest(con.${keys}) WITH ORDINALITY k(n, o)
+      JOIN pg_attribute a ON a.attrelid = con.${relation} AND a.attnum = k.n
+      ORDER BY k.o
+    )`;
+const REFERENCES_SQL = `
+  SELECT con.conname AS name,
+    fn.nspname || '.' || fc.relname AS "fromRelation", ${COLUMN_LIST("conrelid", "conkey")} AS "fromColumns",
+    tn.nspname || '.' || tc.relname AS "toRelation", ${COLUMN_LIST("confrelid", "confkey")} AS "toColumns"
+  FROM pg_constraint con
+  JOIN pg_class fc ON fc.oid = con.conrelid
+  JOIN pg_namespace fn ON fn.oid = fc.relnamespace
+  JOIN pg_class tc ON tc.oid = con.confrelid
+  JOIN pg_namespace tn ON tn.oid = tc.relnamespace
+  WHERE con.contype = 'f' AND con.conparentid = 0 AND (con.conrelid = $1 OR con.confrelid = $1)
+  ORDER BY con.conname`;
+const INFO_SQL = `
+  SELECT current_setting('server_version') AS version, current_database() AS database,
+    current_user AS role`;
+const KINDS = {
+    r: "table",
+    p: "partitioned",
+    v: "view",
+    m: "materialized",
+    f: "foreign",
+};
+const PARTIAL_GRANTS = "SELECT is granted on some of its columns only";
+const NOT_READABLE = "the connected role cannot SELECT from it";
+function RelationName(row) {
+    return `${row.schema}.${row.name}`;
+}
+async function ReadInfo() {
+    const [row] = (await (0, connection_1.Query)(INFO_SQL)).rows;
+    return { engine: ENGINE, ...row };
+}
+async function ReadRelationRows(schemas) {
+    return (await (0, connection_1.Query)(RELATIONS_SQL, [schemas ?? null])).rows;
+}
+async function ReadNamedRelationRows(relations) {
+    return (await (0, connection_1.Query)(NAMED_RELATIONS_SQL, [relations])).rows;
+}
+async function PlannedRows(row) {
+    try {
+        const sql = `EXPLAIN (FORMAT JSON) SELECT * FROM ${(0, identifier_1.QualifiedName)(row.schema, row.name)}`;
+        const [plan] = (await (0, connection_1.Query)(sql)).rows;
+        return plan["QUERY PLAN"][0].Plan["Plan Rows"];
+    }
+    catch {
+        return null;
+    }
+}
+async function EstimateOf(row) {
+    if (row.analyzed && row.statistics !== null) {
+        return { estimatedRows: row.statistics, estimate: "statistics" };
+    }
+    if (row.liveTuples !== null) {
+        return { estimatedRows: row.liveTuples, estimate: "live-tuples" };
+    }
+    if (!row.readable) {
+        return { estimatedRows: null, estimate: null };
+    }
+    const planned = await PlannedRows(row);
+    return planned === null
+        ? { estimatedRows: null, estimate: null }
+        : { estimatedRows: planned, estimate: "plan" };
+}
+function UnmappableReason(row) {
+    if (row.readable) {
+        return undefined;
+    }
+    return row.someColumns ? PARTIAL_GRANTS : NOT_READABLE;
+}
+function KeyFrom(indexes, columns) {
+    const key = (0, external_catalog_1.KeyOf)(indexes);
+    const byName = new Map(columns.map((column) => [column.name, column]));
+    if (!key || !(0, external_types_1.DescribeKeyColumns)(key.columns, byName)) {
+        return null;
+    }
+    return { columns: key.columns, source: key.primary ? "primary" : "unique" };
+}
+async function SummaryOf(row, key) {
+    return {
+        schema: row.schema,
+        name: row.name,
+        kind: KINDS[row.kind],
+        ...(await EstimateOf(row)),
+        key,
+        unmappable: UnmappableReason(row),
+        writes: { insert: row.insert, update: row.update, delete: row.delete },
+        comment: row.comment,
+    };
+}
+async function Summarize(row) {
+    const [columns, indexes] = await Promise.all([
+        (0, external_catalog_1.ReadColumns)(row.oid),
+        (0, external_catalog_1.ReadIndexes)(row.oid),
+    ]);
+    return SummaryOf(row, KeyFrom(indexes, columns));
+}
+function ReadOnlyOf(column, path) {
+    const [proposed] = (0, external_declarations_1.AcceptedDeclarations)(column);
+    if (!proposed) {
+        return undefined;
+    }
+    const descriptor = (0, external_types_1.Describe)(column.name, proposed.kind, column, path);
+    return (0, external_types_1.IsReadOnly)(descriptor) ? (0, external_types_1.ReadOnlyReason)(descriptor) : undefined;
+}
+const IDENTITIES = {
+    a: "always",
+    d: "by default",
+};
+function DescribeColumn(column, relation) {
+    const accepts = (0, external_declarations_1.AcceptedDeclarations)(column).map(({ declared, lossy }) => lossy ? { declared, lossy } : { declared });
+    const described = {
+        name: column.name,
+        native: column.native,
+        nullable: !column.notNull,
+        hasDefault: column.hasDefault,
+        generated: column.generated,
+        identity: IDENTITIES[column.identity] ?? null,
+        accepts,
+        comment: column.comment,
+    };
+    if (column.enumLabels) {
+        described.enumLabels = column.enumLabels;
+    }
+    if (accepts.length === 0) {
+        described.unsupported = (0, external_declarations_1.UnsupportedReason)(column);
+    }
+    const readOnly = ReadOnlyOf(column, `${relation}.${column.name}`);
+    if (readOnly) {
+        described.readOnly = readOnly;
+    }
+    return described;
+}
+function IndexOf(index) {
+    return { name: index.name, columns: index.columns, unique: index.unique };
+}
+function ReferenceOf(row) {
+    return {
+        name: row.name,
+        from: { relation: row.fromRelation, columns: row.fromColumns },
+        to: { relation: row.toRelation, columns: row.toColumns },
+    };
+}
+async function ReadReferences(oid) {
+    return (await (0, connection_1.Query)(REFERENCES_SQL, [oid])).rows;
+}
+async function DescribeRow(row) {
+    const relation = RelationName(row);
+    const [columns, indexes, references] = await Promise.all([
+        (0, external_catalog_1.ReadColumns)(row.oid),
+        (0, external_catalog_1.ReadIndexes)(row.oid),
+        ReadReferences(row.oid),
+    ]);
+    return {
+        ...(await SummaryOf(row, KeyFrom(indexes, columns))),
+        columns: columns.map((column) => DescribeColumn(column, relation)),
+        indexes: indexes.filter((index) => index.columns.length > 0).map(IndexOf),
+        references: references
+            .filter((reference) => reference.fromRelation === relation)
+            .map(ReferenceOf),
+        referencedBy: references
+            .filter((reference) => reference.toRelation === relation)
+            .map(ReferenceOf),
+    };
+}
+//# sourceMappingURL=external-discovery.js.map

package/dist/implementations/database/external-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-discovery.js","sourceRoot":"","sources":["../../../src/implementations/database/external-discovery.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/external-measures.d.ts

@@ -0,0 +1,11 @@
+import type { Measure } from "@antelopejs/interface-database-catalog";
+import type { QueryResultRow } from "pg";
+export declare function SetMeasureTimeoutForTests(ms?: number): void;
+export interface MeasureSession {
+    measure<T extends QueryResultRow>(sql: string, params?: unknown[]): Promise<Measure<T[]>>;
+}
+export declare function WithMeasures<T>(work: (session: MeasureSession) => Promise<T>): Promise<T>;
+export declare function FirstRow<T, R>(measured: Measure<T[]>, read: (row: T) => R): Measure<R>;
+export declare function Mapped<T, R>(measured: Measure<T>, read: (value: T) => R): Measure<R>;
+export declare function ValueOf<T>(measured: Measure<T> | undefined): T | undefined;
+export declare function Sequentially<T, R>(items: T[], work: (item: T) => Promise<R>): Promise<R[]>;

package/dist/implementations/database/external-measures.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetMeasureTimeoutForTests = SetMeasureTimeoutForTests;
+exports.WithMeasures = WithMeasures;
+exports.FirstRow = FirstRow;
+exports.Mapped = Mapped;
+exports.ValueOf = ValueOf;
+exports.Sequentially = Sequentially;
+const connection_1 = require("../../connection");
+const DEFAULT_STATEMENT_TIMEOUT_MS = 5000;
+const LOCK_TIMEOUT_MS = 1000;
+const SAVEPOINT = "measure";
+const TIMEOUT_CODES = ["57014", "55P03"];
+let statementTimeoutMs = DEFAULT_STATEMENT_TIMEOUT_MS;
+function SetMeasureTimeoutForTests(ms) {
+    statementTimeoutMs = ms ?? DEFAULT_STATEMENT_TIMEOUT_MS;
+}
+function Failed(error) {
+    const code = error.code ?? "unknown";
+    return TIMEOUT_CODES.includes(code)
+        ? { status: "timeout" }
+        : { status: "error", code };
+}
+function SessionOver(client) {
+    return {
+        async measure(sql, params) {
+            await client.query(`SAVEPOINT ${SAVEPOINT}`);
+            try {
+                const result = await client.query(sql, params);
+                await client.query(`RELEASE SAVEPOINT ${SAVEPOINT}`);
+                return { status: "ok", value: result.rows };
+            }
+            catch (error) {
+                await client.query(`ROLLBACK TO SAVEPOINT ${SAVEPOINT}`);
+                return Failed(error);
+            }
+        },
+    };
+}
+let queue = Promise.resolve();
+function Serialized(work) {
+    const run = queue.then(work, work);
+    queue = run.catch(() => undefined);
+    return run;
+}
+function WithMeasures(work) {
+    return Serialized(async () => {
+        const client = await (0, connection_1.AcquireClient)();
+        try {
+            await client.query("BEGIN READ ONLY");
+            await client.query(`SET LOCAL statement_timeout = ${statementTimeoutMs}`);
+            await client.query(`SET LOCAL lock_timeout = ${LOCK_TIMEOUT_MS}`);
+            return await work(SessionOver(client));
+        }
+        finally {
+            await client.query("ROLLBACK").catch(() => undefined);
+            client.release();
+        }
+    });
+}
+function FirstRow(measured, read) {
+    if (measured.status !== "ok") {
+        return measured;
+    }
+    return { status: "ok", value: read(measured.value[0]) };
+}
+function Mapped(measured, read) {
+    return measured.status === "ok"
+        ? { status: "ok", value: read(measured.value) }
+        : measured;
+}
+function ValueOf(measured) {
+    return measured?.status === "ok" ? measured.value : undefined;
+}
+async function Sequentially(items, work) {
+    const results = [];
+    for (const item of items) {
+        results.push(await work(item));
+    }
+    return results;
+}
+//# sourceMappingURL=external-measures.js.map

package/dist/implementations/database/external-measures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-measures.js","sourceRoot":"","sources":["../../../src/implementations/database/external-measures.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/external-profile.d.ts

@@ -0,0 +1,4 @@
+import type { ProfileRequest, RelationProfile } from "@antelopejs/interface-database-catalog";
+import { type RelationRow } from "./external-discovery";
+export declare function NamedRow(relation: string): Promise<RelationRow>;
+export declare function ProfileRelation(request: ProfileRequest): Promise<RelationProfile>;

package/dist/implementations/database/external-profile.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NamedRow = NamedRow;
+exports.ProfileRelation = ProfileRelation;
+const external_column_profile_1 = require("./external-column-profile");
+const external_catalog_1 = require("./external-catalog");
+const external_discovery_1 = require("./external-discovery");
+const external_measures_1 = require("./external-measures");
+const external_sample_1 = require("./external-sample");
+const identifier_1 = require("./identifier");
+const sql_1 = require("./sql");
+async function CountRows(session, row, estimate) {
+    if (estimate !== null && estimate > external_sample_1.SAMPLE_THRESHOLD_ROWS) {
+        return { status: "ok", value: { rows: estimate, exact: false } };
+    }
+    const measured = await session.measure(`SELECT count(*)::float8 AS rows FROM ${(0, identifier_1.QualifiedName)(row.schema, row.name)}`);
+    return (0, external_measures_1.FirstRow)(measured, (counted) => ({ rows: counted.rows, exact: true }));
+}
+async function MeasuredRows(session, source, counted) {
+    if (!source.sample) {
+        return (0, external_measures_1.ValueOf)(counted)?.rows;
+    }
+    const measured = await session.measure(`SELECT count(*)::float8 AS rows FROM ${source.from}`);
+    const rows = (0, external_measures_1.ValueOf)(measured)?.[0]?.rows;
+    source.sample.rows = rows ?? 0;
+    return rows;
+}
+function ColumnTuple(alias, columns) {
+    return `(${columns.map((column) => `${alias}.${(0, sql_1.QuoteIdentifier)(column)}`).join(", ")})`;
+}
+function QualifiedOf(relation) {
+    const dot = relation.indexOf(".");
+    return (0, identifier_1.QualifiedName)(relation.slice(0, dot), relation.slice(dot + 1));
+}
+function FanOutSql(reference) {
+    const child = QualifiedOf(reference.from.relation);
+    const parent = QualifiedOf(reference.to.relation);
+    const childKey = ColumnTuple("c", reference.from.columns);
+    const parentKey = ColumnTuple("p", reference.to.columns);
+    const filled = reference.from.columns
+        .map((column) => `c.${(0, sql_1.QuoteIdentifier)(column)} IS NOT NULL`)
+        .join(" AND ");
+    return `SELECT
+    (SELECT avg(n) FROM (SELECT count(*) AS n FROM ${child} AS c WHERE ${filled} GROUP BY ${childKey}) g)::float8 AS average,
+    (SELECT max(n) FROM (SELECT count(*) AS n FROM ${child} AS c WHERE ${filled} GROUP BY ${childKey}) g)::float8 AS max,
+    (SELECT count(*) FROM ${parent} AS p WHERE NOT EXISTS (
+      SELECT 1 FROM ${child} AS c WHERE ${childKey} = ${parentKey}))::float8 AS "parentsWithoutChildren"`;
+}
+async function ProfileReference(session, reference) {
+    const measured = await session.measure(FanOutSql(reference));
+    const fanOut = (0, external_measures_1.FirstRow)(measured, (row) => ({
+        average: row.average ?? 0,
+        max: row.max ?? 0,
+        parentsWithoutChildren: row.parentsWithoutChildren,
+    }));
+    return { reference, fanOut };
+}
+async function Inbound(references) {
+    const rows = await (0, external_discovery_1.ReadNamedRelationRows)(references.map((reference) => reference.from.relation));
+    const byName = new Map(rows.map((row) => [(0, external_discovery_1.RelationName)(row), row]));
+    return Promise.all(references.map(async (reference) => {
+        const row = byName.get(reference.from.relation);
+        const estimate = row ? (await (0, external_discovery_1.EstimateOf)(row)).estimatedRows : null;
+        return { reference, estimatedRows: estimate };
+    }));
+}
+async function NamedRow(relation) {
+    const [row] = await (0, external_discovery_1.ReadNamedRelationRows)([relation]);
+    if (!row) {
+        throw new Error(`Relation '${relation}' does not exist, or the connected role cannot see it`);
+    }
+    if (!row.readable) {
+        throw new Error(`Relation '${relation}' cannot be read by the connected role`);
+    }
+    return row;
+}
+function Selected(columns, request) {
+    const unknown = (request.columns ?? []).filter((name) => !columns.some((column) => column.name === name));
+    if (unknown.length > 0) {
+        throw new Error(`Relation '${request.relation}' has no column ${unknown.join(", ")}`);
+    }
+    return columns
+        .filter((column) => !request.columns || request.columns.includes(column.name))
+        .map(external_column_profile_1.Profiled)
+        .filter((column) => column !== undefined);
+}
+async function PlanProfile(request) {
+    const row = await NamedRow(request.relation);
+    const relation = (0, external_discovery_1.RelationName)(row);
+    const [columns, indexes, referenceRows] = await Promise.all([
+        (0, external_catalog_1.ReadColumns)(row.oid),
+        (0, external_catalog_1.ReadIndexes)(row.oid),
+        (0, external_discovery_1.ReadReferences)(row.oid),
+    ]);
+    const references = referenceRows.map(external_discovery_1.ReferenceOf);
+    const outgoing = references.filter((reference) => reference.from.relation === relation);
+    const { estimatedRows } = await (0, external_discovery_1.EstimateOf)(row);
+    return {
+        relation,
+        row,
+        estimate: estimatedRows,
+        source: (0, external_sample_1.SourceFor)(row, estimatedRows),
+        columns: Selected(columns, request),
+        outgoing,
+        inbound: await Inbound(references.filter((reference) => reference.to.relation === relation)),
+        roles: {
+            keys: new Set((0, external_discovery_1.KeyFrom)(indexes, columns)?.columns ?? []),
+            references: new Set(outgoing.flatMap((reference) => reference.from.columns)),
+        },
+    };
+}
+async function ProfileRelation(request) {
+    const plan = await PlanProfile(request);
+    return (0, external_measures_1.WithMeasures)(async (session) => {
+        const rows = await CountRows(session, plan.row, plan.estimate);
+        const measured = await MeasuredRows(session, plan.source, rows);
+        const columns = await (0, external_measures_1.Sequentially)(plan.columns, (column) => (0, external_column_profile_1.ProfileColumn)(session, column, plan.source, measured, plan.roles));
+        const references = await (0, external_measures_1.Sequentially)(plan.outgoing, (reference) => ProfileReference(session, reference));
+        return {
+            relation: plan.relation,
+            rows,
+            sample: plan.source.sample,
+            columns,
+            references,
+            inbound: plan.inbound,
+        };
+    });
+}
+//# sourceMappingURL=external-profile.js.map

package/dist/implementations/database/external-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-profile.js","sourceRoot":"","sources":["../../../src/implementations/database/external-profile.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/external-reference.d.ts

@@ -0,0 +1,2 @@
+import type { Measure, ReferenceCheck, ReferenceMatch } from "@antelopejs/interface-database-catalog";
+export declare function CheckColumnReference(check: ReferenceCheck): Promise<Measure<ReferenceMatch>>;

package/dist/implementations/database/external-reference.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckColumnReference = CheckColumnReference;
+const external_catalog_1 = require("./external-catalog");
+const external_discovery_1 = require("./external-discovery");
+const external_measures_1 = require("./external-measures");
+const external_sample_1 = require("./external-sample");
+const identifier_1 = require("./identifier");
+const sql_1 = require("./sql");
+async function Resolve(reference) {
+    const [row] = await (0, external_discovery_1.ReadNamedRelationRows)([reference.relation]);
+    if (!row || !row.readable) {
+        throw new Error(`Relation '${reference.relation}' does not exist, or the connected role cannot read it`);
+    }
+    const columns = await (0, external_catalog_1.ReadColumns)(row.oid);
+    const column = columns.find((candidate) => candidate.name === reference.column);
+    if (!column) {
+        throw new Error(`Relation '${reference.relation}' has no column ${reference.column}`);
+    }
+    return { row, column, columns };
+}
+async function IsKey(side) {
+    const key = (0, external_discovery_1.KeyFrom)(await (0, external_catalog_1.ReadIndexes)(side.row.oid), side.columns);
+    return key?.columns.length === 1 && key.columns[0] === side.column.name;
+}
+function Equality(from, to) {
+    const left = `t.${(0, sql_1.QuoteIdentifier)(to.column.name)}`;
+    const right = `f.${(0, sql_1.QuoteIdentifier)(from.column.name)}`;
+    return from.column.castType === to.column.castType
+        ? `${left} = ${right}`
+        : `${left}::text = ${right}::text`;
+}
+async function CheckColumnReference(check) {
+    const from = await Resolve(check.from);
+    const to = await Resolve(check.to);
+    const source = (0, external_sample_1.SourceFor)(from.row, (await (0, external_discovery_1.EstimateOf)(from.row)).estimatedRows, "f");
+    const targetIsKey = await IsKey(to);
+    const target = (0, identifier_1.QualifiedName)(to.row.schema, to.row.name);
+    const sql = `SELECT count(*)::float8 AS checked,
+    (count(*) FILTER (WHERE EXISTS (SELECT 1 FROM ${target} AS t WHERE ${Equality(from, to)})))::float8 AS found
+    FROM ${source.from} WHERE f.${(0, sql_1.QuoteIdentifier)(from.column.name)} IS NOT NULL`;
+    return (0, external_measures_1.WithMeasures)(async (session) => (0, external_measures_1.FirstRow)(await session.measure(sql), (row) => ({
+        containment: row.checked > 0 ? row.found / row.checked : 0,
+        checkedRows: row.checked,
+        sampled: source.sample !== null,
+        targetIsKey,
+    })));
+}
+//# sourceMappingURL=external-reference.js.map

package/dist/implementations/database/external-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-reference.js","sourceRoot":"","sources":["../../../src/implementations/database/external-reference.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/external-rows.d.ts

@@ -0,0 +1,2 @@
+import { type RowSample, type SampleRequest } from "@antelopejs/interface-database-catalog";
+export declare function SampleRelationRows(request: SampleRequest): Promise<RowSample>;

package/dist/implementations/database/external-rows.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SampleRelationRows = SampleRelationRows;
+const interface_database_catalog_1 = require("@antelopejs/interface-database-catalog");
+const external_catalog_1 = require("./external-catalog");
+const external_discovery_1 = require("./external-discovery");
+const external_measures_1 = require("./external-measures");
+const external_profile_1 = require("./external-profile");
+const external_sample_1 = require("./external-sample");
+const sql_1 = require("./sql");
+const BINARY_TYPES = ["bytea"];
+const COLUMN_ALIAS_PREFIX = "c";
+function SampledColumnOf(column) {
+    return {
+        name: column.name,
+        binary: BINARY_TYPES.includes(column.typname),
+    };
+}
+function CheckedLimit(limit) {
+    if (!Number.isInteger(limit) || limit < 1 || limit > interface_database_catalog_1.SAMPLE_ROWS_LIMIT) {
+        throw new Error(`A sample answers from 1 to ${interface_database_catalog_1.SAMPLE_ROWS_LIMIT} rows, not ${limit}`);
+    }
+    return limit;
+}
+function Chosen(columns, request) {
+    const unknown = (request.columns ?? []).filter((name) => !columns.some((column) => column.name === name));
+    if (unknown.length > 0) {
+        throw new Error(`Relation '${request.relation}' has no column ${unknown.join(", ")}`);
+    }
+    return columns
+        .filter((column) => !request.columns || request.columns.includes(column.name))
+        .map(SampledColumnOf);
+}
+function Expression(column, index) {
+    const value = `${external_sample_1.SOURCE_ALIAS}.${(0, sql_1.QuoteIdentifier)(column.name)}`;
+    const read = column.binary
+        ? `octet_length(${value})`
+        : `left(${value}::text, ${interface_database_catalog_1.SAMPLE_TEXT_LENGTH + 1})`;
+    return `${read} AS ${COLUMN_ALIAS_PREFIX}${index}`;
+}
+function Value(column, read) {
+    if (read === null) {
+        return null;
+    }
+    if (column.binary) {
+        return { bytes: Number(read) };
+    }
+    const text = String(read);
+    return {
+        text: text.slice(0, interface_database_catalog_1.SAMPLE_TEXT_LENGTH),
+        truncated: text.length > interface_database_catalog_1.SAMPLE_TEXT_LENGTH,
+    };
+}
+function Row(columns, row) {
+    return columns.map((column, index) => Value(column, row[`${COLUMN_ALIAS_PREFIX}${index}`] ?? null));
+}
+function FailureOf(measured) {
+    return measured.status === "timeout" ? "timeout" : measured.code;
+}
+async function SampleRelationRows(request) {
+    const limit = CheckedLimit(request.limit);
+    const row = await (0, external_profile_1.NamedRow)(request.relation);
+    const columns = Chosen(await (0, external_catalog_1.ReadColumns)(row.oid), request);
+    const { estimatedRows } = await (0, external_discovery_1.EstimateOf)(row);
+    const source = (0, external_sample_1.SourceFor)(row, estimatedRows);
+    const select = columns.map(Expression).join(", ");
+    const measured = await (0, external_measures_1.WithMeasures)((session) => session.measure(`SELECT ${select} FROM ${source.from} LIMIT $1`, [limit]));
+    if (measured.status !== "ok") {
+        throw new Error(`The sample of '${request.relation}' did not finish: ${FailureOf(measured)}`);
+    }
+    return {
+        relation: (0, external_discovery_1.RelationName)(row),
+        columns: columns.map((column) => column.name),
+        rows: measured.value.map((sampled) => Row(columns, sampled)),
+        sample: source.sample && {
+            ...source.sample,
+            rows: measured.value.length,
+        },
+    };
+}
+//# sourceMappingURL=external-rows.js.map

package/dist/implementations/database/external-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-rows.js","sourceRoot":"","sources":["../../../src/implementations/database/external-rows.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/external-sample.d.ts

@@ -0,0 +1,9 @@
+import type { SampleInfo } from "@antelopejs/interface-database-catalog";
+import type { RelationRow } from "./external-discovery";
+export declare const SAMPLE_THRESHOLD_ROWS = 1000000;
+export declare const SOURCE_ALIAS = "r";
+export interface Source {
+    from: string;
+    sample: SampleInfo | null;
+}
+export declare function SourceFor(row: RelationRow, estimate: number | null, alias?: string): Source;