[MDEV-12807] Document CONNECT engine's OPTION_LIST options more clearly Created: 2017-05-15  Updated: 2023-12-13

Status: Open
Project: MariaDB Server
Component/s: Documentation, Storage Engine - Connect
Affects Version/s: 10.0, 10.1, 10.2
Fix Version/s: 10.2

Type: Bug Priority: Major
Reporter: Geoff Montee (Inactive) Assignee: Olivier Bertrand
Resolution: Unresolved Votes: 1
Labels: connect-engine, documentation

Issue Links:
PartOf

 Description   

Various CONNECT engine documentation pages refer to OPTION_LIST options in passing.

For example, this page mentions the eof option:

alter table xtab option_list='eof=1';

And this page refers to the Expand option:

OPTION_LIST='Expand=AUTHOR'

And the level option:

create table jsampall2 engine=connect table_type=JSON 
  file_name='biblio3.json' option_list='level=1';

And there seems to be many more of these options spread across many different documentation pages, but there does not seem to be any page that lists all of these options that also describes what each options does.

It might help to create a new CONNECT documentation page that contains the following information:

  • A full list of options available to be used in OPTION_LIST.
  • A description of what each option does.
  • A list of what table types each option is valid for.
  • If an option was added or removed in a certain CONNECT version, list what those versions are.

It might also help to create an "OPTION_LIST" section on the documentation page for each table type, and this section can describe the options that can be used in OPTION_LIST for that table type. This section should probably also the information mentioned above about each option.



 Comments   
Comment by Julien Fritsch [ 2018-03-22 ]

bertrandop how are you? May I ask if this is something you see as a good idea to be documented or not? If not I recommend we close it as "won't fix".

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