artin/sourcegraph
1
0
Fork 0
mirror of https://github.com/sourcegraph/sourcegraph.git synced 2026-02-06 15:51:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

schema: Document perf scaling for occurrences(...) (#62941)

Browse Source 
Fixes GRAPH-634
This commit is contained in:
Varun Gandhi 2024-06-04 18:07:44 +08:00 committed by GitHub
parent a23d241c6d
commit 20c1c15608
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 19 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
cmd/frontend/graphqlbackend/codeintel.codenav.graphql
View File

@ -118,7 +118,26 @@ type CodeGraphData {
"""
Occurrences are guaranteed to be sorted by range. It is possible
for there to be multiple occurrences for the same exact source range.
At the moment, using higher values of 'first:' should not cause
significantly worst performance.
As an example, for a large C++ codebase, here are the percentiles
for number of occurrences per document.
| Percentile | Occurrences count |
| 50 | 241 |
| 90 | 2443 |
| 95 | 4554 |
| 99 | 15869 |
| 99.9 | 94465 |
| 100 | 707850 |
"""
# Tip: One can get the percentiles above using the scip CLI's 'stats'
# subcommand. (https://github.com/sourcegraph/scip/blob/main/docs/CLI.md#scip-stats)
#
# TODO(issue: GRAPH-635): Allow passing a filter here to only get
# occurrences for specific lines.
occurrences(first: Int, after: String): SCIPOccurrenceConnection
}