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,304 +1,304 @@
1
- /* eslint max-len: 0 */
2
-
3
- // PostgreSQL Table Builder & Compiler
4
- // -------
5
-
6
- const has = require('lodash/has');
7
- const TableCompiler = require('../../../schema/tablecompiler');
8
- const { isObject, isString } = require('../../../util/is');
9
-
10
- class TableCompiler_PG extends TableCompiler {
11
- constructor(client, tableBuilder) {
12
- super(client, tableBuilder);
13
- }
14
-
15
- // Compile a rename column command.
16
- renameColumn(from, to) {
17
- return this.pushQuery({
18
- sql: `alter table ${this.tableName()} rename ${this.formatter.wrap(
19
- from
20
- )} to ${this.formatter.wrap(to)}`,
21
- });
22
- }
23
-
24
- _setNullableState(column, isNullable) {
25
- const constraintAction = isNullable ? 'drop not null' : 'set not null';
26
- const sql = `alter table ${this.tableName()} alter column ${this.formatter.wrap(
27
- column
28
- )} ${constraintAction}`;
29
- return this.pushQuery({
30
- sql: sql,
31
- });
32
- }
33
-
34
- compileAdd(builder) {
35
- const table = this.formatter.wrap(builder);
36
- const columns = this.prefixArray('add column', this.getColumns(builder));
37
- return this.pushQuery({
38
- sql: `alter table ${table} ${columns.join(', ')}`,
39
- });
40
- }
41
-
42
- // Adds the "create" query to the query sequence.
43
- createQuery(columns, ifNot, like) {
44
- const createStatement = ifNot
45
- ? 'create table if not exists '
46
- : 'create table ';
47
- const columnsSql = ` (${columns.sql.join(', ')}${
48
- this.primaryKeys() || ''
49
- }${this._addChecks()})`;
50
-
51
- let sql =
52
- createStatement +
53
- this.tableName() +
54
- (like && this.tableNameLike()
55
- ? ' (like ' +
56
- this.tableNameLike() +
57
- ' including all' +
58
- (columns.sql.length ? ', ' + columns.sql.join(', ') : '') +
59
- ')'
60
- : columnsSql);
61
- if (this.single.inherits)
62
- sql += ` inherits (${this.formatter.wrap(this.single.inherits)})`;
63
- this.pushQuery({
64
- sql,
65
- bindings: columns.bindings,
66
- });
67
- const hasComment = has(this.single, 'comment');
68
- if (hasComment) this.comment(this.single.comment);
69
- }
70
-
71
- primaryKeys() {
72
- const pks = (this.grouped.alterTable || []).filter(
73
- (k) => k.method === 'primary'
74
- );
75
- if (pks.length > 0 && pks[0].args.length > 0) {
76
- const columns = pks[0].args[0];
77
- let constraintName = pks[0].args[1] || '';
78
- let deferrable;
79
- if (isObject(constraintName)) {
80
- ({ constraintName, deferrable } = constraintName);
81
- }
82
- deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
83
- constraintName = constraintName
84
- ? this.formatter.wrap(constraintName)
85
- : this.formatter.wrap(`${this.tableNameRaw}_pkey`);
86
-
87
- return `, constraint ${constraintName} primary key (${this.formatter.columnize(
88
- columns
89
- )})${deferrable}`;
90
- }
91
- }
92
-
93
- addColumns(columns, prefix, colCompilers) {
94
- if (prefix === this.alterColumnsPrefix) {
95
- // alter columns
96
- for (const col of colCompilers) {
97
- this._addColumn(col);
98
- }
99
- } else {
100
- // base class implementation for normal add
101
- super.addColumns(columns, prefix);
102
- }
103
- }
104
-
105
- _addColumn(col) {
106
- const quotedTableName = this.tableName();
107
- const type = col.getColumnType();
108
- // We'd prefer to call this.formatter.wrapAsIdentifier here instead, however the context passed to
109
- // `this` instance is not that of the column, but of the table. Thus, we unfortunately have to call
110
- // `wrapIdentifier` here as well (it is already called once on the initial column operation) to give
111
- // our `alter` operation the correct `queryContext`. Refer to issue #2606 and PR #2612.
112
- const colName = this.client.wrapIdentifier(
113
- col.getColumnName(),
114
- col.columnBuilder.queryContext()
115
- );
116
-
117
- // To alter enum columns they must be cast to text first
118
- const isEnum = col.type === 'enu';
119
- this.pushQuery({
120
- sql: `alter table ${quotedTableName} alter column ${colName} drop default`,
121
- bindings: [],
122
- });
123
-
124
- const alterNullable = col.columnBuilder.alterNullable;
125
- if (alterNullable) {
126
- this.pushQuery({
127
- sql: `alter table ${quotedTableName} alter column ${colName} drop not null`,
128
- bindings: [],
129
- });
130
- }
131
-
132
- const alterType = col.columnBuilder.alterType;
133
- if (alterType) {
134
- this.pushQuery({
135
- sql: `alter table ${quotedTableName} alter column ${colName} type ${type} using (${colName}${
136
- isEnum ? '::text::' : '::'
137
- }${type})`,
138
- bindings: [],
139
- });
140
- }
141
-
142
- const defaultTo = col.modified['defaultTo'];
143
- if (defaultTo) {
144
- const modifier = col.defaultTo.apply(col, defaultTo);
145
- this.pushQuery({
146
- sql: `alter table ${quotedTableName} alter column ${colName} set ${modifier}`,
147
- bindings: [],
148
- });
149
- }
150
-
151
- if (alterNullable) {
152
- const nullable = col.modified['nullable'];
153
- if (nullable && nullable[0] === false) {
154
- this.pushQuery({
155
- sql: `alter table ${quotedTableName} alter column ${colName} set not null`,
156
- bindings: [],
157
- });
158
- }
159
- }
160
- }
161
-
162
- // Compiles the comment on the table.
163
- comment(comment) {
164
- this.pushQuery(
165
- `comment on table ${this.tableName()} is '${this.single.comment}'`
166
- );
167
- }
168
-
169
- // Indexes:
170
- // -------
171
-
172
- primary(columns, constraintName) {
173
- let deferrable;
174
- if (isObject(constraintName)) {
175
- ({ constraintName, deferrable } = constraintName);
176
- }
177
- deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
178
- constraintName = constraintName
179
- ? this.formatter.wrap(constraintName)
180
- : this.formatter.wrap(`${this.tableNameRaw}_pkey`);
181
- if (this.method !== 'create' && this.method !== 'createIfNot') {
182
- this.pushQuery(
183
- `alter table ${this.tableName()} add constraint ${constraintName} primary key (${this.formatter.columnize(
184
- columns
185
- )})${deferrable}`
186
- );
187
- }
188
- }
189
-
190
- unique(columns, indexName) {
191
- let deferrable;
192
- let useConstraint = true;
193
- let predicate;
194
- if (isObject(indexName)) {
195
- ({ indexName, deferrable, useConstraint, predicate } = indexName);
196
- if (useConstraint === undefined) {
197
- useConstraint = !!deferrable || !predicate;
198
- }
199
- }
200
- if (!useConstraint && deferrable && deferrable !== 'not deferrable') {
201
- throw new Error('postgres cannot create deferrable index');
202
- }
203
- if (useConstraint && predicate) {
204
- throw new Error('postgres cannot create constraint with predicate');
205
- }
206
- deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
207
- indexName = indexName
208
- ? this.formatter.wrap(indexName)
209
- : this._indexCommand('unique', this.tableNameRaw, columns);
210
-
211
- if (useConstraint) {
212
- this.pushQuery(
213
- `alter table ${this.tableName()} add constraint ${indexName}` +
214
- ' unique (' +
215
- this.formatter.columnize(columns) +
216
- ')' +
217
- deferrable
218
- );
219
- } else {
220
- const predicateQuery = predicate
221
- ? ' ' + this.client.queryCompiler(predicate).where()
222
- : '';
223
-
224
- this.pushQuery(
225
- `create unique index ${indexName} on ${this.tableName()} (${this.formatter.columnize(
226
- columns
227
- )})${predicateQuery}`
228
- );
229
- }
230
- }
231
-
232
- index(columns, indexName, options) {
233
- indexName = indexName
234
- ? this.formatter.wrap(indexName)
235
- : this._indexCommand('index', this.tableNameRaw, columns);
236
-
237
- let predicate;
238
- let storageEngineIndexType;
239
- let indexType;
240
-
241
- if (isString(options)) {
242
- storageEngineIndexType = options;
243
- } else if (isObject(options)) {
244
- ({ indexType, storageEngineIndexType, predicate } = options);
245
- }
246
-
247
- const predicateQuery = predicate
248
- ? ' ' + this.client.queryCompiler(predicate).where()
249
- : '';
250
-
251
- this.pushQuery(
252
- `create${
253
- typeof indexType === 'string' && indexType.toLowerCase() === 'unique'
254
- ? ' unique'
255
- : ''
256
- } index ${indexName} on ${this.tableName()}${
257
- (storageEngineIndexType && ` using ${storageEngineIndexType}`) || ''
258
- }` +
259
- ' (' +
260
- this.formatter.columnize(columns) +
261
- ')' +
262
- `${predicateQuery}`
263
- );
264
- }
265
-
266
- dropPrimary(constraintName) {
267
- constraintName = constraintName
268
- ? this.formatter.wrap(constraintName)
269
- : this.formatter.wrap(this.tableNameRaw + '_pkey');
270
- this.pushQuery(
271
- `alter table ${this.tableName()} drop constraint ${constraintName}`
272
- );
273
- }
274
-
275
- dropIndex(columns, indexName) {
276
- indexName = indexName
277
- ? this.formatter.wrap(indexName)
278
- : this._indexCommand('index', this.tableNameRaw, columns);
279
- indexName = this.schemaNameRaw
280
- ? `${this.formatter.wrap(this.schemaNameRaw)}.${indexName}`
281
- : indexName;
282
- this.pushQuery(`drop index ${indexName}`);
283
- }
284
-
285
- dropUnique(columns, indexName) {
286
- indexName = indexName
287
- ? this.formatter.wrap(indexName)
288
- : this._indexCommand('unique', this.tableNameRaw, columns);
289
- this.pushQuery(
290
- `alter table ${this.tableName()} drop constraint ${indexName}`
291
- );
292
- }
293
-
294
- dropForeign(columns, indexName) {
295
- indexName = indexName
296
- ? this.formatter.wrap(indexName)
297
- : this._indexCommand('foreign', this.tableNameRaw, columns);
298
- this.pushQuery(
299
- `alter table ${this.tableName()} drop constraint ${indexName}`
300
- );
301
- }
302
- }
303
-
304
- module.exports = TableCompiler_PG;
1
+ /* eslint max-len: 0 */
2
+
3
+ // PostgreSQL Table Builder & Compiler
4
+ // -------
5
+
6
+ const has = require('lodash/has');
7
+ const TableCompiler = require('../../../schema/tablecompiler');
8
+ const { isObject, isString } = require('../../../util/is');
9
+
10
+ class TableCompiler_PG extends TableCompiler {
11
+ constructor(client, tableBuilder) {
12
+ super(client, tableBuilder);
13
+ }
14
+
15
+ // Compile a rename column command.
16
+ renameColumn(from, to) {
17
+ return this.pushQuery({
18
+ sql: `alter table ${this.tableName()} rename ${this.formatter.wrap(
19
+ from
20
+ )} to ${this.formatter.wrap(to)}`,
21
+ });
22
+ }
23
+
24
+ _setNullableState(column, isNullable) {
25
+ const constraintAction = isNullable ? 'drop not null' : 'set not null';
26
+ const sql = `alter table ${this.tableName()} alter column ${this.formatter.wrap(
27
+ column
28
+ )} ${constraintAction}`;
29
+ return this.pushQuery({
30
+ sql: sql,
31
+ });
32
+ }
33
+
34
+ compileAdd(builder) {
35
+ const table = this.formatter.wrap(builder);
36
+ const columns = this.prefixArray('add column', this.getColumns(builder));
37
+ return this.pushQuery({
38
+ sql: `alter table ${table} ${columns.join(', ')}`,
39
+ });
40
+ }
41
+
42
+ // Adds the "create" query to the query sequence.
43
+ createQuery(columns, ifNot, like) {
44
+ const createStatement = ifNot
45
+ ? 'create table if not exists '
46
+ : 'create table ';
47
+ const columnsSql = ` (${columns.sql.join(', ')}${
48
+ this.primaryKeys() || ''
49
+ }${this._addChecks()})`;
50
+
51
+ let sql =
52
+ createStatement +
53
+ this.tableName() +
54
+ (like && this.tableNameLike()
55
+ ? ' (like ' +
56
+ this.tableNameLike() +
57
+ ' including all' +
58
+ (columns.sql.length ? ', ' + columns.sql.join(', ') : '') +
59
+ ')'
60
+ : columnsSql);
61
+ if (this.single.inherits)
62
+ sql += ` inherits (${this.formatter.wrap(this.single.inherits)})`;
63
+ this.pushQuery({
64
+ sql,
65
+ bindings: columns.bindings,
66
+ });
67
+ const hasComment = has(this.single, 'comment');
68
+ if (hasComment) this.comment(this.single.comment);
69
+ }
70
+
71
+ primaryKeys() {
72
+ const pks = (this.grouped.alterTable || []).filter(
73
+ (k) => k.method === 'primary'
74
+ );
75
+ if (pks.length > 0 && pks[0].args.length > 0) {
76
+ const columns = pks[0].args[0];
77
+ let constraintName = pks[0].args[1] || '';
78
+ let deferrable;
79
+ if (isObject(constraintName)) {
80
+ ({ constraintName, deferrable } = constraintName);
81
+ }
82
+ deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
83
+ constraintName = constraintName
84
+ ? this.formatter.wrap(constraintName)
85
+ : this.formatter.wrap(`${this.tableNameRaw}_pkey`);
86
+
87
+ return `, constraint ${constraintName} primary key (${this.formatter.columnize(
88
+ columns
89
+ )})${deferrable}`;
90
+ }
91
+ }
92
+
93
+ addColumns(columns, prefix, colCompilers) {
94
+ if (prefix === this.alterColumnsPrefix) {
95
+ // alter columns
96
+ for (const col of colCompilers) {
97
+ this._addColumn(col);
98
+ }
99
+ } else {
100
+ // base class implementation for normal add
101
+ super.addColumns(columns, prefix);
102
+ }
103
+ }
104
+
105
+ _addColumn(col) {
106
+ const quotedTableName = this.tableName();
107
+ const type = col.getColumnType();
108
+ // We'd prefer to call this.formatter.wrapAsIdentifier here instead, however the context passed to
109
+ // `this` instance is not that of the column, but of the table. Thus, we unfortunately have to call
110
+ // `wrapIdentifier` here as well (it is already called once on the initial column operation) to give
111
+ // our `alter` operation the correct `queryContext`. Refer to issue #2606 and PR #2612.
112
+ const colName = this.client.wrapIdentifier(
113
+ col.getColumnName(),
114
+ col.columnBuilder.queryContext()
115
+ );
116
+
117
+ // To alter enum columns they must be cast to text first
118
+ const isEnum = col.type === 'enu';
119
+ this.pushQuery({
120
+ sql: `alter table ${quotedTableName} alter column ${colName} drop default`,
121
+ bindings: [],
122
+ });
123
+
124
+ const alterNullable = col.columnBuilder.alterNullable;
125
+ if (alterNullable) {
126
+ this.pushQuery({
127
+ sql: `alter table ${quotedTableName} alter column ${colName} drop not null`,
128
+ bindings: [],
129
+ });
130
+ }
131
+
132
+ const alterType = col.columnBuilder.alterType;
133
+ if (alterType) {
134
+ this.pushQuery({
135
+ sql: `alter table ${quotedTableName} alter column ${colName} type ${type} using (${colName}${
136
+ isEnum ? '::text::' : '::'
137
+ }${type})`,
138
+ bindings: [],
139
+ });
140
+ }
141
+
142
+ const defaultTo = col.modified['defaultTo'];
143
+ if (defaultTo) {
144
+ const modifier = col.defaultTo.apply(col, defaultTo);
145
+ this.pushQuery({
146
+ sql: `alter table ${quotedTableName} alter column ${colName} set ${modifier}`,
147
+ bindings: [],
148
+ });
149
+ }
150
+
151
+ if (alterNullable) {
152
+ const nullable = col.modified['nullable'];
153
+ if (nullable && nullable[0] === false) {
154
+ this.pushQuery({
155
+ sql: `alter table ${quotedTableName} alter column ${colName} set not null`,
156
+ bindings: [],
157
+ });
158
+ }
159
+ }
160
+ }
161
+
162
+ // Compiles the comment on the table.
163
+ comment(comment) {
164
+ this.pushQuery(
165
+ `comment on table ${this.tableName()} is '${this.single.comment}'`
166
+ );
167
+ }
168
+
169
+ // Indexes:
170
+ // -------
171
+
172
+ primary(columns, constraintName) {
173
+ let deferrable;
174
+ if (isObject(constraintName)) {
175
+ ({ constraintName, deferrable } = constraintName);
176
+ }
177
+ deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
178
+ constraintName = constraintName
179
+ ? this.formatter.wrap(constraintName)
180
+ : this.formatter.wrap(`${this.tableNameRaw}_pkey`);
181
+ if (this.method !== 'create' && this.method !== 'createIfNot') {
182
+ this.pushQuery(
183
+ `alter table ${this.tableName()} add constraint ${constraintName} primary key (${this.formatter.columnize(
184
+ columns
185
+ )})${deferrable}`
186
+ );
187
+ }
188
+ }
189
+
190
+ unique(columns, indexName) {
191
+ let deferrable;
192
+ let useConstraint = true;
193
+ let predicate;
194
+ if (isObject(indexName)) {
195
+ ({ indexName, deferrable, useConstraint, predicate } = indexName);
196
+ if (useConstraint === undefined) {
197
+ useConstraint = !!deferrable || !predicate;
198
+ }
199
+ }
200
+ if (!useConstraint && deferrable && deferrable !== 'not deferrable') {
201
+ throw new Error('postgres cannot create deferrable index');
202
+ }
203
+ if (useConstraint && predicate) {
204
+ throw new Error('postgres cannot create constraint with predicate');
205
+ }
206
+ deferrable = deferrable ? ` deferrable initially ${deferrable}` : '';
207
+ indexName = indexName
208
+ ? this.formatter.wrap(indexName)
209
+ : this._indexCommand('unique', this.tableNameRaw, columns);
210
+
211
+ if (useConstraint) {
212
+ this.pushQuery(
213
+ `alter table ${this.tableName()} add constraint ${indexName}` +
214
+ ' unique (' +
215
+ this.formatter.columnize(columns) +
216
+ ')' +
217
+ deferrable
218
+ );
219
+ } else {
220
+ const predicateQuery = predicate
221
+ ? ' ' + this.client.queryCompiler(predicate).where()
222
+ : '';
223
+
224
+ this.pushQuery(
225
+ `create unique index ${indexName} on ${this.tableName()} (${this.formatter.columnize(
226
+ columns
227
+ )})${predicateQuery}`
228
+ );
229
+ }
230
+ }
231
+
232
+ index(columns, indexName, options) {
233
+ indexName = indexName
234
+ ? this.formatter.wrap(indexName)
235
+ : this._indexCommand('index', this.tableNameRaw, columns);
236
+
237
+ let predicate;
238
+ let storageEngineIndexType;
239
+ let indexType;
240
+
241
+ if (isString(options)) {
242
+ storageEngineIndexType = options;
243
+ } else if (isObject(options)) {
244
+ ({ indexType, storageEngineIndexType, predicate } = options);
245
+ }
246
+
247
+ const predicateQuery = predicate
248
+ ? ' ' + this.client.queryCompiler(predicate).where()
249
+ : '';
250
+
251
+ this.pushQuery(
252
+ `create${
253
+ typeof indexType === 'string' && indexType.toLowerCase() === 'unique'
254
+ ? ' unique'
255
+ : ''
256
+ } index ${indexName} on ${this.tableName()}${
257
+ (storageEngineIndexType && ` using ${storageEngineIndexType}`) || ''
258
+ }` +
259
+ ' (' +
260
+ this.formatter.columnize(columns) +
261
+ ')' +
262
+ `${predicateQuery}`
263
+ );
264
+ }
265
+
266
+ dropPrimary(constraintName) {
267
+ constraintName = constraintName
268
+ ? this.formatter.wrap(constraintName)
269
+ : this.formatter.wrap(this.tableNameRaw + '_pkey');
270
+ this.pushQuery(
271
+ `alter table ${this.tableName()} drop constraint ${constraintName}`
272
+ );
273
+ }
274
+
275
+ dropIndex(columns, indexName) {
276
+ indexName = indexName
277
+ ? this.formatter.wrap(indexName)
278
+ : this._indexCommand('index', this.tableNameRaw, columns);
279
+ indexName = this.schemaNameRaw
280
+ ? `${this.formatter.wrap(this.schemaNameRaw)}.${indexName}`
281
+ : indexName;
282
+ this.pushQuery(`drop index ${indexName}`);
283
+ }
284
+
285
+ dropUnique(columns, indexName) {
286
+ indexName = indexName
287
+ ? this.formatter.wrap(indexName)
288
+ : this._indexCommand('unique', this.tableNameRaw, columns);
289
+ this.pushQuery(
290
+ `alter table ${this.tableName()} drop constraint ${indexName}`
291
+ );
292
+ }
293
+
294
+ dropForeign(columns, indexName) {
295
+ indexName = indexName
296
+ ? this.formatter.wrap(indexName)
297
+ : this._indexCommand('foreign', this.tableNameRaw, columns);
298
+ this.pushQuery(
299
+ `alter table ${this.tableName()} drop constraint ${indexName}`
300
+ );
301
+ }
302
+ }
303
+
304
+ module.exports = TableCompiler_PG;
@@ -1,21 +1,21 @@
1
- const ViewBuilder = require('../../../schema/viewbuilder.js');
2
-
3
- class ViewBuilder_PG 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_PG;
1
+ const ViewBuilder = require('../../../schema/viewbuilder.js');
2
+
3
+ class ViewBuilder_PG 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_PG;