@kaelio/ktx 0.4.1 → 0.6.0

package/dist/connectors/sqlserver/connector.js

@@ -0,0 +1,581 @@
+import { assertReadOnlySql } from '../../context/connections/read-only-sql.js';
+import { getDialectForDriver } from '../../context/connections/dialects.js';
+import { tryConstraintQuery } from '../../context/scan/constraint-discovery.js';
+import { scopedTableNames } from '../../context/scan/table-ref.js';
+import { createKtxConnectorCapabilities, } from '../../context/scan/types.js';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import sql from 'mssql';
+function sqlTypeDeclaration(type) {
+    if (typeof type === 'function') {
+        try {
+            return sqlTypeDeclaration(type());
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    if (typeof type === 'object' && type !== null && 'declaration' in type) {
+        const declaration = type.declaration;
+        return typeof declaration === 'string' ? declaration : 'unknown';
+    }
+    return 'unknown';
+}
+function sqlRecordset(rows, columns) {
+    const recordset = [...(rows ?? [])];
+    recordset.columns = Object.fromEntries(Object.entries(columns ?? {}).map(([name, metadata]) => [
+        name,
+        { type: { declaration: sqlTypeDeclaration(metadata.type) } },
+    ]));
+    return recordset;
+}
+function tableScopeSql(scopedNames, columnExpression) {
+    if (!scopedNames)
+        return { clause: '', params: {} };
+    const params = {};
+    const placeholders = scopedNames.map((name, index) => {
+        const key = `table_${index}`;
+        params[key] = name;
+        return `@${key}`;
+    });
+    return { clause: `AND ${columnExpression} IN (${placeholders.join(', ')})`, params };
+}
+/** @internal */
+export function prepareSqlServerReadOnlyQuery(sql, params) {
+    if (!params) {
+        return { sql, params: undefined };
+    }
+    let parameterizedQuery = sql;
+    for (const key of Object.keys(params)) {
+        parameterizedQuery = parameterizedQuery.replace(new RegExp(`:${key}\\b`, 'g'), `@${key}`);
+    }
+    return { sql: parameterizedQuery, params };
+}
+class DefaultSqlServerPoolFactory {
+    async createPool(config) {
+        const pool = await new sql.ConnectionPool(config).connect();
+        return {
+            request() {
+                const request = pool.request();
+                return {
+                    input(name, value) {
+                        request.input(name, value);
+                        return this;
+                    },
+                    async query(query) {
+                        const result = await request.query(query);
+                        return {
+                            recordset: sqlRecordset(result.recordset, result.recordset?.columns),
+                        };
+                    },
+                };
+            },
+            close: () => pool.close(),
+        };
+    }
+}
+function stringConfigValue(connection, key, env) {
+    const value = connection?.[key];
+    return typeof value === 'string' && value.trim().length > 0 ? resolveStringReference(value.trim(), env) : undefined;
+}
+function resolveStringReference(value, env) {
+    if (value.startsWith('env:')) {
+        return env[value.slice('env:'.length)] ?? '';
+    }
+    if (value.startsWith('file:')) {
+        const rawPath = value.slice('file:'.length);
+        const path = rawPath.startsWith('~') ? resolve(homedir(), rawPath.slice(1)) : rawPath;
+        return readFileSync(path, 'utf-8').trim();
+    }
+    return value;
+}
+function parseSqlServerUrl(url) {
+    const parsed = new URL(url);
+    return {
+        host: parsed.hostname,
+        port: parsed.port ? Number(parsed.port) : undefined,
+        database: parsed.pathname.replace(/^\/+/, '') || undefined,
+        username: parsed.username ? decodeURIComponent(parsed.username) : undefined,
+        password: parsed.password ? decodeURIComponent(parsed.password) : undefined,
+        trustServerCertificate: parsed.searchParams.get('trustServerCertificate') === 'true',
+    };
+}
+function maybeNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function positiveIntegerConfigValue(input) {
+    const value = input.connection[input.key];
+    if (value === undefined) {
+        return input.defaultValue;
+    }
+    const numberValue = Number(value);
+    if (!Number.isInteger(numberValue) || numberValue < 1) {
+        throw new Error(`connections.${input.connectionId}.${String(input.key)} must be a positive integer`);
+    }
+    return numberValue;
+}
+function schemaNames(connection, env) {
+    if (Array.isArray(connection.schemas) && connection.schemas.length > 0) {
+        return connection.schemas.filter((schema) => schema.trim().length > 0).map((schema) => resolveStringReference(schema, env));
+    }
+    return [stringConfigValue(connection, 'schema', env) ?? 'dbo'];
+}
+function groupByTable(rows) {
+    const grouped = new Map();
+    for (const row of rows) {
+        const values = grouped.get(row.table_name) ?? [];
+        values.push(row);
+        grouped.set(row.table_name, values);
+    }
+    return grouped;
+}
+function firstNumber(value) {
+    const numberValue = Number(value);
+    return Number.isFinite(numberValue) ? numberValue : null;
+}
+function isDeniedError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const number = error.number;
+    return number === 229 || number === 230 || number === 297;
+}
+function limitSqlForSqlServerExecution(sqlText, maxRows) {
+    const trimmed = assertReadOnlySql(sqlText).replace(/;+\s*$/, '');
+    if (!maxRows) {
+        return trimmed;
+    }
+    if (!Number.isInteger(maxRows) || maxRows <= 0) {
+        throw new Error('maxRows must be a positive integer.');
+    }
+    return `SELECT TOP ${maxRows} * FROM (${trimmed}) AS ktx_query_result`;
+}
+export function isKtxSqlServerConnectionConfig(connection) {
+    return String(connection?.driver ?? '').toLowerCase() === 'sqlserver';
+}
+/** @internal */
+export function sqlServerConnectionPoolConfigFromConfig(input) {
+    const inputDriver = input.connection?.driver ?? 'unknown';
+    if (!isKtxSqlServerConnectionConfig(input.connection)) {
+        throw new Error(`Native SQL Server connector cannot run driver "${inputDriver}"`);
+    }
+    const env = input.env ?? process.env;
+    const referencedUrl = stringConfigValue(input.connection, 'url', env);
+    const urlConfig = referencedUrl ? parseSqlServerUrl(referencedUrl) : {};
+    const merged = { ...urlConfig, ...input.connection };
+    const server = stringConfigValue(merged, 'host', env);
+    const database = stringConfigValue(merged, 'database', env);
+    const user = stringConfigValue(merged, 'username', env) ?? stringConfigValue(merged, 'user', env);
+    const maxConnections = positiveIntegerConfigValue({
+        connection: merged,
+        key: 'maxConnections',
+        connectionId: input.connectionId,
+        defaultValue: 10,
+    });
+    if (!server) {
+        throw new Error(`Native SQL Server connector requires connections.${input.connectionId}.host or url`);
+    }
+    if (!database) {
+        throw new Error(`Native SQL Server connector requires connections.${input.connectionId}.database or url`);
+    }
+    if (!user) {
+        throw new Error(`Native SQL Server connector requires connections.${input.connectionId}.username, user, or url`);
+    }
+    return {
+        server,
+        port: maybeNumber(merged.port) ?? 1433,
+        database,
+        user,
+        password: stringConfigValue(merged, 'password', env),
+        options: { encrypt: true, trustServerCertificate: merged.trustServerCertificate ?? true },
+        pool: { max: maxConnections, min: 0, idleTimeoutMillis: 30000 },
+    };
+}
+export class KtxSqlServerScanConnector {
+    id;
+    driver = 'sqlserver';
+    capabilities = createKtxConnectorCapabilities({
+        tableSampling: true,
+        columnSampling: true,
+        columnStats: false,
+        readOnlySql: true,
+        nestedAnalysis: false,
+        formalForeignKeys: true,
+        estimatedRowCounts: true,
+    });
+    connectionId;
+    connection;
+    poolConfig;
+    schemas;
+    poolFactory;
+    endpointResolver;
+    now;
+    dialect = getDialectForDriver('sqlserver');
+    pool = null;
+    resolvedEndpoint = null;
+    constructor(options) {
+        this.connectionId = options.connectionId;
+        this.connection = options.connection ?? {};
+        const env = options.env ?? process.env;
+        this.poolConfig = sqlServerConnectionPoolConfigFromConfig({
+            connectionId: options.connectionId,
+            connection: options.connection,
+            env,
+        });
+        this.schemas = schemaNames(this.connection, env);
+        this.poolFactory = options.poolFactory ?? new DefaultSqlServerPoolFactory();
+        this.endpointResolver = options.endpointResolver;
+        this.now = options.now ?? (() => new Date());
+        this.id = `sqlserver:${options.connectionId}`;
+    }
+    async testConnection() {
+        try {
+            await this.query('SELECT 1');
+            return { success: true };
+        }
+        catch (error) {
+            return { success: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async introspect(input, _ctx) {
+        this.assertConnection(input.connectionId);
+        const tables = [];
+        const snapshotWarnings = [];
+        for (const schemaName of this.schemas) {
+            const scopedNames = input.tableScope
+                ? scopedTableNames(input.tableScope, { catalog: this.poolConfig.database, db: schemaName })
+                : null;
+            tables.push(...(await this.introspectSchema(schemaName, scopedNames, snapshotWarnings)));
+        }
+        return {
+            connectionId: this.connectionId,
+            driver: 'sqlserver',
+            extractedAt: this.now().toISOString(),
+            scope: { catalogs: [this.poolConfig.database], schemas: this.schemas },
+            metadata: {
+                database: this.poolConfig.database,
+                schemas: this.schemas,
+                host: this.poolConfig.server,
+                table_count: tables.length,
+                total_columns: tables.reduce((sum, table) => sum + table.columns.length, 0),
+            },
+            tables,
+            warnings: snapshotWarnings,
+        };
+    }
+    async sampleTable(input, _ctx) {
+        this.assertConnection(input.connectionId);
+        const result = await this.query(this.dialect.generateSampleQuery(this.qTableName(input.table), input.limit, input.columns));
+        return { headers: result.headers, headerTypes: result.headerTypes, rows: result.rows, totalRows: result.totalRows };
+    }
+    async sampleColumn(input, _ctx) {
+        this.assertConnection(input.connectionId);
+        const result = await this.query(this.dialect.generateColumnSampleQuery(this.qTableName(input.table), input.column, input.limit));
+        const values = result.rows.filter((row) => row.length > 0 && row[0] !== null).map((row) => row[0]);
+        return { values, nullCount: null, distinctCount: null };
+    }
+    async columnStats(_input, _ctx) {
+        return null;
+    }
+    async executeReadOnly(input, _ctx) {
+        this.assertConnection(input.connectionId);
+        const limitedSql = limitSqlForSqlServerExecution(input.sql, input.maxRows);
+        const prepared = prepareSqlServerReadOnlyQuery(limitedSql, input.params);
+        const result = await this.query(prepared.sql, prepared.params);
+        return { ...result, rowCount: result.rows.length };
+    }
+    async getColumnDistinctValues(table, columnName, options) {
+        const tableName = this.qTableName(table);
+        const quotedColumn = this.dialect.quoteIdentifier(columnName);
+        const cardinalityRows = await this.queryRaw(this.dialect.generateCardinalitySampleQuery(tableName, quotedColumn, options.sampleSize ?? 10000));
+        const cardinality = Number(cardinalityRows[0]?.cardinality);
+        if (Number.isNaN(cardinality)) {
+            return null;
+        }
+        if (cardinality === 0) {
+            return { values: [], cardinality: 0 };
+        }
+        if (cardinality > options.maxCardinality) {
+            return { values: null, cardinality };
+        }
+        const valuesRows = await this.queryRaw(this.dialect.generateDistinctValuesQuery(tableName, quotedColumn, options.limit));
+        return { values: valuesRows.filter((row) => row.val !== null).map((row) => String(row.val)), cardinality };
+    }
+    async getTableRowCount(tableName, schemaName = this.schemas[0] ?? 'dbo') {
+        const rows = await this.queryRaw(`
+      SELECT SUM(p.rows) AS row_count
+      FROM sys.tables t
+      INNER JOIN sys.partitions p ON t.object_id = p.object_id
+      INNER JOIN sys.schemas s ON t.schema_id = s.schema_id
+      WHERE s.name = @schemaName
+        AND t.name = @tableName
+        AND p.index_id IN (0, 1)
+      `, { schemaName, tableName });
+        return firstNumber(rows[0]?.row_count) ?? 0;
+    }
+    qTableName(table) {
+        return this.dialect.formatTableName(table);
+    }
+    quoteIdentifier(identifier) {
+        return this.dialect.quoteIdentifier(identifier);
+    }
+    async listSchemas() {
+        const rows = await this.queryRaw(`
+      SELECT s.name AS schema_name
+      FROM sys.schemas s
+      WHERE s.name NOT IN (
+        'INFORMATION_SCHEMA', 'sys', 'guest',
+        'db_owner', 'db_accessadmin', 'db_securityadmin', 'db_ddladmin',
+        'db_backupoperator', 'db_datareader', 'db_datawriter',
+        'db_denydatareader', 'db_denydatawriter'
+      )
+      ORDER BY s.name
+    `);
+        return rows.map((row) => row.schema_name);
+    }
+    async listTables(schemas) {
+        const filterSchemas = schemas ?? (await this.listSchemas());
+        if (filterSchemas.length === 0)
+            return [];
+        const params = {};
+        const placeholders = filterSchemas.map((s, i) => {
+            params[`schema${i}`] = s;
+            return `@schema${i}`;
+        });
+        const rows = await this.queryRaw(`
+      SELECT s.name AS schema_name, o.name AS table_name, o.type_desc AS table_type
+      FROM sys.objects o
+      JOIN sys.schemas s ON o.schema_id = s.schema_id
+      WHERE o.type IN ('U', 'V')
+        AND s.name IN (${placeholders.join(', ')})
+      ORDER BY s.name, o.name
+      `, params);
+        return rows.map((row) => ({
+            catalog: this.poolConfig.database,
+            schema: row.schema_name,
+            name: row.table_name,
+            kind: row.table_type === 'VIEW' ? 'view' : 'table',
+        }));
+    }
+    async cleanup() {
+        if (this.pool) {
+            await this.pool.close();
+            this.pool = null;
+        }
+        if (this.resolvedEndpoint?.close) {
+            await this.resolvedEndpoint.close();
+            this.resolvedEndpoint = null;
+        }
+    }
+    async introspectSchema(schemaName, scopedNames, snapshotWarnings) {
+        if (scopedNames && scopedNames.length === 0)
+            return [];
+        const tableScope = tableScopeSql(scopedNames, 'TABLE_NAME');
+        const tables = await this.queryRaw(`
+      SELECT TABLE_NAME AS table_name, TABLE_TYPE AS table_type
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = @schemaName
+        AND TABLE_TYPE IN ('BASE TABLE', 'VIEW')
+        ${tableScope.clause}
+      ORDER BY TABLE_NAME
+      `, { schemaName, ...tableScope.params });
+        const columns = await this.queryRaw(`
+      SELECT TABLE_NAME AS table_name, COLUMN_NAME AS column_name, DATA_TYPE AS data_type, IS_NULLABLE AS is_nullable
+      FROM INFORMATION_SCHEMA.COLUMNS
+      WHERE TABLE_SCHEMA = @schemaName
+        ${tableScope.clause}
+      ORDER BY TABLE_NAME, ORDINAL_POSITION
+      `, { schemaName, ...tableScope.params });
+        const tableComments = await this.tableComments(schemaName, scopedNames);
+        const columnComments = await this.columnComments(schemaName, scopedNames);
+        const primaryKeysResult = await tryConstraintQuery({ schema: schemaName, kind: 'primary_key', isDeniedError }, () => this.primaryKeys(schemaName, scopedNames));
+        const foreignKeysResult = await tryConstraintQuery({ schema: schemaName, kind: 'foreign_key', isDeniedError }, () => this.foreignKeys(schemaName, scopedNames));
+        const primaryKeys = primaryKeysResult.ok ? primaryKeysResult.value : new Map();
+        const foreignKeys = foreignKeysResult.ok ? foreignKeysResult.value : [];
+        if (!primaryKeysResult.ok) {
+            snapshotWarnings.push(primaryKeysResult.warning);
+        }
+        if (!foreignKeysResult.ok) {
+            snapshotWarnings.push(foreignKeysResult.warning);
+        }
+        const rowCounts = await this.rowCounts(schemaName, scopedNames);
+        const columnsByTable = groupByTable(columns);
+        const foreignKeysByTable = groupByTable(foreignKeys);
+        return tables.map((table) => ({
+            catalog: this.poolConfig.database,
+            db: schemaName,
+            name: table.table_name,
+            kind: table.table_type === 'VIEW' ? 'view' : 'table',
+            comment: tableComments.get(table.table_name) ?? null,
+            estimatedRows: table.table_type === 'VIEW' ? null : rowCounts.get(table.table_name) ?? 0,
+            columns: (columnsByTable.get(table.table_name) ?? []).map((column) => this.toSchemaColumn(column, primaryKeys.get(table.table_name) ?? new Set(), columnComments)),
+            foreignKeys: (foreignKeysByTable.get(table.table_name) ?? []).map((row) => this.toSchemaForeignKey(row)),
+        }));
+    }
+    async tableComments(schemaName, scopedNames) {
+        const tableScope = tableScopeSql(scopedNames, 'o.name');
+        const rows = await this.queryRaw(`
+      SELECT o.name AS table_name, CAST(ep.value AS NVARCHAR(MAX)) AS table_comment
+      FROM sys.objects o
+      INNER JOIN sys.schemas s ON o.schema_id = s.schema_id
+      INNER JOIN sys.extended_properties ep ON ep.major_id = o.object_id
+        AND ep.minor_id = 0
+        AND ep.name = 'MS_Description'
+      WHERE s.name = @schemaName
+        AND o.type IN ('U', 'V')
+        ${tableScope.clause}
+      `, { schemaName, ...tableScope.params });
+        return new Map(rows.map((row) => [row.table_name, row.table_comment]));
+    }
+    async columnComments(schemaName, scopedNames) {
+        const tableScope = tableScopeSql(scopedNames, 'o.name');
+        const rows = await this.queryRaw(`
+      SELECT o.name AS table_name, c.name AS column_name, CAST(ep.value AS NVARCHAR(MAX)) AS column_comment
+      FROM sys.columns c
+      INNER JOIN sys.objects o ON c.object_id = o.object_id
+      INNER JOIN sys.schemas s ON o.schema_id = s.schema_id
+      INNER JOIN sys.extended_properties ep ON ep.major_id = c.object_id
+        AND ep.minor_id = c.column_id
+        AND ep.name = 'MS_Description'
+      WHERE s.name = @schemaName
+        AND o.type IN ('U', 'V')
+        ${tableScope.clause}
+      `, { schemaName, ...tableScope.params });
+        return new Map(rows.map((row) => [`${row.table_name}.${row.column_name}`, row.column_comment]));
+    }
+    async primaryKeys(schemaName, scopedNames) {
+        const tableScope = tableScopeSql(scopedNames, 'tc.TABLE_NAME');
+        const rows = await this.queryRaw(`
+      SELECT tc.TABLE_NAME AS table_name, kcu.COLUMN_NAME AS column_name
+      FROM INFORMATION_SCHEMA.TABLE_CONSTRAINTS tc
+      JOIN INFORMATION_SCHEMA.KEY_COLUMN_USAGE kcu
+        ON tc.CONSTRAINT_NAME = kcu.CONSTRAINT_NAME
+        AND tc.TABLE_SCHEMA = kcu.TABLE_SCHEMA
+      WHERE tc.CONSTRAINT_TYPE = 'PRIMARY KEY'
+        AND tc.TABLE_SCHEMA = @schemaName
+        ${tableScope.clause}
+      ORDER BY tc.TABLE_NAME, kcu.ORDINAL_POSITION
+      `, { schemaName, ...tableScope.params });
+        const grouped = new Map();
+        for (const row of rows) {
+            const columns = grouped.get(row.table_name) ?? new Set();
+            columns.add(row.column_name);
+            grouped.set(row.table_name, columns);
+        }
+        return grouped;
+    }
+    async foreignKeys(schemaName, scopedNames) {
+        const tableScope = tableScopeSql(scopedNames, 'fk.TABLE_NAME');
+        return this.queryRaw(`
+      SELECT
+        fk.TABLE_NAME AS table_name,
+        fk.COLUMN_NAME AS column_name,
+        pk.TABLE_SCHEMA AS referenced_table_schema,
+        pk.TABLE_NAME AS referenced_table_name,
+        pk.COLUMN_NAME AS referenced_column_name,
+        fk.CONSTRAINT_NAME AS constraint_name
+      FROM INFORMATION_SCHEMA.REFERENTIAL_CONSTRAINTS rc
+      JOIN INFORMATION_SCHEMA.KEY_COLUMN_USAGE fk
+        ON fk.CONSTRAINT_CATALOG = rc.CONSTRAINT_CATALOG
+        AND fk.CONSTRAINT_SCHEMA = rc.CONSTRAINT_SCHEMA
+        AND fk.CONSTRAINT_NAME = rc.CONSTRAINT_NAME
+      JOIN INFORMATION_SCHEMA.KEY_COLUMN_USAGE pk
+        ON pk.CONSTRAINT_CATALOG = rc.UNIQUE_CONSTRAINT_CATALOG
+        AND pk.CONSTRAINT_SCHEMA = rc.UNIQUE_CONSTRAINT_SCHEMA
+        AND pk.CONSTRAINT_NAME = rc.UNIQUE_CONSTRAINT_NAME
+        AND pk.ORDINAL_POSITION = fk.ORDINAL_POSITION
+      WHERE fk.TABLE_SCHEMA = @schemaName
+        ${tableScope.clause}
+      ORDER BY fk.TABLE_NAME, fk.COLUMN_NAME
+      `, { schemaName, ...tableScope.params });
+    }
+    async rowCounts(schemaName, scopedNames) {
+        const tableScope = tableScopeSql(scopedNames, 't.name');
+        const rows = await this.queryRaw(`
+      SELECT t.name AS table_name, SUM(p.rows) AS row_count
+      FROM sys.tables t
+      INNER JOIN sys.partitions p ON t.object_id = p.object_id
+      INNER JOIN sys.schemas s ON t.schema_id = s.schema_id
+      WHERE s.name = @schemaName
+        AND p.index_id IN (0, 1)
+        ${tableScope.clause}
+      GROUP BY t.name
+      `, { schemaName, ...tableScope.params });
+        return new Map(rows.map((row) => [row.table_name, firstNumber(row.row_count) ?? 0]));
+    }
+    toSchemaColumn(column, primaryKeys, comments) {
+        return {
+            name: column.column_name,
+            nativeType: column.data_type,
+            normalizedType: this.dialect.mapDataType(column.data_type),
+            dimensionType: this.dialect.mapToDimensionType(column.data_type),
+            nullable: column.is_nullable === 'YES',
+            primaryKey: primaryKeys.has(column.column_name),
+            comment: comments.get(`${column.table_name}.${column.column_name}`) ?? null,
+        };
+    }
+    toSchemaForeignKey(row) {
+        return {
+            fromColumn: row.column_name,
+            toCatalog: this.poolConfig.database,
+            toDb: row.referenced_table_schema,
+            toTable: row.referenced_table_name,
+            toColumn: row.referenced_column_name,
+            constraintName: row.constraint_name || null,
+        };
+    }
+    async poolForQuery() {
+        if (!this.pool) {
+            const config = { ...this.poolConfig };
+            if (this.endpointResolver) {
+                this.resolvedEndpoint = await this.endpointResolver.resolve({
+                    host: config.server,
+                    port: config.port,
+                    connection: this.connection,
+                });
+                config.server = this.resolvedEndpoint.host;
+                config.port = this.resolvedEndpoint.port;
+            }
+            this.pool = await this.poolFactory.createPool(config);
+        }
+        return this.pool;
+    }
+    async queryRaw(query, params) {
+        const pool = await this.poolForQuery();
+        const request = pool.request();
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                request.input(key, value);
+            }
+        }
+        const result = await request.query(query);
+        return (result.recordset ?? []);
+    }
+    async query(query, params) {
+        const pool = await this.poolForQuery();
+        const request = pool.request();
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                request.input(key, value);
+            }
+        }
+        const result = await request.query(assertReadOnlySql(query));
+        const recordset = result.recordset ?? [];
+        const columnMetadata = recordset.columns ?? {};
+        const metadataHeaders = Object.keys(columnMetadata);
+        const headers = metadataHeaders.length > 0 ? metadataHeaders : Object.keys(recordset[0] ?? {});
+        const headerTypes = headers.map((header) => columnMetadata[header]?.type?.declaration ?? 'unknown');
+        return {
+            headers,
+            headerTypes,
+            rows: recordset.map((row) => headers.map((header) => row[header])),
+            totalRows: recordset.length,
+        };
+    }
+    assertConnection(connectionId) {
+        if (connectionId !== this.connectionId) {
+            throw new Error(`KTX SQL Server connector ${this.id} cannot serve connection ${connectionId}`);
+        }
+    }
+}

package/dist/connectors/sqlserver/dialect.d.ts

@@ -0,0 +1,31 @@
+import type { KtxDialect } from '../../context/connections/dialects.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
+type SqlServerTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
+/** @internal */
+export declare class KtxSqlServerDialect implements KtxDialect {
+    readonly type: "sqlserver";
+    private readonly typeMappings;
+    quoteIdentifier(identifier: string): string;
+    formatTableName(table: SqlServerTableNameRef): string;
+    formatDisplayRef(table: SqlServerTableNameRef): string;
+    parseDisplayRef(display: string): KtxTableRef | null;
+    columnDisplayTablePartCount(): 1 | 2 | 3;
+    mapDataType(nativeType: string): string;
+    mapToDimensionType(nativeType: string): KtxSchemaDimensionType;
+    generateSampleQuery(tableName: string, limit: number, columns?: string[]): string;
+    generateColumnSampleQuery(tableName: string, columnName: string, limit: number): string;
+    getRandomSampleFilter(samplePct: number): string;
+    getTableSampleClause(samplePct: number): string;
+    getLimitOffsetClause(_limit: number, _offset?: number): string;
+    getTopClause(limit: number): string;
+    getNullCountExpression(column: string): string;
+    getDistinctCountExpression(column: string): string;
+    textLengthExpression(columnSql: string): string;
+    castToText(columnSql: string): string;
+    getSampleValueAggregation(innerSql: string): string;
+    generateCardinalitySampleQuery(tableName: string, columnName: string, sampleSize: number): string;
+    generateDistinctValuesQuery(tableName: string, columnName: string, limit: number): string;
+    generateColumnStatisticsQuery(_schemaName: string, _tableName: string): string | null;
+    generateRandomizedCardinalitySampleQuery(tableName: string, columnName: string, sampleSize: number): string;
+}
+export {};