使用 lo 模块管理大型对象 - Amazon Aurora
安装 lo 扩展使用 lo_manage 触发器函数使用 vacuumlo 实用工具

使用 lo 模块管理大型对象

lo 模块（扩展）适用于通过 JDBC 或 ODBC 驱动程序使用 PostgreSQL 数据库的数据库用户和开发人员。JDBC 和 ODBC 都希望数据库能够在对大型对象的引用发生更改时处理对大型对象的删除。但 PostgreSQL 并非如此。PostgreSQL 并不假定在对于对象的引用发生变化时应该删除该对象。结果是对象保留在磁盘上，未引用。lo 扩展包括一个函数，您可以使用该函数在引用发生变化时触发，以便在需要时删除对象。

提示

要确定数据库是否可以从 lo 扩展中受益，请使用 vacuumlo 实用程序检查孤立的大型对象。要在不采取任何操作的情况下获取孤立的大型对象的计数，请使用 -n 选项（无操作）运行此实用程序。要了解如何操作，请参阅下面的 vacuumlo utility。

lo 模块适用于 Aurora PostgreSQL 13.7、12.11、11.16、10.21 及更高的次要版本。

要安装模块（扩展），您需要 rds_superuser 权限。安装 lo 扩展会将以下内容添加到数据库中：

  • lo – 这是一种大型对象 (lo) 数据类型，可用于二进制大型对象 (BLOB) 和其他大型对象。lo 数据类型是 oid 数据类型的域。换句话说，它是一个具有可选限制的对象标识符。有关更多信息，请参阅 PostgreSQL 文档中的对象标识符。简单来说，您可以使用 lo 数据类型，以区分包含大型对象引用的数据库列与其他对象标识符 (OID)。

  • lo_manage – 这是一个函数，您可以在包含大型对象引用的表列上的触发器中使用。无论何时删除或修改引用大型对象的值，触发器都会取消 (lo_unlink) 对象与其引用之间的关联。仅当列是对大型对象的唯一数据库引用时，才对列使用触发器。

有关大型对象模块的更多信息，请参阅 PostgreSQL 文档中的 Lo。

安装 lo 扩展

在安装 lo 扩展之前，请确保您具有 rds_superuser 权限。

安装 lo 扩展

  1. 使用 psql 连接到 Aurora PostgreSQL 数据库集群的主数据库实例。

    psql --host=your-cluster-instance-1.666666666666.aws-region.rds.amazonaws.com --port=5432 --username=postgres --password

    出现提示时请输入密码。psql 客户端会建立连接并显示默认的管理连接数据库 postgres=>，作为提示符。

  2. 按如下方式安装扩展。

    postgres=> CREATE EXTENSION lo;
CREATE EXTENSION

您现在可以使用 lo 数据类型定义表中的列。例如，您可以创建包含光栅图像数据的表 (images)。您可以对列 raster 使用 lo 数据类型，如以下示例所示，它将创建一个表。

postgres=> CREATE TABLE images (image_name text, raster lo);

使用 lo_manage 触发器函数删除对象

在更新或删除 lo 时，可以在 lo 或其他大型对象列上的触发器中使用 lo_manage 函数来清理（并防止出现孤立对象）。

在引用大型对象的列上设置触发器

  • 请执行下列操作之一：

    • 对此参数使用列名称，在每个列上创建一个 BEFORE UPDATE OR DELETE 触发器，以包含对大型对象的唯一引用。

      postgres=> CREATE TRIGGER t_raster BEFORE UPDATE OR DELETE ON images
    FOR EACH ROW EXECUTE FUNCTION lo_manage(raster);

    • 仅在更新列时才应用触发器。

      postgres=> CREATE TRIGGER t_raster BEFORE UPDATE OF images
    FOR EACH ROW EXECUTE FUNCTION lo_manage(raster);

lo_manage 触发器函数仅在插入或删除列数据的上下文中起作用，具体取决于您定义触发器的方式。对数据库执行 DROP 或 TRUNCATE 操作时，它不起作用。这意味着在删除之前应该从任何表中删除对象列，以防止创建孤立的对象。

例如，假设您要删除包含 images 表的数据库。您可以按如下方式删除该列。

postgres=> DELETE FROM images COLUMN raster

假设在该列上定义了用于处理删除 lo_manage 的函数，现在可以安全地删除该表。

使用 vacuumlo 实用工具

vacuumlo 实用程序识别孤立的大型对象并可以从数据库中删除它们。此实用程序自 PostgreSQL 9.1.24 以来一直可用。如果数据库用户定期使用大型对象，我们建议您偶尔运行 vacuumlo 来清理孤立的大型对象。

在安装 lo 扩展之前，您可以使用 vacuumlo 评估 Aurora PostgreSQL 数据库集群是否可以受益。要执行此操作，请使用 -n 选项（无操作）运行 vacuumlo 以显示要删除的内容，如下所示：

$ vacuumlo -v -n -h your-cluster-instance-1.666666666666.aws-region.rds.amazonaws.com -p 5433 -U postgres docs-lab-spatial-db
Password:*****
Connected to database "docs-lab-spatial-db"
Test run: no large objects will be removed!
Would remove 0 large objects from database "docs-lab-spatial-db".

如输出所示，孤立的大型对象对于这个特定的数据库来说并不是问题。

有关此实用程序的更多信息，请参阅 PostgreSQL 文档中的 vacuumlo。