Module dbwriter_sa

Parameters:

• engineStr - SQLAlchemy engine str
• tableNamePattern - table name incl.placeholder for int (rotate number), e.g. "mylog%d"
• filters - default = () See rrlog.server.LogServer.__init__
• observers - default = () See rrlog.server.LogServer.__init__
• tsFormat - timestamp format. See rrlog.server.LogServer.__init__
• rotateCount - int >=1, how many tables to use for rotation
• rotateLineMin - rotate when ~ lines are written. None to switch off rotation.
• logwriterFactory - Creates LogWriter instances (one per db table). If None, the module variable LOGWRITER_CLASS is used.
• drop - if True, drop an eventually existing table. When False, append to an existing one (this is possible with rotateCount==1 only).
• cols - Custom column configuration. See rrlog.server.dbwriter_sa.DBConfig.__init__
• format_dict - callable taking a job and returning {colname:fieldcontent}. Ignored if a logwriterFactory is given.

Raises:

• AssertionError - when drop==False and rotateCount > 1

Parameters:

• catsEnable - see rrlog.Log.__init__
• catsDisable - see rrlog.Log.__init__
• seFilesExclude - see rrlog.Log.__init__
• filters - see rrlog.server.LogServer.__init__
• observers - see rrlog.server.LogServer.__init__
• tsFormat - timestamp format. See rrlog.server.LogServer.__init__
• tableNamePattern - table name incl.placeholder for int (rotate number), e.g. "mylog%d"
• rotateCount - int >>1, how many tables to use for rotation
• rotateLineMin - rotate when ~ lines are written. None to switch off rotation.
• stackMax - see rrlog.Log.__init__, default: 5 (==log 5 stack levels.)
• drop - if True, drop an eventually existing table. When False, append to an existing one (this is possible with rotateCount==1 only).
• extractStack - see rrlog.Log.__init__
• cols - Custom column configuration. See rrlog.server.dbwriter_sa.DBConfig.__init__

Returns:

callable log object, ready to use

Format the row fields for writing.

Returns:

{colname:fieldcontent} as to be written into the database row.