{"Entry":{"collection":"psql","key":"cmd-62-69-6e-64","name":"\\bind","aliases":["\\bind"],"metadata":{"aliases":["\\bind"],"category":"Query execution","content_hash":"01e00f641f39cb7a05984d8837eedf503e740a4f802277a3663393e727a8624a","derived_content_hash":"11debe9cc1ad93343a1549062bfb0533189208d5dffc9e62ad55a7380ca9c62e","documentation_refresh":{"batch":"20261113","original_source_rev":"","versions":{"16":"16.16","17":"17.12","18":"18.7","19":"19rc2"}},"imported_at":"2026-09-30T00:40:44.706346+08:00","name":"\\bind","name_zh":"","slug":"cmd-62-69-6e-64","summary":"Sets query parameters for the next query execution, with the specified parameters passed for any parameter placeholders ( $1 etc.)."}},"Definition":{"Collection":"psql","Key":"cmd-62-69-6e-64","SourceDatabase":"center","Version":"18","SourceTable":"psql_command","SourceKey":"cmd-62-69-6e-64","SourceRevision":"1b2d62b4845aa46374f2cb680f95d3392322cc8128646992ae4e18d0e7084915","Facts":{"command":"\\bind","comparison_data":{"definition":"Sets query parameters for the next query execution, with the specified parameters passed for any parameter placeholders ( $1 etc.). Example: INSERT INTO tbl1 VALUES ($1, $2) \\bind 'first value' 'second value' \\g This also works for query-execution commands besides \\g , such as \\gx and \\gset . This command causes the extended query protocol (see Section 54.1.2 ) to be used, unlike normal psql operation, which uses the simple query protocol. So this command can be useful to test the extended query protocol from psql . (The extended query protocol is used even if the query has no parameters and this command specifies zero parameters.) This command affects only the next query executed; all subsequent queries will use the simple query protocol by default.","modifiers":[],"signature":"\\bind [ parameter ] ...","spellings":["\\bind"]},"comparison_hash":"6289835b165c64d534aa75d06db8cd8fb98840ebcf240fb78f682fef2ff9a6c4","description":["Sets query parameters for the next query execution, with the specified parameters passed for any parameter placeholders ( $1 etc.)."],"description_zh":"为下一次查询执行设置查询参数，并将指定参数传给任意参数占位符（ $1 等）。","description_zh_html":"\u003cdd\u003e\u003cp\u003e\n         为下一次查询执行设置查询参数，并将指定参数传给任意参数占位符（\u003ccode class=\"literal\"\u003e$1\u003c/code\u003e 等）。\n        \u003c/p\u003e\u003cp\u003e\n         示例：\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003e\nINSERT INTO tbl1 VALUES ($1, $2) \\bind 'first value' 'second value' \\g\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         这对除 \u003ccode class=\"literal\"\u003e\\g\u003c/code\u003e 之外的查询执行命令也有效，例如 \u003ccode class=\"literal\"\u003e\\gx\u003c/code\u003e 和\n         \u003ccode class=\"literal\"\u003e\\gset\u003c/code\u003e。\n        \u003c/p\u003e\u003cp\u003e\n         此命令会使用扩展查询协议（参见\u003ca class=\"xref\" href=\"/zh/docs/18/protocol-overview.html#PROTOCOL-QUERY-CONCEPTS\" title=\"54.1.2. 扩展查询概述\"\u003e第 54.1.2 节\u003c/a\u003e），不同于 \u003cspan class=\"application\"\u003epsql\u003c/span\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":"\\bind"}],"facts_zh":[{"label":"客户端","value":"psql 18.7"},{"label":"区分大小写的写法","value":"\\bind"}],"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-BIND\"\u003e\u003cspan class=\"term\"\u003e\u003ccode class=\"literal\"\u003e\\bind\u003c/code\u003e [ \u003cem class=\"replaceable\"\u003e\u003ccode\u003eparameter\u003c/code\u003e\u003c/em\u003e ] ... \u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Sets query parameters for the next query execution, with the\n         specified parameters passed for any parameter placeholders\n         (\u003ccode class=\"literal\"\u003e$1\u003c/code\u003e etc.).\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eINSERT INTO tbl1 VALUES ($1, $2) \\bind 'first value' 'second value' \\g\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This also works for query-execution commands besides\n         \u003ccode class=\"literal\"\u003e\\g\u003c/code\u003e, such as \u003ccode class=\"literal\"\u003e\\gx\u003c/code\u003e and\n         \u003ccode class=\"literal\"\u003e\\gset\u003c/code\u003e.\n        \u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol (see \u003ca class=\"xref\" href=\"/docs/18/protocol-overview.html#PROTOCOL-QUERY-CONCEPTS\" title=\"54.1.2. Extended Query Overview\"\u003eSection 54.1.2\u003c/a\u003e) to be used, unlike normal\n         \u003cspan class=\"application\"\u003epsql\u003c/span\u003e operation, which uses the simple\n         query protocol.  So this command can be useful to test the extended\n         query protocol from \u003cspan class=\"application\"\u003epsql\u003c/span\u003e.  (The extended\n         query protocol is used even if the query has no parameters and this\n         command specifies zero parameters.)  This command affects only the\n         next 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-BIND","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":"\\bind [ parameter ] ...","sources":[{"anchor":"APP-PSQL-META-COMMAND-BIND","file":"app-psql.html","label":"18.7 English manual · app-psql.html","sha256":"af50448485df02bdef2b72b8347192ba029c7082b8d0392ecb17db44ad533aaf","url":"/docs/18/app-psql.html#APP-PSQL-META-COMMAND-BIND"}],"spellings":["\\bind"],"tables":[{"columns":[{"key":"command","label":"Command"},{"key":"modifiers","label":"Documented suffix modifiers"}],"key":"spellings","rows":[{"command":{"text":"\\bind","url":"/wiki/psql/cmd-62-69-6e-64/?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":"\\bind","url":"/wiki/psql/cmd-62-69-6e-64/?v=18"},"modifiers":"此语法签名未列出"}],"title":"本版手册中的写法"}],"zh_from":"same-version-manual"},"ManualEvidence":{"manual_path":"app-psql.html#APP-PSQL-META-COMMAND-BIND","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-BIND","file":"app-psql.html","label":"18.7 English manual · app-psql.html","sha256":"af50448485df02bdef2b72b8347192ba029c7082b8d0392ecb17db44ad533aaf","url":"/docs/18/app-psql.html#APP-PSQL-META-COMMAND-BIND"}]},"MeasuredEvidence":{}},"Text":{"Collection":"psql","Key":"cmd-62-69-6e-64","SourceDatabase":"center","Version":"18","Locale":"en","Title":"\\bind","Summary":"Sets query parameters for the next query execution, with the specified parameters passed for any parameter placeholders ( $1 etc.).","BodyHTML":"\u003cdiv\u003e\u003cdl\u003e\u003cdt id=\"APP-PSQL-META-COMMAND-BIND\"\u003e\u003cspan\u003e\u003ccode\u003e\\bind\u003c/code\u003e [ \u003cem\u003e\u003ccode\u003eparameter\u003c/code\u003e\u003c/em\u003e ] ... \u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Sets query parameters for the next query execution, with the\n         specified parameters passed for any parameter placeholders\n         (\u003ccode\u003e$1\u003c/code\u003e etc.).\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre\u003eINSERT INTO tbl1 VALUES ($1, $2) \\bind \u0026#39;first value\u0026#39; \u0026#39;second value\u0026#39; \\g\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This also works for query-execution commands besides\n         \u003ccode\u003e\\g\u003c/code\u003e, such as \u003ccode\u003e\\gx\u003c/code\u003e and\n         \u003ccode\u003e\\gset\u003c/code\u003e.\n        \u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol (see \u003ca href=\"/docs/18/protocol-overview.html#PROTOCOL-QUERY-CONCEPTS\" rel=\"nofollow\"\u003eSection 54.1.2\u003c/a\u003e) to be used, unlike normal\n         \u003cspan\u003epsql\u003c/span\u003e operation, which uses the simple\n         query protocol.  So this command can be useful to test the extended\n         query protocol from \u003cspan\u003epsql\u003c/span\u003e.  (The extended\n         query protocol is used even if the query has no parameters and this\n         command specifies zero parameters.)  This command affects only the\n         next 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":"25d56f13cc9485ee14094c77376e4e942a24df921861cd3afc54cdaf19c1238a","Payload":{"description":["Sets query parameters for the next query execution, with the specified parameters passed for any parameter placeholders ( $1 etc.)."],"manual_html":"\u003cdiv\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt id=\"APP-PSQL-META-COMMAND-BIND\"\u003e\u003cspan class=\"term\"\u003e\u003ccode class=\"literal\"\u003e\\bind\u003c/code\u003e [ \u003cem class=\"replaceable\"\u003e\u003ccode\u003eparameter\u003c/code\u003e\u003c/em\u003e ] ... \u003c/span\u003e \u003c/dt\u003e\u003cdd\u003e\u003cp\u003e\n         Sets query parameters for the next query execution, with the\n         specified parameters passed for any parameter placeholders\n         (\u003ccode class=\"literal\"\u003e$1\u003c/code\u003e etc.).\n        \u003c/p\u003e\u003cp\u003e\n         Example:\n\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eINSERT INTO tbl1 VALUES ($1, $2) \\bind 'first value' 'second value' \\g\n\u003c/pre\u003e\u003cp\u003e\n\u003c/p\u003e\u003cp\u003e\n         This also works for query-execution commands besides\n         \u003ccode class=\"literal\"\u003e\\g\u003c/code\u003e, such as \u003ccode class=\"literal\"\u003e\\gx\u003c/code\u003e and\n         \u003ccode class=\"literal\"\u003e\\gset\u003c/code\u003e.\n        \u003c/p\u003e\u003cp\u003e\n         This command causes the extended query protocol (see \u003ca class=\"xref\" href=\"/docs/18/protocol-overview.html#PROTOCOL-QUERY-CONCEPTS\" title=\"54.1.2. Extended Query Overview\"\u003eSection 54.1.2\u003c/a\u003e) to be used, unlike normal\n         \u003cspan class=\"application\"\u003epsql\u003c/span\u003e operation, which uses the simple\n         query protocol.  So this command can be useful to test the extended\n         query protocol from \u003cspan class=\"application\"\u003epsql\u003c/span\u003e.  (The extended\n         query protocol is used even if the query has no parameters and this\n         command specifies zero parameters.)  This command affects only the\n         next 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":"\\bind","url":"/wiki/psql/cmd-62-69-6e-64/?v=18"},"modifiers":"None listed in this signature"}],"title":"Spellings in this manual definition"}]}},"RequestedLocale":"en","Fallback":false,"Versions":["16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":[{"Version":"18","Ordinal":0,"Command":"\\bind","Signature":"\\bind [ parameter ] ...","Modifiers":[]}],"SQLState":null,"Evidence":null}