[MDEV-14913] Document human-readable XA RECOVER Created: 2018-01-10  Updated: 2018-01-15  Resolved: 2018-01-15

Status: Closed
Project: MariaDB Server
Component/s: Documentation, XA
Affects Version/s: None
Fix Version/s: N/A

Type: Bug Priority: Major
Reporter: Ian Gilfillan Assignee: Ian Gilfillan
Resolution: Fixed Votes: 0
Labels: None

Issue Links:
Relates
relates to MDEV-14922 XA RECOVER FORMAT='SQL' requires quot... Confirmed
relates to MDEV-14593 human-readable XA RECOVER Closed

 Description   

MDEV-14593 has no associated documentation, and the documentation that has been added by others on https://mariadb.com/kb/en/library/xa-transactions/ is not sufficient.



 Comments   
Comment by Ian Gilfillan [ 2018-01-10 ]

holyfoot, monty or serg please provide examples for this feature - I can't find any tests, and the documentation added to the page in:
https://mariadb.com/kb/en/library/xa-transactions/+revision/64274/64269/
and
https://mariadb.com/kb/en/library/xa-transactions/+revision/64269/25115/
is not correct or sufficient. For example,

XA RECOVER FORMAT=SQL;
ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'SQL' at line 1

If I run the two forms, all I see is a difference in quotes, and I'm not sure how that's helpful:

XA RECOVER FORMAT='SQL';
+----------+--------------+--------------+--------+
| formatID | gtrid_length | bqual_length | data   |
+----------+--------------+--------------+--------+
|        1 |            4 |            0 | 'test' |
+----------+--------------+--------------+--------+
 
XA RECOVER FORMAT='RAW';
+----------+--------------+--------------+------+
| formatID | gtrid_length | bqual_length | data |
+----------+--------------+--------------+------+
|        1 |            4 |            0 | test |
+----------+--------------+--------------+------+

Comment by Sergei Golubchik [ 2018-01-10 ]

Test cases are in the commit, https://github.com/mariadb/server/commit/0acac4fe5fd6d8fab9f13859219f46842153803b

For a meaningful test case try something with non-printable bytes in gtrid and/or with bqual. Then you'll see the difference.

Generated at Thu Feb 08 08:17:15 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.