Project

General

Profile

1
# XML-database conversion
2

    
3
import copy
4
import re
5
from xml.dom import Node
6

    
7
import exc
8
import Parser
9
import sql
10
import sql_io
11
import sql_gen
12
import strings
13
import util
14
import xml_dom
15
import xml_func
16
import xpath
17

    
18
def name_of(node): return re.sub(r'^.*\.', r'', node.tagName)
19

    
20
ptr_suffix = '_id'
21

    
22
def is_ptr(node_name): return node_name.lower().endswith(ptr_suffix)
23

    
24
def ptr_type_guess(node_name):
25
    assert is_ptr(node_name)
26
    return node_name[:-len(ptr_suffix)]
27

    
28
def ptr_target(node):
29
    assert is_ptr(name_of(node))
30
    return xml_dom.value_node(node)
31

    
32
def find_by_name(node, name):
33
    for parent in xml_dom.NodeParentIter(node):
34
        if name_of(parent) == name: return parent
35
        else:
36
            for child in xml_dom.NodeElemIter(parent):
37
                child_name = name_of(child)
38
                if is_ptr(child_name):
39
                    target = ptr_target(child)
40
                    if target.tagName == name: return target
41
                elif child_name == name: return child
42
    return None
43

    
44
def get(db, node, limit=None, start=None):
45
    def pkey(table): return sql.pkey(db, table)
46
    
47
    node = node.firstChild
48
    table = name_of(node)
49
    pkey_ = pkey(table)
50
    
51
    fields = []
52
    conds = {}
53
    for child in xml_dom.NodeElemIter(node):
54
        child_name = name_of(child)
55
        if xml_dom.is_empty(child): fields.append(child_name)
56
        elif xml_dom.is_text(child): conds[child_name] = xml_dom.value(child)
57
        else: raise Exception('Joins not supported yet')
58
    id_ = xml_dom.get_id(node)
59
    if id_ != None: conds[pkey(table)] = id_ # replace any existing pkey value
60
    if fields == []: fields.append(pkey_)
61
    
62
    return sql.select(db, table, fields, conds, limit, start)
63

    
64
def put(db, node, row_ct_ref=None, on_error=exc.raise_, pool=None,
65
    store_ids=False, parent_id=None):
66
    '''store_ids enables searching the tree for missing fields'''
67
    def pkey(table): return sql.pkey(db, table, True)
68
    
69
    def put_(node, parent_id=None):
70
        args = (db, node, row_ct_ref, on_error, pool, store_ids, parent_id)
71
        if parent_id != None and pool != None: pool.apply_async(put, args)
72
        else: return put(*args)
73
    
74
    def on_error_(e):
75
        exc.add_msg(e, 'node:\n'+str(node))
76
        on_error(e)
77
    
78
    table = name_of(node)
79
    try: pkey_ = pkey(table)
80
    except sql.DatabaseErrors, e: on_error_(e); return None
81
    row = {}
82
    children = []
83
    
84
    # Divide children into fields and children with fkeys to parent
85
    for child in xml_dom.NodeElemIter(node):
86
        child_name = name_of(child)
87
        if xml_dom.is_empty(child): row[child_name] = None
88
        elif xml_dom.is_text(child):
89
            row[child_name] = strings.to_unicode(xml_dom.value(child))
90
        elif is_ptr(child_name): row[child_name] = put_(ptr_target(child))
91
        else: children.append(child)
92
    try: del row[pkey_]
93
    except KeyError: pass
94
    
95
    # Add fkey to parent
96
    if parent_id != None:
97
        parent_ptr = node.getAttribute('fkey')
98
        if parent_ptr == '': parent_ptr = pkey(name_of(node.parentNode))
99
        row[parent_ptr] = parent_id
100
    
101
    # Insert node
102
    try:
103
        for try_num in xrange(2):
104
            try:
105
                id_ = sql_io.put(db, table, row, pkey_, row_ct_ref)
106
                if store_ids: xml_dom.set_id(node, id_)
107
                break
108
            except sql.NullValueException, e:
109
                col = e.cols[0]
110
                if try_num > 0: raise # exception still raised after retry
111
                if store_ids and is_ptr(col):
112
                    # Search for required column in ancestors and their children
113
                    target = find_by_name(node, ptr_type_guess(col))
114
                    if target == None: raise
115
                    row[col] = xml_dom.get_id(target)
116
                else: raise
117
    except sql.DatabaseErrors, e: on_error_(e); return None
118
    
119
    # Insert children with fkeys to parent
120
    for child in children: put_(child, id_)
121
    
122
    return id_
123

    
124
class ColRef:
125
    '''A reference to a table column'''
126
    def __init__(self, name, idx):
127
        self.name = name
128
        self.idx = idx
129
    
130
    def __str__(self): return self.name
131

    
132
# Controls when and how put_table() will partition the input table
133
partition_size = 500000 # rows
134

    
135
input_col_prefix = '$'
136

    
137
put_table_special_funcs = set(['_simplifyPath'])
138

    
139
def put_table(db, node, in_table, in_row_ct_ref=None,
140
    row_ins_ct_ref=None, limit=None, start=0, on_error=exc.raise_,
141
    parent_ids_loc=None, next=None, top_call=True):
142
    '''
143
    @param node The XML tree that transforms the input to the output. Similar to
144
        put()'s node param, but with the input column name prefixed by
145
        input_col_prefix in place of the column value.
146
    @return sql_gen.Col Where the pkeys (from INSERT RETURNING) are made
147
        available
148
    '''
149
    in_table = sql_gen.as_Table(in_table)
150
    in_table.set_srcs([in_table], overwrite=False)
151
    db.src = str(in_table)
152
    
153
    def put_table_(node, in_row_ct_ref=None):
154
        return put_table(db, node, in_table, in_row_ct_ref, row_ins_ct_ref,
155
            None, 0, on_error, parent_ids_loc, next, False)
156
    
157
    # Subset and/or partition in_table if needed
158
    if top_call:
159
        full_in_table = in_table
160
        
161
        total = 0
162
        while limit == None or total < limit:
163
            # Adjust partition size if last partition
164
            this_limit = partition_size
165
            if limit != None: this_limit = min(this_limit, limit - total)
166
            
167
            # Row # is interally 0-based, but 1-based to the user
168
            db.log_debug('********** Partition: rows '+str(start+1)+'-'
169
                +str(start+this_limit)+' **********', level=1.2)
170
            
171
            # Subset in_table
172
            in_table = copy.copy(full_in_table) # don't modify input!
173
            in_table.name = str(in_table) # prepend schema
174
            cur = sql.run_query_into(db, sql.mk_select(db, full_in_table,
175
                limit=this_limit, start=start), into=in_table)
176
                # full_in_table will be shadowed (hidden) by created temp table
177
            
178
            this_ct = cur.rowcount
179
            total += this_ct
180
            start += this_ct # advance start to fetch next set
181
            if this_ct == 0: break # if in_table size is exact multiple of limit
182
            
183
            sql.add_pkey(db, in_table)
184
            
185
            # Recurse
186
            pkeys_loc = put_table_(node, in_row_ct_ref)
187
            
188
            sql.empty_temp(db, in_table)
189
            
190
            if this_ct < partition_size: break # partial partition = last
191
            
192
            # Work around PostgreSQL's temp table disk space leak
193
            db.reconnect()
194
        
195
        return pkeys_loc
196
    
197
    is_func = xml_func.is_func(node)
198
    out_table = name_of(node)
199
    
200
    # Divide children into fields and children with fkeys to parent
201
    row = {}
202
    children = []
203
    for child in xml_dom.NodeElemIter(node):
204
        child_name = name_of(child)
205
        if xml_dom.is_empty(child): row[child_name] = None
206
        elif xml_dom.is_text(child):
207
            row[child_name] = strings.to_unicode(xml_dom.value(child))
208
        else:
209
            child_value = xml_dom.value_node(child)
210
            if is_func or is_ptr(child_name) or xml_func.is_func(child_value):
211
                row[child_name] = child_value
212
            else: children.append(child)
213
    
214
    # Special handling for structural XML functions
215
    if out_table == '_simplifyPath':
216
        # Parse args
217
        def wrap_e(e): raise xml_func.SyntaxError(e)
218
        try:
219
            next = row['next'] # modifies outer next var used by put_table_()
220
            require = row['require']
221
            path = row['path']
222
        except KeyError, e: wrap_e(e)
223
        try: next = xpath.parse(next)
224
        except Parser.SyntaxError, e: wrap_e(e)
225
        try: next = next[0].name
226
        except IndexError, e: wrap_e(e)
227
        
228
        return put_table_(path)
229
    
230
    no_empty = set([in_table])
231
    
232
    def pkey(table): return sql.pkey(db, table, True)
233
    
234
    # Remove any explicit pkey
235
    try: del row[pkey(out_table)]
236
    except KeyError: pass
237
    
238
    # Add fkey to parent
239
    if parent_ids_loc != None:
240
        no_empty.add(parent_ids_loc.table)
241
        parent_ptr = node.getAttribute('fkey')
242
        if parent_ptr == '': parent_ptr = pkey(name_of(node.parentNode))
243
        row[parent_ptr] = parent_ids_loc
244
    
245
    # Divide fields into input columns and literal values
246
    parent_ids_loc = None # applies to this section
247
    in_tables = [in_table]
248
    for out_col, value in row.iteritems():
249
        # Handle forward pointers
250
        if xml_dom.is_node(value): row[out_col] = value = put_table_(value)
251
        
252
        # Translate values
253
        if isinstance(value, sql_gen.Col): # value is temp table column
254
            in_tables.append(value.table)
255
        elif util.is_str(value) and value.startswith(input_col_prefix):
256
            # value is input column
257
            row[out_col] = sql_gen.Col(strings.remove_prefix(input_col_prefix,
258
                value), in_table)
259
        else: # value is literal value; should only be string or None
260
            assert util.is_str(value) or value == None
261
            row[out_col] = sql_gen.NamedCol(out_col, value)
262
    
263
    # Insert node
264
    pkeys_loc = sql_io.put_table(db, out_table, in_tables, row, row_ins_ct_ref,
265
        None, next, is_func, on_error)
266
    
267
    sql.empty_temp(db, set(in_tables) - no_empty)
268
    
269
    # Insert children with fkeys to parent
270
    parent_ids_loc = pkeys_loc # applies to this section
271
    for child in children: put_table_(child)
272
    
273
    # Count # rows and update in_row_ct_ref once all columns have been processed
274
    if in_row_ct_ref != None:
275
        in_row_ct_ref[0] += sql.table_row_count(db, in_table)
276
    
277
    return pkeys_loc
(9-9/37)