-
Type: Spec Change
-
Resolution: Unresolved
-
Priority: Unknown
-
None
-
Component/s: Index Management
-
None
-
Needed
-
Summary
The index management specification lists `version` as an option for the create index helpers. This is not a valid option for the `createIndexes` command and the correct option is `v`.
It seems that the original intent of the specification was to provide users with a `version` option that would result in the `v` option being attached to the `createIndexes` command, but this was not specified. The spec should clarify that if drivers provide a `version` option, it should correspond to the `v` option on the createIndexes command.
We can also consider making `version` optional in the spec, since it is an undocumented option to the `createIndexes` command.
We may also want to consider adding tests for the index management helpers - there are currently no index management prose or unified tests.
Motivation
Who is the affected end user?
driver users.
How does this affect the end user?
users may encounter server errors when attempting to specify the version of their indexes, if drivers support the `version` option for createIndex
How likely is it that this problem or use case will occur?
unlikely - these fields aren't documented so it's unlikely that users are using them.
If the problem does occur, what are the consequences and how severe are they?
minor - users might encounter server errors trying to specify the index version or might be unable to create indexes with version 1 in some drivers.
Is this issue urgent?
no.
Is this ticket required by a downstream team?
no.
Is this ticket only for tests?
no.
Acceptance Criteria
- clarify that `version` maps to the `v` field in the createIndexes command
- (optional) make `version` optional for drivers to implement
- (optional) add tests for the createIndex specification
- is related to
-
NODE-5971 use the value of `CreateIndexOptions.version` to specify the index version in `createIndex` helpers
- Closed