Creating .fromRaw API & its tests

lib/query/method-constants.js

@@ -8,6 +8,7 @@ module.exports = [
   'columns',
   'column',
   'from',
+  'fromRaw',
   'fromJS',
   'into',
   'withSchema',

lib/query/querybuilder.js

@@ -203,6 +203,17 @@ class Builder extends EventEmitter {
     return this;
   }
 
+  fromRaw(sql, bindings) {
+    //Verify if is rawInstance
+    const raw = sql.isRawInstance ? sql : this.client.raw(sql, bindings);
+
+    //Add wrapper to fromRaw function
+    const wrappedRaw = raw.wrap('(', ')');
+
+    this._single.table = wrappedRaw;
+    return this;
+  }
+
   // Adds a `distinct` clause to the query.
   distinct(...args) {
     this._statements.push({

test/unit/query/builder.js

@@ -835,6 +835,54 @@ describe('QueryBuilder', () => {
     );
   });
 
+  it('uses fromRaw api, #1767', () => {
+    testsql(qb().select('*').fromRaw('select * from users where age > 18'), {
+      mysql: 'select * from (select * from users where age > 18)',
+      mssql: 'select * from (select * from users where age > 18)',
+      pg: 'select * from (select * from users where age > 18)',
+      'pg-redshift': 'select * from (select * from users where age > 18)',
+    });
+  });
+
+  it('uses fromRaw api with a query function, #1767', () => {
+    const subquery = qb()
+      .select(raw('? as f', ['inner raw select']))
+      .as('g');
+    testsql(
+      qb()
+        .select(raw('?', ['outer raw select']), 'g.f')
+        .from(subquery)
+        .where('g.secret', 123),
+      {
+        mysql: {
+          sql:
+            'select ?, `g`.`f` from (select ? as f) as `g` where `g`.`secret` = ?',
+          bindings: ['outer raw select', 'inner raw select', 123],
+        },
+        mssql: {
+          sql:
+            'select ?, [g].[f] from (select ? as f) as [g] where [g].[secret] = ?',
+          bindings: ['outer raw select', 'inner raw select', 123],
+        },
+        oracledb: {
+          sql:
+            'select ?, "g"."f" from (select ? as f) "g" where "g"."secret" = ?',
+          bindings: ['outer raw select', 'inner raw select', 123],
+        },
+        pg: {
+          sql:
+            'select ?, "g"."f" from (select ? as f) as "g" where "g"."secret" = ?',
+          bindings: ['outer raw select', 'inner raw select', 123],
+        },
+        'pg-redshift': {
+          sql:
+            'select ?, "g"."f" from (select ? as f) as "g" where "g"."secret" = ?',
+          bindings: ['outer raw select', 'inner raw select', 123],
+        },
+      }
+    );
+  });
+
   it('basic wheres', () => {
     testsql(qb().select('*').from('users').where('id', '=', 1), {
       mysql: {

types/index.d.ts

@@ -496,6 +496,7 @@ export declare namespace Knex {
     column: Select<TRecord, TResult>;
     hintComment: HintComment<TRecord, TResult>;
     from: Table<TRecord, TResult>;
+    fromRaw: Table<TRecord, TResult>;
     into: Table<TRecord, TResult>;
     table: Table<TRecord, TResult>;
     distinct: Distinct<TRecord, TResult>;