[IGNITE-19397] Thin 3.0: Return an error to client when outdated schema is used

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.0-beta1
• Fix Version/s: 3.0.0-beta2
• Component/s: thin client
• Labels: ignite-3
• Epic Link: Thin 3.0: Schema validation

Language

Java

• Assignee: Pavel Tupitsyn
• Reporter: Pavel Tupitsyn
• Reviewer: Igor Sapego
• Created: 02/May/23 11:21
• Updated: 23/Oct/23 14:36
• Resolved: 25/Jul/23 09:44

Description

IGNITE-19241 attempts to solve "client inserts data with old schema" problem by sending the latest schema version with every tuple operation response.
However, this approach is not reliable, for example:
1. var view = client.tables().table("FOO").recordView(); view.upsert(...) - now client knows schema v1
2. client.sql().exec("ALTER TABLE FOO ADD COLUMN NEWCOL INT"); - client alters the table, but does not know about schema v2 with new column
3. view.upsert(Tuple.create().set("key", 1).set("NEWCOL", 100)) - v1 is used to send data to the server, NEWCOL is ignored, data is lost. Response says that schema v2 is available, but it is too late.

To ensure that the latest schema is used by the client and no data is lost, we should throw an exception (with a specific error code) from TupleMarshallerImpl when specified schema version is outdated: client will receive an exception (with specific schema version in it), load the specified schema, and retry the operation.

This exception should never be thrown to the user code. We can use an interface on org.apache.ignite.client.handler.requests.table.ClientTuple, something like MatchingSchemaRequired, and TupleMarshallerImpl will only perform the check in that case.

IGNITE-19241 should be probably reverted.

Issue Links

• blocks: IGNITE-19710 .NET: Thin 3.0: Data Streamer schema synchronization
• fixes: IGNITE-20106 Check that client schema version matches server-side schema version
• supercedes: IGNITE-19241 Java thin 3.0: propagate table schema updates to client on write-only operations
• supercedes: IGNITE-19242 .NET: Thin 3.0: propagate table schema updates to client on write-only operations
• links to: GitHub Pull Request #2317