← Cloudflare D1 / d1 / reference

Časté dotazy

Ano, plán Workers Free bude vždy zahrnovat možnost bezplatně vytvářet prototypy a experimentovat s D1.

Jakmile váš účet dosáhne denních limitů na čtení a/nebo zápis, nebudete moci proti D1 spouštět dotazy. D1 API vrátí vašemu klientovi chyby oznamující, že jste překročili denní limity. Jakmile dosáhnete zahrnutého limitu úložiště, budete muset smazat nepoužívané databáze nebo vyčistit zastaralá data, než budete moci vkládat nová data, vytvářet nebo měnit tabulky či vytvářet indexy a triggery.

Přechod na plán Workers Paid tyto limity odstraní, obvykle během několika minut.

Za dodatečná čtení, zápisy a úložiště vám bude účtováno podle metriky cen D1.

Každý dotaz vrací meta objekt, který obsahuje celkový počet přečtených řádků (rows_read) a zapsané řádky (rows_written) tímto dotazem. Například dotaz, který provádí úplné procházení tabulky (například SELECT * FROM users) z tabulky s 5000 řádky by vrátil rows_read hodnotu 5000:

"meta": {
  "duration": 0.20472300052642825,
  "size_after": 45137920,
  "rows_read": 5000,
  "rows_written": 0
}

Ty jsou také součástí D1 Cloudflare dashboard ↗ a analytické API, což vám umožňuje přiřadit objemy čtení a zápisu ke konkrétním databázím, časovým obdobím nebo obojímu.

Ne.

D1 samo o sobě neúčtuje za dodatečný výpočetní výkon. Workers, které dotazují D1 a zpracovávají výsledky, například serializují výsledky do JSON nebo spouštějí dotazy, se účtují za Ceny Workers, kromě specifického využití D1.

Ano, všechny dotazy spuštěné v databázi, včetně vkládání dat (INSERT) stávající data do nové databáze, procházení tabulky (SELECT * FROM table) nebo vytváření indexů se počítá jako čtení, nebo zápis.

Ano, index můžete použít ke snížení počtu řádků, které dotaz načte. Vytváření indexů pro nejčastěji dotazované tabulky a filtrované sloupce snižuje množství skenovaných dat a zároveň zlepšuje výkon dotazů. Pokud máte zátěž s převahou čtení (což je nejběžnější případ), může to být obzvlášť výhodné. Zápis do sloupců, na které odkazuje index, přidá alespoň jeden (1) další zapsaný řádek kvůli aktualizaci indexu, což je ale obvykle vyváženo snížením počtu přečtených řádků díky výhodám indexu.

Ano, i když jen minimálně. Prázdná tabulka zabírá alespoň několik kilobajtů v závislosti na počtu sloupců (šířce tabulky). Prázdná databáze zabírá přibližně 12 KB úložiště.

D1 je navrženo pro horizontální škálování napříč více menšími (10 GB) databázemi, například databázemi pro jednotlivé uživatele, nájemce nebo entity. D1 vám umožňuje vytvářet aplikace s tisíci databázemi bez dodatečných nákladů, protože cena vychází pouze z nákladů na dotazy a úložiště.

Každá databáze D1 může uchovávat až 10 GB dat.

Každá jednotlivá databáze D1 je svou podstatou jednovláknová a zpracovává dotazy postupně, jeden po druhém.

Maximální propustnost přímo souvisí s dobou trvání vašich dotazů.

• Pokud váš průměrný dotaz trvá 1 ms, můžete provést přibližně 1,000 dotazů za sekundu.
• Pokud váš průměrný dotaz trvá 100 ms, můžete provést 10 dotazů za sekundu.

Databáze, která přijímá příliš mnoho souběžných požadavků, je nejprve zařadí do fronty. Pokud se fronta zaplní, databáze vrátí chyba „overloaded“.

Každá jednotlivá databáze D1 je podporována jedním Durable Object. Při použití Replikace pro čtení D1 ↗ každá instance repliky je samostatný Durable Object a tyto pokyny platí pro každou instanci repliky nezávisle.

Výkon dotazů je nejdůležitějším faktorem propustnosti. Orientačně platí:

• Čtecí dotazy jako SELECT name FROM users WHERE id = ? s vhodným indexem na id bude trvat méně než jednu milisekundu doby trvání SQL.
• Zápisové dotazy jako INSERT nebo UPDATE mohou trvat několik milisekund doby trvání SQL a závisí na počtu zapsaných řádků. Zápisy musí být trvale uloženy na několika místech, více informací najdete na jak D1 interně ukládá data ↗.
• Migrace dat, jako je velká UPDATE nebo DELETE ovlivňující miliony řádků je nutné spouštět po dávkách. Jediný dotaz, který se pokusí najednou upravit stovky tisíc řádků nebo stovky MB dat, překročí limity provádění. Rozdělte práci na menší části (například zpracovávejte po 1 000 řádcích), abyste zůstali v limitech platformy.

Chcete-li zajistit, aby vaše dotazy byly rychlé a efektivní, používejte vhodné indexy ve svém databázovém schématu SQL.

Operace nad databází D1, včetně provádění dotazů a serializace výsledků, probíhají v rámci Limity CPU a paměti platformy Workers.

Překročení těchto limitů nebo dosažení jiných limitů platformy způsobí chyby. Přečtěte si seznam chyb D1 s dalšími podrobnostmi.

Pro každé volání Workeru můžete současně otevřít až šest připojení (k D1).

Další informace o souběžných připojeních Workeru najdete v Současně otevřená spojení.