Word-smithing doc changes

Поиск
Список
Период
Сортировка
От Greg Stark
Тема Word-smithing doc changes
Дата
Msg-id BANLkTikCz3Mc8c6pkQJJz7jnw7wdxfUWVg@mail.gmail.com
обсуждение исходный текст
Ответы Re: Word-smithing doc changes  (Robert Haas <robertmhaas@gmail.com>)
Re: Word-smithing doc changes  (Alvaro Herrera <alvherre@commandprompt.com>)
Список pgsql-hackers
I think this commit was ill-advised:
http://git.postgresql.org/gitweb?p=postgresql.git;a=commitdiff;h=a03feb9354bda5084f19cc952bc52ba7be89f372
    In a concurrent index build, the index is actually entered into the    system catalogs in one transaction, then the
twotable scans occur in a
 
-    second and third transaction.
+    second and third transaction.  All active transactions at the time the
+    second table scan starts, not just ones that already involve the table,
+    have the potential to block the concurrent index creation until they
+    finish.  When checking for transactions that could still use the original
+    index, concurrent index creation advances through potentially interfering
+    older transactions one at a time, obtaining shared locks on their virtual
+    transaction identifiers to wait for them to complete.


Seems way to implementation-specific and detailed for a user to make
heads or tails of. Except in the sections talking about locking
internals we don't talk about "shared locks on virtual transactions
identifiers" we just talk about waiting for a transaction to complete.
And looping over the transactions one by one is purely an
implementation detail and uninteresting to users. Also it uses
ill-defined terms like "active transactions", "potentially interfering
older transactions", and  "original index" -- from the user's point of
view there's only one index and it just isn't completely built yet.

Are we not yet in string-freeze though? I'll go ahead and edit it if
people don't mind. I'm curious to see the original complaint though.

-- 
greg


В списке pgsql-hackers по дате отправления:

Предыдущее
От: Greg Stark
Дата:
Сообщение: Re: spinlock contention
Следующее
От: Jeff Davis
Дата:
Сообщение: Range Types and length function