pgmemcache 技术文档

1. 安装指南

1.1 系统要求

• PostgreSQL 9.1 或更新版本
• libmemcached 0.38 或 OMcache 0.2.0 或更新版本

1.2 安装步骤

1.2.1 从源码构建

1. 安装 PostgreSQL 并确保 PGXS 已安装（如果尚未安装）。
2. 安装 libmemcached 或 OMcache。
3. 运行 make。
4. 运行 sudo make install。

如果需要，更新 PostgreSQL 服务器所有者的 LD_LIBRARY_CACHE 并重启 PostgreSQL。确保 pg_config 二进制文件在您的 PATH 中（或编辑 Makefile）。

1.2.2 在 Debian 上构建

1. 运行 sudo make build-dep。
2. 运行 make deb9.2（或根据您的 PostgreSQL 版本选择 deb9.3、deb9.4 等）。
3. 运行 sudo dpkg -i ../postgresql-pgmemcache-*.deb。

1.2.3 在 Fedora、CentOS 或 RHEL 上构建

1. 运行 make rpm。
2. 运行 sudo rpm -Uvh $(rpm --eval '%{_rpmdir}/%{_arch}')/pgmemcache-*.rpm。

2. 项目使用说明

2.1 设置 PostgreSQL

1. 使用 psql 连接到您的数据库并运行以下命令：

   CREATE EXTENSION pgmemcache;
   

2. 编辑 postgresql.conf 文件，将 pgmemcache 添加到 shared_preload_libraries。
3. （如果使用 PostgreSQL 9.1 或更早版本）将 pgmemcache 添加到 custom_variable_classes。
4. （可选）设置 pgmemcache.default_servers 和 pgmemcache.default_behavior 变量。

2.2 使用示例

• 添加服务器：

  memcache_server_add('hostname:port'::TEXT);
  

• 添加键值对：

  memcache_add(key::TEXT, value::TEXT, expire::TIMESTAMPTZ);
  

• 删除键：

  memcache_delete(key::TEXT);
  

• 获取键值：

  value = memcache_get(key::TEXT);
  

3. 项目API使用文档

3.1 常用API

• memcache_server_add：添加 memcached 服务器。
• memcache_add：添加键值对到缓存。
• memcache_decr：原子性减少键的值。
• memcache_delete：删除指定键。
• memcache_flush_all：清空所有缓存数据。
• memcache_get：获取指定键的值。
• memcache_get_multi：获取多个键的值。
• memcache_incr：原子性增加键的值。
• memcache_replace：替换已存在键的值。
• memcache_set：设置键的值，无论键是否存在。
• memcache_stats：获取所有服务器的统计信息。

3.2 示例函数

• 触发器函数示例：

  CREATE OR REPLACE FUNCTION auth_passwd_upd()
  RETURNS TRIGGER LANGUAGE plpgsql AS $$
  BEGIN
      IF OLD.passwd <> NEW.passwd THEN
          PERFORM memcache_replace('user_id_' || NEW.user_id || '_password', NEW.passwd);
      END IF;
      RETURN NEW;
  END;
  $$;
  

4. 项目安装方式

4.1 从源码安装

1. 安装 PostgreSQL 和 PGXS。
2. 安装 libmemcached 或 OMcache。
3. 运行 make。
4. 运行 sudo make install。

4.2 在 Debian 上安装

1. 运行 sudo make build-dep。
2. 运行 make deb9.2。
3. 运行 sudo dpkg -i ../postgresql-pgmemcache-*.deb。

4.3 在 Fedora、CentOS 或 RHEL 上安装

1. 运行 make rpm。
2. 运行 sudo rpm -Uvh $(rpm --eval '%{_rpmdir}/%{_arch}')/pgmemcache-*.rpm。

通过以上步骤，您可以成功安装并使用 pgmemcache 扩展，与 memcached 进行交互。