Project

General

Profile

1
# Database import/export
2

    
3
import operator
4

    
5
import exc
6
import dicts
7
import sql
8
import sql_gen
9
import strings
10
import util
11

    
12
##### 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
##### 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 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
    @pre The invalid value must be in a local variable "value" of type text.
46
    '''
47
    save_errors = errors_table != None and srcs
48
    handler = ''
49
    if save_errors:
50
        errors_table_cols = map(sql_gen.Col,
51
            ['column', 'value', 'error_code', 'error'])
52
        col_names_query = sql.mk_select(db, sql_gen.NamedValues('c', None,
53
            [[c.name] for c in srcs]), order_by=None)
54
        insert_query = sql.mk_insert_select(db, errors_table, errors_table_cols,
55
            sql_gen.Values(errors_table_cols).to_str(db))+';\n'
56
        handler += '''\
57
-- Save error in errors table.
58
DECLARE
59
    error_code text := SQLSTATE;
60
    error text := SQLERRM;
61
BEGIN
62
    -- Insert the value and error for *each* source column.
63
'''+strings.indent(sql_gen.RowExcIgnore('text', col_names_query, insert_query,
64
    row_var=errors_table_cols[0]).to_str(db))+'''
65
END;
66
'''
67
    else:
68
        handler += '''\
69
RAISE WARNING '%', SQLERRM;
70
'''
71
    handler += '''\
72
RETURN NULL;
73
'''
74
    return sql_gen.ExcHandler('data_exception', handler)
75

    
76
def cast(db, type_, col, errors_table=None):
77
    '''Casts an (unrenamed) column or value.
78
    If errors_table set and col has srcs, saves errors in errors_table (using
79
    col's srcs attr as source columns). Otherwise, converts errors to warnings.
80
    @param col str|sql_gen.Col|sql_gen.Literal
81
    @param errors_table None|sql_gen.Table|str
82
    '''
83
    col = sql_gen.as_Col(col)
84
    
85
    # Don't convert exceptions to warnings for user-supplied constants
86
    if isinstance(col, sql_gen.Literal): return sql_gen.Cast(type_, col)
87
    
88
    assert not isinstance(col, sql_gen.NamedCol)
89
    
90
    function_name = strings.first_word(type_)
91
    srcs = col.srcs
92
    save_errors = (errors_table != None and isinstance(col, sql_gen.Col)
93
        and col.srcs != ())
94
    if save_errors:
95
        srcs = map(sql_gen.to_name_only_col, col.srcs)
96
        function_name = str(sql_gen.FunctionCall(function_name, *srcs))
97
    function = db.TempFunction(function_name)
98
    
99
    # Create function definition
100
    modifiers = 'STRICT'
101
    if not save_errors: modifiers = 'IMMUTABLE '+modifiers
102
    handler = data_exception_handler(db, srcs, errors_table)
103
    body = sql_gen.CustomCode(handler.to_str(db, '''\
104
/* The explicit cast to the return type is needed to make the cast happen
105
inside the try block. (Implicit casts to the return type happen at the end
106
of the function, outside any block.) */
107
RETURN value::'''+type_+''';
108
'''))
109
    body.lang='plpgsql'
110
    sql.define_func(db, sql_gen.FunctionDef(function, type_, body,
111
        [sql_gen.FunctionParam('value', 'text')], modifiers))
112
    
113
    return sql_gen.FunctionCall(function, col)
114

    
115
def cast_temp_col(db, type_, col, errors_table=None):
116
    '''Like cast(), but creates a new column with the cast values if the input
117
    is a column.
118
    @return The new column or cast value
119
    '''
120
    def cast_(col): return cast(db, type_, col, errors_table)
121
    
122
    try: col = sql_gen.underlying_col(col)
123
    except sql_gen.NoUnderlyingTableException: return sql_gen.wrap(cast_, col)
124
    
125
    table = col.table
126
    new_col = sql_gen.suffixed_col(col, '::'+strings.first_word(type_))
127
    expr = cast_(col)
128
    
129
    # Add column
130
    new_typed_col = sql_gen.TypedCol(new_col.name, type_)
131
    sql.add_col(db, table, new_typed_col, comment=repr(col)+'::'+type_)
132
    new_col.name = new_typed_col.name # propagate any renaming
133
    
134
    sql.update(db, table, [(new_col, expr)], in_place=True, recover=True)
135
    
136
    return new_col
137

    
138
def errors_table(db, table, if_exists=True):
139
    '''
140
    @param if_exists If set, returns None if the errors table doesn't exist
141
    @return None|sql_gen.Table
142
    '''
143
    table = sql_gen.as_Table(table)
144
    if table.srcs != (): table = table.srcs[0]
145
    
146
    errors_table = sql_gen.suffixed_table(table, '.errors')
147
    if if_exists and not sql.table_exists(db, errors_table): return None
148
    return errors_table
149

    
150
##### Import
151

    
152
def put(db, table, row, pkey_=None, row_ct_ref=None):
153
    '''Recovers from errors.
154
    Only works under PostgreSQL (uses INSERT RETURNING).
155
    '''
156
    row = sql_gen.ColDict(db, table, row)
157
    if pkey_ == None: pkey_ = sql.pkey(db, table, recover=True)
158
    
159
    try:
160
        cur = sql.insert(db, table, row, pkey_, recover=True, log_level=3.5)
161
        if row_ct_ref != None and cur.rowcount >= 0:
162
            row_ct_ref[0] += cur.rowcount
163
        return sql.value(cur)
164
    except sql.DuplicateKeyException, e:
165
        row = sql_gen.ColDict(db, table,
166
            util.dict_subset_right_join(row, e.cols))
167
        return sql.value(sql.select(db, table, [pkey_], row, recover=True,
168
            log_level=3.5))
169
    except sql.NullValueException: return None
170

    
171
def get(db, table, row, pkey, row_ct_ref=None, create=False):
172
    '''Recovers from errors'''
173
    try:
174
        return sql.value(sql.select(db, table, [pkey], row, limit=1,
175
            recover=True))
176
    except StopIteration:
177
        if not create: raise
178
        return put(db, table, row, pkey, row_ct_ref) # insert new row
179

    
180
def is_func_result(col):
181
    return col.table.name.find('(') >= 0 and col.name == 'result'
182

    
183
def into_table_name(out_table, in_tables0, mapping, is_func):
184
    def in_col_str(in_col):
185
        in_col = sql_gen.remove_col_rename(in_col)
186
        if isinstance(in_col, sql_gen.Col):
187
            table = in_col.table
188
            if table == in_tables0:
189
                in_col = sql_gen.to_name_only_col(in_col)
190
            elif is_func_result(in_col): in_col = table # omit col name
191
        return str(in_col)
192
    
193
    str_ = str(out_table)
194
    if is_func:
195
        str_ += '('
196
        
197
        try: value_in_col = mapping['value']
198
        except KeyError:
199
            str_ += ', '.join((str(k)+'='+in_col_str(v)
200
                for k, v in mapping.iteritems()))
201
        else: str_ += in_col_str(value_in_col)
202
        
203
        str_ += ')'
204
    else:
205
        out_col = 'rank'
206
        try: in_col = mapping[out_col]
207
        except KeyError: str_ += '_pkeys'
208
        else: # has a rank column, so hierarchical
209
            str_ += '['+str(out_col)+'='+in_col_str(in_col)+']'
210
    return str_
211

    
212
def put_table(db, out_table, in_tables, mapping, row_ct_ref=None, into=None,
213
    default=None, is_func=False, on_error=exc.raise_):
214
    '''Recovers from errors.
215
    Only works under PostgreSQL (uses INSERT RETURNING).
216
    IMPORTANT: Must be run at the *beginning* of a transaction.
217
    @param in_tables The main input table to select from, followed by a list of
218
        tables to join with it using the main input table's pkey
219
    @param mapping dict(out_table_col=in_table_col, ...)
220
        * out_table_col: str (*not* sql_gen.Col)
221
        * in_table_col: sql_gen.Col|literal-value
222
    @param into The table to contain the output and input pkeys.
223
        Defaults to `out_table.name+'_pkeys'`.
224
    @param default The *output* column to use as the pkey for missing rows.
225
        If this output column does not exist in the mapping, uses None.
226
    @param is_func Whether out_table is the name of a SQL function, not a table
227
    @return sql_gen.Col Where the output pkeys are made available
228
    '''
229
    import psycopg2.extensions
230
    
231
    out_table = sql_gen.as_Table(out_table)
232
    
233
    def log_debug(msg): db.log_debug(msg, level=1.5)
234
    def col_ustr(str_):
235
        return strings.repr_no_u(sql_gen.remove_col_rename(str_))
236
    
237
    log_debug('********** New iteration **********')
238
    log_debug('Inserting these input columns into '+strings.as_tt(
239
        out_table.to_str(db))+':\n'+strings.as_table(mapping, ustr=col_ustr))
240
    
241
    is_function = sql.function_exists(db, out_table)
242
    
243
    if is_function: out_pkey = 'result'
244
    else: out_pkey = sql.pkey(db, out_table, recover=True)
245
    out_pkey_col = sql_gen.as_Col(out_pkey, out_table)
246
    
247
    in_tables_ = in_tables[:] # don't modify input!
248
    try: in_tables0 = in_tables_.pop(0) # first table is separate
249
    except IndexError: in_tables0 = None
250
    else:
251
        in_pkey = sql.pkey(db, in_tables0, recover=True)
252
        in_pkey_col = sql_gen.as_Col(in_pkey, in_tables0)
253
    
254
    # Determine if can use optimization for only literal values
255
    is_literals = not reduce(operator.or_, map(sql_gen.is_table_col,
256
        mapping.values()), False)
257
    is_literals_or_function = is_literals or is_function
258
    
259
    if in_tables0 == None: errors_table_ = None
260
    else: errors_table_ = errors_table(db, in_tables0)
261
    
262
    # Create input joins from list of input tables
263
    input_joins = [in_tables0]+[sql_gen.Join(v,
264
        {in_pkey: sql_gen.join_same_not_null}) for v in in_tables_]
265
    
266
    if mapping == {} and not is_function: # need >= one column for INSERT SELECT
267
        mapping = {out_pkey: None} # ColDict will replace with default value
268
    
269
    if not is_literals:
270
        if into == None:
271
            into = into_table_name(out_table, in_tables0, mapping, is_func)
272
        into = sql_gen.as_Table(into)
273
        
274
        # Set column sources
275
        in_cols = filter(sql_gen.is_table_col, mapping.values())
276
        for col in in_cols:
277
            if col.table == in_tables0: col.set_srcs(sql_gen.src_self)
278
        
279
        log_debug('Joining together input tables into temp table')
280
        # Place in new table so don't modify input and for speed
281
        in_table = sql_gen.Table('in')
282
        mapping = dicts.join(mapping, sql.flatten(db, in_table, input_joins,
283
            in_cols, preserve=[in_pkey_col]))
284
        input_joins = [in_table]
285
        db.log_debug('Temp table: '+strings.as_tt(in_table.to_str(db)), level=2)
286
    
287
    mapping = sql_gen.ColDict(db, out_table, mapping)
288
        # after applying dicts.join() because that returns a plain dict
289
    
290
    # Resolve default value column
291
    if default != None:
292
        try: default = mapping[default]
293
        except KeyError:
294
            db.log_debug('Default value column '
295
                +strings.as_tt(strings.repr_no_u(default))
296
                +' does not exist in mapping, falling back to None', level=2.1)
297
            default = None
298
    
299
    # Save default values for all rows since in_table may have rows deleted
300
    if is_literals: pass
301
    elif is_function: full_in_table = in_table
302
    else:
303
        full_in_table = sql_gen.suffixed_table(in_table, '_full')
304
        full_in_table_cols = [in_pkey_col]
305
        if default != None:
306
            full_in_table_cols.append(default)
307
            default = sql_gen.with_table(default, full_in_table)
308
        sql.run_query_into(db, sql.mk_select(db, in_table, full_in_table_cols,
309
            order_by=None), into=full_in_table, add_pkey_=True)
310
    
311
    if not is_literals:
312
        pkeys_names = [in_pkey, out_pkey]
313
        pkeys_cols = [in_pkey_col, out_pkey_col]
314
    
315
    pkeys_table_exists_ref = [False]
316
    def insert_into_pkeys(joins, cols=None, limit=None, **kw_args):
317
        query = sql.mk_select(db, joins, cols, order_by=None, limit=limit)
318
        if pkeys_table_exists_ref[0]:
319
            sql.insert_select(db, into, pkeys_names, query, **kw_args)
320
        else:
321
            sql.run_query_into(db, query, into=into, add_pkey_=True, **kw_args)
322
            pkeys_table_exists_ref[0] = True
323
    
324
    limit_ref = [None]
325
    def mk_main_select(joins, cols):
326
        return sql.mk_select(db, joins, cols, limit=limit_ref[0], order_by=None)
327
    
328
    if is_literals: insert_in_table = None
329
    else:
330
        insert_in_table = in_table
331
        insert_in_tables = [insert_in_table]
332
    join_cols = sql_gen.ColDict(db, out_table)
333
    
334
    exc_strs = set()
335
    def log_exc(e):
336
        e_str = exc.str_(e, first_line_only=True)
337
        log_debug('Caught exception: '+e_str)
338
        assert e_str not in exc_strs # avoid infinite loops
339
        exc_strs.add(e_str)
340
    
341
    def remove_all_rows():
342
        log_debug('Ignoring all rows')
343
        limit_ref[0] = 0 # just create an empty pkeys table
344
    
345
    def ignore_cond(cond, e):
346
        out_table_cols = sql_gen.ColDict(db, out_table)
347
        out_table_cols.update(util.dict_subset_right_join({},
348
            sql.table_cols(db, out_table)))
349
        
350
        in_cols = []
351
        cond = sql.map_expr(db, cond, mapping, in_cols)
352
        cond = sql.map_expr(db, cond, out_table_cols)
353
        
354
        track_data_error(db, errors_table_, sql_gen.cols_srcs(in_cols), None,
355
            e.cause.pgcode,
356
            strings.ensure_newl(e.cause.pgerror)+'condition: '+cond)
357
        
358
        not_cond = sql_gen.NotCond(sql_gen.CustomCode(cond))
359
        log_debug('Ignoring rows where '+strings.as_tt(not_cond.to_str(db)))
360
        sql.delete(db, insert_in_table, not_cond)
361
    
362
    not_null_cols = set()
363
    def ignore(in_col, value, e):
364
        in_col = sql_gen.with_table(in_col, insert_in_table)
365
        
366
        track_data_error(db, errors_table_, in_col.srcs, value,
367
            e.cause.pgcode, e.cause.pgerror)
368
        log_debug('Ignoring rows with '+strings.as_tt(repr(in_col))+' = '
369
            +strings.as_tt(repr(value)))
370
        
371
        sql.add_index(db, in_col, insert_in_table) # enable fast filtering
372
        if value != None and in_col not in not_null_cols:
373
            # Try just mapping the value to NULL
374
            sql.update(db, insert_in_table, [(in_col, None)],
375
                sql_gen.ColValueCond(in_col, value))
376
        else:
377
            sql.delete(db, insert_in_table, sql_gen.ColValueCond(in_col, value))
378
            if value == None: not_null_cols.add(in_col)
379
    
380
    if not is_literals:
381
        def insert_pkeys_table(which):
382
            return sql_gen.Table(sql_gen.concat(in_table.name,
383
                '_insert_'+which+'_pkeys'))
384
        insert_out_pkeys = insert_pkeys_table('out')
385
        insert_in_pkeys = insert_pkeys_table('in')
386
    
387
    # Do inserts and selects
388
    while True:
389
        has_joins = join_cols != {}
390
        
391
        if limit_ref[0] == 0: # special case
392
            assert not has_joins
393
            
394
            if is_literals: return None
395
            log_debug('Creating an empty output pkeys table')
396
            cur = sql.run_query_into(db, sql.mk_select(db, out_table,
397
                [out_pkey], order_by=None, limit=0), into=insert_out_pkeys)
398
            break # don't do main case
399
        
400
        log_debug('Trying to insert new rows')
401
        
402
        # Prepare to insert new rows
403
        if is_function:
404
            log_debug('Calling function on input rows')
405
            args = dict(((k.name, v) for k, v in mapping.iteritems()))
406
            func_call = sql_gen.NamedCol(out_pkey,
407
                sql_gen.FunctionCall(out_table, **args))
408
            
409
            if not is_literals:
410
                # Create empty pkeys table so its row type can be used
411
                insert_into_pkeys(input_joins, [in_pkey_col, func_call],
412
                    limit=0, recover=True)
413
                
414
                # Create error handling wrapper function
415
                select_cols = [in_pkey_col]+args.values()
416
                args = dict(((k, sql_gen.with_table(v, sql_gen.Table('row')))
417
                    for k, v in args.iteritems()))
418
                func_call = sql_gen.FunctionCall(out_table, **args)
419
                wrapper = db.TempFunction(sql_gen.concat(into.name, '_wrap'))
420
                sql.define_func(db, sql_gen.FunctionDef(wrapper,
421
                    sql_gen.SetOf(into),
422
                    sql_gen.RowExcIgnore(sql_gen.RowType(in_table),
423
                        sql.mk_select(db, input_joins, order_by=None),
424
                        sql_gen.ReturnQuery(sql.mk_select(db,
425
                            fields=[sql_gen.Col(in_pkey, 'row'), func_call],
426
                            explain=False)),
427
                        exc_handler=sql_gen.plpythonu_error_handler)
428
                    ))
429
                wrapper_table = sql_gen.FunctionCall(wrapper)
430
        else:
431
            insert_args = dict(recover=True, cacheable=False)
432
            if has_joins:
433
                insert_args.update(dict(ignore=True))
434
            else:
435
                insert_args.update(dict(returning=out_pkey))
436
                if not is_literals:
437
                    insert_args.update(dict(into=insert_out_pkeys))
438
            main_select = mk_main_select([insert_in_table], [sql_gen.with_table(
439
                c, insert_in_table) for c in mapping.values()])
440
        
441
        try:
442
            cur = None
443
            if is_function:
444
                if is_literals: cur = sql.select(db, fields=[func_call])
445
                else: insert_into_pkeys(wrapper_table, recover=True)
446
            else:
447
                cur = sql.insert_select(db, out_table, mapping.keys(),
448
                    main_select, **insert_args)
449
            break # insert successful
450
        except sql.MissingCastException, e:
451
            log_exc(e)
452
            
453
            out_col = e.col
454
            type_ = e.type
455
            
456
            log_debug('Casting '+strings.as_tt(out_col)+' input to '
457
                +strings.as_tt(type_))
458
            in_col = mapping[out_col]
459
            while True:
460
                try:
461
                    mapping[out_col] = cast_temp_col(db, type_, in_col,
462
                        errors_table_)
463
                    break # cast successful
464
                except sql.InvalidValueException, e:
465
                    log_exc(e)
466
                    
467
                    ignore(in_col, e.value, e)
468
        except sql.DuplicateKeyException, e:
469
            log_exc(e)
470
            
471
            # Different rows violating different unique constraints not
472
            # supported
473
            assert not join_cols
474
            
475
            join_cols.update(util.dict_subset_right_join(mapping, e.cols))
476
            log_debug('Ignoring existing rows, comparing on these columns:\n'
477
                +strings.as_inline_table(join_cols, ustr=col_ustr))
478
            
479
            if is_literals:
480
                return sql.value(sql.select(db, out_table, [out_pkey_col],
481
                    mapping, order_by=None))
482
            
483
            # Uniquify input table to avoid internal duplicate keys
484
            insert_in_table = sql.distinct_table(db, insert_in_table,
485
                join_cols.values())
486
            insert_in_tables.append(insert_in_table)
487
        except sql.NullValueException, e:
488
            log_exc(e)
489
            
490
            out_col, = e.cols
491
            try: in_col = mapping[out_col]
492
            except KeyError:
493
                msg = 'Missing mapping for NOT NULL column '+out_col
494
                log_debug(msg)
495
                if default == None: on_error(SyntaxError(msg)) # required col
496
                remove_all_rows()
497
            else: ignore(in_col, None, e)
498
        except sql.CheckException, e:
499
            log_exc(e)
500
            
501
            ignore_cond(e.cond, e)
502
        except sql.InvalidValueException, e:
503
            log_exc(e)
504
            
505
            for in_col in mapping.values(): ignore(in_col, e.value, e)
506
        except psycopg2.extensions.TransactionRollbackError, e:
507
            log_exc(e)
508
            # retry
509
        except sql.DatabaseErrors, e:
510
            log_exc(e)
511
            
512
            log_debug('No handler for exception')
513
            on_error(e)
514
            remove_all_rows()
515
        # after exception handled, rerun loop with additional constraints
516
    
517
    if cur != None and row_ct_ref != None and cur.rowcount >= 0:
518
        row_ct_ref[0] += cur.rowcount
519
    
520
    if is_literals_or_function: pass # pkeys table already created
521
    elif has_joins:
522
        select_joins = input_joins+[sql_gen.Join(out_table, join_cols)]
523
        log_debug('Getting output table pkeys of existing/inserted rows')
524
        insert_into_pkeys(select_joins, pkeys_cols)
525
    else:
526
        sql.add_row_num(db, insert_out_pkeys) # for joining with input pkeys
527
        
528
        log_debug('Getting input table pkeys of inserted rows')
529
        # Note that mk_main_select() does not use ORDER BY. Instead, assume that
530
        # since the SELECT query is identical to the one used in INSERT SELECT,
531
        # its rows will be retrieved in the same order.
532
        sql.run_query_into(db, mk_main_select(input_joins, [in_pkey]),
533
            into=insert_in_pkeys)
534
        sql.add_row_num(db, insert_in_pkeys) # for joining with output pkeys
535
        
536
        assert sql.table_row_count(db, insert_out_pkeys) == sql.table_row_count(
537
            db, insert_in_pkeys)
538
        
539
        log_debug('Combining output and input pkeys in inserted order')
540
        pkey_joins = [insert_in_pkeys, sql_gen.Join(insert_out_pkeys,
541
            {sql.row_num_col: sql_gen.join_same_not_null})]
542
        insert_into_pkeys(pkey_joins, pkeys_names)
543
        
544
        sql.empty_temp(db, [insert_out_pkeys, insert_in_pkeys])
545
    
546
    if not is_literals_or_function:
547
        log_debug('Setting pkeys of missing rows to '
548
            +strings.as_tt(repr(default)))
549
        missing_rows_joins = [full_in_table, sql_gen.Join(into,
550
            {in_pkey: sql_gen.join_same_not_null}, sql_gen.filter_out)]
551
            # must use join_same_not_null or query will take forever
552
        insert_into_pkeys(missing_rows_joins,
553
            [sql_gen.Col(in_pkey, full_in_table),
554
            sql_gen.NamedCol(out_pkey, default)])
555
    # otherwise, there is already an entry for every row
556
    
557
    if is_literals: return sql.value(cur)
558
    else:
559
        assert (sql.table_row_count(db, into)
560
            == sql.table_row_count(db, full_in_table))
561
        
562
        sql.empty_temp(db, insert_in_tables+[full_in_table])
563
        
564
        srcs = []
565
        if is_func: srcs = sql_gen.cols_srcs(in_cols)
566
        return sql_gen.Col(out_pkey, into, srcs)
(26-26/37)