{"Entry":{"collection":"psql","key":"cmd-70-61-72-73-65","name":"\\parse","aliases":["\\parse"],"metadata":{"aliases":["\\parse"],"category":"Query execution","content_hash":"5c9fffa54744e2fe2a02eeea9208ea3c58764d15f31907b527cf46b62c961bb6","derived_content_hash":"c562d89a02d206a511e6cc7873d3d5eb4a1f168e1af19ebfb594090c09ff5153","documentation_refresh":{"batch":"20261113","original_source_rev":"","versions":{"18":"18.7","19":"19rc2"}},"imported_at":"2026-09-30T00:40:45.126266+08:00","name":"\\parse","name_zh":"","slug":"cmd-70-61-72-73-65","summary":"Creates a prepared statement from the current query buffer, based on the name of a destination prepared-statement object. An empty string denotes the unnamed prepared statement."}},"Definition":{"Collection":"psql","Key":"cmd-70-61-72-73-65","SourceDatabase":"center","Version":"18","SourceTable":"psql_command","SourceKey":"cmd-70-61-72-73-65","SourceRevision":"1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915","Facts":{"command":"\\parse","comparison_data":{"definition":"Creates a prepared statement from the current query buffer, based on the name of a destination prepared-statement object. An empty string denotes the unnamed prepared statement. Example: SELECT $1 \\parse stmt1 This command causes the extended query protocol to be used, unlike normal psql operation, which uses the simple query protocol. A Parse (F) message will be issued by this command so it can be useful to test the extended query protocol from psql . This command affects only the next query executed; all subsequent queries will use the simple query protocol by default.","modifiers":[],"signature":"\\parse statement_name","spellings":["\\parse"]},"comparison_hash":"7c5c085ea0f3fe44488436b45dea4f7f6affb0f181e303fb593ac2e6bc231b6d","description":["Creates a prepared statement from the current query buffer, based on the name of a destination prepared-statement object. An empty string denotes the unnamed prepared statement."],"description_zh":"基于目标预备语句对象的名称，从当前查询缓冲区创建一个预备语句。空字符串表示未命名的预备语句。","description_zh_html":"\u003cdd\u003e\u003cp\u003e\n         基于目标预备语句对象的名称，从当前查询缓冲区创建一个预备语句。空字符串表示未命名的预备语句。\n        \u003c/p\u003e\u003cp\u003e\n         示例：\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003e\nSELECT $1 \\parse stmt1\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         此命令会使用扩展查询协议，不同于 \u003cspan class=\"application\"\u003epsql\u003c/span\u003e 通常使用的简单查询协议。该命令会发出一条 \u003ca class=\"xref\" href=\"/zh/docs/18/protocol-message-formats.html#PROTOCOL-MESSAGE-FORMATS-PARSE\"\u003eParse (F)\u003c/a\u003e 消息，因此可用于在 \u003cspan class=\"application\"\u003epsql\u003c/span\u003e 中测试扩展查询协议。此命令只影响下一条被执行的查询；之后的所有查询默认仍会使用简单查询协议。\n        \u003c/p\u003e\u003c/dd\u003e","documentation_revision":{"inputs":[{"file":"app-psql.html","kind":"same-version-reviewed-manual","locale":"en","sha256":"af50448485df02bdef2b72b8347192ba029c7082b8d0392ecb17db44ad533aaf","version":"18.7"},{"file":"app-psql.html","kind":"same-version-reviewed-manual","locale":"zh-Hans","sha256":"cb475c53a16d9e06358f5e6c9c5649645db92568cfd319f230c62c9f57ae090b","version":"18.7"}],"release":"18.7","runtime_remeasured":false,"source_revision":"pgdoc:b9f0e7232f60f380d642ac9b99226606c254b552"},"facts":[{"label":"Client","value":"psql 18.7"},{"label":"Case-sensitive spelling","value":"\\parse"}],"facts_zh":[{"label":"客户端","value":"psql 18.7"},{"label":"区分大小写的写法","value":"\\parse"}],"localization":{"documentation_release":"18.7","language":"en","source_language":"en","source_revision":"pgdoc:b9f0e7232f60f380d642ac9b99226606c254b552","status":"same-version-reviewed-manual"},"manual_html":"\u003cdiv\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt id=\"APP-PSQL-META-COMMAND-PARSE\"\u003e\u003cspan class=\"term\"\u003e\u003ccode class=\"literal\"\u003e\\parse \u003cem class=\"replaceable\"\u003e\u003ccode\u003estatement_name\u003c/code\u003e\u003c/em\u003e\u003c/code\u003e\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Creates a prepared statement from the current query buffer, based on\n         the name of a destination prepared-statement object. An empty string\n         denotes the unnamed prepared statement.\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eSELECT $1 \\parse stmt1\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol to be used, unlike\n         normal \u003cspan class=\"application\"\u003epsql\u003c/span\u003e operation, which uses the\n         simple query protocol. A\n         \u003ca class=\"xref\" href=\"/docs/18/protocol-message-formats.html#PROTOCOL-MESSAGE-FORMATS-PARSE\"\u003eParse (F)\u003c/a\u003e\n         message will be issued by this command so it can be useful to\n         test the extended query protocol from\n         \u003cspan class=\"application\"\u003epsql\u003c/span\u003e. This command affects only the next\n         query executed; all subsequent queries will use the simple query\n         protocol by default.\n        \u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e","manual_path":"app-psql.html#APP-PSQL-META-COMMAND-PARSE","modifiers":[],"related":[{"label":"psql command-line options and complete manual","url":"/wiki/tool/psql/?v=18"}],"related_zh":[{"label":"psql 命令行选项及完整手册","url":"/wiki/tool/psql/?v=18"}],"release":{"channel":"stable","evidence_kind":"English manual and source declarations","label":"18.7","major":"18","manifest":{"major":"18","release":"18.7","source_sha256":"441dfae4280cae3e0425e5f876f80559fb0731c140f1aae22b3e5a54d0411bfd","source_url":"https://ftp.postgresql.org/pub/source/v18.7/postgresql-18.7.tar.bz2"},"ref":"https://ftp.postgresql.org/pub/source/v18.7/postgresql-18.7.tar.bz2","revision":"1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915","source_sha256":"441dfae4280cae3e0425e5f876f80559fb0731c140f1aae22b3e5a54d0411bfd"},"sections":[],"sections_zh":[],"signature":"\\parse statement_name","sources":[{"anchor":"APP-PSQL-META-COMMAND-PARSE","file":"app-psql.html","label":"18.7 English manual · app-psql.html","sha256":"af50448485df02bdef2b72b8347192ba029c7082b8d0392ecb17db44ad533aaf","url":"/docs/18/app-psql.html#APP-PSQL-META-COMMAND-PARSE"}],"spellings":["\\parse"],"tables":[{"columns":[{"key":"command","label":"Command"},{"key":"modifiers","label":"Documented suffix modifiers"}],"key":"spellings","rows":[{"command":{"text":"\\parse","url":"/wiki/psql/cmd-70-61-72-73-65/?v=18"},"modifiers":"None listed in this signature"}],"title":"Spellings in this manual definition"}],"tables_zh":[{"columns":[{"key":"command","label":"命令"},{"key":"modifiers","label":"手册中的后缀修饰符"}],"key":"spellings","rows":[{"command":{"text":"\\parse","url":"/wiki/psql/cmd-70-61-72-73-65/?v=18"},"modifiers":"此语法签名未列出"}],"title":"本版手册中的写法"}],"zh_from":"same-version-manual"},"ManualEvidence":{"manual_path":"app-psql.html#APP-PSQL-META-COMMAND-PARSE","release":{"channel":"stable","evidence_kind":"English manual and source declarations","label":"18.7","major":"18","manifest":{"major":"18","release":"18.7","source_sha256":"441dfae4280cae3e0425e5f876f80559fb0731c140f1aae22b3e5a54d0411bfd","source_url":"https://ftp.postgresql.org/pub/source/v18.7/postgresql-18.7.tar.bz2"},"ref":"https://ftp.postgresql.org/pub/source/v18.7/postgresql-18.7.tar.bz2","revision":"1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915","source_sha256":"441dfae4280cae3e0425e5f876f80559fb0731c140f1aae22b3e5a54d0411bfd"},"sources":[{"anchor":"APP-PSQL-META-COMMAND-PARSE","file":"app-psql.html","label":"18.7 English manual · app-psql.html","sha256":"af50448485df02bdef2b72b8347192ba029c7082b8d0392ecb17db44ad533aaf","url":"/docs/18/app-psql.html#APP-PSQL-META-COMMAND-PARSE"}]},"MeasuredEvidence":{}},"Text":{"Collection":"psql","Key":"cmd-70-61-72-73-65","SourceDatabase":"center","Version":"18","Locale":"en","Title":"\\parse","Summary":"Creates a prepared statement from the current query buffer, based on the name of a destination prepared-statement object. An empty string denotes the unnamed prepared statement.","BodyHTML":"\u003cdiv\u003e\u003cdl\u003e\u003cdt id=\"APP-PSQL-META-COMMAND-PARSE\"\u003e\u003cspan\u003e\u003ccode\u003e\\parse \u003cem\u003e\u003ccode\u003estatement_name\u003c/code\u003e\u003c/em\u003e\u003c/code\u003e\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Creates a prepared statement from the current query buffer, based on\n         the name of a destination prepared-statement object. An empty string\n         denotes the unnamed prepared statement.\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre\u003eSELECT $1 \\parse stmt1\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol to be used, unlike\n         normal \u003cspan\u003epsql\u003c/span\u003e operation, which uses the\n         simple query protocol. A\n         \u003ca href=\"/docs/18/protocol-message-formats.html#PROTOCOL-MESSAGE-FORMATS-PARSE\" rel=\"nofollow\"\u003eParse (F)\u003c/a\u003e\n         message will be issued by this command so it can be useful to\n         test the extended query protocol from\n         \u003cspan\u003epsql\u003c/span\u003e. This command affects only the next\n         query executed; all subsequent queries will use the simple query\n         protocol by default.\n        \u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e","SourceRevision":"1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915","ContentHash":"e0d53100b951fc1bf8653a0be3c143c034d60a2ae141fab200b412c7352ff5a6","Payload":{"description":["Creates a prepared statement from the current query buffer, based on the name of a destination prepared-statement object. An empty string denotes the unnamed prepared statement."],"manual_html":"\u003cdiv\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt id=\"APP-PSQL-META-COMMAND-PARSE\"\u003e\u003cspan class=\"term\"\u003e\u003ccode class=\"literal\"\u003e\\parse \u003cem class=\"replaceable\"\u003e\u003ccode\u003estatement_name\u003c/code\u003e\u003c/em\u003e\u003c/code\u003e\u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Creates a prepared statement from the current query buffer, based on\n         the name of a destination prepared-statement object. An empty string\n         denotes the unnamed prepared statement.\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eSELECT $1 \\parse stmt1\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol to be used, unlike\n         normal \u003cspan class=\"application\"\u003epsql\u003c/span\u003e operation, which uses the\n         simple query protocol. A\n         \u003ca class=\"xref\" href=\"/docs/18/protocol-message-formats.html#PROTOCOL-MESSAGE-FORMATS-PARSE\"\u003eParse (F)\u003c/a\u003e\n         message will be issued by this command so it can be useful to\n         test the extended query protocol from\n         \u003cspan class=\"application\"\u003epsql\u003c/span\u003e. This command affects only the next\n         query executed; all subsequent queries will use the simple query\n         protocol by default.\n        \u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e","related":[{"label":"psql command-line options and complete manual","url":"/wiki/tool/psql/?v=18"}],"sections":[],"tables":[{"columns":[{"key":"command","label":"Command"},{"key":"modifiers","label":"Documented suffix modifiers"}],"key":"spellings","rows":[{"command":{"text":"\\parse","url":"/wiki/psql/cmd-70-61-72-73-65/?v=18"},"modifiers":"None listed in this signature"}],"title":"Spellings in this manual definition"}]}},"RequestedLocale":"en","Fallback":false,"Versions":["18","19","20"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":[{"Version":"18","Ordinal":0,"Command":"\\parse","Signature":"\\parse statement_name","Modifiers":[]}],"SQLState":null,"Evidence":null}