18 |
# $Source$ |
# $Source$ |
19 |
# $Id$ |
# $Id$ |
20 |
|
|
|
import os |
|
|
import weakref |
|
21 |
from sqlite import connect |
from sqlite import connect |
22 |
|
|
23 |
|
from base import TitledObject |
24 |
|
|
25 |
import table |
import table |
26 |
|
|
27 |
sql_type_map = { |
sql_type_map = { |
160 |
""" |
""" |
161 |
return self.column_map.has_key(col) |
return self.column_map.has_key(col) |
162 |
|
|
163 |
def ReadRowAsDict(self, index): |
def RowIdToOrdinal(self, gid): |
164 |
|
"""Return the row ordinal given its id |
165 |
|
|
166 |
|
At the moment the transient tables are only used for tables that |
167 |
|
don't distinguish between row number and row id, so the value is |
168 |
|
returned unchanged. |
169 |
|
""" |
170 |
|
return gid |
171 |
|
|
172 |
|
def RowOrdinalToId(self, num): |
173 |
|
"""Return the rowid for given its ordinal |
174 |
|
|
175 |
|
At the moment the transient tables are only used for tables that |
176 |
|
don't distinguish between row number and row id, so the value is |
177 |
|
returned unchanged. |
178 |
|
""" |
179 |
|
return num |
180 |
|
|
181 |
|
def ReadRowAsDict(self, index, row_is_ordinal = 0): |
182 |
|
"""Return the entire row as a dictionary with column names as keys |
183 |
|
|
184 |
|
The row_is_ordinal is ignored because at the moment the |
185 |
|
transient tables are only used for DBF files where it doesn't |
186 |
|
matter. |
187 |
|
""" |
188 |
|
# Implementation Strategy: Executing a completely new select |
189 |
|
# statement every time this method is called is too slow. The |
190 |
|
# most important usage is to read the records more or less |
191 |
|
# sequentially. This happens e.g. when drawing a layer with a |
192 |
|
# classification where the shapes are drawn in order of the |
193 |
|
# shape ids. Another pattern is that the same row is requested |
194 |
|
# several times in a row. This happens in the table view, for |
195 |
|
# instance. |
196 |
|
|
197 |
|
# We can exploit this to make access faster by having one cursor |
198 |
|
# open all the time and keeping the last row read around in case |
199 |
|
# the same row is accessed again the next time and if the row |
200 |
|
# index is larger than the row we have read last we simply fetch |
201 |
|
# rows from the cursor until we've reached the requested row. If |
202 |
|
# the requested row index is smaller then we start a new cursor. |
203 |
|
|
204 |
|
# FIXME: So far this scheme seems to work well enough. Obvious |
205 |
|
# improvements would be to start the cursor at exactly the |
206 |
|
# requested row (should be efficient and easy to do now that the |
207 |
|
# id is the primary key) and to perhaps to also start a new |
208 |
|
# cursor if the requested index is much larger than the last row |
209 |
|
# so that we don't read and discard lots of the rows. |
210 |
|
|
211 |
|
# Check whether we have to start a new cursor |
212 |
if self.read_record_cursor is None or index <self.read_record_last_row: |
if self.read_record_cursor is None or index <self.read_record_last_row: |
213 |
stmt = ("SELECT %s FROM %s;" |
stmt = ("SELECT %s FROM %s;" |
214 |
% (", ".join([c.internal_name for c in self.columns]), |
% (", ".join([c.internal_name for c in self.columns]), |
232 |
self.read_record_last_row = index |
self.read_record_last_row = index |
233 |
return dict(zip(self.orig_names, result)) |
return dict(zip(self.orig_names, result)) |
234 |
|
|
235 |
|
def ReadValue(self, row, col, row_is_ordinal = 0): |
236 |
|
"""Return the value of the specified row and column |
237 |
|
|
238 |
|
The col parameter may be the index of the column or its name. |
239 |
|
|
240 |
|
The row_is_ordinal is ignored because at the moment the |
241 |
|
transient tables are only used for DBF files where it doesn't |
242 |
|
matter. |
243 |
|
""" |
244 |
|
# Depending on the actual access patterns of the table data, it |
245 |
|
# might be a bit faster in some circumstances to not implement |
246 |
|
# this via ReadRowAsDict, but this simple implementation should |
247 |
|
# be fast enough for most purposes. |
248 |
|
return self.ReadRowAsDict(row)[self.column_map[col].name] |
249 |
|
|
250 |
def ValueRange(self, col): |
def ValueRange(self, col): |
251 |
col = self.column_map[col] |
col = self.column_map[col] |
252 |
iname = col.internal_name |
iname = col.internal_name |
268 |
result.append(row[0]) |
result.append(row[0]) |
269 |
return result |
return result |
270 |
|
|
271 |
|
def Width(self, col): |
272 |
|
"""Return the maximum width of values in the column |
273 |
|
|
274 |
|
The return value is the the maximum length of string |
275 |
|
representation of the values in the column (represented by index |
276 |
|
or name). |
277 |
|
""" |
278 |
|
max = 0 |
279 |
|
|
280 |
|
type = self.column_map[col].type |
281 |
|
iname = self.column_map[col].internal_name |
282 |
|
cursor = self.db.cursor() |
283 |
|
cursor.execute("SELECT %s FROM %s;" % (iname, self.tablename)) |
284 |
|
values = [ i[0] for i in cursor.fetchall()] |
285 |
|
if not values: |
286 |
|
return None |
287 |
|
|
288 |
|
if type == table.FIELDTYPE_DOUBLE: |
289 |
|
format = "%.12f" |
290 |
|
elif type == table.FIELDTYPE_INT: |
291 |
|
format = "%d" |
292 |
|
else: |
293 |
|
format = "%s" |
294 |
|
for value in values: |
295 |
|
if value is None: continue |
296 |
|
l = len(format % value) |
297 |
|
if l > max: |
298 |
|
max = l |
299 |
|
|
300 |
|
return max |
301 |
|
|
302 |
def SimpleQuery(self, left, comparison, right): |
def SimpleQuery(self, left, comparison, right): |
303 |
"""Return the indices of all rows that matching a condition. |
"""Return the indices of all rows that matching a condition. |
304 |
|
|
339 |
result.append(row[0]) |
result.append(row[0]) |
340 |
return result |
return result |
341 |
|
|
342 |
|
def Dependencies(self): |
343 |
|
"""Placeholder for a method in a derived class. |
344 |
|
|
345 |
|
Return a sequence with the tables and other data objects that |
346 |
|
self depends on. |
347 |
|
""" |
348 |
|
raise NotImplementedError |
349 |
|
|
350 |
|
|
351 |
class TransientTable(TransientTableBase): |
class TransientTable(TitledObject, TransientTableBase): |
352 |
|
|
353 |
"""A Table in a transient DB that starts as the copy of a Thuban Table.""" |
"""A Table in a transient DB that starts as the copy of a Thuban Table.""" |
354 |
|
|
359 |
interface. |
interface. |
360 |
""" |
""" |
361 |
TransientTableBase.__init__(self, transient_db) |
TransientTableBase.__init__(self, transient_db) |
362 |
|
TitledObject.__init__(self, table.Title()) |
363 |
self.create(table) |
self.create(table) |
364 |
|
|
365 |
def create(self, table): |
def create(self, table): |
393 |
|
|
394 |
|
|
395 |
|
|
396 |
class TransientJoinedTable(TransientTableBase): |
class TransientJoinedTable(TitledObject, TransientTableBase): |
397 |
|
|
398 |
"""A Table in the transient DB that contains a join of two tables""" |
"""A Table in the transient DB that contains a join of two tables""" |
399 |
|
|
400 |
def __init__(self, transient_db, left_table, left_field, |
def __init__(self, transient_db, left_table, left_field, |
401 |
right_table, right_field = None): |
right_table, right_field = None, outer_join = False): |
402 |
"""Create a new table in the transient DB as a join of two tables. |
"""Create a new table in the transient DB as a join of two tables. |
403 |
|
|
404 |
Both input tables, left_table and right_table must have a |
Both input tables, left_table and right_table must have a |
405 |
transient_table method that returns a table object for a table |
transient_table method that returns a table object for a table |
406 |
in the trnsient database. The join is performed on the condition |
in the transient database. The join is performed on the condition |
407 |
that the value of the left_field column the the left table is |
that the value of the left_field column the the left table is |
408 |
equal to the value of the right_field in the right_table. |
equal to the value of the right_field in the right_table. |
409 |
|
|
410 |
The joined table contains all columns of the input tables with |
The joined table contains all columns of the input tables, |
411 |
one exception: Any column in the right_table with the same name |
however, the column names of the right table may be changed |
412 |
as one of the columns in the left_table will be omitted. This is |
slightly to make them unique in the joined table. This is |
413 |
somewhat of an implementation detail, but is done so that the |
currently done by appending a sufficient number of underscores |
414 |
column names of the joined table can be the same as the column |
('_'). |
|
names of the input tables without having to create prefixes. |
|
415 |
""" |
""" |
416 |
TransientTableBase.__init__(self, transient_db) |
TransientTableBase.__init__(self, transient_db) |
417 |
|
self.dependencies = (left_table, right_table) |
418 |
self.left_table = left_table.transient_table() |
self.left_table = left_table.transient_table() |
419 |
self.left_field = left_field |
self.left_field = left_field |
420 |
self.right_table = right_table.transient_table() |
self.right_table = right_table.transient_table() |
422 |
self.right_field = right_field |
self.right_field = right_field |
423 |
else: |
else: |
424 |
self.right_field = self.left_field |
self.right_field = self.left_field |
425 |
|
self.outer_join = outer_join |
426 |
|
|
427 |
|
title = "Join of %(left)s and %(right)s" \ |
428 |
|
% {"left": self.left_table.Title(), |
429 |
|
"right": self.right_table.Title()} |
430 |
|
TitledObject.__init__(self, title) |
431 |
|
|
432 |
self.create() |
self.create() |
433 |
|
|
434 |
def create(self): |
def create(self): |
437 |
|
|
438 |
self.right_table.ensure_index(self.right_field) |
self.right_table.ensure_index(self.right_field) |
439 |
|
|
440 |
|
# determine the internal column names to join on before |
441 |
|
# coalescing the column information because if the external |
442 |
|
# column names are the same they will be mapped to the same |
443 |
|
# internal name afterwards. |
444 |
|
internal_left_col = self.left_table.orig_to_internal[self.left_field] |
445 |
|
internal_right_col =self.right_table.orig_to_internal[self.right_field] |
446 |
|
|
447 |
# Coalesce the column information |
# Coalesce the column information |
448 |
visited = {} |
visited = {} |
449 |
columns = [] |
columns = [] |
450 |
for col in self.left_table.columns + self.right_table.columns: |
newcolumns = [] |
451 |
if col.name in visited: |
for table in (self.left_table, self.right_table): |
452 |
# We can't allow multiple columns with the same original |
for col in table.Columns(): |
453 |
# name, so omit this one. FIXME: There should be a |
colname = col.name |
454 |
# better solution. |
# We can't allow multiple columns with the same |
455 |
continue |
# original name, so append '_' to this one until |
456 |
columns.append(col) |
# it is unique. |
457 |
TransientTableBase.create(self, columns) |
# FIXME: There should be a better solution. |
458 |
|
while colname in visited: |
459 |
|
colname = colname + '_' |
460 |
|
columns.append((table.tablename, col)) |
461 |
|
newcol = ColumnReference(colname, col.type, |
462 |
|
"Col%03d" % (len(newcolumns)+1)) |
463 |
|
newcolumns.append(newcol) |
464 |
|
visited[colname] = 1 |
465 |
|
TransientTableBase.create(self, newcolumns) |
466 |
|
|
467 |
# Copy the joined data to the table. |
# Copy the joined data to the table. |
468 |
internal_names = [col.internal_name for col in self.columns] |
newinternal_names = [col.internal_name for col in self.columns] |
469 |
|
internal_references = ["%s.%s" % (table, col.internal_name) |
470 |
|
for table, col in columns] |
471 |
|
if self.outer_join: |
472 |
|
join_operator = 'LEFT OUTER JOIN' |
473 |
|
else: |
474 |
|
join_operator = 'JOIN' |
475 |
stmt = ("INSERT INTO %s (id, %s) SELECT %s.id, %s FROM %s" |
stmt = ("INSERT INTO %s (id, %s) SELECT %s.id, %s FROM %s" |
476 |
" JOIN %s ON %s = %s;" |
" %s %s ON %s.%s = %s.%s;" |
477 |
% (self.tablename, |
% (self.tablename, |
478 |
", ".join(internal_names), |
", ".join(newinternal_names), |
479 |
self.left_table.tablename, |
self.left_table.tablename, |
480 |
", ".join(internal_names), |
", ".join(internal_references), |
481 |
self.left_table.tablename, |
self.left_table.tablename, |
482 |
|
join_operator, |
483 |
self.right_table.tablename, |
self.right_table.tablename, |
484 |
self.orig_to_internal[self.left_field], |
self.left_table.tablename, |
485 |
self.orig_to_internal[self.right_field])) |
internal_left_col, |
486 |
|
self.right_table.tablename, |
487 |
|
internal_right_col)) |
488 |
self.db.execute(stmt) |
self.db.execute(stmt) |
489 |
|
|
490 |
|
def Dependencies(self): |
491 |
|
"""Return a tuple with the two tables the join depends on.""" |
492 |
|
return self.dependencies |
493 |
|
|
494 |
|
def JoinType(self): |
495 |
|
"""Return the type of the join (either 'INNER' or 'LEFT OUTER')""" |
496 |
|
if self.outer_join: |
497 |
|
return "LEFT OUTER" |
498 |
|
else: |
499 |
|
return "INNER" |
500 |
|
|
501 |
class AutoTransientTable(table.OldTableInterfaceMixin): |
|
502 |
|
class AutoTransientTable(TitledObject, table.OldTableInterfaceMixin): |
503 |
|
|
504 |
"""Table that copies data to a transient table on demand. |
"""Table that copies data to a transient table on demand. |
505 |
|
|
508 |
""" |
""" |
509 |
|
|
510 |
def __init__(self, transient_db, table): |
def __init__(self, transient_db, table): |
511 |
|
TitledObject.__init__(self, table.Title()) |
512 |
self.transient_db = transient_db |
self.transient_db = transient_db |
513 |
self.table = table |
self.table = table |
514 |
self.t_table = None |
self.t_table = None |
530 |
def NumColumns(self): |
def NumColumns(self): |
531 |
return self.table.NumColumns() |
return self.table.NumColumns() |
532 |
|
|
533 |
def ReadRowAsDict(self, record): |
def RowIdToOrdinal(self, gid): |
534 |
|
"""Return the row ordinal given its id""" |
535 |
|
if self.t_table is not None: |
536 |
|
return self.t_table.RowIdToOrdinal(gid) |
537 |
|
else: |
538 |
|
return self.table.RowIdToOrdinal(gid) |
539 |
|
|
540 |
|
def RowOrdinalToId(self, num): |
541 |
|
"""Return the rowid for given its ordinal""" |
542 |
|
if self.t_table is not None: |
543 |
|
return self.t_table.RowOrdinalToId(num) |
544 |
|
else: |
545 |
|
return self.table.RowOrdinalToId(num) |
546 |
|
|
547 |
|
def ReadRowAsDict(self, record, row_is_ordinal = 0): |
548 |
"""Return the record no. record as a dict mapping field names to values |
"""Return the record no. record as a dict mapping field names to values |
549 |
""" |
""" |
550 |
if self.t_table is not None: |
if self.t_table is not None: |
551 |
return self.t_table.ReadRowAsDict(record) |
return self.t_table.ReadRowAsDict(record, |
552 |
|
row_is_ordinal = row_is_ordinal) |
553 |
else: |
else: |
554 |
return self.table.ReadRowAsDict(record) |
return self.table.ReadRowAsDict(record, |
555 |
|
row_is_ordinal = row_is_ordinal) |
556 |
|
|
557 |
|
def ReadValue(self, row, col, row_is_ordinal = 0): |
558 |
|
"""Return the value of the specified row and column |
559 |
|
|
560 |
|
The col parameter may be the index of the column or its name. |
561 |
|
""" |
562 |
|
if self.t_table is not None: |
563 |
|
return self.t_table.ReadValue(row, col, |
564 |
|
row_is_ordinal = row_is_ordinal) |
565 |
|
else: |
566 |
|
return self.table.ReadValue(row, col, |
567 |
|
row_is_ordinal = row_is_ordinal) |
568 |
|
|
569 |
def copy_to_transient(self): |
def copy_to_transient(self): |
570 |
"""Internal: Create a transient table and copy the data into it""" |
"""Internal: Create a transient table and copy the data into it""" |
587 |
if self.t_table is None: |
if self.t_table is None: |
588 |
self.copy_to_transient() |
self.copy_to_transient() |
589 |
return self.t_table.UniqueValues(col) |
return self.t_table.UniqueValues(col) |
590 |
|
|
591 |
|
def SimpleQuery(self, left, comparison, right): |
592 |
|
if self.t_table is None: |
593 |
|
self.copy_to_transient() |
594 |
|
# Make sure to use the column object of the transient table. The |
595 |
|
# left argument is always a column object so we can just ask the |
596 |
|
# t_table for the right object. |
597 |
|
if hasattr(right, "name"): |
598 |
|
return self.t_table.SimpleQuery(self.t_table.Column(left.name), |
599 |
|
comparison, |
600 |
|
self.t_table.Column(right.name)) |
601 |
|
else: |
602 |
|
return self.t_table.SimpleQuery(self.t_table.Column(left.name), |
603 |
|
comparison, right) |
604 |
|
|
605 |
|
def Dependencies(self): |
606 |
|
"""Return a tuple containing the original table""" |
607 |
|
return (self.table,) |
608 |
|
|
609 |
|
def Width(self, col): |
610 |
|
return self.table.Width(col) |