更新日期：2024年09月11日
咨询锁函数用于管理咨询锁（Advisory Lock）
。
pg_advisory_lock(key bigint)
描述：获取会话级别的排它咨询锁。
返回值类型：void
备注：
pg_advisory_lock 锁定应用程序定义的资源，
该资源可以用一个64 位或两个不重
叠的32 位键值标识。如果已经有另外的会话锁定了该资源，则该函数将阻塞到该资源可用
为止。这个锁是排它的。多个锁定请求将会被压入栈中，因此，如果同一个资源被锁定了三
次，它必须被解锁三次以将资源释放给其他会话使用。
pg_advisory_lock(key1 int, key2 int)
描述：获取会话级别的排它咨询锁。
返回值类型：void
备注：只允许sysadmin 对键值对(65535, 65535)加会话级别的排它咨询锁，普通用户无
权限。
pg_advisory_lock(int4, int4, Name)
描述：获取指定数据库的排它咨询锁。
返回值类型：void
pg_advisory_lock_shared(key bigint)
描述：获取会话级别的共享咨询锁。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
458
返回值类型：void
pg_advisory_lock_shared(key1 int, key2 int)
描述：获取会话级别的共享咨询锁。
返回值类型：void
备注：
pg_advisory_lock_shared 类似于pg_advisory_lock，
不同之处仅在于共享锁会话可
以和其他请求共享锁的会话共享资源，但排它锁除外。
pg_advisory_unlock(key bigint)
描述：释放会话级别的排它咨询锁。
返回值类型：Boolean
pg_advisory_unlock(key1 int, key2 int)
描述：释放会话级别的排它咨询锁。
返回值类型：Boolean
备注：pg_advisory_unlock 释放先前取得的排它咨询锁。如果释放成功则返回true。如
果实际上并未持有指定的锁，将返回false 并在服务器中产生一条SQL 警告信息。
pg_advisory_unlock(int4, int4, Name)
描述：释放指定数据库上的排它咨询锁。
返回值类型：Boolean
备注：如果释放成功则返回true；如果未持有锁，则返回false。
pg_advisory_unlock_shared(key bigint)
描述：释放会话级别的共享咨询锁。
返回值类型：Boolean
pg_advisory_unlock_shared(key1 int, key2 int)
描述：释放会话级别的共享咨询锁。
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
459
返回值类型：Boolean
备注：
pg_advisory_unlock_shared 类似于pg_advisory_unlock，
不同之处在于该函数释放
的是共享咨询锁。
pg_advisory_unlock_all()
描述：释放当前会话持有的所有咨询锁。
返回值类型：void
备注：
pg_advisory_unlock_all 将会释放当前会话持有的所有咨询锁，
该函数在会话结束
的时候被隐含调用，即使客户端异常地断开连接也是一样。
pg_advisory_xact_lock(key bigint)
描述：获取事务级别的排它咨询锁。
返回值类型：void
pg_advisory_xact_lock(key1 int, key2 int)
描述：获取事务级别的排它咨询锁。
返回值类型：void
备注：
pg_advisory_xact_lock 类似于pg_advisory_lock，
不同之处在于锁是自动在当前事
务结束时释放，而且不能被显式的释放。只允许sysadmin 对键值对(65535, 65535)加事务级
别的排它咨询锁，普通用户无权限。
pg_advisory_xact_lock_shared(key bigint)
描述：获取事务级别的共享咨询锁。
返回值类型：void
pg_advisory_xact_lock_shared(key1 int, key2 int)
描述：获取事务级别的共享咨询锁。
返回值类型：void
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
460
备注：pg_advisory_xact_lock_shared 类似于pg_advisory_lock_shared，不同之处在于锁
是在当前事务结束时自动释放，而且不能被显式的释放。
pg_try_advisory_lock(key bigint)
描述：尝试获取会话级排它咨询锁。
返回值类型：Boolean
备注：pg_try_advisory_lock 类似于pg_advisory_lock，不同之处在于该函数不会阻塞以
等待资源的释放。它要么立即获得锁并返回true，要么返回false 表示目前不能锁定。
pg_try_advisory_lock(key1 int, key2 int)
描述：尝试获取会话级排它咨询锁。
返回值类型：Boolean
备注：只允许sysadmin 对键值对(65535, 65535)加会话级别的排它咨询锁，普通用户无
权限。
pg_try_advisory_lock_shared(key bigint)
描述：尝试获取会话级共享咨询锁。
返回值类型：Boolean
pg_try_advisory_lock_shared(key1 int, key2 int)
描述：尝试获取会话级共享咨询锁。
返回值类型：Boolean
备注：pg_try_advisory_lock_shared 类似于pg_try_advisory_lock，不同之处在于该函数
尝试获得共享锁而不是排它锁。
pg_try_advisory_xact_lock(key bigint)
描述：尝试获取事务级别的排它咨询锁。
返回值类型：Boolean
GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
461
pg_try_advisory_xact_lock(key1 int, key2 int)
描述：尝试获取事务级别的排它咨询锁。
返回值类型：Boolean
备注：pg_try_advisory_xact_lock 类似于pg_try_advisory_lock，不同之处在于如果得到
锁，
在当前事务的结束时自动释放，
而且不能被显式的释放。
只允许sysadmin 对键值对(65535,
65535)加事务级别的排它咨询锁，普通用户无权限。
pg_try_advisory_xact_lock_shared(key bigint)
描述：尝试获取事务级别的共享咨询锁。
返回值类型：Boolean
pg_try_advisory_xact_lock_shared(key1 int, key2 int)
描述：尝试获取事务级别的共享咨询锁。
返回值类型：Boolean
备注：pg_try_advisory_xact_lock_shared 类似于pg_try_advisory_lock_shared，不同之处
在于如果得到锁，在当前事务结束时自动释放，而且不能被显式的释放。
lock_cluster_ddl()
描述：尝试对GBase 8c 内所有存活的数据库主节点获取会话级别的排他咨询锁。
返回值类型：Boolean
备注：只允许sysadmin 调用，普通用户无权限。
unlock_cluster_ddl()
描述：尝试对数据库主节点会话级别的排他咨询锁。
返回值类型：Boolean
具体升级步骤如下：
步骤1
确认所有集群节点的数据库服务已经停止。
步骤2
解压V9.5.X.X 集群安装包，并切换到安装包解压后的gcinstall 目录下。
步骤3
使用root 用户在集群各个节点执行gbase 用户的环境部署脚本：
# cd gcinstall
GBase 8a MPP Cluster 产品手册
3 集群安装升级与卸载
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
111
# scp SetSysEnv.py
gbase@集群节点IP:/opt/
# ./SetSysEnv.py --installPrefix=/opt --dbaUser=gbase
SetSysEnv 语法和参数说明请参考3.2.2 初始安装章节。
在gcinstall 目录下找到并修改demo.options 配置文件。demo.options 文件参数值与
原集群信息保持一致。gcwareHost 必须填写原集群的gcware 节点ip（8.6.2.X 集群
中gcware 与coordinator 节点是同一节点），gcwareHostNodeID 在IP4 下可以不填
写，如果是IPV6，nodeid 可以到$GCWARE_BASE/config 下gcware.conf 文件中获
取：
totem 下的nodeid 是gcwareHostNodeID，
gcware 下的是coordinateHostNodeID。
#su - gbase
$ vi /opt/gcinstall/demo.options
installPrefix= /opt
coordinateHost = 192.168.146.20,192.168.146.21,192.168.146.22
coordinateHostNodeID = 20,21,22
dataHost =