From: Derrick Stolee <stolee@gmail.com>
To: Stefan Beller <sbeller@google.com>
Cc: git <git@vger.kernel.org>, "Jeff King" <peff@peff.net>,
"Junio C Hamano" <gitster@pobox.com>,
"Jakub Narębski" <jnareb@gmail.com>,
"Derrick Stolee" <dstolee@microsoft.com>,
"Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
Subject: Re: [RFC] Generation Number v2
Date: Mon, 29 Oct 2018 16:06:59 -0400 [thread overview]
Message-ID: <78882b71-09b2-cb4a-4285-5aa7b61907fe@gmail.com> (raw)
In-Reply-To: <CAGZ79ka-FTqaXdrMixjUp2THJ3L0YvEnkKxs3XFgB3WEEy2-Tg@mail.gmail.com>
On 10/29/2018 3:22 PM, Stefan Beller wrote:
>> Based on the performance results alone, we should remove minimum
>> generation numbers, (epoch, date) pairs, and FELINE index from
>> consideration. There are enough examples of these indexes performing
>> poorly.
>>
>> In contrast, maximum generation numbers and corrected commit
>> dates both performed quite well. They are frequently the top
>> two performing indexes, and rarely significantly different.
>>
>> The trade-off here now seems to be: which _property_ is more important,
>> locally-computable or backwards-compatible?
>>
>> * Maximum generation number is backwards-compatible but not
>> locally-computable or immutable.
> These maximum generation numbers sound like the reverse of
> the generation numbers as they are currently implemented, i.e.
> we count all commits between the commit A and all heads.
> How would this impact creation of a commit?
The indexes listed here would be computed at the same time as a
commit-graph (and only change on commit-graph writes).
This idea of having something depend on the "global state" isn't ideal
(in my opinion) but it certainly works for the tests specified below.
> The current generation numbers can be lazily updated or not
> updated at all. In my understanding of the maximum generation
> numbers, a new commit would make these maximum generation
> numbers invalid (i.e. they have to be recomputed).
New commits would change the value you would get by the definition (on
rewrite of the commit-graph) but don't violate the reachability index
property (maxgen(A) < maxgen(B) =>
A can't reach B). So that doesn't effect their usefulness.
> Are there ways out by deferring the computation of maximum
> generation numbers while still being able to work with some
> commits that are un-accounted for?
Creating a commit that doesn't exist in the commit-graph file results in
a commit with generation number INFINITY. The new commits can't be
reached by commits with finite generation number.
> When recomputing these numbers, the current generation number
> (V0) has the property that already existing numbers can be re-used
> as-is. We only need to compute the numbers for new commits,
> and then insert this to the appropriate data structures (which is
> a separate problem, one could imagine a split generation
> numbers file like the split index)
>
> For the V2 maximum generation numbers, would we need to
> rewrite the numbers for all commits once we recompute them?
> Assuming that is true, it sounds like the benchmark doesn't
> cover the whole costs associated with V2, which is why the
> exceptional performance can be explained.
You're right, we need to recompute the entire list of maximum generation
number values. However, you are a bit hung up on "maxgen" being a fixed
function that is correct at all times. We could compute the "maxgen" for
the set of commits that are written to the "split" commit-graph while
leaving the base the same. There is one tricky part here: we need to
initialize the values starting at "num commits in the combined
commit-graph" (commits in the base and split portion). The minimum
possible value in the split portion will be larger than the maximum
possible value in the base portion. Since the (future) implementation of
split commit-graphs would have all commit-parent edges pointing down
into the base and not from the base into the split, this will continue
to satisfy our reachability index property.
As for the cost: we need to do a topo-order walk and then a quick
minimum-value check across all parents. This is O(N), and the constant
is small. This may be a cost worth paying.
> (Note: The table as read in
> https://public-inbox.org/git/6367e30a-1b3a-4fe9-611b-d931f51effef@gmail.com/
> seems line broken, using gmails web interface is not good
> for ASCII art and patches, git-send-email would fare better)
Sorry for that. I copy-pasted into Thunderbird. Hopefully most users can
redirect to the GitHub-rendered markdown if they have trouble.
>
>> * Corrected commit-date is locally-computable and immutable,
>> but not backwards-compatible.
> How are these dates not backwards incompatible?
> We don't have to expose these dates to the user, but
> - just like generation numbers - could store them and use them
> but not tell the user about it.
>
> We would need to be really careful to not expose them at all
> as they look like the real dates, so that could make for an
> awkward bug report.
By "backwards-compatible" I mean that we could store them in the
commit-graph file without breaking existing clients (or by introducing
extra data).
We could easily add these corrected commit dates as an optional chunk,
but that adds 8 bytes per commit, and we already use 8 bytes for the
(generation, date) pairs.
The solution I made in my prototype is to replace the generation number
with an offset for how much to add to the commit-date to get the
corrected commit-date. However, an old client would interpret these
offsets as generations and have incorrect output.
A potential way to get around this is to consider the pair (offset,
date) and define the offset(C) to be the minimum of min { offset(P),
date(P) - date(C) }. This would satisfy the requirements for the V0
reachability index. I'm making a note to implement _this_ version and
give it a test.
>
> The approach of "corrected commit date" sounds like we could
> have a very lazy approach, i.e. no extra data structures needed
> for many commits (as the corrected date equals the real date)
> and only need to store the corrections for some commits.
> Such an approach however would not make it easy to know
> if we operate on corrected dates, or if we even checked them
> for correctness before.
>
> So if we'd have an additional row in the generation numbers file
> telling the corrected date, then we should be able to be backwards
> compatible?
Yeah, an optional chunk with the corrected date would work, but be wasteful.
Thanks,
-Stolee
next prev parent reply other threads:[~2018-10-29 20:07 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-10-29 16:55 [RFC] Generation Number v2 Derrick Stolee
2018-10-29 19:22 ` Stefan Beller
2018-10-29 20:06 ` Derrick Stolee [this message]
2018-11-01 20:06 ` Jakub Narebski
2018-11-02 9:30 ` Jakub Narebski
2018-11-03 17:27 ` Jakub Narebski
2018-10-29 20:25 ` Derrick Stolee
2018-11-01 22:13 ` Jakub Narebski
2018-10-30 3:59 ` Junio C Hamano
2018-10-31 12:30 ` Derrick Stolee
2018-11-02 13:33 ` Jakub Narebski
2018-10-31 12:54 ` Ævar Arnfjörð Bjarmason
2018-10-31 13:04 ` Derrick Stolee
2018-11-02 17:44 ` Jakub Narebski
2018-11-01 12:27 ` Jakub Narebski
2018-11-01 13:29 ` Derrick Stolee
2018-11-03 12:33 ` Jakub Narebski
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=78882b71-09b2-cb4a-4285-5aa7b61907fe@gmail.com \
--to=stolee@gmail.com \
--cc=avarab@gmail.com \
--cc=dstolee@microsoft.com \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=jnareb@gmail.com \
--cc=peff@peff.net \
--cc=sbeller@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).