-
Notifications
You must be signed in to change notification settings - Fork 24.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Removes typed calls from YAML REST tests #37611
Removes typed calls from YAML REST tests #37611
Conversation
Pinging @elastic/es-search |
type_2: {} | ||
properties: | ||
foo2: | ||
type: keyword |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Curious: why the need to introduce new properties in this test?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The test failed if I added an empty mappings object here. I think it might be because in the YAML framework we might evaluate {} as falsey but I could be wrong. If you feel strongly against doing this I could probably modify the checks below to check explicitly for an empty mappings object
@elasticmachine test this please |
Thanks @colings86 for this PR!
For this API, we accidentally deviated from our usual strategy of creating a new file called
You're right in that these tests are explicitly testing typed behavior, and shouldn't need much modification. Instead of skipping 7.0 completely for these tests, I think we should just make sure the index creation calls specify |
@jtibshirani I push a commit that should address your comments |
@elasticmachine run elasticsearch-ci-2 |
@elasticmachine test this please |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These changes are looking good to me, I just had one additional comment: should we remove the change to the test harness as part of this PR, to make sure that we've covered all the tests that need updating? Here is the change, for reference: https://github.com/elastic/elasticsearch/blob/master/test/framework/src/main/java/org/elasticsearch/test/rest/yaml/ClientYamlTestExecutionContext.java#L101-L107
I also just had a couple thoughts/ clarifications:
- I noticed that in many places we still check the value of the
_type
field in responses. This makes sense to me for the current PR, and I assume we will remove these checks in 8.0 when we stop returning the_type
field altogether. - After this merges, backports from 7.0 to 6.x may encounter more conflicts. However, I'm assuming this will not be a big issue given where we are in terms of the 6.x release cycles.
I think we should do this as a follow up PR since this PR is already pretty big if thats ok with you. The follow up can change the test harness back and then clean up any remaining tests
Yeah I think still checking
I think any conflicts should be pretty simple to resolve since the vast majority of these changes are fairly minor.. Also most of the changes are in the setup of the tests which are less likely to need to be modified in backported PRs, especially given we are so late in the 6.x series |
@elasticmachine test this please |
Is the |
@jpountz I was leaving the |
I don't have a preference, I just had a look and it looks really great. We certainly owe you beers (yes, plural) for that work! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks again for this PR, looks good to me assuming the tests pass!
@elasticmachine test this please |
@elasticmachine run elasticsearch-ci/1 |
@elasticmachine run elasticsearch-ci/1 |
@elasticmachine test this please |
@elasticmachine run elasticsearch-ci/default-distro |
@elasticmachine run elasticsearch-ci/2 |
1 similar comment
@elasticmachine run elasticsearch-ci/2 |
@elasticmachine run elasticsearch-ci/packaging-sample |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Changes to the test harness look good to me.
rest-api-spec/src/main/resources/rest-api-spec/test/indices.get/11_basic_with_types.yml
Show resolved
Hide resolved
...framework/src/main/java/org/elasticsearch/test/rest/yaml/ClientYamlTestExecutionContext.java
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I left one question about the test harness change. It would also be good if we updated the description of the PR to describe this harness change.
// When running tests against a mixed 7.x/6.x cluster we need to add the type to the bulk API requests | ||
// if its not already included. The type can either be on the request parameters or in the action metadata | ||
// in the body of the request so we need to be sensitive to both scenarios | ||
if (apiName.equals("bulk") && esVersion().before(Version.V_7_0_0) && requestParams.containsKey("type") == false) { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry if I'm missing something, but instead of this list of checks, could we just take the simpler approach of always doing requestParams.put("type", "_doc")
when the request param is not already there? In particular, I'm not sure why we would only put the type
parameter if index
is also specified.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We have to do this because in our tests we use both methods of specifying the index (and type) in a bulk request. Sometimes we set the index (and type) on the request params so its applied as a default and then the action metadata just contains {index:{}}
or {index:{ _id: foo}
and sometimes we don't specify the index (or type) on the request params and explicitly define them in the action metadata on each document we want to index. The problem with always setting the type on the request params is that if the index is not set on the request params the request will fail since its not valid to specify the type but not the index here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+1 to the current approach of this PR
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The way our request parsing works, you can actually specify the type without the index. In particular POST _bulk?type=_doc { ... }
is a valid call.
It sounds like you and @jpountz are happy with this though, and this approach is sensible + straightforward, so I'm also happy if we want to merge.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the issue here though is that the type and index are actually used in the path rather than queryParams on the URL (it seems in this class the two are put in the same map). So specifying a type without an index would try the endpoint {type}/_bulk
which is not valid. I actually did it the way you suggested initially and found I got errors when I specified the type without the test specifying the index.
As you are happy for me to merge I'll merge this now and have a closer look into this as a follow up
@jpountz @jtibshirani thanks for the reviews. I pushed a fix for the code style issue and updated the PR description. I also replied to the question. Could you take another look? |
test/framework/src/main/java/org/elasticsearch/test/rest/yaml/ClientYaml TestExecutionContext.java
* master: Expose retention leases in shard stats (elastic#37991) Make primary terms fields private in index shard (elastic#38036) ML: Add reason field in JobTaskState (elastic#38029) Log flush_stats and commit_stats in testMaybeFlush HLRC: Fix strict setting exception handling (elastic#37247) Test: Enable strict deprecation on all tests (elastic#36558) Removes typed calls from YAML REST tests (elastic#37611) Switch default time format for ingest from Joda to Java for v7 (elastic#37934) Remove deprecated Plugin#onModule extension points (elastic#37866) Geo: Fix Empty Geometry Collection Handling (elastic#37978)
This PR removes the temporary change we made to the yml test harness in #37285 to automatically set `include_type_name` to `true` in index creation requests if it's not already specified. This is possible now that the vast majority of index creation requests were updated to be typeless in #37611. A few additional tests also needed updating here. Additionally, this PR updates the test harness to set `include_type_name` to `false` in index creation requests when communicating with 6.x nodes. This mirrors the logic added in #37611 to allow for typeless document write requests in test set-up code. With this update in place, we can remove many references to `include_type_name: false` from the yml tests.
This PR attempts to remove all typed calls from our YAML REST tests. The PR adds
include_type_name: false
to create index requests that use a mapping and also to put mapping requests. It also removes _type from index requests where they haven't already been removed. The PR ignores tests named*_with_types.yml
since this are specifically testing typed API behaviour.The change also includes changing the test harness to add the type
_doc
to index, update, get and bulk requests that do not specify the document type when the test is running against a mixed 7.x/6.x cluster.