8000 docs: add explanation on crud usage by cristianmtr · Pull Request #3486 · jina-ai/serve · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

docs: add explanation on crud usage #3486

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

Merged
merged 2 commits into from
Sep 27, 2021
Merged

docs: add explanation on crud usage #3486

merged 2 commits into from
Sep 27, 2021

Conversation

cristianmtr
Copy link
Contributor
@cristianmtr cristianmtr commented Sep 27, 2021

This is required in order to explain what a Storage vs Searcher implements (generally).

@github-actions github-actions bot added size/S area/docs This issue/PR affects the docs labels Sep 27, 2021
maximilianwerk
maximilianwerk previously approved these changes Sep 27, 2021
Copy link
Member
@maximilianwerk maximilianwerk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the linking happens in the next step: LGTM

@codecov
Copy link
codecov bot commented Sep 27, 2021

Codecov Report

Merging #3486 (fc8bfe4) into master (e6da08f) will decrease coverage by 0.55%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #3486      +/-   ##
==========================================
- Coverage   90.12%   89.57%   -0.56%     
==========================================
  Files         151      151              
  Lines       11070    11070              
==========================================
- Hits         9977     9916      -61     
- Misses       1093     1154      +61     
Flag Coverage Δ
daemon 45.79% <ø> (+0.01%) ⬆️
jina 89.08% <ø> (-0.98%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files Coverage Δ
jina/flow/base.py 82.33% <0.00%> (-7.72%) ⬇️
jina/jaml/parsers/__init__.py 92.85% <0.00%> (-7.15%) ⬇️
.../runtimes/request_handlers/data_request_handler.py 90.54% <0.00%> (-2.71%) ⬇️
jina/jaml/helper.py 82.92% <0.00%> (-2.44%) ⬇️
jina/jaml/parsers/flow/v1.py 96.49% <0.00%> (-1.76%) ⬇️
jina/types/message/__init__.py 85.92% <0.00%> (-1.46%) ⬇️
jina/peapods/runtimes/zmq/zed.py 92.85% <0.00%> (-1.03%) ⬇️
jina/peapods/runtimes/jinad/__init__.py 87.96% <0.00%> (-0.93%) ⬇️
jina/peapods/zmq/__init__.py 88.81% <0.00%> (-0.70%) ⬇️
jina/helper.py 83.12% <0.00%> (+0.35%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update e6da08f...fc8bfe4. Read the comment docs.

@github-actions
Copy link
github-actions bot commented Sep 27, 2021

Latency summary

Current PR yields:

  • 🐎🐎 index QPS at 1181, delta to last 2 avg.: +8%
  • 🐎🐎🐎🐎 query QPS at 50, delta to last 2 avg.: +13%
  • 🐎🐎🐎🐎 dam extend QPS at 47183, delta to last 2 avg.: +23%
  • 🐎🐎🐎🐎 avg flow time within 1.4216 seconds, delta to last 2 avg.: -17%
  • 🐢🐢 import jina within 0.408 seconds, delta to last 2 avg.: -7%

Breakdown

Version Index QPS Query QPS DAM Extend QPS Avg Flow Time (s) Import Time (s)
current 1181 50 47183 1.4216 0.408
2.1.3 1081 43 36461 1.7372 0.4468
2.1.2 1103 44 39839 1.7224 0.436

Backed by latency-tracking. Further commits will update this comment.

hanxiao
hanxiao previously approved these changes Sep 27, 2021
@cristianmtr
Copy link
Contributor Author

@hanxiao Headers need to be in Title Case, afaik. https://en.wikipedia.org/wiki/Title_case

Also, the commit message is invalid

@cristianmtr
Copy link
Contributor Author

@hanxiao Fixed. Please re-approve

@github-actions
Copy link

📝 Docs are deployed on https://docs-crud-endpoints--jina-docs.netlify.app 🎉

@hanxiao hanxiao merged commit e9d9a43 into master Sep 27, 2021
@hanxiao hanxiao deleted the docs-crud-endpoints branch September 27, 2021 14:32
Copy link
Member
@alexcg1 alexcg1 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few minor tweaks. Otherwise LGTM 👍

| **D**elete | `/delete` | Storage |

The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers.
The `/search` endpoints do not correspond perfectly with the Read operation, as it _searches_ for sim 8000 ilar results, and not return a specific Document by id.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • and does not return...

| **U**pdate | `/update` | Storage |
| **D**elete | `/delete` | Storage |

The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • The C, U, D operations


The Create, Update, Delete are implemented by the Storage Indexers, while the Read operation is implemented in the `/search` endpoints in the Search Indexers.
The `/search` endpoints do not correspond perfectly with the Read operation, as it _searches_ for similar results, and not return a specific Document by id.
Some Storage Indexers do implement a `/fill_embedding` endpoint, which function as a Read by id.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • which functions

@cristianmtr
Copy link
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs This issue/PR affects the docs size/S
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants
0