BITSMITHS审计

这是第二层基础/核心 Bitsmiths python 库。该产品的目的是为产品中的任何表或对象提供字段级别的行审计。

该审计产品被我们自己的开源产品以及需要详细审计的商业产品使用。好消息是，如果您正在使用任何 Bitsmiths 产品，那么您的项目中已经有了一个可以运行的审计解决方案。

注意，我们将生成的 Mettle 代码打包在这个包中，也就是说这个模块需要的 Mettle 版本很重要。

表格和设置

Audit旨在使用具有audit. 您将需要自己创建此数据库模式。它还需要四个关系数据库表。

该包提供了创建这些表的 SQL 代码。有两种方法可以访问表创建 SQL。

1. 您可以bs-audit -g postgresql在命令行运行，这会将所有 SQL 打印到stdout.
2. 您可以导入 bs_audit 模块并获取 SQL，如下所示：

import bs_audit

print(bs_audit.get_table_sql('postgresql'))

笔记！目前只有postgresql SQL 被添加到包中。如果您希望我们支持另一个数据库，请告诉我们，我们会将其放入开发管道中。

库对象

这些是审核产品中的对象，并对其预期目的进行了简短描述。

审计

Audit类（以及异步代码的AuditAsync对应部分）是使用审计产品的方法。每次对表进行插入、更新或删除时，都可以选择使用此类来审核该表。

该对象有几个假设Audit：

• 您正在审核一个继承自mettle.io.ISerializable. 这是因为审计将使用该_deserialize()方法来读取对象字段。
• 审计对象的名称已输入到audit.cfg表中。
• 您还在某种AutoTransaction 中使用审核对象 - 请参阅 bitsmiths-lib.AutoTransaction。

以下是预期用途的示例：

• 我们假设 Pod 对象包含该对象的一个​​实例Audit。
• 我们假设 Pod 对象包含一个数据库连接的实例。
• 我们假设这brec是某种类型的勇气表记录。
• 我们假设 pod 中已经配置了用户标识符，并且Audit.cfg表已经配置为使用该modified_by列。

import copy
from mettle.lib import AutoTransaction

def save_bank_record(self, brec: tBank):
	with AutoTransaction(self.pod.audit, self.pod) as at:
		bank_tbl = self.pod.dao.dBank(self.pod.dbcon)

		brec.modified_by = self.pod.usr_id

		if bank_tbl.try_select_one_deft(brec.id):
			orig = copy.copy(bank_tbl.rec)
			bank_tbl.update(brec)
			self.pod.audit.diff(orig, bank_tbl.rec)  # audits the difference between the original and new record
		else:
			bank_tbl.insert(brec)
			self.pod.audit.diff(None, bank_tbl.rec)  # audits a brand new record.

		at.commit()

表表

这是一个简单的对象，旨在检查表更改的时间间隔。如果表有行更改，您可能希望实现更新内部缓存或其他内容。假设您在对表行进行插入、更新或删除操作时都在使用Audit对象，否则它不会知道。

更改历史

2.2.2

2.2.1

2.2.0

2.1.6

审计跟踪查询/功能示例：

select * from audit.show_trail('{"config"}', null, '{"value"}', '2022-05-01', null, '{"U"}');

2.1.5

2.1.4

2.1.3

2.1.0