Driver Sql
Driver Sql protocol schemas
SQL Dialect Enumeration
Supported SQL database dialects
Source: packages/spec/src/data/driver-sql.zod.ts
TypeScript Usage
import { DataTypeMapping, SQLDialect, SQLDriverConfig, SSLConfig } from '@objectstack/spec/data';
import type { DataTypeMapping, SQLDialect, SQLDriverConfig, SSLConfig } from '@objectstack/spec/data';
// Validate data
const result = DataTypeMapping.parse(data);DataTypeMapping
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| text | string | ✅ | SQL type for text fields (e.g., VARCHAR, TEXT) |
| number | string | ✅ | SQL type for number fields (e.g., NUMERIC, DECIMAL, INT) |
| boolean | string | ✅ | SQL type for boolean fields (e.g., BOOLEAN, BIT) |
| date | string | ✅ | SQL type for date fields (e.g., DATE) |
| datetime | string | ✅ | SQL type for datetime fields (e.g., TIMESTAMP, DATETIME) |
| json | string | optional | SQL type for JSON fields (e.g., JSON, JSONB) |
| uuid | string | optional | SQL type for UUID fields (e.g., UUID, CHAR(36)) |
| binary | string | optional | SQL type for binary fields (e.g., BLOB, BYTEA) |
SQLDialect
Allowed Values
postgresqlmysqlsqlitemssqloraclemariadb
SQLDriverConfig
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| name | string | ✅ | Driver instance name |
| type | string | ✅ | Driver type must be "sql" |
| capabilities | Object | ✅ | Driver capability flags |
| connectionString | string | optional | Database connection string (driver-specific format) |
| poolConfig | Object | optional | Connection pool configuration |
| dialect | Enum<'postgresql' | 'mysql' | 'sqlite' | 'mssql' | 'oracle' | 'mariadb'> | ✅ | SQL database dialect |
| dataTypeMapping | Object | ✅ | SQL data type mapping configuration |
| ssl | boolean | ✅ | Enable SSL/TLS connection |
| sslConfig | Object | optional | SSL/TLS configuration (required when ssl is true) |
SSLConfig
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| rejectUnauthorized | boolean | ✅ | Reject connections with invalid certificates |
| ca | string | optional | CA certificate file path or content |
| cert | string | optional | Client certificate file path or content |
| key | string | optional | Client private key file path or content |