Při exportu v polovině vypněte. Nedávejte uživateli polovinu souboru: nejprve dokončete psaní a poté publikujte.

Napsáno pro vývojáře, kteří provádějí export souborů, stahování nebo doručování překladů. Pokud je služba restartována, když je soubor napůl zapsán a odkaz ke stažení je již uživateli otevřen, může uživatel získat polotovar, který nelze otevřít. Tento druh problému není jen "soubor nelze příležitostně otevřít", hlavní příčinou je, že systém považuje nedokončené produkty za oficiální výsledky.

Po přečtení tohoto článku můžete jasně navrhnout hranici vydání: nejprve dokončit zápis a ověření a poté nechat vstoupit v platnost oficiální záznam. Tento článek také vysvětlí, co dělat při různých metodách ukládání a co je ještě třeba zkontrolovat po publikování.

Tento článek používá syntetické vzorky k demonstraci metody zpracování. Kód byl zkontrolován s příklady v izolovaném prostředí; to není zárukou všech skutečných souborů nebo výkonu produktu. Před zpracováním důležitých dokumentů si prosím uschovejte originály a zkontrolujte je podle hranic a přejímacích položek v textu.

Pokud v polovině exportu selže napájení, jak se mohu vyhnout předání poloviny souboru? Závěr jednou větou

Základní přístup je: Zapište nejprve dočasný soubor a poté nahraďte oficiální cestu nebo aktualizujte oficiální ukazatel poté, co projdou všechna ověření.

vaší situaci	Doporučené postupy	důvod
Soubor existuje v místním systému souborů	Napište dočasný soubor do stejného adresáře a po jeho zavření zavolejte `os.replace`.	Stejný adresář se může vyhnout běžným problémům s výměnou systému mezi soubory
Stačí ověřit objednávku vydání	Použít ověření plánu stavu: výměna je povolena pouze po dokončení zápisu, uzavření a ověření	Zapište podmínky vydání do testovatelných pravidel
Použijte úložiště objektů	Používejte neměnné klíče objektů, aktualizujte oficiální ukazatele po nahrání a ověření	Úložiště objektů obvykle nemají stejnou sémantiku přejmenování adresářů jako místní systémy souborů
Potřeba silnější záruky odolnosti	Studujte synchronizaci souborů a adresářů, sémantiku disku a souborového systému a provádějte ověření vkládání chyb	Atomová náhrada neznamená, že data zůstanou zachována i po výpadku napájení.

Proč jsi předal polovinu souboru?

Služba se restartuje, když je soubor zapsán v polovině, a pokud je již dostupný odkaz ke stažení, uživatel získá nedokončený produkt. To naznačuje, že problém je v načasování vydání, nejen v samotné operaci zápisu.

Přidání vrstvy zachycení výjimek do operace zápisu může zpracovat pouze chyby, které může program detekovat během procesu zápisu. Co je skutečně potřeba hlídat, je: které státy mohou být viditelné pro vnější svět.

Nejprve zapište dočasný soubor a poté nahraďte oficiální záznam

V lokálním souborovém systému je běžnou metodou zapsání dočasného souboru do cílového adresáře a následné volání os.replace po jeho zapsání a uzavření. Stejný adresář se může vyhnout běžným problémům s výměnou systému mezi soubory.

Je třeba poznamenat, že atomová náhrada pouze popisuje, jaké jméno čtenář vidí, a neznamená, že data zůstanou zachována i po výpadku napájení.

Zdroje: Python tempfile.

Použijte stavový plán k určení pořadí vydání

Níže uvedený kód ve skutečnosti nevytváří ani nepřepisuje soubor, ale spíše ověřuje plán doručení: dokončí se pouze zápis, uzavření a ověření obsahu, než je povoleno nahradit oficiální cestu.

def publish_plan(written, closed, content_ok, same_filesystem):
    if not written:
        return ("write_temporary",)
    if not closed:
        return ("close_temporary",)
    if not content_ok:
        return ("quarantine_temporary",)
    if not same_filesystem:
        return ("prepare_destination_temporary",)
    return ("replace_destination", "confirm_readable", "mark_ready")

assert publish_plan(False, False, False, True) == ("write_temporary",)
assert publish_plan(True, False, True, True) == ("close_temporary",)
assert publish_plan(True, True, False, True) == ("quarantine_temporary",)
assert "mark_ready" not in publish_plan(True, True, True, False)
assert publish_plan(True, True, True, True)[-1] == "mark_ready"

Toto je protokolový test, ne experiment s výpadkem proudu. Skutečný zapisovač souborů by také musel zvládnout čištění výjimek, oprávnění a rozdíly na platformě. Nebalte obyčejný úspěch čtení a zápisu, protože „bezpečnost při vypnutí byla prokázána".

Které státy umožňují stahování

Stav produktu	vnější viditelnost	zotavovací akce
Dočasný soubor se zapisuje	Nebyl uveden žádný oficiální odkaz	Zkuste to znovu nebo vyčistěte zbytky
Ověření obsahu se nezdařilo	Karanténa, nepropuštěna	Pokračujte v ladění informací
Výměna byla dokončena, ale čtení nebylo potvrzeno	Zatím nebylo úspěšně označeno	Zkontrolujte konečnou cestu
Čitelné a kontrolní součet se shoduje	Poskytněte výsledky	Verze záznamu a shrnutí

Nebuďte přísní ohledně přejmenování úložiště objektů

Úložiště objektů obvykle nemají přesně stejnou sémantiku přejmenování adresářů jako místní systémy souborů. Vhodnější přístup je:

Nahrajte produkty pomocí neměnných klíčů objektů.
Po nahrání ověřte obsah.
Po absolvování ověření aktualizujte oficiální ukazatel v databázi.

Pokud je zahrnuta také síť CDN, měly by být společně zvažovány také klíče mezipaměti a zachování staré verze.

Dokončení překladu by mělo zahrnovat doručení souboru

Když připojíte stav zpracování OmniDoc (produktový portál) k vašemu vlastnímu produktu, nelze místní úspěšnost stahování zobrazit ihned po obdržení „Konec zpracování". Před nastavením úkolu jako dodaného byste se měli nejprve ujistit, že uložený rukopis překladu lze číst a je správného typu.

Dokončení vnímané uživatelem konečně získává soubor, který lze otevřít.

📊 Srovnání jádra

Srovnávací položka	lokální souborový systém	úložiště objektů
Způsob psaní	Zapište dočasné soubory do stejného adresáře a po zavření je nahraďte	Nahrajte pomocí neměnných objektových klíčů
zveřejnit akci	Zavolejte`os.replace` a nahraďte oficiální cestu	Po ověření aktualizujte oficiální ukazatel v databázi
Vyžaduje další zvážení	Synchronizace souborů a adresářů, sémantika disku a souborového systému	Klíče mezipaměti CDN zachovány u starších verzí

🎯 Která metoda je pro vás vhodná?

Pokud je váš produkt uložen na místním disku

Zapište dočasný soubor do cílového adresáře a poté, co ověření projde, nahraďte oficiální cestu os.replace.

Pokud je váš produkt uložen v objektovém úložišti

K nahrání použijte neměnný objektový klíč a po úspěšném ověření aktualizujte oficiální ukazatel.

Pokud máte vyšší požadavky na zabezpečení dat po výpadku proudu

Nespoléhejte jen na atomickou náhradu, ale také prostudujte sémantiku synchronizace souborů a adresářů a ověřte ji pomocí injekce chyb.

Pokud je vaším následným stahováním uživatel

Odkaz ke stažení je k dispozici pouze v případě, že stav produktu je „Čitelný a shoduje se s ověřením".

❓ Často kladené otázky (FAQ)

1. Může atomová náhrada zajistit, že se data po výpadku proudu neztratí?

nemůže. Atomic replacement popisuje, jaké jméno čtenář vidí, což neznamená, že data zůstanou zachována i po výpadku napájení.

2. Proč se v cílovém adresáři vytvářejí dočasné soubory?

Stejný adresář se může vyhnout běžným problémům s výměnou systému mezi soubory.

3. Může úložiště objektů přímo používat přejmenování k publikování souborů?

Tvrdé použití se nedoporučuje. Úložiště objektů obecně nemá přesně stejnou sémantiku přejmenování adresářů jako místní systémy souborů a je vhodnější pro neměnné klíče objektů plus formální ukazatele.

4. Co je třeba udělat s produkty, které neprojdou ověřením?

Měl by být izolován, neměl by být uvolněn a informace o ladění by měly být zachovány.

📝 Shrnutí

Hranice publikování určují, co uživatelé uvidí. Nejprve dokončete zápis a ověření a poté nechte vstoupit v platnost oficiální vstup, abyste se vyhnuli předávání nedokončených výrobků uživatelům.

Vyzkoušejte to hned: Nahrajte dokument a začněte překládat při zachování původního rozvržení