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
class ExcToErrorsTable(sql_gen.ExcToWarning):
41
    '''Handles an exception by saving it or converting it to a warning.'''
42
    def __init__(self, return_, srcs, errors_table):
43
        '''
44
        @param return_ See sql_gen.ExcToWarning
45
        @param srcs The column names for the errors table
46
        @param errors_table None|sql_gen.Table
47
        @pre The invalid value must be in a local variable "value" of type text.
48
        '''
49
        sql_gen.ExcToWarning.__init__(self, return_)
50
        
51
        self.srcs = srcs
52
        self.errors_table = errors_table
53
    
54
    def to_str(self, db):
55
        if not self.srcs or self.errors_table == None:
56
            return sql_gen.ExcToWarning.to_str(self, db)
57
        
58
        errors_table_cols = map(sql_gen.Col,
59
            ['column', 'value', 'error_code', 'error'])
60
        col_names_query = sql.mk_select(db, sql_gen.NamedValues('c', None,
61
            [[c.name] for c in self.srcs]), order_by=None)
62
        insert_query = sql.mk_insert_select(db, self.errors_table,
63
            errors_table_cols,
64
            sql_gen.Values(errors_table_cols).to_str(db))+';\n'
65
        return '''\
66
-- Save error in errors table.
67
DECLARE
68
    error_code text := SQLSTATE;
69
    error text := SQLERRM;
70
BEGIN
71
    -- Insert the value and error for *each* source column.
72
'''+strings.indent(sql_gen.RowExcIgnore('text', col_names_query, insert_query,
73
    row_var=errors_table_cols[0]).to_str(db))+'''
74
END;
75

    
76
'''+self.return_.to_str(db)
77

    
78
def data_exception_handler(*args, **kw_args):
79
    '''Handles a data_exception by saving it or converting it to a warning.
80
    For params, see ExcToErrorsTable().
81
    '''
82
    return sql_gen.data_exception_handler(ExcToErrorsTable(*args, **kw_args))
83

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

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

    
145
def errors_table(db, table, if_exists=True):
146
    '''
147
    @param if_exists If set, returns None if the errors table doesn't exist
148
    @return None|sql_gen.Table
149
    '''
150
    table = sql_gen.as_Table(table)
151
    if table.srcs != (): table = table.srcs[0]
152
    
153
    errors_table = sql_gen.suffixed_table(table, '.errors')
154
    if if_exists and not sql.table_exists(db, errors_table): return None
155
    return errors_table
156

    
157
##### Import
158

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

    
178
def get(db, table, row, pkey, row_ct_ref=None, create=False):
179
    '''Recovers from errors'''
180
    try:
181
        return sql.value(sql.select(db, table, [pkey], row, limit=1,
182
            recover=True))
183
    except StopIteration:
184
        if not create: raise
185
        return put(db, table, row, pkey, row_ct_ref) # insert new row
186

    
187
def is_func_result(col):
188
    return col.table.name.find('(') >= 0 and col.name == 'result'
189

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

    
219
def put_table(db, out_table, in_tables, mapping, row_ct_ref=None, into=None,
220
    default=None, is_func=False, on_error=exc.raise_):
221
    '''Recovers from errors.
222
    Only works under PostgreSQL (uses INSERT RETURNING).
223
    IMPORTANT: Must be run at the *beginning* of a transaction.
224
    @param in_tables The main input table to select from, followed by a list of
225
        tables to join with it using the main input table's pkey
226
    @param mapping dict(out_table_col=in_table_col, ...)
227
        * out_table_col: str (*not* sql_gen.Col)
228
        * in_table_col: sql_gen.Col|literal-value
229
    @param into The table to contain the output and input pkeys.
230
        Defaults to `out_table.name+'_pkeys'`.
231
    @param default The *output* column to use as the pkey for missing rows.
232
        If this output column does not exist in the mapping, uses None.
233
    @param is_func Whether out_table is the name of a SQL function, not a table
234
    @return sql_gen.Col Where the output pkeys are made available
235
    '''
236
    import psycopg2.extensions
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
    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
    
261
    # Determine if can use optimization for only literal values
262
    is_literals = not reduce(operator.or_, map(sql_gen.is_table_col,
263
        mapping.values()), False)
264
    is_literals_or_function = is_literals or is_function
265
    
266
    if in_tables0 == None: errors_table_ = None
267
    else: errors_table_ = errors_table(db, in_tables0)
268
    
269
    # Create input joins from list of input tables
270
    input_joins = [in_tables0]+[sql_gen.Join(v,
271
        {in_pkey: sql_gen.join_same_not_null}) for v in in_tables_]
272
    
273
    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
    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
    
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
    # Save default values for all rows since in_table may have rows deleted
307
    if is_literals: pass
308
    elif is_function: full_in_table = in_table
309
    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
    
318
    if not is_literals:
319
        pkeys_names = [in_pkey, out_pkey]
320
        pkeys_cols = [in_pkey_col, out_pkey_col]
321
    
322
    pkeys_table_exists_ref = [False]
323
    def insert_into_pkeys(joins, cols=None, limit=None, **kw_args):
324
        query = sql.mk_select(db, joins, cols, order_by=None, limit=limit)
325
        if pkeys_table_exists_ref[0]:
326
            sql.insert_select(db, into, pkeys_names, query, **kw_args)
327
        else:
328
            sql.run_query_into(db, query, into=into, add_pkey_=True, **kw_args)
329
            pkeys_table_exists_ref[0] = True
330
    
331
    limit_ref = [None]
332
    def mk_main_select(joins, cols):
333
        return sql.mk_select(db, joins, cols, limit=limit_ref[0], order_by=None)
334
    
335
    if is_literals: insert_in_table = None
336
    else:
337
        insert_in_table = in_table
338
        insert_in_tables = [insert_in_table]
339
    join_cols = sql_gen.ColDict(db, out_table)
340
    
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
    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
    not_null_cols = set()
370
    def ignore(in_col, value, e):
371
        in_col = sql_gen.with_table(in_col, insert_in_table)
372
        
373
        track_data_error(db, errors_table_, in_col.srcs, value,
374
            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
        
378
        sql.add_index(db, in_col, insert_in_table) # enable fast filtering
379
        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
        else:
384
            sql.delete(db, insert_in_table, sql_gen.ColValueCond(in_col, value))
385
            if value == None: not_null_cols.add(in_col)
386
    
387
    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
    
394
    # Do inserts and selects
395
    while True:
396
        has_joins = join_cols != {}
397
        
398
        if limit_ref[0] == 0: # special case
399
            assert not has_joins
400
            
401
            if is_literals: return None
402
            log_debug('Creating an empty output pkeys table')
403
            cur = sql.run_query_into(db, sql.mk_select(db, out_table,
404
                [out_pkey], order_by=None, limit=0), into=insert_out_pkeys)
405
            break # don't do main case
406
        
407
        log_debug('Trying to insert new rows')
408
        
409
        # Prepare to insert new rows
410
        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
            
416
            if not is_literals:
417
                # Create empty pkeys table so its row type can be used
418
                insert_into_pkeys(input_joins, [in_pkey_col, func_call],
419
                    limit=0, recover=True)
420
                
421
                # Create error handling wrapper function
422
                select_cols = [in_pkey_col]+args.values()
423
                args = dict(((k, sql_gen.with_table(v, sql_gen.Table('row')))
424
                    for k, v in args.iteritems()))
425
                func_call = sql_gen.FunctionCall(out_table, **args)
426
                wrapper = db.TempFunction(sql_gen.concat(into.name, '_wrap'))
427
                sql.define_func(db, sql_gen.FunctionDef(wrapper,
428
                    sql_gen.SetOf(into),
429
                    sql_gen.RowExcIgnore(sql_gen.RowType(in_table),
430
                        sql.mk_select(db, input_joins, order_by=None),
431
                        sql_gen.ReturnQuery(sql.mk_select(db,
432
                            fields=[sql_gen.Col(in_pkey, 'row'), func_call],
433
                            explain=False)),
434
                        exc_handler=sql_gen.plpythonu_error_handler)
435
                    ))
436
                wrapper_table = sql_gen.FunctionCall(wrapper)
437
        else:
438
            insert_args = dict(recover=True, cacheable=False)
439
            if has_joins:
440
                insert_args.update(dict(ignore=True))
441
            else:
442
                insert_args.update(dict(returning=out_pkey))
443
                if not is_literals:
444
                    insert_args.update(dict(into=insert_out_pkeys))
445
            main_select = mk_main_select([insert_in_table], [sql_gen.with_table(
446
                c, insert_in_table) for c in mapping.values()])
447
        
448
        try:
449
            cur = None
450
            if is_function:
451
                if is_literals: cur = sql.select(db, fields=[func_call])
452
                else: insert_into_pkeys(wrapper_table, recover=True)
453
            else:
454
                cur = sql.insert_select(db, out_table, mapping.keys(),
455
                    main_select, **insert_args)
456
            break # insert successful
457
        except sql.MissingCastException, e:
458
            log_exc(e)
459
            
460
            out_col = e.col
461
            type_ = e.type
462
            
463
            log_debug('Casting '+strings.as_tt(out_col)+' input to '
464
                +strings.as_tt(type_))
465
            in_col = mapping[out_col]
466
            while True:
467
                try:
468
                    mapping[out_col] = cast_temp_col(db, type_, in_col,
469
                        errors_table_)
470
                    break # cast successful
471
                except sql.InvalidValueException, e:
472
                    log_exc(e)
473
                    
474
                    ignore(in_col, e.value, e)
475
        except sql.DuplicateKeyException, e:
476
            log_exc(e)
477
            
478
            # Different rows violating different unique constraints not
479
            # supported
480
            assert not join_cols
481
            
482
            join_cols.update(util.dict_subset_right_join(mapping, e.cols))
483
            log_debug('Ignoring existing rows, comparing on these columns:\n'
484
                +strings.as_inline_table(join_cols, ustr=col_ustr))
485
            
486
            if is_literals:
487
                return sql.value(sql.select(db, out_table, [out_pkey_col],
488
                    mapping, order_by=None))
489
            
490
            # Uniquify input table to avoid internal duplicate keys
491
            insert_in_table = sql.distinct_table(db, insert_in_table,
492
                join_cols.values())
493
            insert_in_tables.append(insert_in_table)
494
        except sql.NullValueException, e:
495
            log_exc(e)
496
            
497
            out_col, = e.cols
498
            try: in_col = mapping[out_col]
499
            except KeyError:
500
                msg = 'Missing mapping for NOT NULL column '+out_col
501
                log_debug(msg)
502
                if default == None: on_error(SyntaxError(msg)) # required col
503
                remove_all_rows()
504
            else: ignore(in_col, None, e)
505
        except sql.CheckException, e:
506
            log_exc(e)
507
            
508
            ignore_cond(e.cond, e)
509
        except sql.InvalidValueException, e:
510
            log_exc(e)
511
            
512
            for in_col in mapping.values(): ignore(in_col, e.value, e)
513
        except psycopg2.extensions.TransactionRollbackError, e:
514
            log_exc(e)
515
            # retry
516
        except sql.DatabaseErrors, e:
517
            log_exc(e)
518
            
519
            log_debug('No handler for exception')
520
            on_error(e)
521
            remove_all_rows()
522
        # after exception handled, rerun loop with additional constraints
523
    
524
    if cur != None and row_ct_ref != None and cur.rowcount >= 0:
525
        row_ct_ref[0] += cur.rowcount
526
    
527
    if is_literals_or_function: pass # pkeys table already created
528
    elif has_joins:
529
        select_joins = input_joins+[sql_gen.Join(out_table, join_cols)]
530
        log_debug('Getting output table pkeys of existing/inserted rows')
531
        insert_into_pkeys(select_joins, pkeys_cols)
532
    else:
533
        sql.add_row_num(db, insert_out_pkeys) # for joining with input pkeys
534
        
535
        log_debug('Getting input table pkeys of inserted rows')
536
        # Note that mk_main_select() does not use ORDER BY. Instead, assume that
537
        # since the SELECT query is identical to the one used in INSERT SELECT,
538
        # its rows will be retrieved in the same order.
539
        sql.run_query_into(db, mk_main_select(input_joins, [in_pkey]),
540
            into=insert_in_pkeys)
541
        sql.add_row_num(db, insert_in_pkeys) # for joining with output pkeys
542
        
543
        assert sql.table_row_count(db, insert_out_pkeys) == sql.table_row_count(
544
            db, insert_in_pkeys)
545
        
546
        log_debug('Combining output and input pkeys in inserted order')
547
        pkey_joins = [insert_in_pkeys, sql_gen.Join(insert_out_pkeys,
548
            {sql.row_num_col: sql_gen.join_same_not_null})]
549
        insert_into_pkeys(pkey_joins, pkeys_names)
550
        
551
        sql.empty_temp(db, [insert_out_pkeys, insert_in_pkeys])
552
    
553
    if not is_literals_or_function:
554
        log_debug('Setting pkeys of missing rows to '
555
            +strings.as_tt(repr(default)))
556
        missing_rows_joins = [full_in_table, sql_gen.Join(into,
557
            {in_pkey: sql_gen.join_same_not_null}, sql_gen.filter_out)]
558
            # must use join_same_not_null or query will take forever
559
        insert_into_pkeys(missing_rows_joins,
560
            [sql_gen.Col(in_pkey, full_in_table),
561
            sql_gen.NamedCol(out_pkey, default)])
562
    # otherwise, there is already an entry for every row
563
    
564
    if is_literals: return sql.value(cur)
565
    else:
566
        assert (sql.table_row_count(db, into)
567
            == sql.table_row_count(db, full_in_table))
568
        
569
        sql.empty_temp(db, insert_in_tables+[full_in_table])
570
        
571
        srcs = []
572
        if is_func: srcs = sql_gen.cols_srcs(in_cols)
573
        return sql_gen.Col(out_pkey, into, srcs)
(26-26/37)