cockroachdb / cockroachdb/docs

Clarify that follower reads are not currently a guarantee of low latency and discuss some more factors that can affect them

Đang mở
#5,024 8 bình luận 0 reaction 1 người được giao Được @rmloveland nhận Xem trên GitHub
C-doc-improvement O-eng P-1 T-incorrect-or-unclear-info
Ngôn ngữ chính
HTML
Star
212
Fork
476
Merge trung bình
40 phút
Pull request đã merge (30 ngày)
3

Mô tả

Jesse Seldess (jseldess) commented:

In this PR on topology patterns, @bdarnell called into questions some explicit statements we're making about follower reads, namely that follower reads are available for any read operation at least 48 seconds in the past, and that the `experimental_follower_read_timestamp()` function is the best way to get a follower read:

> Note that this function does not guarantee that a follower read will be performed. It picks a timestamp that should usually result in a follower read, but may perform a remote leaseholder read if things are falling behind.
>
> I'm wary of documenting this function while it's experimental; I think it might be better to have the user hard-code the amount of staleness they can tolerate in the query.
>
> It does pick a timestamp a minute in the past, but that doesn't guarantee a follower read. If things are falling behind, the threshold for performing follower reads increases and this function is not currently aware of that (hard coding the interval would have the same problem). We do not currently provide any tools that would offer a stronger guarantee of being able to perform a follower read.

Jira Issue: DOC-288

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.