Nej, dokumentationen är felaktig. Att använda enbart en transaktion inte undvika detta problem. Det garanterar bara att hela transaktionen rullas tillbaka om ett undantag skulle inträffa - så att inget inkonsekvent tillstånd kommer att kvarstå i databasen.
Att undvika detta problem måste du låsa bordet - inne i en transaktion, eftersom alla lås släpps i slutet av en transaktion. Något i stil med:
BEGIN;
LOCK TABLE mytbl IN SHARE MODE;
-- do your find_or_create here
COMMIT;
Men det är inte ett magiskt botemedel mot allt. Det kan bli ett prestandaproblem och det kan finnas dödlägen (samtidiga transaktioner som ömsesidigt försöker låsa resurser som den andra redan har låst). PostgreSQL kommer att upptäcka ett sådant tillstånd och avbryta alla utom en av de konkurrerande transaktionerna. Du måste vara beredd att försöka igen vid misslyckande.
Om du inte har mycket samtidighet kan du också bara ignorera problemet. Tidsluckan är väldigt liten så det händer bara väldigt sällan. Om du upptäcker felet med dubblettnyckeln, vilket inte skadar, har du täckt detta också.