{"Entry":{"collection":"func","key":"jsonb-path-query-first","name":"jsonb_path_query_first","aliases":[],"metadata":{"changed_in":[],"changes":[{"descriptions_changed":false,"doc_overhaul":false,"from":"11","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"added","to":"12"},{"descriptions_changed":false,"doc_overhaul":true,"from":"12","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"13"},{"descriptions_changed":true,"doc_overhaul":false,"from":"16","group_changed":null,"signatures":{"added":[],"removed":[]},"status":"changed","to":"17"}],"content_hash":"d236414dad3079a1dc2cecdbaaf4e1c4d4948b49d0f2e601c3dfe39e63177f85","derived_content_hash":"6f1795954d00f0e0c7e7830d772095db978b09a5ac1e7fed44da0d55bb44f783","documentation_refresh":{"batch":"20261113","original_source_rev":"wiki-repair-20261023:392b4f9b2621a202715953fdb4b5083441dad4e2d002af7f56a0a1563710ab34","versions":{"14":"14.25","15":"15.20","16":"16.16","17":"17.12","18":"18.7","19":"19rc2"}},"first_version":"12","group":"json","group_label":"Json Functions And Operators","groups":["json"],"imported_at":"2026-09-14T21:49:48.809523+08:00","last_version":"20","name":"jsonb_path_query_first","name_key":"jsonb_path_query_first","position":16045,"present_in":["12","13","14","15","16","17","18","19","20"],"repair_provenance":{"original_source_revision":"2026-09-14T13:14:25.684213+00:00@99e6866c","receipt_sha256":"b78901f26031fa846e5020398dcba1f0de6690544e85d0f47d61499d21be16cb","repair":"wiki-repair-20261023"},"signature":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean ]] ) → jsonb","signature_count":1,"slug":"jsonb-path-query-first","source_rev":"wiki-repair-20261023:392b4f9b2621a202715953fdb4b5083441dad4e2d002af7f56a0a1563710ab34","summary":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results.","summary_zh":""}},"Definition":{"Collection":"func","Key":"jsonb-path-query-first","SourceDatabase":"center","Version":"18","SourceTable":"func","SourceKey":"jsonb-path-query-first","SourceRevision":"wiki-repair-20261023:392b4f9b2621a202715953fdb4b5083441dad4e2d002af7f56a0a1563710ab34","Facts":{"description":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","description_html":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e.","description_zh":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 NULL。参数与 jsonb_path_query 相同。","description_zh_html":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。参数与 \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e 相同。","doc":{"anchor":"FUNCTIONS-JSON-PROCESSING-TABLE","file":"functions-json.html","sha256":"060b67147827d70ddcf5948833ddfbeada321366476016c8b8b7d68afda8045c","slug":"18"},"documentation_revision":{"inputs":[{"file":"functions-json.html","kind":"same-version-reviewed-manual","locale":"en","sha256":"060b67147827d70ddcf5948833ddfbeada321366476016c8b8b7d68afda8045c","version":"18.7"},{"file":"functions-json.html","kind":"same-version-reviewed-manual","locale":"zh-Hans","sha256":"31b98fa7f00387abf441728c31918bfe8b368642bceeb8bba88a73c3fbd607de","version":"18.7"}],"release":"18.7","runtime_remeasured":false,"source_revision":"pgdoc:b9f0e7232f60f380d642ac9b99226606c254b552"},"group":"json","group_label":"JSON 函数和操作符","lang":"en","layout":"table-new","pages":["functions-json.html"],"prose_only":false,"signatures":[{"description":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","description_html":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e.","description_zh":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 NULL。参数与 jsonb_path_query 相同。","description_zh_html":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。参数与 \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e 相同。","examples":[{"expr":"jsonb_path_query_first('{\"a\":[1,2,3,4,5]}', '$.a[*] ? (@ \u003e= $min \u0026\u0026 @ \u003c= $max)', '{\"min\":2, \"max\":4}')","result":"2"}],"html":"\u003ccode class=\"function\"\u003ejsonb_path_query_first\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003etarget\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003epath\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonpath\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003evars\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003esilent\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003eboolean\u003c/code\u003e\u003c/span\u003e]\u003c/span\u003e] ) → \u003ccode class=\"returnvalue\"\u003ejsonb\u003c/code\u003e","returns":"jsonb","text":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean]] ) → jsonb","zh_from":"same-version-manual"}],"translation_provenance":{"inputs":[{"kind":"current-pgdoc-translation","path":"/Users/vonng/pgsty/pgdoc/zh/18/html/functions-json.html","sha256":"a412feb14a229f1d9f14fa2d7735255aa297d5eb8f2971d744d9dfee659c7cca"}],"kind":"same-version-pgdoc","locale":"zh-Hans","source_revision":"b1b500221dbe5437cfca004d6b04d3f6e422765d","version":"18"},"zh_from":"same-version-manual"},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-JSON-PROCESSING-TABLE","file":"functions-json.html","sha256":"060b67147827d70ddcf5948833ddfbeada321366476016c8b8b7d68afda8045c","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"jsonb-path-query-first","SourceDatabase":"center","Version":"18","Locale":"en","Title":"jsonb_path_query_first","Summary":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","BodyHTML":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode\u003ejsonb_path_query\u003c/code\u003e.","SourceRevision":"wiki-repair-20261023:392b4f9b2621a202715953fdb4b5083441dad4e2d002af7f56a0a1563710ab34","ContentHash":"046a8e78e8363ba2ee6dd475e56c1de928e8457286359b0e5489313143f44867","Payload":{"description":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","description_html":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e.","signatures":[{"description":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","description_html":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e.","description_zh":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 NULL。参数与 jsonb_path_query 相同。","description_zh_html":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。参数与 \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e 相同。","examples":[{"expr":"jsonb_path_query_first('{\"a\":[1,2,3,4,5]}', '$.a[*] ? (@ \u003e= $min \u0026\u0026 @ \u003c= $max)', '{\"min\":2, \"max\":4}')","result":"2"}],"html":"\u003ccode class=\"function\"\u003ejsonb_path_query_first\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003etarget\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003epath\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonpath\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003evars\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003esilent\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003eboolean\u003c/code\u003e\u003c/span\u003e]\u003c/span\u003e] ) → \u003ccode class=\"returnvalue\"\u003ejsonb\u003c/code\u003e","returns":"jsonb","text":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean]] ) → jsonb","zh_from":"same-version-manual"}]}},"RequestedLocale":"en","Fallback":false,"Versions":["12","13","14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"3eec9bc44aee65392ca8fd2539ba8e5039783efbba7e647b9ba3081d652882d4","Text":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean]] ) → jsonb","Returns":"jsonb","Payload":{"description":"Returns the first JSON item returned by the JSON path for the specified JSON value, or NULL if there are no results. The parameters are the same as for jsonb_path_query.","description_html":"Returns the first JSON item returned by the JSON path for the specified JSON value, or \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e if there are no results. The parameters are the same as for \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e.","description_zh":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 NULL。参数与 jsonb_path_query 相同。","description_zh_html":"为指定的 JSON 值返回由 JSON 路径返回的第一个 JSON 项。如果没有结果则返回 \u003ccode class=\"literal\"\u003eNULL\u003c/code\u003e。参数与 \u003ccode class=\"function\"\u003ejsonb_path_query\u003c/code\u003e 相同。","examples":[{"expr":"jsonb_path_query_first('{\"a\":[1,2,3,4,5]}', '$.a[*] ? (@ \u003e= $min \u0026\u0026 @ \u003c= $max)', '{\"min\":2, \"max\":4}')","result":"2"}],"html":"\u003ccode class=\"function\"\u003ejsonb_path_query_first\u003c/code\u003e ( \u003cem class=\"parameter\"\u003e\u003ccode\u003etarget\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003epath\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonpath\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003evars\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003ejsonb\u003c/code\u003e [\u003cspan class=\"optional\"\u003e, \u003cem class=\"parameter\"\u003e\u003ccode\u003esilent\u003c/code\u003e\u003c/em\u003e \u003ccode class=\"type\"\u003eboolean\u003c/code\u003e\u003c/span\u003e]\u003c/span\u003e] ) → \u003ccode class=\"returnvalue\"\u003ejsonb\u003c/code\u003e","returns":"jsonb","text":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean]] ) → jsonb","zh_from":"same-version-manual"}}],"Spellings":null,"SQLState":null,"Evidence":null}