INTEGRITY Dokumentace

Slovníček

Projděte si definice pojmů používaných v dokumentaci Cloudflare Durable Objects.

PojemDefinice
alarm

Alarm Durable Object je mechanismus, který umožňuje naplánovat probuzení Durable Object v budoucím okamžiku.

bookmark

Bookmark je řetězec, převážně alfanumerický, například 0000007b-0000b26e-00001538-0c3e87bb37b3db5cc52eedb93cd3b96b která představuje konkrétní stav databáze SQLite v daném okamžiku. Bookmarky jsou navrženy tak, aby byly lexikálně porovnatelné: bookmark představující dřívější okamžik je při běžném porovnání řetězců menší než bookmark představující pozdější okamžik.

Durable Object

Durable Object je jednotlivá instance třídy Durable Object. Durable Object je globálně jedinečný (odkazuje se na něj pomocí ID), poskytuje globální bod koordinace pro všechny metody a požadavky, které jsou mu zasílány, a má vlastní trvalé úložiště, které není sdíleno s ostatními Durable Objects v rámci namespace.

Třída Durable Object

Třída JavaScriptu, která definuje metody (RPC) a handlery (fetch, alarm) jako součást vašeho Durable Object, a/nebo volitelný constructor. Všechny Durable Objects v rámci jednoho namespace sdílejí stejnou definici třídy.

Durable Objects

Název produktu, případně souhrnné označení pro více než jeden Durable Object.

vstupní brána

Zatímco probíhá operace s úložištěm, do Durable Object se nedoručují žádné události kromě událostí o dokončení operace s úložištěm. Všechny ostatní události se odloží, dokud objekt nepřestane vykonávat kód JavaScript a nepřestane čekat na jakoukoli operaci s úložištěm. Říkáme, že tyto události čekají, až se otevře "vstupní brána".

instance

Viz „Durable Object“.

KV API

Metody API, které jsou součástí Storage API a podporují ukládání dat typu klíč-hodnota.

migrace

Migrace Durable Object je proces mapování názvu třídy na stav za běhu. Migraci Durable Object zahajte, pokud potřebujete:

  • Vytvořte novou třídu Durable Object.
  • Přejmenování třídy Durable Object.
  • Odstraňte třídu Durable Object.
  • Přenos existující třídy Durable Objects.
namespace

Logická množina objektů Durable Objects, které sdílejí stejnou definici třídy Durable Object. Jeden namespace může obsahovat (desítky) milionů objektů Durable Objects. Metriky se sledují pro každý namespace zvlášť.

  • Název vazby (binding) oboru názvů (namespace), jak bude zpřístupněn v kódu Workeru, se definuje v souboru Wrangler pod položkou durable_objects.bindings.name klíč. Mějte na paměti, že název vazby nemusí jednoznačně identifikovat obor názvů v rámci účtu. Každý obor názvů má místo toho jedinečné ID, které si můžete zobrazit v Cloudflare dashboard.
  • Jedinečný Durable Object v rámci namespace vytvoříte pomocí Metody oboru názvů Durable Object.
výstupní brána

Když právě probíhá zápis do úložiště, veškeré nové odchozí síťové zprávy se pozdrží, dokud zápis nedokončí. Říkáme, že tyto zprávy čekají, až se otevře "výstupní brána". Pokud zápis nakonec selže, odchozí síťové zprávy se zahodí a nahradí chybami, přičemž Durable Object se vypne a spustí znovu od začátku.

SQL API

Metody API, které jsou součástí Storage API a podporují dotazování pomocí SQL.

Storage API

Transakční a silně konzistentní (serializovatelné) Storage API pro ukládání dat v rámci každého Durable Object. Stav uložený v rámci jedinečného Durable Object je pro tento Durable Object „soukromý“ a není přístupný z jiných Durable Objects.

Storage API zahrnuje key-value (KV) API, SQL API a point-in-time-recovery (PITR) API.

  • Třídy Durable Object s úložištěm typu klíč-hodnota mohou používat KV API.
  • Třídy Durable Object s úložištěm SQLite mohou používat KV API, SQL API a PITR API.
Úložiště

Ve výchozím nastavení může třída Durable Object používat Storage API, které využívá úložiště typu klíč-hodnota. Nové třídy Durable Object se mohou rozhodnout používat Backend úložiště SQLite.

stub

Objekt, který odkazuje na jedinečný Durable Object v rámci jmenného prostoru a umožňuje do tohoto Durable Object volat pomocí metod RPC nebo fetch API. Například let stub = env.MY_DURABLE_OBJECT.get(id)