Sdílet prostřednictvím

Implementace zásad opakování pomocí JavaScriptu nebo TypeScriptu

  • Článek

Každá aplikace, která běží v cloudu nebo komunikuje se vzdálenými službami a prostředky, musí být schopná zpracovat přechodné chyby. U těchto aplikací je běžné, že dochází k chybám kvůli momentální ztrátě síťového připojení, vypršení časového limitu požadavku, když je služba nebo prostředek zaneprázdněný, nebo kvůli jiným faktorům. Vývojáři by měli vytvářet aplikace pro transparentní zpracování přechodných chyb za účelem zlepšení stability a odolnosti.

V tomto článku se dozvíte, jak pomocí klientské knihovny Azure Storage pro JavaScript nakonfigurovat zásady opakování pro aplikaci, která se připojuje ke službě Azure Blob Storage. Zásady opakování definují, jak aplikace zpracovává neúspěšné požadavky, a měly by se vždy ladit tak, aby odpovídaly obchodním požadavkům aplikace a povaze selhání.

Konfigurace možností opakování

Zásady opakování pro Blob Storage se konfigurují programově a nabízejí kontrolu nad tím, jak se možnosti opakování použijí pro různé požadavky a scénáře služby. Například webová aplikace, která vydává požadavky na základě interakce uživatele, může implementovat zásadu s menším počtem opakování a kratšími prodlevami, aby se zvýšila rychlost odezvy a upozorňují uživatele, když dojde k chybě. Případně může aplikace nebo komponenta, která spouští dávkové požadavky na pozadí, zvýšit počet opakovaných pokusů a použít exponenciální strategii zpětného odpočtu, která umožní úspěšné dokončení žádosti.

Následující tabulka uvádí dostupné parametry při vytváření instance StorageRetryOptions spolu s typem, stručným popisem a výchozí hodnotou, pokud neproděláte žádné změny. Měli byste být proaktivní při ladění hodnot těchto vlastností tak, aby vyhovovaly potřebám vaší aplikace.

Vlastnost Type Popis Default value
maxRetryDelayInMs number Nepovinné. Určuje maximální povolenou prodlevu před opakováním operace. 120 sekund (nebo 120 * 1000 ms)
maxTries number Nepovinné. Maximální počet pokusů o opakování před předáním. 4
retryDelayInMs number Nepovinné. Určuje množství zpoždění, které se má použít před opakováním operace. 4 sekundy (nebo 4 * 1000 ms)
retryPolicyType StorageRetryPolicyType Nepovinné. StorageRetryPolicyType, výchozí hodnota je exponenciální zásada opakování. StorageRetryPolicyType.Exponential
secondaryHost string Nepovinné. Sekundární koncový bod účtu úložiště pro opakování požadavků. Před nastavením této hodnoty byste měli porozumět problémům se čtením zastaralých a potenciálně nekonzistentních dat. Další informace najdete v tématu Použití geografické redundance k návrhu aplikací s vysokou dostupností. Nic
tryTimeoutInMs number Nepovinné. Maximální povolená doba před zrušením požadavku a předpokládá se, že selhala. Tento časový limit platí pro požadavek na operaci a měl by být založený na šířce pásma dostupné hostitelskému počítači a blízkosti služby Storage. Hodnota 0 nebo nedefinovaná má za následek žádný výchozí časový limit klienta a použije se výchozí časový limit na straně serveru. Další informace najdete v tématu Vypršení časových limitů operací služby Blob Service.

V následujícím příkladu kódu nakonfigurujeme možnosti opakování v instanci StorageRetryOptions, předáme ji nové instanci StoragePipelineOptions a předáme pipeline při vytváření BlobServiceClientinstancí:

const options = {
  retryOptions: {
    maxTries: 4,
    retryDelayInMs: 3 * 1000,
    maxRetryDelayInMs: 120 * 1000,
    retryPolicyType: StorageRetryPolicyType.EXPONENTIAL
  },
};

const pipeline = newPipeline(credential, options);

const blobServiceClient = new BlobServiceClient(
  `https://${accountName}.blob.core.windows.net`,
  credential,
  pipeline
);

V tomto příkladu každý požadavek služby vydaný z objektu BlobServiceClient používá možnosti opakování definované v retryOptions. Tato zásada se vztahuje na požadavky klientů. Pro klienty služeb můžete nakonfigurovat různé strategie opakování na základě potřeb vaší aplikace.

Související obsah

  • Pokyny k architektuře a obecné osvědčené postupy pro zásady opakování najdete v tématu Zpracování přechodných chyb.
  • Pokyny k implementaci vzoru opakování pro přechodné selhání najdete v tématu Vzor opakování.