Project

General

Profile

1 3077 aaronmk
# Database import/export
2
3 3431 aaronmk
import operator
4
5 3077 aaronmk
import exc
6
import dicts
7
import sql
8
import sql_gen
9
import strings
10
import util
11
12 3081 aaronmk
##### Data cleanup
13
14
def cleanup_table(db, table, cols):
15
    table = sql_gen.as_Table(table)
16
    cols = map(sql_gen.as_Col, cols)
17
18
    expr = ('nullif(nullif(trim(both from %s), '+db.esc_value('')+'), '
19
        +db.esc_value(r'\N')+')')
20
    changes = [(v, sql_gen.CustomCode(expr % v.to_str(db)))
21
        for v in cols]
22
23
    sql.update(db, table, changes, in_place=True)
24
25 3078 aaronmk
##### Error tracking
26
27
def track_data_error(db, errors_table, cols, value, error_code, error):
28
    '''
29
    @param errors_table If None, does nothing.
30
    '''
31
    if errors_table == None or cols == (): return
32
33
    for col in cols:
34
        try:
35
            sql.insert(db, errors_table, dict(column=col.name, value=value,
36
                error_code=error_code, error=error), recover=True,
37
                cacheable=True, log_level=4)
38
        except sql.DuplicateKeyException: pass
39
40 3459 aaronmk
def data_exception_handler(db, srcs=[], errors_table=None):
41
    '''Handles a data_exception by saving the error or converting it to a
42
    warning, and returning NULL.
43
    @param srcs The column names for the errors table
44
    @param errors_table None|sql_gen.Table
45
    '''
46
    save_errors = errors_table != None and srcs
47
    handler = ''
48
    if save_errors:
49
        errors_table_cols = map(sql_gen.Col,
50
            ['column', 'value', 'error_code', 'error'])
51 3465 aaronmk
        col_names_query = sql.mk_select(db, sql_gen.NamedValues('c', None,
52
            [[c.name] for c in srcs]), order_by=None)
53
        insert_query = sql.mk_insert_select(db, errors_table, errors_table_cols,
54
            sql_gen.Values(errors_table_cols).to_str(db))+';\n'
55 3459 aaronmk
        handler += '''\
56
-- Save error in errors table.
57
DECLARE
58
    error_code text := SQLSTATE;
59
    error text := SQLERRM;
60
BEGIN
61
    -- Insert the value and error for *each* source column.
62 3467 aaronmk
'''+strings.indent(sql_gen.RowExcIgnore('text', col_names_query, insert_query,
63
    row_var=errors_table_cols[0]).to_str(db))+'''
64 3459 aaronmk
END;
65
'''
66
    else:
67
        handler += '''\
68
RAISE WARNING '%', SQLERRM;
69
'''
70
    handler += '''\
71
RETURN NULL;
72
'''
73
    return sql_gen.ExcHandler('data_exception', handler)
74
75 3078 aaronmk
def cast(db, type_, col, errors_table=None):
76
    '''Casts an (unrenamed) column or value.
77
    If errors_table set and col has srcs, saves errors in errors_table (using
78 3360 aaronmk
    col's srcs attr as source columns). Otherwise, converts errors to warnings.
79 3078 aaronmk
    @param col str|sql_gen.Col|sql_gen.Literal
80
    @param errors_table None|sql_gen.Table|str
81
    '''
82
    col = sql_gen.as_Col(col)
83
84 3112 aaronmk
    # Don't convert exceptions to warnings for user-supplied constants
85
    if isinstance(col, sql_gen.Literal): return sql_gen.Cast(type_, col)
86
87 3078 aaronmk
    assert not isinstance(col, sql_gen.NamedCol)
88
89 3460 aaronmk
    function_name = strings.first_word(type_)
90 3459 aaronmk
    srcs = col.srcs
91 3112 aaronmk
    save_errors = (errors_table != None and isinstance(col, sql_gen.Col)
92
        and col.srcs != ())
93
    if save_errors:
94
        srcs = map(sql_gen.to_name_only_col, col.srcs)
95
        function_name = str(sql_gen.FunctionCall(function_name, *srcs))
96 3078 aaronmk
    function = db.TempFunction(function_name)
97
98 3464 aaronmk
    # Create function definition
99
    modifiers = 'STRICT'
100
    if not save_errors: modifiers = 'IMMUTABLE '+modifiers
101
    handler = data_exception_handler(db, srcs, errors_table)
102
    body = sql_gen.CustomCode(handler.to_str(db, '''\
103 3467 aaronmk
/* The explicit cast to the return type is needed to make the cast happen
104
inside the try block. (Implicit casts to the return type happen at the end
105
of the function, outside any block.) */
106
RETURN value::'''+type_+''';
107 3464 aaronmk
'''))
108
    body.lang='plpgsql'
109 3470 aaronmk
    def_ = sql_gen.FunctionDef(function, type_, body,
110
        [sql_gen.FunctionParam('value', 'text')], modifiers)
111 3464 aaronmk
112
    # Create function
113
    while True:
114 3078 aaronmk
        try:
115 3464 aaronmk
            sql.run_query(db, def_.to_str(db), recover=True, cacheable=True,
116 3078 aaronmk
                log_ignore_excs=(sql.DuplicateException,))
117
            break # successful
118
        except sql.DuplicateException:
119
            function.name = sql.next_version(function.name)
120
            # try again with next version of name
121
122
    return sql_gen.FunctionCall(function, col)
123
124
def cast_temp_col(db, type_, col, errors_table=None):
125
    '''Like cast(), but creates a new column with the cast values if the input
126
    is a column.
127
    @return The new column or cast value
128
    '''
129
    def cast_(col): return cast(db, type_, col, errors_table)
130
131
    try: col = sql_gen.underlying_col(col)
132
    except sql_gen.NoUnderlyingTableException: return sql_gen.wrap(cast_, col)
133
134
    table = col.table
135 3173 aaronmk
    new_col = sql_gen.suffixed_col(col, '::'+strings.first_word(type_))
136 3078 aaronmk
    expr = cast_(col)
137
138
    # Add column
139
    new_typed_col = sql_gen.TypedCol(new_col.name, type_)
140 3174 aaronmk
    sql.add_col(db, table, new_typed_col, comment=repr(col)+'::'+type_)
141 3078 aaronmk
    new_col.name = new_typed_col.name # propagate any renaming
142
143 3110 aaronmk
    sql.update(db, table, [(new_col, expr)], in_place=True, recover=True)
144 3078 aaronmk
145
    return new_col
146
147
def errors_table(db, table, if_exists=True):
148
    '''
149
    @param if_exists If set, returns None if the errors table doesn't exist
150
    @return None|sql_gen.Table
151
    '''
152
    table = sql_gen.as_Table(table)
153
    if table.srcs != (): table = table.srcs[0]
154
155
    errors_table = sql_gen.suffixed_table(table, '.errors')
156
    if if_exists and not sql.table_exists(db, errors_table): return None
157
    return errors_table
158
159
##### Import
160
161 3077 aaronmk
def put(db, table, row, pkey_=None, row_ct_ref=None):
162
    '''Recovers from errors.
163
    Only works under PostgreSQL (uses INSERT RETURNING).
164
    '''
165
    row = sql_gen.ColDict(db, table, row)
166
    if pkey_ == None: pkey_ = sql.pkey(db, table, recover=True)
167
168
    try:
169 3131 aaronmk
        cur = sql.insert(db, table, row, pkey_, recover=True, log_level=3.5)
170 3077 aaronmk
        if row_ct_ref != None and cur.rowcount >= 0:
171
            row_ct_ref[0] += cur.rowcount
172
        return sql.value(cur)
173
    except sql.DuplicateKeyException, e:
174
        row = sql_gen.ColDict(db, table,
175
            util.dict_subset_right_join(row, e.cols))
176 3131 aaronmk
        return sql.value(sql.select(db, table, [pkey_], row, recover=True,
177
            log_level=3.5))
178 3208 aaronmk
    except sql.NullValueException: return None
179 3077 aaronmk
180
def get(db, table, row, pkey, row_ct_ref=None, create=False):
181
    '''Recovers from errors'''
182
    try:
183
        return sql.value(sql.select(db, table, [pkey], row, limit=1,
184
            recover=True))
185
    except StopIteration:
186
        if not create: raise
187
        return put(db, table, row, pkey, row_ct_ref) # insert new row
188
189
def is_func_result(col):
190
    return col.table.name.find('(') >= 0 and col.name == 'result'
191
192
def into_table_name(out_table, in_tables0, mapping, is_func):
193
    def in_col_str(in_col):
194
        in_col = sql_gen.remove_col_rename(in_col)
195
        if isinstance(in_col, sql_gen.Col):
196
            table = in_col.table
197
            if table == in_tables0:
198
                in_col = sql_gen.to_name_only_col(in_col)
199
            elif is_func_result(in_col): in_col = table # omit col name
200
        return str(in_col)
201
202
    str_ = str(out_table)
203
    if is_func:
204
        str_ += '('
205
206
        try: value_in_col = mapping['value']
207
        except KeyError:
208
            str_ += ', '.join((str(k)+'='+in_col_str(v)
209
                for k, v in mapping.iteritems()))
210
        else: str_ += in_col_str(value_in_col)
211
212
        str_ += ')'
213
    else:
214
        out_col = 'rank'
215
        try: in_col = mapping[out_col]
216
        except KeyError: str_ += '_pkeys'
217
        else: # has a rank column, so hierarchical
218
            str_ += '['+str(out_col)+'='+in_col_str(in_col)+']'
219
    return str_
220
221
def put_table(db, out_table, in_tables, mapping, row_ct_ref=None, into=None,
222
    default=None, is_func=False, on_error=exc.raise_):
223
    '''Recovers from errors.
224
    Only works under PostgreSQL (uses INSERT RETURNING).
225
    IMPORTANT: Must be run at the *beginning* of a transaction.
226
    @param in_tables The main input table to select from, followed by a list of
227
        tables to join with it using the main input table's pkey
228
    @param mapping dict(out_table_col=in_table_col, ...)
229
        * out_table_col: str (*not* sql_gen.Col)
230
        * in_table_col: sql_gen.Col|literal-value
231
    @param into The table to contain the output and input pkeys.
232
        Defaults to `out_table.name+'_pkeys'`.
233
    @param default The *output* column to use as the pkey for missing rows.
234
        If this output column does not exist in the mapping, uses None.
235
    @param is_func Whether out_table is the name of a SQL function, not a table
236
    @return sql_gen.Col Where the output pkeys are made available
237
    '''
238
    out_table = sql_gen.as_Table(out_table)
239
240
    def log_debug(msg): db.log_debug(msg, level=1.5)
241
    def col_ustr(str_):
242
        return strings.repr_no_u(sql_gen.remove_col_rename(str_))
243
244
    log_debug('********** New iteration **********')
245
    log_debug('Inserting these input columns into '+strings.as_tt(
246
        out_table.to_str(db))+':\n'+strings.as_table(mapping, ustr=col_ustr))
247
248
    is_function = sql.function_exists(db, out_table)
249
250
    if is_function: out_pkey = 'result'
251
    else: out_pkey = sql.pkey(db, out_table, recover=True)
252
    out_pkey_col = sql_gen.as_Col(out_pkey, out_table)
253
254
    in_tables_ = in_tables[:] # don't modify input!
255 3432 aaronmk
    try: in_tables0 = in_tables_.pop(0) # first table is separate
256
    except IndexError: in_tables0 = None
257
    else:
258
        in_pkey = sql.pkey(db, in_tables0, recover=True)
259
        in_pkey_col = sql_gen.as_Col(in_pkey, in_tables0)
260 3431 aaronmk
261
    # Determine if can use optimization for only literal values
262
    is_literals = not reduce(operator.or_, map(sql_gen.is_table_col,
263 3434 aaronmk
        mapping.values()), False)
264 3431 aaronmk
    is_literals_or_function = is_literals or is_function
265
266 3432 aaronmk
    if in_tables0 == None: errors_table_ = None
267
    else: errors_table_ = errors_table(db, in_tables0)
268 3431 aaronmk
269
    # Create input joins from list of input tables
270 3077 aaronmk
    input_joins = [in_tables0]+[sql_gen.Join(v,
271
        {in_pkey: sql_gen.join_same_not_null}) for v in in_tables_]
272
273 3433 aaronmk
    if mapping == {} and not is_function: # need >= one column for INSERT SELECT
274
        mapping = {out_pkey: None} # ColDict will replace with default value
275
276 3431 aaronmk
    if not is_literals:
277
        if into == None:
278
            into = into_table_name(out_table, in_tables0, mapping, is_func)
279
        into = sql_gen.as_Table(into)
280
281
        # Set column sources
282
        in_cols = filter(sql_gen.is_table_col, mapping.values())
283
        for col in in_cols:
284
            if col.table == in_tables0: col.set_srcs(sql_gen.src_self)
285
286
        log_debug('Joining together input tables into temp table')
287
        # Place in new table so don't modify input and for speed
288
        in_table = sql_gen.Table('in')
289
        mapping = dicts.join(mapping, sql.flatten(db, in_table, input_joins,
290
            in_cols, preserve=[in_pkey_col]))
291
        input_joins = [in_table]
292
        db.log_debug('Temp table: '+strings.as_tt(in_table.to_str(db)), level=2)
293 3077 aaronmk
294
    mapping = sql_gen.ColDict(db, out_table, mapping)
295
        # after applying dicts.join() because that returns a plain dict
296
297
    # Resolve default value column
298
    if default != None:
299
        try: default = mapping[default]
300
        except KeyError:
301
            db.log_debug('Default value column '
302
                +strings.as_tt(strings.repr_no_u(default))
303
                +' does not exist in mapping, falling back to None', level=2.1)
304
            default = None
305
306 3287 aaronmk
    # Save default values for all rows since in_table may have rows deleted
307 3431 aaronmk
    if is_literals: pass
308
    elif is_function: full_in_table = in_table
309 3386 aaronmk
    else:
310
        full_in_table = sql_gen.suffixed_table(in_table, '_full')
311
        full_in_table_cols = [in_pkey_col]
312
        if default != None:
313
            full_in_table_cols.append(default)
314
            default = sql_gen.with_table(default, full_in_table)
315
        sql.run_query_into(db, sql.mk_select(db, in_table, full_in_table_cols,
316
            order_by=None), into=full_in_table, add_pkey_=True)
317 3287 aaronmk
318 3431 aaronmk
    if not is_literals:
319
        pkeys_names = [in_pkey, out_pkey]
320
        pkeys_cols = [in_pkey_col, out_pkey_col]
321 3077 aaronmk
322
    pkeys_table_exists_ref = [False]
323 3307 aaronmk
    def insert_into_pkeys(joins, cols, **kw_args):
324
        query = sql.mk_select(db, joins, cols, order_by=None)
325 3077 aaronmk
        if pkeys_table_exists_ref[0]:
326 3289 aaronmk
            sql.insert_select(db, into, pkeys_names, query, **kw_args)
327 3077 aaronmk
        else:
328 3304 aaronmk
            sql.run_query_into(db, query, into=into, add_pkey_=True, **kw_args)
329 3077 aaronmk
            pkeys_table_exists_ref[0] = True
330
331
    limit_ref = [None]
332 3418 aaronmk
    def mk_main_select(joins, cols):
333
        return sql.mk_select(db, joins, cols, limit=limit_ref[0], order_by=None)
334
335 3431 aaronmk
    if is_literals: insert_in_table = None
336
    else:
337
        insert_in_table = in_table
338
        insert_in_tables = [insert_in_table]
339 3352 aaronmk
    join_cols = sql_gen.ColDict(db, out_table)
340 3077 aaronmk
341
    exc_strs = set()
342
    def log_exc(e):
343
        e_str = exc.str_(e, first_line_only=True)
344
        log_debug('Caught exception: '+e_str)
345
        assert e_str not in exc_strs # avoid infinite loops
346
        exc_strs.add(e_str)
347
348
    def remove_all_rows():
349
        log_debug('Ignoring all rows')
350
        limit_ref[0] = 0 # just create an empty pkeys table
351
352 3352 aaronmk
    def ignore_cond(cond, e):
353
        out_table_cols = sql_gen.ColDict(db, out_table)
354
        out_table_cols.update(util.dict_subset_right_join({},
355
            sql.table_cols(db, out_table)))
356
357
        in_cols = []
358
        cond = sql.map_expr(db, cond, mapping, in_cols)
359
        cond = sql.map_expr(db, cond, out_table_cols)
360
361
        track_data_error(db, errors_table_, sql_gen.cols_srcs(in_cols), None,
362
            e.cause.pgcode,
363
            strings.ensure_newl(e.cause.pgerror)+'condition: '+cond)
364
365
        not_cond = sql_gen.NotCond(sql_gen.CustomCode(cond))
366
        log_debug('Ignoring rows where '+strings.as_tt(not_cond.to_str(db)))
367
        sql.delete(db, insert_in_table, not_cond)
368
369 3294 aaronmk
    not_null_cols = set()
370 3077 aaronmk
    def ignore(in_col, value, e):
371 3311 aaronmk
        in_col = sql_gen.with_table(in_col, insert_in_table)
372
373 3078 aaronmk
        track_data_error(db, errors_table_, in_col.srcs, value,
374 3077 aaronmk
            e.cause.pgcode, e.cause.pgerror)
375
        log_debug('Ignoring rows with '+strings.as_tt(repr(in_col))+' = '
376
            +strings.as_tt(repr(value)))
377 3294 aaronmk
378 3310 aaronmk
        sql.add_index(db, in_col, insert_in_table) # enable fast filtering
379 3294 aaronmk
        if value != None and in_col not in not_null_cols:
380
            # Try just mapping the value to NULL
381
            sql.update(db, insert_in_table, [(in_col, None)],
382
                sql_gen.ColValueCond(in_col, value))
383 3293 aaronmk
        else:
384 3309 aaronmk
            sql.delete(db, insert_in_table, sql_gen.ColValueCond(in_col, value))
385 3294 aaronmk
            if value == None: not_null_cols.add(in_col)
386 3077 aaronmk
387 3431 aaronmk
    if not is_literals:
388
        def insert_pkeys_table(which):
389
            return sql_gen.Table(sql_gen.concat(in_table.name,
390
                '_insert_'+which+'_pkeys'))
391
        insert_out_pkeys = insert_pkeys_table('out')
392
        insert_in_pkeys = insert_pkeys_table('in')
393 3077 aaronmk
394
    # Do inserts and selects
395
    while True:
396 3473 aaronmk
        has_joins = join_cols != {}
397
398 3077 aaronmk
        if limit_ref[0] == 0: # special case
399 3473 aaronmk
            assert not has_joins
400
401 3431 aaronmk
            if is_literals: return None
402 3472 aaronmk
            log_debug('Creating an empty output pkeys table')
403 3077 aaronmk
            cur = sql.run_query_into(db, sql.mk_select(db, out_table,
404 3312 aaronmk
                [out_pkey], order_by=None, limit=0), into=insert_out_pkeys)
405 3077 aaronmk
            break # don't do main case
406
407
        log_debug('Trying to insert new rows')
408
409
        # Prepare to insert new rows
410 3291 aaronmk
        if is_function:
411
            log_debug('Calling function on input rows')
412
            args = dict(((k.name, v) for k, v in mapping.iteritems()))
413
            func_call = sql_gen.NamedCol(out_pkey,
414
                sql_gen.FunctionCall(out_table, **args))
415 3077 aaronmk
        else:
416 3291 aaronmk
            insert_args = dict(recover=True, cacheable=False)
417
            if has_joins:
418
                insert_args.update(dict(ignore=True))
419
            else:
420 3431 aaronmk
                insert_args.update(dict(returning=out_pkey))
421
                if not is_literals:
422
                    insert_args.update(dict(into=insert_out_pkeys))
423 3291 aaronmk
            main_select = mk_main_select([insert_in_table], [sql_gen.with_table(
424
                c, insert_in_table) for c in mapping.values()])
425 3077 aaronmk
426 3292 aaronmk
        try:
427
            cur = None
428 3077 aaronmk
            if is_function:
429 3431 aaronmk
                if is_literals: cur = sql.select(db, fields=[func_call])
430
                else:
431
                    insert_into_pkeys(input_joins, [in_pkey_col, func_call],
432
                        recover=True)
433 3077 aaronmk
            else:
434 3292 aaronmk
                cur = sql.insert_select(db, out_table, mapping.keys(),
435 3077 aaronmk
                    main_select, **insert_args)
436
            break # insert successful
437
        except sql.MissingCastException, e:
438
            log_exc(e)
439
440
            out_col = e.col
441
            type_ = e.type
442
443
            log_debug('Casting '+strings.as_tt(out_col)+' input to '
444
                +strings.as_tt(type_))
445 3111 aaronmk
            in_col = mapping[out_col]
446
            while True:
447
                try:
448
                    mapping[out_col] = cast_temp_col(db, type_, in_col,
449
                        errors_table_)
450
                    break # cast successful
451
                except sql.InvalidValueException, e:
452
                    log_exc(e)
453
454 3294 aaronmk
                    ignore(in_col, e.value, e)
455 3077 aaronmk
        except sql.DuplicateKeyException, e:
456
            log_exc(e)
457
458 3274 aaronmk
            # Different rows violating different unique constraints not
459
            # supported
460
            assert not join_cols
461
462 3077 aaronmk
            join_cols.update(util.dict_subset_right_join(mapping, e.cols))
463
            log_debug('Ignoring existing rows, comparing on these columns:\n'
464
                +strings.as_inline_table(join_cols, ustr=col_ustr))
465 3102 aaronmk
466 3431 aaronmk
            if is_literals:
467
                return sql.value(sql.select(db, out_table, [out_pkey_col],
468
                    mapping, order_by=None))
469
470 3102 aaronmk
            # Uniquify input table to avoid internal duplicate keys
471
            insert_in_table = sql.distinct_table(db, insert_in_table,
472 3358 aaronmk
                join_cols.values())
473 3144 aaronmk
            insert_in_tables.append(insert_in_table)
474 3077 aaronmk
        except sql.NullValueException, e:
475
            log_exc(e)
476
477
            out_col, = e.cols
478
            try: in_col = mapping[out_col]
479
            except KeyError:
480 3323 aaronmk
                msg = 'Missing mapping for NOT NULL column '+out_col
481
                log_debug(msg)
482
                if default == None: on_error(SyntaxError(msg)) # required col
483 3077 aaronmk
                remove_all_rows()
484 3294 aaronmk
            else: ignore(in_col, None, e)
485 3352 aaronmk
        except sql.CheckException, e:
486
            log_exc(e)
487
488
            ignore_cond(e.cond, e)
489 3413 aaronmk
        except sql.InvalidValueException, e:
490
            log_exc(e)
491
492
            for in_col in mapping.values(): ignore(in_col, e.value, e)
493 3077 aaronmk
        except sql.DatabaseErrors, e:
494
            log_exc(e)
495
496
            log_debug('No handler for exception')
497
            on_error(e)
498
            remove_all_rows()
499
        # after exception handled, rerun loop with additional constraints
500
501
    if cur != None and row_ct_ref != None and cur.rowcount >= 0:
502
        row_ct_ref[0] += cur.rowcount
503
504 3431 aaronmk
    if is_literals_or_function: pass # pkeys table already created
505 3077 aaronmk
    elif has_joins:
506
        select_joins = input_joins+[sql_gen.Join(out_table, join_cols)]
507
        log_debug('Getting output table pkeys of existing/inserted rows')
508 3306 aaronmk
        insert_into_pkeys(select_joins, pkeys_cols)
509 3077 aaronmk
    else:
510
        sql.add_row_num(db, insert_out_pkeys) # for joining with input pkeys
511
512
        log_debug('Getting input table pkeys of inserted rows')
513 3285 aaronmk
        # Note that mk_main_select() does not use ORDER BY. Instead, assume that
514
        # since the SELECT query is identical to the one used in INSERT SELECT,
515
        # its rows will be retrieved in the same order.
516 3077 aaronmk
        sql.run_query_into(db, mk_main_select(input_joins, [in_pkey]),
517
            into=insert_in_pkeys)
518
        sql.add_row_num(db, insert_in_pkeys) # for joining with output pkeys
519
520
        assert sql.table_row_count(db, insert_out_pkeys) == sql.table_row_count(
521
            db, insert_in_pkeys)
522
523
        log_debug('Combining output and input pkeys in inserted order')
524
        pkey_joins = [insert_in_pkeys, sql_gen.Join(insert_out_pkeys,
525
            {sql.row_num_col: sql_gen.join_same_not_null})]
526
        insert_into_pkeys(pkey_joins, pkeys_names)
527
528
        sql.empty_temp(db, [insert_out_pkeys, insert_in_pkeys])
529
530 3431 aaronmk
    if not is_literals_or_function:
531 3187 aaronmk
        log_debug('Setting pkeys of missing rows to '
532
            +strings.as_tt(repr(default)))
533 3287 aaronmk
        missing_rows_joins = [full_in_table, sql_gen.Join(into,
534 3187 aaronmk
            {in_pkey: sql_gen.join_same_not_null}, sql_gen.filter_out)]
535
            # must use join_same_not_null or query will take forever
536
        insert_into_pkeys(missing_rows_joins,
537 3287 aaronmk
            [sql_gen.Col(in_pkey, full_in_table),
538
            sql_gen.NamedCol(out_pkey, default)])
539 3187 aaronmk
    # otherwise, there is already an entry for every row
540 3077 aaronmk
541 3431 aaronmk
    if is_literals: return sql.value(cur)
542
    else:
543
        assert (sql.table_row_count(db, into)
544
            == sql.table_row_count(db, full_in_table))
545
546
        sql.empty_temp(db, insert_in_tables+[full_in_table])
547
548
        srcs = []
549
        if is_func: srcs = sql_gen.cols_srcs(in_cols)
550
        return sql_gen.Col(out_pkey, into, srcs)