2 # Functions for interacting with the events table in the database
4 # Tony Mack <tmack@cs.princeton.edu>
5 # Copyright (C) 2006 The Trustees of Princeton University
7 # $Id: Events.py,v 1.7 2006/11/09 19:43:55 mlhuang Exp $
10 from PLC.Faults import *
11 from PLC.Parameter import Parameter
12 from PLC.Filter import Filter
13 from PLC.Debug import profile
14 from PLC.Table import Row, Table
18 Representation of a row in the events table.
22 primary_key = 'event_id'
24 'event_id': Parameter(int, "Event identifier"),
25 'person_id': Parameter(int, "Identifier of person responsible for event, if any"),
26 'node_id': Parameter(int, "Identifier of node responsible for event, if any"),
27 'fault_code': Parameter(int, "Event fault code"),
28 'call_name': Parameter(str, "Call responsible for this event"),
29 'call': Parameter(str, "Call responsible for this event, including paramters"),
30 'runtime': Parameter(float, "Runtime of event"),
31 'time': Parameter(int, "Date and time that the event took place, in seconds since UNIX epoch", ro = True),
32 'object_ids': Parameter([int], "IDs of objects affected by this event")
35 def add_object(self, object_id, commit = True):
37 Relate object to this event.
40 assert 'event_id' in self
42 event_id = self['event_id']
44 if 'object_ids' not in self:
45 self['object_ids'] = []
47 if object_id not in self['object_ids']:
48 self.api.db.do("INSERT INTO event_object (event_id, object_id)" \
49 " VALUES(%(event_id)d, %(object_id)d)",
55 self['object_ids'].append(object_id)
59 Representation of row(s) from the events table in the database.
62 def __init__(self, api, event_filter = None, columns = None):
63 Table.__init__(self, api, Event, columns)
65 sql = "SELECT %s FROM view_events WHERE True" % \
66 ", ".join(self.columns)
68 if event_filter is not None:
69 if isinstance(event_filter, (list, tuple, set)):
70 event_filter = Filter(Event.fields, {'event_id': event_filter})
71 elif isinstance(event_filter, dict):
72 event_filter = Filter(Event.fields, event_filter)
73 sql += " AND (%s)" % event_filter.sql(api)