Skip to main content
Version: 7.0

abstractDatabaseDriver <C>

Abstract base class for all database drivers, implementing common driver logic.

Hierarchy

Implements

Index

Properties

Methods

Properties

[EntityManagerType]

[EntityManagerType]: EntityManager<DatabaseDriver<C>>

readonlyconfig

config: Configuration<IDatabaseDriver<Connection>, EntityManager<IDatabaseDriver<Connection>>>

Methods

aggregate

  • aggregate(entityName, pipeline): Promise<any[]>

  • Executes a MongoDB aggregation pipeline (MongoDB driver only).

    Parameters

    Returns Promise<any[]>

close

  • close(force): Promise<void>

  • Closes the primary connection and all read replicas.

    Parameters

    • optionalforce: boolean

    Returns Promise<void>

connect

  • connect(options): Promise<C>

  • Opens the primary connection and all read replicas.

    Parameters

    • optionaloptions: { skipOnConnect?: boolean }
      • optionalskipOnConnect: boolean

    Returns Promise<C>

convertException

  • Converts native db errors to standardized driver exceptions

    Parameters

    • exception: Error

    Returns DriverException

abstractcount

  • count<T, P>(entityName, where, options): Promise<number>

  • Counts entities matching the given condition.

    Parameters

    Returns Promise<number>

countVirtual

  • countVirtual<T>(entityName, where, options): Promise<number>

createEntityManager

  • Creates a new EntityManager instance bound to this driver.

    Parameters

    • optionaluseContext: boolean

    Returns EntityManager<DatabaseDriver<C>>

abstractfind

  • find<T, P, F, E>(entityName, where, options): Promise<EntityData<T>[]>

abstractfindOne

  • findOne<T, P, F, E>(entityName, where, options): Promise<null | EntityData<T>>

findVirtual

  • findVirtual<T>(entityName, where, options): Promise<EntityData<T>[]>

  • Finds entities backed by a virtual (expression-based) definition.

    Parameters

    Returns Promise<EntityData<T>[]>

getConnection

  • getConnection(type): C

  • Returns the write connection or a random read replica.

    Parameters

    Returns C

getDependencies

  • getDependencies(): string[]

  • Returns the names of native database dependencies required by this driver.

    Returns string[]

getMetadata

  • Returns the metadata storage used by this driver.

    Returns MetadataStorage

getPlatform

  • Returns the database platform abstraction for this driver.

    Returns Platform

loadFromPivotTable

  • loadFromPivotTable<T, O>(prop, owners, where, orderBy, ctx, options, pivotJoin): Promise<Dictionary<T[]>>

  • When driver uses pivot tables for M:N, this method will load identifiers for given collections from them

    Parameters

    • prop: EntityProperty<any, any>
    • owners: (O extends { [PrimaryKeyProp]?: PK } ? PK extends undefined ? Omit<O<O>, typeof PrimaryKeyProp> : PK extends keyof O<O> ? ReadonlyPrimary<UnwrapPrimary<O<O>[PK<PK>]>> : PK extends keyof O<O>[] ? ReadonlyPrimary<PrimaryPropToType<O<O>, PK<PK>>> : PK : O extends { _id?: PK } ? string | ReadonlyPrimary<PK> : O extends { id?: PK } ? ReadonlyPrimary<PK> : O extends { uuid?: PK } ? ReadonlyPrimary<PK> : O)[][]
    • optionalwhere: any
    • optionalorderBy: OrderDefinition<T>
    • optionalctx: any
    • optionaloptions: FindOptions<T, any, any, any>
    • optionalpivotJoin: boolean

    Returns Promise<Dictionary<T[]>>

lockPessimistic

  • lockPessimistic<T>(entity, options): Promise<void>

  • Acquires a pessimistic lock on the given entity.

    Parameters

    Returns Promise<void>

mapResult

  • mapResult<T>(result, meta, populate): null | EntityData<T>

abstractnativeDelete

  • nativeDelete<T>(entityName, where, options): Promise<QueryResult<T>>

abstractnativeInsert

  • nativeInsert<T>(entityName, data, options): Promise<QueryResult<T>>

abstractnativeInsertMany

  • nativeInsertMany<T>(entityName, data, options, transform): Promise<QueryResult<T>>

abstractnativeUpdate

  • nativeUpdate<T>(entityName, where, data, options): Promise<QueryResult<T>>

nativeUpdateMany

  • nativeUpdateMany<T>(entityName, where, data, options): Promise<QueryResult<T>>

reconnect

  • reconnect(options): Promise<C>

  • Closes all connections and re-establishes them.

    Parameters

    • optionaloptions: { skipOnConnect?: boolean }
      • optionalskipOnConnect: boolean

    Returns Promise<C>

setMetadata

  • setMetadata(metadata): void

  • Sets the metadata storage and initializes the comparator for all connections.

    Parameters

    Returns void

abstractstream

  • stream<T>(entityName, where, options): AsyncIterableIterator<T, any, any>

  • Returns an async iterator that streams query results one entity at a time.

    Parameters

    Returns AsyncIterableIterator<T, any, any>

syncCollections

  • syncCollections<T, O>(collections, options): Promise<void>

  • Persists changes to M:N collections (inserts/deletes pivot table rows).

    Parameters

    Returns Promise<void>

Page Options