Skip to content

Commit d920990

Browse files
authored
Update background.md
Small editorial errors.
1 parent e50757f commit d920990

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

specification/changes/2025-08-25-bucket-beacons/background.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -40,13 +40,13 @@ All existing databases are retroactively configured with one bucket.
4040
The hash for a value in bucket number zero is the same as the hash in an unbucketed system;
4141
therefore, there is no difference between "one bucket" and "not using buckets".
4242

43-
Unfortunately, if you spread your items across N buckets,
44-
then to find all the items, you'll haver to make N queries.
45-
Only `Query` is affected. `Scan` and `Get` operations will continue to work as expected.
46-
The reason that Query has to change is that one queries against an index,
47-
and indexes have to exactly match a value, leaving to room for a `this OR that OR other` optimization.
43+
Unfortunately, when items are distributed across N buckets, retrieving all of them requires N separate queries.
44+
- Only the `Query` operation is affected.
45+
- `Scan` and `Get` operations continue to work as usual.
4846

49-
Note that there is not way to look at an encrypted item and deduce what bucket it is in.
47+
The reason Query behaves differently is that it searches against an index, which requires an exact match. This leaves no opportunity to optimize the query with a “this OR that OR other” approach, unlike a Scan which examines all items.
48+
49+
Note: There is no way to determine an item’s bucket just by looking at its encrypted value.
5050

5151
### Performance
5252

@@ -174,7 +174,7 @@ Perhaps "Smith" would be divided among all 5 buckets, while "Svaboda" was always
174174
This has two benefits
175175

176176
- This can do a much better job of overcoming the [shortcoming of Beacons](#a-shortcoming-of-beacons),
177-
by only splitting the popular names, making the distribution of hashes ven more regular.
177+
by only splitting the popular names, making the distribution of hashes even more regular.
178178
- When querying on the LastName "Svaboda", only one query is needed, rather than five.
179179

180180
## Changing Beacon Constraints

0 commit comments

Comments
 (0)