← Cloudflare R2 / r2 / buckets

Local uploads

Local Uploads můžete pro svůj bucket povolit, abyste zlepšili výkon nahrávacích požadavků, když klienti nahrávají data z jiného regionu, než ve kterém se nachází váš bucket. Local Uploads zapisuje data objektu na blízké místo a poté je asynchronně zkopíruje do vašeho bucketu. Data jsou k dispozici okamžitě a zůstávají silně konzistentní.

Následující části popisují, jak R2 zpracovává požadavky na nahrání se zapnutou i vypnutou funkcí Local Uploads.

Když klient nahrává objekt do vašeho bucketu R2, data objektu musí putovat od klienta k úložné infrastruktuře bucketu. To může vést k vyšší latenci a nižší spolehlivosti, pokud se klient nachází v jiném regionu než bucket. Další informace najdete v Jak R2 funguje s podrobnostmi.

Když odešlete požadavek na nahrání (tj. PutObject a UploadPart) do bucketu s povolenou funkcí Local Uploads se řeší dva případy:

• Klient a bucket ve stejném regionu: R2 postupuje podle běžného postupu nahrávání, při kterém se data objektu nahrávají z klienta do infrastruktury úložiště vašeho bucketu.
• Klient a bucket v různých regionech: Data objektu se zapisují do úložiště v blízkosti klienta a poté se asynchronně replikují do vašeho bucketu. Objekt je okamžitě dostupný a po celou dobu procesu zůstává trvanlivý.

Local uploads jsou určeny pro zátěže, které přijímají velké množství nahrávání z jiných geografických oblastí, než ve které se nachází váš bucket. Tato funkce je ideální, pokud:

• Vaši uživatelé jsou rozmístěni po celém světě
• Výkon a spolehlivost nahrávání jsou pro vaši aplikaci klíčové
• Chcete optimalizovat výkon zápisu, aniž byste měnili primární umístění svého bucketu

Chcete-li pochopit geografické rozložení míst, odkud jsou iniciovány vaše požadavky na čtení a zápis:

1. Přihlaste se do Cloudflare dashboardu a přejděte na R2 Overview.

   Přejděte na Přehled ↗

2. Vyberte svůj bucket.

3. Vyberte Metriky a zobrazte Distribuce požadavků graf.

Když je povoleno Local Uploads, nahraná data mohou dočasně zůstat v blízkosti klienta, než se dokončí replikace.

Pokud vaše zátěž vyžaduje okamžité čtení hned po zápisu, zvažte, odkud čtecí požadavky přicházejí. Čtení z regionu nahrávajícího bude rychlé, zatímco čtení blízko regionu bucketu může do dokončení replikace vykazovat latenci mezi regiony.

Local uploads nejsou podporovány u bucketů s jurisdikční omezení, protože to vyžaduje dočasné směrování dat přes lokality mimo region bucketu.

Když povolíte Local Uploads, stávající nahrávání se dokončí podle očekávání bez přerušení provozu.

npx wrangler r2 bucket local-uploads enable <BUCKET_NAME>

Local Uploads můžete kdykoli deaktivovat. Existující požadavky provedené pomocí Local Uploads dokončí replikaci bez přerušení vašeho provozu.

npx wrangler r2 bucket local-uploads disable <BUCKET_NAME>

Existuje bez dalších nákladů abyste povolili lokální nahrávání. Požadavky na nahrání odeslané s touto povolenou funkcí podléhají standardní Náklady na operaci třídy A, stejně jako v případě požadavků na nahrání bez místního nahrávání.