knex 2.5.0 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (167) hide show
  1. package/CHANGELOG.md +64 -58
  2. package/CONTRIBUTING.md +194 -194
  3. package/README.md +149 -147
  4. package/UPGRADING.md +245 -233
  5. package/bin/cli.js +475 -473
  6. package/bin/utils/cli-config-utils.js +212 -210
  7. package/bin/utils/constants.js +7 -7
  8. package/bin/utils/migrationsLister.js +37 -37
  9. package/knex.js +23 -23
  10. package/knex.mjs +11 -11
  11. package/lib/builder-interface-augmenter.js +120 -120
  12. package/lib/client.js +495 -495
  13. package/lib/constants.js +61 -61
  14. package/lib/dialects/better-sqlite3/index.js +77 -77
  15. package/lib/dialects/cockroachdb/crdb-columncompiler.js +14 -14
  16. package/lib/dialects/cockroachdb/crdb-querybuilder.js +11 -11
  17. package/lib/dialects/cockroachdb/crdb-querycompiler.js +122 -122
  18. package/lib/dialects/cockroachdb/crdb-tablecompiler.js +37 -37
  19. package/lib/dialects/cockroachdb/crdb-viewcompiler.js +15 -15
  20. package/lib/dialects/cockroachdb/index.js +86 -86
  21. package/lib/dialects/index.js +20 -20
  22. package/lib/dialects/mssql/index.js +500 -500
  23. package/lib/dialects/mssql/mssql-formatter.js +34 -34
  24. package/lib/dialects/mssql/query/mssql-querycompiler.js +601 -601
  25. package/lib/dialects/mssql/schema/mssql-columncompiler.js +185 -185
  26. package/lib/dialects/mssql/schema/mssql-compiler.js +91 -91
  27. package/lib/dialects/mssql/schema/mssql-tablecompiler.js +378 -378
  28. package/lib/dialects/mssql/schema/mssql-viewcompiler.js +55 -55
  29. package/lib/dialects/mssql/transaction.js +176 -176
  30. package/lib/dialects/mysql/index.js +201 -201
  31. package/lib/dialects/mysql/query/mysql-querycompiler.js +274 -274
  32. package/lib/dialects/mysql/schema/mysql-columncompiler.js +193 -193
  33. package/lib/dialects/mysql/schema/mysql-compiler.js +60 -60
  34. package/lib/dialects/mysql/schema/mysql-tablecompiler.js +381 -381
  35. package/lib/dialects/mysql/schema/mysql-viewbuilder.js +21 -21
  36. package/lib/dialects/mysql/schema/mysql-viewcompiler.js +15 -15
  37. package/lib/dialects/mysql/transaction.js +46 -46
  38. package/lib/dialects/mysql2/index.js +53 -53
  39. package/lib/dialects/mysql2/transaction.js +44 -44
  40. package/lib/dialects/oracle/DEAD_CODE.md +5 -5
  41. package/lib/dialects/oracle/index.js +92 -92
  42. package/lib/dialects/oracle/query/oracle-querycompiler.js +343 -343
  43. package/lib/dialects/oracle/schema/internal/incrementUtils.js +20 -20
  44. package/lib/dialects/oracle/schema/internal/trigger.js +135 -135
  45. package/lib/dialects/oracle/schema/oracle-columnbuilder.js +17 -17
  46. package/lib/dialects/oracle/schema/oracle-columncompiler.js +126 -126
  47. package/lib/dialects/oracle/schema/oracle-compiler.js +122 -122
  48. package/lib/dialects/oracle/schema/oracle-tablecompiler.js +190 -190
  49. package/lib/dialects/oracle/utils.js +87 -87
  50. package/lib/dialects/oracledb/index.js +327 -327
  51. package/lib/dialects/oracledb/query/oracledb-querycompiler.js +481 -481
  52. package/lib/dialects/oracledb/schema/oracledb-columncompiler.js +61 -61
  53. package/lib/dialects/oracledb/schema/oracledb-tablecompiler.js +19 -19
  54. package/lib/dialects/oracledb/schema/oracledb-viewbuilder.js +13 -13
  55. package/lib/dialects/oracledb/schema/oracledb-viewcompiler.js +19 -19
  56. package/lib/dialects/oracledb/transaction.js +98 -98
  57. package/lib/dialects/oracledb/utils.js +208 -208
  58. package/lib/dialects/pgnative/index.js +60 -60
  59. package/lib/dialects/postgres/execution/pg-transaction.js +19 -19
  60. package/lib/dialects/postgres/index.js +358 -358
  61. package/lib/dialects/postgres/query/pg-querybuilder.js +43 -43
  62. package/lib/dialects/postgres/query/pg-querycompiler.js +400 -400
  63. package/lib/dialects/postgres/schema/pg-columncompiler.js +156 -156
  64. package/lib/dialects/postgres/schema/pg-compiler.js +138 -138
  65. package/lib/dialects/postgres/schema/pg-tablecompiler.js +304 -304
  66. package/lib/dialects/postgres/schema/pg-viewbuilder.js +21 -21
  67. package/lib/dialects/postgres/schema/pg-viewcompiler.js +35 -35
  68. package/lib/dialects/redshift/index.js +86 -86
  69. package/lib/dialects/redshift/query/redshift-querycompiler.js +163 -163
  70. package/lib/dialects/redshift/schema/redshift-columnbuilder.js +22 -22
  71. package/lib/dialects/redshift/schema/redshift-columncompiler.js +67 -67
  72. package/lib/dialects/redshift/schema/redshift-compiler.js +14 -14
  73. package/lib/dialects/redshift/schema/redshift-tablecompiler.js +122 -122
  74. package/lib/dialects/redshift/schema/redshift-viewcompiler.js +11 -11
  75. package/lib/dialects/redshift/transaction.js +32 -32
  76. package/lib/dialects/sqlite3/execution/sqlite-transaction.js +25 -25
  77. package/lib/dialects/sqlite3/index.js +250 -250
  78. package/lib/dialects/sqlite3/query/sqlite-querybuilder.js +33 -33
  79. package/lib/dialects/sqlite3/query/sqlite-querycompiler.js +334 -334
  80. package/lib/dialects/sqlite3/schema/ddl.js +400 -400
  81. package/lib/dialects/sqlite3/schema/internal/compiler.js +327 -327
  82. package/lib/dialects/sqlite3/schema/internal/parser-combinator.js +161 -161
  83. package/lib/dialects/sqlite3/schema/internal/parser.js +638 -638
  84. package/lib/dialects/sqlite3/schema/internal/sqlite-ddl-operations.js +41 -41
  85. package/lib/dialects/sqlite3/schema/internal/tokenizer.js +38 -38
  86. package/lib/dialects/sqlite3/schema/internal/utils.js +12 -12
  87. package/lib/dialects/sqlite3/schema/sqlite-columncompiler.js +50 -50
  88. package/lib/dialects/sqlite3/schema/sqlite-compiler.js +80 -80
  89. package/lib/dialects/sqlite3/schema/sqlite-tablecompiler.js +347 -347
  90. package/lib/dialects/sqlite3/schema/sqlite-viewcompiler.js +40 -40
  91. package/lib/execution/batch-insert.js +51 -51
  92. package/lib/execution/internal/delay.js +6 -6
  93. package/lib/execution/internal/ensure-connection-callback.js +41 -41
  94. package/lib/execution/internal/query-executioner.js +62 -62
  95. package/lib/execution/runner.js +325 -325
  96. package/lib/execution/transaction.js +409 -409
  97. package/lib/formatter/formatterUtils.js +42 -42
  98. package/lib/formatter/rawFormatter.js +84 -84
  99. package/lib/formatter/wrappingFormatter.js +250 -250
  100. package/lib/formatter.js +25 -25
  101. package/lib/index.js +3 -3
  102. package/lib/knex-builder/FunctionHelper.js +80 -80
  103. package/lib/knex-builder/Knex.js +59 -59
  104. package/lib/knex-builder/internal/config-resolver.js +57 -57
  105. package/lib/knex-builder/internal/parse-connection.js +87 -87
  106. package/lib/knex-builder/make-knex.js +345 -345
  107. package/lib/logger.js +76 -76
  108. package/lib/migrations/common/MigrationsLoader.js +36 -36
  109. package/lib/migrations/migrate/MigrationGenerator.js +84 -84
  110. package/lib/migrations/migrate/Migrator.js +598 -598
  111. package/lib/migrations/migrate/migrate-stub.js +17 -17
  112. package/lib/migrations/migrate/migration-list-resolver.js +33 -33
  113. package/lib/migrations/migrate/migrator-configuration-merger.js +58 -58
  114. package/lib/migrations/migrate/sources/fs-migrations.js +74 -74
  115. package/lib/migrations/migrate/table-creator.js +77 -77
  116. package/lib/migrations/migrate/table-resolver.js +27 -27
  117. package/lib/migrations/seed/Seeder.js +137 -137
  118. package/lib/migrations/seed/seed-stub.js +13 -13
  119. package/lib/migrations/seed/seeder-configuration-merger.js +60 -60
  120. package/lib/migrations/seed/sources/fs-seeds.js +65 -65
  121. package/lib/migrations/util/fs.js +86 -86
  122. package/lib/migrations/util/import-file.js +12 -12
  123. package/lib/migrations/util/is-module-type.js +9 -9
  124. package/lib/migrations/util/template.js +52 -52
  125. package/lib/migrations/util/timestamp.js +14 -14
  126. package/lib/query/analytic.js +52 -52
  127. package/lib/query/constants.js +15 -15
  128. package/lib/query/joinclause.js +270 -270
  129. package/lib/query/method-constants.js +136 -136
  130. package/lib/query/querybuilder.js +1793 -1793
  131. package/lib/query/querycompiler.js +1591 -1591
  132. package/lib/raw.js +139 -139
  133. package/lib/ref.js +39 -39
  134. package/lib/schema/builder.js +115 -115
  135. package/lib/schema/columnbuilder.js +146 -146
  136. package/lib/schema/columncompiler.js +307 -307
  137. package/lib/schema/compiler.js +187 -187
  138. package/lib/schema/internal/helpers.js +55 -55
  139. package/lib/schema/tablebuilder.js +376 -376
  140. package/lib/schema/tablecompiler.js +433 -433
  141. package/lib/schema/viewbuilder.js +92 -92
  142. package/lib/schema/viewcompiler.js +138 -138
  143. package/lib/util/finally-mixin.js +13 -13
  144. package/lib/util/helpers.js +95 -95
  145. package/lib/util/is.js +32 -32
  146. package/lib/util/nanoid.js +40 -40
  147. package/lib/util/noop.js +1 -1
  148. package/lib/util/save-async-stack.js +14 -14
  149. package/lib/util/security.js +26 -26
  150. package/lib/util/string.js +190 -190
  151. package/lib/util/timeout.js +29 -29
  152. package/package.json +11 -10
  153. package/scripts/build.js +125 -125
  154. package/scripts/clean.js +31 -31
  155. package/scripts/docker-compose.yml +152 -152
  156. package/scripts/next-release-howto.md +24 -24
  157. package/scripts/release.sh +2 -0
  158. package/scripts/runkit-example.js +35 -34
  159. package/scripts/stress-test/docker-compose.yml +57 -57
  160. package/scripts/stress-test/knex-stress-test.js +212 -208
  161. package/scripts/stress-test/mysql2-random-hanging-every-now-and-then.js +149 -145
  162. package/scripts/stress-test/mysql2-sudden-exit-without-error.js +101 -100
  163. package/scripts/stress-test/reconnect-test-mysql-based-drivers.js +188 -184
  164. package/scripts/update_gitignore_for_tsc_output.js +90 -90
  165. package/types/index.d.ts +3274 -3273
  166. package/types/result.d.ts +27 -27
  167. package/types/tables.d.ts +4 -4
@@ -1,21 +1,21 @@
1
- const ViewBuilder = require('../../../schema/viewbuilder.js');
2
-
3
- class ViewBuilder_MySQL extends ViewBuilder {
4
- constructor() {
5
- super(...arguments);
6
- }
7
-
8
- checkOption() {
9
- this._single.checkOption = 'default_option';
10
- }
11
-
12
- localCheckOption() {
13
- this._single.checkOption = 'local';
14
- }
15
-
16
- cascadedCheckOption() {
17
- this._single.checkOption = 'cascaded';
18
- }
19
- }
20
-
21
- module.exports = ViewBuilder_MySQL;
1
+ const ViewBuilder = require('../../../schema/viewbuilder.js');
2
+
3
+ class ViewBuilder_MySQL extends ViewBuilder {
4
+ constructor() {
5
+ super(...arguments);
6
+ }
7
+
8
+ checkOption() {
9
+ this._single.checkOption = 'default_option';
10
+ }
11
+
12
+ localCheckOption() {
13
+ this._single.checkOption = 'local';
14
+ }
15
+
16
+ cascadedCheckOption() {
17
+ this._single.checkOption = 'cascaded';
18
+ }
19
+ }
20
+
21
+ module.exports = ViewBuilder_MySQL;
@@ -1,15 +1,15 @@
1
- /* eslint max-len: 0 */
2
-
3
- const ViewCompiler = require('../../../schema/viewcompiler.js');
4
-
5
- class ViewCompiler_MySQL extends ViewCompiler {
6
- constructor(client, viewCompiler) {
7
- super(client, viewCompiler);
8
- }
9
-
10
- createOrReplace() {
11
- this.createQuery(this.columns, this.selectQuery, false, true);
12
- }
13
- }
14
-
15
- module.exports = ViewCompiler_MySQL;
1
+ /* eslint max-len: 0 */
2
+
3
+ const ViewCompiler = require('../../../schema/viewcompiler.js');
4
+
5
+ class ViewCompiler_MySQL extends ViewCompiler {
6
+ constructor(client, viewCompiler) {
7
+ super(client, viewCompiler);
8
+ }
9
+
10
+ createOrReplace() {
11
+ this.createQuery(this.columns, this.selectQuery, false, true);
12
+ }
13
+ }
14
+
15
+ module.exports = ViewCompiler_MySQL;
@@ -1,46 +1,46 @@
1
- const Transaction = require('../../execution/transaction');
2
- const Debug = require('debug');
3
-
4
- const debug = Debug('knex:tx');
5
-
6
- class Transaction_MySQL extends Transaction {
7
- query(conn, sql, status, value) {
8
- const t = this;
9
- const q = this.trxClient
10
- .query(conn, sql)
11
- .catch((err) => {
12
- if (err.errno === 1305) {
13
- this.trxClient.logger.warn(
14
- 'Transaction was implicitly committed, do not mix transactions and ' +
15
- 'DDL with MySQL (#805)'
16
- );
17
- return;
18
- }
19
-
20
- status = 2;
21
- value = err;
22
- t._completed = true;
23
- debug('%s error running transaction query', t.txid);
24
- })
25
- .then(function (res) {
26
- if (status === 1) t._resolver(value);
27
- if (status === 2) {
28
- if (value === undefined) {
29
- if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
30
- t._resolver();
31
- return;
32
- }
33
- value = new Error(`Transaction rejected with non-error: ${value}`);
34
- }
35
- t._rejecter(value);
36
- }
37
- return res;
38
- });
39
- if (status === 1 || status === 2) {
40
- t._completed = true;
41
- }
42
- return q;
43
- }
44
- }
45
-
46
- module.exports = Transaction_MySQL;
1
+ const Transaction = require('../../execution/transaction');
2
+ const Debug = require('debug');
3
+
4
+ const debug = Debug('knex:tx');
5
+
6
+ class Transaction_MySQL extends Transaction {
7
+ query(conn, sql, status, value) {
8
+ const t = this;
9
+ const q = this.trxClient
10
+ .query(conn, sql)
11
+ .catch((err) => {
12
+ if (err.errno === 1305) {
13
+ this.trxClient.logger.warn(
14
+ 'Transaction was implicitly committed, do not mix transactions and ' +
15
+ 'DDL with MySQL (#805)'
16
+ );
17
+ return;
18
+ }
19
+
20
+ status = 2;
21
+ value = err;
22
+ t._completed = true;
23
+ debug('%s error running transaction query', t.txid);
24
+ })
25
+ .then(function (res) {
26
+ if (status === 1) t._resolver(value);
27
+ if (status === 2) {
28
+ if (value === undefined) {
29
+ if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
30
+ t._resolver();
31
+ return;
32
+ }
33
+ value = new Error(`Transaction rejected with non-error: ${value}`);
34
+ }
35
+ t._rejecter(value);
36
+ }
37
+ return res;
38
+ });
39
+ if (status === 1 || status === 2) {
40
+ t._completed = true;
41
+ }
42
+ return q;
43
+ }
44
+ }
45
+
46
+ module.exports = Transaction_MySQL;
@@ -1,53 +1,53 @@
1
- // MySQL2 Client
2
- // -------
3
- const Client_MySQL = require('../mysql');
4
- const Transaction = require('./transaction');
5
-
6
- // Always initialize with the "QueryBuilder" and "QueryCompiler"
7
- // objects, which extend the base 'lib/query/builder' and
8
- // 'lib/query/compiler', respectively.
9
- class Client_MySQL2 extends Client_MySQL {
10
- transaction() {
11
- return new Transaction(this, ...arguments);
12
- }
13
-
14
- _driver() {
15
- return require('mysql2');
16
- }
17
-
18
- initializeDriver() {
19
- try {
20
- this.driver = this._driver();
21
- } catch (e) {
22
- let message = `Knex: run\n$ npm install ${this.driverName}`;
23
-
24
- const nodeMajorVersion = process.version.replace(/^v/, '').split('.')[0];
25
- if (nodeMajorVersion <= 12) {
26
- message += `@3.2.0`;
27
- this.logger.error(
28
- 'Mysql2 version 3.2.0 is the latest version to support Node.js 12 or lower.'
29
- );
30
- }
31
- message += ` --save`;
32
- this.logger.error(`${message}\n${e.message}\n${e.stack}`);
33
- throw new Error(`${message}\n${e.message}`);
34
- }
35
- }
36
-
37
- validateConnection(connection) {
38
- return (
39
- connection &&
40
- !connection._fatalError &&
41
- !connection._protocolError &&
42
- !connection._closing &&
43
- !connection.stream.destroyed
44
- );
45
- }
46
- }
47
-
48
- Object.assign(Client_MySQL2.prototype, {
49
- // The "dialect", for reference elsewhere.
50
- driverName: 'mysql2',
51
- });
52
-
53
- module.exports = Client_MySQL2;
1
+ // MySQL2 Client
2
+ // -------
3
+ const Client_MySQL = require('../mysql');
4
+ const Transaction = require('./transaction');
5
+
6
+ // Always initialize with the "QueryBuilder" and "QueryCompiler"
7
+ // objects, which extend the base 'lib/query/builder' and
8
+ // 'lib/query/compiler', respectively.
9
+ class Client_MySQL2 extends Client_MySQL {
10
+ transaction() {
11
+ return new Transaction(this, ...arguments);
12
+ }
13
+
14
+ _driver() {
15
+ return require('mysql2');
16
+ }
17
+
18
+ initializeDriver() {
19
+ try {
20
+ this.driver = this._driver();
21
+ } catch (e) {
22
+ let message = `Knex: run\n$ npm install ${this.driverName}`;
23
+
24
+ const nodeMajorVersion = process.version.replace(/^v/, '').split('.')[0];
25
+ if (nodeMajorVersion <= 12) {
26
+ message += `@3.2.0`;
27
+ this.logger.error(
28
+ 'Mysql2 version 3.2.0 is the latest version to support Node.js 12 or lower.'
29
+ );
30
+ }
31
+ message += ` --save`;
32
+ this.logger.error(`${message}\n${e.message}\n${e.stack}`);
33
+ throw new Error(`${message}\n${e.message}`);
34
+ }
35
+ }
36
+
37
+ validateConnection(connection) {
38
+ return (
39
+ connection &&
40
+ !connection._fatalError &&
41
+ !connection._protocolError &&
42
+ !connection._closing &&
43
+ !connection.stream.destroyed
44
+ );
45
+ }
46
+ }
47
+
48
+ Object.assign(Client_MySQL2.prototype, {
49
+ // The "dialect", for reference elsewhere.
50
+ driverName: 'mysql2',
51
+ });
52
+
53
+ module.exports = Client_MySQL2;
@@ -1,44 +1,44 @@
1
- const Transaction = require('../../execution/transaction');
2
- const debug = require('debug')('knex:tx');
3
-
4
- class Transaction_MySQL2 extends Transaction {
5
- query(conn, sql, status, value) {
6
- const t = this;
7
- const q = this.trxClient
8
- .query(conn, sql)
9
- .catch((err) => {
10
- if (err.code === 'ER_SP_DOES_NOT_EXIST') {
11
- this.trxClient.logger.warn(
12
- 'Transaction was implicitly committed, do not mix transactions and ' +
13
- 'DDL with MySQL (#805)'
14
- );
15
- return;
16
- }
17
-
18
- status = 2;
19
- value = err;
20
- t._completed = true;
21
- debug('%s error running transaction query', t.txid);
22
- })
23
- .then(function (res) {
24
- if (status === 1) t._resolver(value);
25
- if (status === 2) {
26
- if (value === undefined) {
27
- if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
28
- t._resolver();
29
- return;
30
- }
31
- value = new Error(`Transaction rejected with non-error: ${value}`);
32
- }
33
- t._rejecter(value);
34
- return res;
35
- }
36
- });
37
- if (status === 1 || status === 2) {
38
- t._completed = true;
39
- }
40
- return q;
41
- }
42
- }
43
-
44
- module.exports = Transaction_MySQL2;
1
+ const Transaction = require('../../execution/transaction');
2
+ const debug = require('debug')('knex:tx');
3
+
4
+ class Transaction_MySQL2 extends Transaction {
5
+ query(conn, sql, status, value) {
6
+ const t = this;
7
+ const q = this.trxClient
8
+ .query(conn, sql)
9
+ .catch((err) => {
10
+ if (err.code === 'ER_SP_DOES_NOT_EXIST') {
11
+ this.trxClient.logger.warn(
12
+ 'Transaction was implicitly committed, do not mix transactions and ' +
13
+ 'DDL with MySQL (#805)'
14
+ );
15
+ return;
16
+ }
17
+
18
+ status = 2;
19
+ value = err;
20
+ t._completed = true;
21
+ debug('%s error running transaction query', t.txid);
22
+ })
23
+ .then(function (res) {
24
+ if (status === 1) t._resolver(value);
25
+ if (status === 2) {
26
+ if (value === undefined) {
27
+ if (t.doNotRejectOnRollback && /^ROLLBACK\b/i.test(sql)) {
28
+ t._resolver();
29
+ return;
30
+ }
31
+ value = new Error(`Transaction rejected with non-error: ${value}`);
32
+ }
33
+ t._rejecter(value);
34
+ return res;
35
+ }
36
+ });
37
+ if (status === 1 || status === 2) {
38
+ t._completed = true;
39
+ }
40
+ return q;
41
+ }
42
+ }
43
+
44
+ module.exports = Transaction_MySQL2;
@@ -1,5 +1,5 @@
1
- # Warning: Dead Code #
2
-
3
- The `oracle` dialect is mostly dead code at this point. However, a handful of its methods are still referenced by the `oracledb` dialect. So, we are in the process of migrating those methods over to the `oracledb` dialect where they belong. Once that task is completed, we will officially remove the `oracle` dialect.
4
-
5
- In short: do not use the `oracle` dialect. Use the `oracledb` dialect instead.
1
+ # Warning: Dead Code
2
+
3
+ The `oracle` dialect is mostly dead code at this point. However, a handful of its methods are still referenced by the `oracledb` dialect. So, we are in the process of migrating those methods over to the `oracledb` dialect where they belong. Once that task is completed, we will officially remove the `oracle` dialect.
4
+
5
+ In short: do not use the `oracle` dialect. Use the `oracledb` dialect instead.
@@ -1,92 +1,92 @@
1
- // Oracle Client
2
- // -------
3
- const { ReturningHelper } = require('./utils');
4
- const { isConnectionError } = require('./utils');
5
- const Client = require('../../client');
6
- const SchemaCompiler = require('./schema/oracle-compiler');
7
- const ColumnBuilder = require('./schema/oracle-columnbuilder');
8
- const ColumnCompiler = require('./schema/oracle-columncompiler');
9
- const TableCompiler = require('./schema/oracle-tablecompiler');
10
-
11
- // Always initialize with the "QueryBuilder" and "QueryCompiler"
12
- // objects, which extend the base 'lib/query/builder' and
13
- // 'lib/query/compiler', respectively.
14
- class Client_Oracle extends Client {
15
- schemaCompiler() {
16
- return new SchemaCompiler(this, ...arguments);
17
- }
18
-
19
- columnBuilder() {
20
- return new ColumnBuilder(this, ...arguments);
21
- }
22
-
23
- columnCompiler() {
24
- return new ColumnCompiler(this, ...arguments);
25
- }
26
-
27
- tableCompiler() {
28
- return new TableCompiler(this, ...arguments);
29
- }
30
-
31
- // Return the database for the Oracle client.
32
- database() {
33
- return this.connectionSettings.database;
34
- }
35
-
36
- // Position the bindings for the query.
37
- positionBindings(sql) {
38
- let questionCount = 0;
39
- return sql.replace(/\?/g, function () {
40
- questionCount += 1;
41
- return `:${questionCount}`;
42
- });
43
- }
44
-
45
- _stream(connection, obj, stream, options) {
46
- if (!obj.sql) throw new Error('The query is empty');
47
-
48
- return new Promise(function (resolver, rejecter) {
49
- stream.on('error', (err) => {
50
- if (isConnectionError(err)) {
51
- connection.__knex__disposed = err;
52
- }
53
- rejecter(err);
54
- });
55
- stream.on('end', resolver);
56
- const queryStream = connection.queryStream(
57
- obj.sql,
58
- obj.bindings,
59
- options
60
- );
61
- queryStream.pipe(stream);
62
- queryStream.on('error', function (error) {
63
- rejecter(error);
64
- stream.emit('error', error);
65
- });
66
- });
67
- }
68
-
69
- // Formatter part
70
-
71
- alias(first, second) {
72
- return first + ' ' + second;
73
- }
74
-
75
- parameter(value, builder, formatter) {
76
- // Returning helper uses always ROWID as string
77
- if (value instanceof ReturningHelper && this.driver) {
78
- value = new this.driver.OutParam(this.driver.OCCISTRING);
79
- } else if (typeof value === 'boolean') {
80
- value = value ? 1 : 0;
81
- }
82
- return super.parameter(value, builder, formatter);
83
- }
84
- }
85
-
86
- Object.assign(Client_Oracle.prototype, {
87
- dialect: 'oracle',
88
-
89
- driverName: 'oracle',
90
- });
91
-
92
- module.exports = Client_Oracle;
1
+ // Oracle Client
2
+ // -------
3
+ const { ReturningHelper } = require('./utils');
4
+ const { isConnectionError } = require('./utils');
5
+ const Client = require('../../client');
6
+ const SchemaCompiler = require('./schema/oracle-compiler');
7
+ const ColumnBuilder = require('./schema/oracle-columnbuilder');
8
+ const ColumnCompiler = require('./schema/oracle-columncompiler');
9
+ const TableCompiler = require('./schema/oracle-tablecompiler');
10
+
11
+ // Always initialize with the "QueryBuilder" and "QueryCompiler"
12
+ // objects, which extend the base 'lib/query/builder' and
13
+ // 'lib/query/compiler', respectively.
14
+ class Client_Oracle extends Client {
15
+ schemaCompiler() {
16
+ return new SchemaCompiler(this, ...arguments);
17
+ }
18
+
19
+ columnBuilder() {
20
+ return new ColumnBuilder(this, ...arguments);
21
+ }
22
+
23
+ columnCompiler() {
24
+ return new ColumnCompiler(this, ...arguments);
25
+ }
26
+
27
+ tableCompiler() {
28
+ return new TableCompiler(this, ...arguments);
29
+ }
30
+
31
+ // Return the database for the Oracle client.
32
+ database() {
33
+ return this.connectionSettings.database;
34
+ }
35
+
36
+ // Position the bindings for the query.
37
+ positionBindings(sql) {
38
+ let questionCount = 0;
39
+ return sql.replace(/\?/g, function () {
40
+ questionCount += 1;
41
+ return `:${questionCount}`;
42
+ });
43
+ }
44
+
45
+ _stream(connection, obj, stream, options) {
46
+ if (!obj.sql) throw new Error('The query is empty');
47
+
48
+ return new Promise(function (resolver, rejecter) {
49
+ stream.on('error', (err) => {
50
+ if (isConnectionError(err)) {
51
+ connection.__knex__disposed = err;
52
+ }
53
+ rejecter(err);
54
+ });
55
+ stream.on('end', resolver);
56
+ const queryStream = connection.queryStream(
57
+ obj.sql,
58
+ obj.bindings,
59
+ options
60
+ );
61
+ queryStream.pipe(stream);
62
+ queryStream.on('error', function (error) {
63
+ rejecter(error);
64
+ stream.emit('error', error);
65
+ });
66
+ });
67
+ }
68
+
69
+ // Formatter part
70
+
71
+ alias(first, second) {
72
+ return first + ' ' + second;
73
+ }
74
+
75
+ parameter(value, builder, formatter) {
76
+ // Returning helper uses always ROWID as string
77
+ if (value instanceof ReturningHelper && this.driver) {
78
+ value = new this.driver.OutParam(this.driver.OCCISTRING);
79
+ } else if (typeof value === 'boolean') {
80
+ value = value ? 1 : 0;
81
+ }
82
+ return super.parameter(value, builder, formatter);
83
+ }
84
+ }
85
+
86
+ Object.assign(Client_Oracle.prototype, {
87
+ dialect: 'oracle',
88
+
89
+ driverName: 'oracle',
90
+ });
91
+
92
+ module.exports = Client_Oracle;