UNPKG

typeorm

Version:

Data-Mapper ORM for TypeScript, ES7, ES6, ES5. Supports MySQL, PostgreSQL, MariaDB, SQLite, MS SQL Server, Oracle, WebSQL, MongoDB databases.

153 lines (152 loc) 5.14 kB
import { Driver } from "../Driver"; import { ObjectLiteral } from "../../common/ObjectLiteral"; import { ColumnMetadata } from "../../metadata/ColumnMetadata"; import { Connection } from "../../connection/Connection"; import { RdbmsSchemaBuilder } from "../../schema-builder/RdbmsSchemaBuilder"; import { MappedColumnTypes } from "../types/MappedColumnTypes"; import { ColumnType } from "../types/ColumnTypes"; import { QueryRunner } from "../../query-runner/QueryRunner"; import { DataTypeDefaults } from "../types/DataTypeDefaults"; import { TableColumn } from "../../schema-builder/schema/TableColumn"; import { BaseConnectionOptions } from "../../connection/BaseConnectionOptions"; /** * Organizes communication with sqlite DBMS. */ export declare class AbstractSqliteDriver implements Driver { /** * Connection used by driver. */ connection: Connection; /** * Sqlite has a single QueryRunner because it works on a single database connection. */ queryRunner?: QueryRunner; /** * Real database connection with sqlite database. */ databaseConnection: any; /** * Connection options. */ options: BaseConnectionOptions; /** * Master database used to perform all write queries. */ database?: string; /** * Indicates if replication is enabled. */ isReplicated: boolean; /** * SQLite underlying library. */ sqlite: any; /** * Indicates if tree tables are supported by this driver. */ treeSupport: boolean; /** * Gets list of supported column data types by a driver. * * @see https://www.tutorialspoint.com/sqlite/sqlite_data_types.htm * @see https://sqlite.org/datatype3.html */ supportedDataTypes: ColumnType[]; /** * Gets list of column data types that support length by a driver. */ withLengthColumnTypes: ColumnType[]; /** * Orm has special columns and we need to know what database column types should be for those types. * Column types are driver dependant. */ mappedDataTypes: MappedColumnTypes; /** * Default values of length, precision and scale depends on column data type. * Used in the cases when length/precision/scale is not specified by user. */ dataTypeDefaults: DataTypeDefaults; constructor(connection: Connection); /** * Performs connection to the database. */ connect(): Promise<void>; /** * Makes any action after connection (e.g. create extensions in Postgres driver). */ afterConnect(): Promise<void>; /** * Closes connection with database. */ disconnect(): Promise<void>; /** * Creates a schema builder used to build and sync a schema. */ createSchemaBuilder(): RdbmsSchemaBuilder; /** * Creates a query runner used to execute database queries. */ createQueryRunner(mode?: "master" | "slave"): QueryRunner; /** * Prepares given value to a value to be persisted, based on its column type and metadata. */ preparePersistentValue(value: any, columnMetadata: ColumnMetadata): any; /** * Prepares given value to a value to be hydrated, based on its column type or metadata. */ prepareHydratedValue(value: any, columnMetadata: ColumnMetadata): any; /** * Replaces parameters in the given sql with special escaping character * and an array of parameter names to be passed to a query. */ escapeQueryWithParameters(sql: string, parameters: ObjectLiteral): [string, any[]]; /** * Escapes a column name. */ escape(columnName: string): string; /** * Creates a database type from a given column metadata. */ normalizeType(column: { type?: ColumnType; length?: number | string; precision?: number; scale?: number; }): string; /** * Normalizes "default" value of the column. */ normalizeDefault(column: ColumnMetadata): string; /** * Normalizes "isUnique" value of the column. */ normalizeIsUnique(column: ColumnMetadata): boolean; /** * Calculates column length taking into account the default length values. */ getColumnLength(column: ColumnMetadata): string; /** * Normalizes "default" value of the column. */ createFullType(column: TableColumn): string; /** * Obtains a new database connection to a master server. * Used for replication. * If replication is not setup then returns default connection's database connection. */ obtainMasterConnection(): Promise<any>; /** * Obtains a new database connection to a slave server. * Used for replication. * If replication is not setup then returns master (default) connection's database connection. */ obtainSlaveConnection(): Promise<any>; /** * Creates connection with the database. */ protected createDatabaseConnection(): void; /** * If driver dependency is not given explicitly, then try to load it via "require". */ protected loadDependencies(): void; }