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