{"Entry":{"collection":"func","key":"pg-try-advisory-lock","name":"pg_try_advisory_lock","aliases":[],"metadata":{"changed_in":[],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"8.1","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"8.2"},{"descriptions_changed":true,"doc_overhaul":false,"from":"9.0","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"9.1"},{"descriptions_changed":false,"doc_overhaul":true,"from":"12","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"13"}],"content_hash":"39fccc08747f95b4f728c5af0aa4e596165bf00df88b58ad58491879499b17ae","first_version":"8.2","group":"admin","group_label":"System Administration Functions","groups":["admin"],"imported_at":"2026-09-27T17:57:29.693283+08:00","last_version":"20","name":"pg_try_advisory_lock","name_key":"pg_try_advisory_lock","position":29109,"present_in":["8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6","10","11","12","13","14","15","16","17","18","19","20"],"signature":"pg_try_advisory_lock ( key bigint ) → boolean","signature_count":2,"slug":"pg-try-advisory-lock","source_rev":"b7bd9cda","summary":"Obtains an exclusive session-level advisory lock if available.","summary_zh":""}},"Definition":{"Collection":"func","Key":"pg-try-advisory-lock","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"pg-try-advisory-lock","SourceRevision":"b7bd9cda","Facts":{"description":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return true, or return false without waiting if the lock cannot be acquired immediately.","description_html":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return \u003ccode class=\"literal\"\u003etrue\u003c/code\u003e, or return \u003ccode class=\"literal\"\u003efalse\u003c/code\u003e without waiting if the lock cannot be acquired immediately.","description_zh":"","description_zh_html":"","doc":{"anchor":"FUNCTIONS-ADVISORY-LOCKS-TABLE","file":"functions-admin.html","slug":"18"},"group":"admin","group_label":"System Administration Functions","lang":"en","layout":"table-new","pages":["functions-admin.html"],"prose_only":false,"signatures":[{"description":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return true, or return false without waiting if the lock cannot be acquired immediately.","description_html":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return \u003ccode class=\"literal\"\u003etrue\u003c/code\u003e, or return \u003ccode class=\"literal\"\u003efalse\u003c/code\u003e without waiting if the lock cannot be acquired immediately.","description_zh":"","description_zh_html":"","examples":[],"html":"\u003ccode class=\"function\"\u003epg_try_advisory_lock\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ebigint\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eboolean\u003c/code\u003e","returns":"boolean","text":"pg_try_advisory_lock ( key bigint ) → boolean","zh_from":""},{"description":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return true, or return false without waiting if the lock cannot be acquired immediately.","description_html":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return \u003ccode class=\"literal\"\u003etrue\u003c/code\u003e, or return \u003ccode class=\"literal\"\u003efalse\u003c/code\u003e without waiting if the lock cannot be acquired immediately.","description_zh":"","description_zh_html":"","examples":[],"html":"\u003ccode class=\"function\"\u003epg_try_advisory_lock\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey1\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey2\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eboolean\u003c/code\u003e","returns":"boolean","text":"pg_try_advisory_lock ( key1 integer, key2 integer ) → boolean","zh_from":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-ADVISORY-LOCKS-TABLE","file":"functions-admin.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"pg-try-advisory-lock","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"pg_try_advisory_lock","Summary":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回true；否则立即返回false，而不等待。","BodyHTML":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode\u003etrue\u003c/code\u003e；否则立即返回\u003ccode\u003efalse\u003c/code\u003e，而不等待。\u003cpre\u003epg_try_advisory_lock ( key bigint ) → boolean\u003c/pre\u003e尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode\u003etrue\u003c/code\u003e；否则立即返回\u003ccode\u003efalse\u003c/code\u003e，而不等待。\u003cpre\u003epg_try_advisory_lock ( key1 integer, key2 integer ) → boolean\u003c/pre\u003e尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode\u003etrue\u003c/code\u003e；否则立即返回\u003ccode\u003efalse\u003c/code\u003e，而不等待。","SourceRevision":"ca936764","ContentHash":"e383a289424ad28a4c7312d04b7525e4e231716b64808d08cc8829658d2d9a8c","Payload":{"description_zh":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回true；否则立即返回false，而不等待。","description_zh_html":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode class=\"literal\"\u003etrue\u003c/code\u003e；否则立即返回\u003ccode class=\"literal\"\u003efalse\u003c/code\u003e，而不等待。","signatures":[{"description_zh":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回true；否则立即返回false，而不等待。","description_zh_html":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode class=\"literal\"\u003etrue\u003c/code\u003e；否则立即返回\u003ccode class=\"literal\"\u003efalse\u003c/code\u003e，而不等待。","returns":"boolean","text":"pg_try_advisory_lock ( key bigint ) → boolean","zh_from":"doc"},{"description_zh":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回true；否则立即返回false，而不等待。","description_zh_html":"尝试获取一个排他的会话级咨询锁。如果能立即获取到锁，就返回\u003ccode class=\"literal\"\u003etrue\u003c/code\u003e；否则立即返回\u003ccode class=\"literal\"\u003efalse\u003c/code\u003e，而不等待。","returns":"boolean","text":"pg_try_advisory_lock ( key1 integer, key2 integer ) → boolean","zh_from":"doc"}],"zh_from":"doc"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"0d86e986a54dd754fa142f8b3ddf570003c87b3484fc0b9ea0c0a92b0ce54595","Text":"pg_try_advisory_lock ( key bigint ) → boolean","Returns":"boolean","Payload":{"description":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return true, or return false without waiting if the lock cannot be acquired immediately.","description_html":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return \u003ccode class=\"literal\"\u003etrue\u003c/code\u003e, or return \u003ccode class=\"literal\"\u003efalse\u003c/code\u003e without waiting if the lock cannot be acquired immediately.","description_zh":"","description_zh_html":"","examples":[],"html":"\u003ccode class=\"function\"\u003epg_try_advisory_lock\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ebigint\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eboolean\u003c/code\u003e","returns":"boolean","text":"pg_try_advisory_lock ( key bigint ) → boolean","zh_from":""}},{"Version":"18","Ordinal":1,"Hash":"26a954bab2c95d46198c80718d2d3fac42fbeaf49f1e909c34970f3eb366ad87","Text":"pg_try_advisory_lock ( key1 integer, key2 integer ) → boolean","Returns":"boolean","Payload":{"description":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return true, or return false without waiting if the lock cannot be acquired immediately.","description_html":"Obtains an exclusive session-level advisory lock if available. This will either obtain the lock immediately and return \u003ccode class=\"literal\"\u003etrue\u003c/code\u003e, or return \u003ccode class=\"literal\"\u003efalse\u003c/code\u003e without waiting if the lock cannot be acquired immediately.","description_zh":"","description_zh_html":"","examples":[],"html":"\u003ccode class=\"function\"\u003epg_try_advisory_lock\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey1\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003ekey2\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003einteger\u003c/code\u003e ) → \u003ccode class=\"returnvalue\"\u003eboolean\u003c/code\u003e","returns":"boolean","text":"pg_try_advisory_lock ( key1 integer, key2 integer ) → boolean","zh_from":""}}],"Spellings":null,"SQLState":null,"Evidence":null}
