{"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","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"],"signature":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean ]] ) → jsonb","signature_count":1,"slug":"jsonb-path-query-first","source_rev":"2026-09-14T13:14:25.684213+00:00@99e6866c","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":"2026-09-14T13:14:25.684213+00:00@99e6866c","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":"","description_zh_html":"","doc":{"anchor":"FUNCTIONS-JSON-PROCESSING-TABLE","file":"functions-json.html","slug":"18"},"group":"json","group_label":"Json Functions And Operators","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":"","description_zh_html":"","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":""}],"zh_from":""},"ManualEvidence":{"doc":{"anchor":"FUNCTIONS-JSON-PROCESSING-TABLE","file":"functions-json.html","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"func","Key":"jsonb-path-query-first","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"jsonb_path_query_first","Summary":"为指定的JSON值返回由JSON路径返回的第一个JSON项。如果没有结果则返回NULL。参数与jsonb_path_query相同。","BodyHTML":"为指定的JSON值返回由JSON路径返回的第一个JSON项。如果没有结果则返回\u003ccode\u003eNULL\u003c/code\u003e。参数与\u003ccode\u003ejsonb_path_query\u003c/code\u003e相同。\u003cpre\u003ejsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean ]] ) → jsonb\u003c/pre\u003e为指定的JSON值返回由JSON路径返回的第一个JSON项。如果没有结果则返回\u003ccode\u003eNULL\u003c/code\u003e。参数与\u003ccode\u003ejsonb_path_query\u003c/code\u003e相同。","SourceRevision":"1b5ca64c","ContentHash":"9bdd95885927d3cd1276cbc6fabaef58293bfa51748894754f43ef5c6dabd78b","Payload":{"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相同。","signatures":[{"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相同。","returns":"jsonb","text":"jsonb_path_query_first ( target jsonb, path jsonpath [, vars jsonb [, silent boolean ]] ) → jsonb","zh_from":"doc"}],"zh_from":"doc"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["12","13","14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":[{"Version":"18","Ordinal":0,"Hash":"cac677f2c802a4d0f17e279f463e020af43ca277b870a05743b0d822575f1b3b","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":"","description_zh_html":"","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":""}}],"Spellings":null,"SQLState":null,"Evidence":null}