kou commented on code in PR #40243:
URL: https://github.com/apache/arrow/pull/40243#discussion_r1534987835
##########
docs/source/format/FlightSql.rst:
##########
@@ -141,6 +141,21 @@ the ``type`` should be ``ClosePreparedStatement``).
Execute a previously created prepared statement and get the results.
When used with DoPut: binds parameter values to the prepared statement.
+ The server may optionally provide an updated handle in the response.
+ Updating the handle allows the client to supply all state required to
+ execute the query in an ActionPreparedStatementExecute message.
+ For example, stateless servers can encode the bound parameter values into
+ the new handle, and the client will send that new handle with parameters
+ back to the server.
+
+ Note that a handle returned from a DoPut call with
+ CommandPreparedStatementQuery can itself be passed to a subsequent DoPut
+ call with CommandPreparedStatementQuery to bind a new set of parameters.
+ The subsequent call itself may return an updated handled which again should
Review Comment:
```suggestion
The subsequent call itself may return an updated handle which again
should
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
