GH-1063: Add is_update field to ActionCreatePreparedStatementResult

[ennuite]

What's Changed

A new field, optional bool is_update = 4;, was added to message ActionCreatePreparedStatementResult. When this field is sent by the server, its value indicates whether the proper network flow to execute the query that the driver should follow uses CommandPreparedStatementQuery or CommandPreparedStatementUpdate.

For outdated servers that don't send the field, the driver maintains its current behavior of using CommandPreparedStatementQuery when the dataset_schema is not empty, thus ensuring the backward compatibility of the new driver with old servers.

This change was created with AI assistance (Augment Code). All lines were manually reviewed by a human. The output is not copyrightable subject matter.

Closes #1063.

[github-actions]

Thank you for opening a pull request!

Please label the PR with one or more of:

• bug-fix
• chore
• dependencies
• documentation
• enhancement

Also, add the 'breaking-change' label if appropriate.

See CONTRIBUTING.md for details.

[ennuite]

@lidavidm this PR currently contains a client implementation of the changes proposed in https://lists.apache.org/thread/88msflnwkkw8t81czs2ndqhkn1fb1pxd

I can expand it with a server side implementation or we can use already use this as a starting point for the discussion, let me know what you think.

[lidavidm]

This should be done on apache/arrow, not apache/arrow-java, which only has a copy of the spec

We will need a client and server implementation, preferably in at least two languages

[lidavidm]

That said we can use this for discussion, if you want to link it from the mailing list thread.

[lidavidm]

Ah you did link this already; thanks. In that case I think we just need to demonstrate the server side, etc.

[ennuite]

Sounds good @lidavidm I updated this PR with a server side implementation and tests for Statement.execute() and PreparedStatement.execute()

I will implement an analogous PR in another driver. The only driver in apache/arrow is the ODBC driver but that is still unreleased and Windows only. Is it ok if I do it in the ADBC Python Flight SQL driver, which lives at apache/arrow-adbc? I can then move on to ODBC if the community tells me to go forward with the changes.

I note that these changes, while affecting the protocol, are mostly about drivers, so arrow-adbc makes more sense to me.

[lidavidm]

I assume you can and would need to make changes to arrow-go, arrow-cpp, etc? We can start there.