@adonisjs/lucid
Version:
SQL ORM built on top of Active Record pattern
202 lines (201 loc) • 7.02 kB
JavaScript
/*
* @adonisjs/lucid
*
* (c) Harminder Virk <virk@adonisjs.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
export class PgDialect {
client;
config;
name = 'postgres';
supportsAdvisoryLocks = true;
supportsViews = true;
supportsTypes = true;
supportsDomains = true;
supportsReturningStatement = true;
/**
* Reference to the database version. Knex.js fetches the version after
* the first database query, so it will be set to undefined initially
*/
version;
/**
* The default format for datetime column. The date formats is
* valid for luxon date parsing library
*/
dateTimeFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSZZ";
constructor(client, config) {
this.client = client;
this.config = config;
this.version = this.client.getReadClient()['context']['client'].version;
}
/**
* Returns a filter function to omit tables, views and
* types from the excludeList
*/
#omitFromExcludeList(excludeList) {
if (!excludeList) {
return () => true;
}
return ({ name, schema }) => {
return !(excludeList.includes(`${schema}.${name}`) || excludeList.includes(name));
};
}
#compileGetAllTables(schemas) {
return this.client
.query()
.from('pg_catalog.pg_tables')
.select(['tablename as name', 'schemaname as schema'])
.whereNotIn('schemaname', ['pg_catalog', 'information_schema'])
.whereIn('schemaname', schemas)
.orderBy('tablename', 'asc');
}
/**
* Returns an array of table names for one or many schemas.
*/
async getAllTables(schemas) {
const tables = await this.#compileGetAllTables(schemas);
return tables.map(({ name }) => name);
}
/**
* Returns an array of all views names for one or many schemas
*/
async getAllViews(schemas) {
const views = await this.client
.query()
.from('pg_catalog.pg_views')
.select('viewname as view_name')
.whereIn('schemaname', schemas)
.orderBy('viewname', 'asc');
return views.map(({ view_name }) => view_name);
}
/**
* Returns an array of all types names
*/
async getAllTypes(_schemas) {
const types = await this.client
.query()
.select('pg_type.typname')
.distinct()
.from('pg_type')
.innerJoin('pg_enum', 'pg_enum.enumtypid', 'pg_type.oid');
return types.map(({ typname }) => typname);
}
/**
* Returns an array of all domain names
*/
async getAllDomains(_schemas) {
const domains = await this.client
.query()
.select('pg_type.typname')
.distinct()
.from('pg_type')
.innerJoin('pg_namespace', 'pg_namespace.oid', 'pg_type.typnamespace')
.where('pg_type.typtype', 'd');
return domains.map(({ typname }) => typname);
}
/**
* Truncate pg table with option to cascade and restart identity
*/
async truncate(table, cascade = false) {
return cascade
? this.client.rawQuery(`TRUNCATE "${table}" RESTART IDENTITY CASCADE;`)
: this.client.rawQuery(`TRUNCATE "${table}";`);
}
async truncateAllTables(excludeTables, schemas) {
/**
* When truncating tables, we only truncate them from the explicitly
* provided searchPaths or from the public schema
*/
const searchPath = schemas ?? ['public'];
const tables = await this.#compileGetAllTables(searchPath);
const knex = this.client.getWriteClient();
/**
* Collecting the tables to be dropped. We ignore tables from the exclude
* tables list.
*/
const tablesToTrunacte = tables
.filter(this.#omitFromExcludeList(excludeTables))
.map((table) => knex.ref(`${table.schema}.${table.name}`).toSQL().sql);
if (tablesToTrunacte.length) {
const trx = await knex.transaction();
try {
await trx.schema.raw('SET CONSTRAINTS ALL DEFERRED;');
await trx.schema.raw(`TRUNCATE ${tablesToTrunacte.join(',')};`);
await trx.schema.raw('SET CONSTRAINTS ALL IMMEDIATE;');
await trx.commit();
}
catch (error) {
await trx.rollback();
throw error;
}
}
}
/**
* Drop all tables inside the database
*/
async dropAllTables(schemas) {
let tables = await this.getAllTables(schemas);
/**
* Filter out tables that are not allowed to be dropped
*/
tables = tables.filter((table) => !(this.config.wipe?.ignoreTables || ['spatial_ref_sys']).includes(table));
if (!tables.length) {
return;
}
await this.client.rawQuery(`DROP TABLE "${tables.join('", "')}" CASCADE;`);
}
/**
* Drop all views inside the database
*/
async dropAllViews(schemas) {
const views = await this.getAllViews(schemas);
if (!views.length)
return;
await this.client.rawQuery(`DROP VIEW "${views.join('", "')}" CASCADE;`);
}
/**
* Drop all types inside the database
*/
async dropAllTypes(schemas) {
const types = await this.getAllTypes(schemas);
if (!types.length)
return;
await this.client.rawQuery(`DROP TYPE "${types.join('", "')}" CASCADE;`);
}
/**
* Drop all domains inside the database
*/
async dropAllDomains(schemas) {
const domains = await this.getAllDomains(schemas);
if (!domains.length)
return;
// Don't drop built-in domains
// https://www.postgresql.org/docs/current/infoschema-datatypes.html
const builtInDomains = [
'cardinal_number',
'character_data',
'sql_identifier',
'time_stamp',
'yes_or_no',
];
const domainsToDrop = domains.filter((domain) => !builtInDomains.includes(domain));
await this.client.rawQuery(`DROP DOMAIN "${domainsToDrop.join('", "')}" CASCADE;`);
}
/**
* Attempts to add advisory lock to the database and
* returns it's status.
*/
async getAdvisoryLock(key) {
const response = await this.client.rawQuery(`SELECT PG_TRY_ADVISORY_LOCK('${key}') as lock_status;`);
return response.rows[0] && response.rows[0].lock_status === true;
}
/**
* Releases the advisory lock
*/
async releaseAdvisoryLock(key) {
const response = await this.client.rawQuery(`SELECT PG_ADVISORY_UNLOCK('${key}') as lock_status;`);
return response.rows[0] && response.rows[0].lock_status === true;
}
}