← Cloudflare Workers / workers / wrangler / commands

D1

Interakce s Databáze D1 službu pomocí Wrangler.

`d1 create`

Vytvoří novou databázi D1 a poskytne binding a UUID, které vložíte do konfiguračního souboru

Tento příkaz pracuje se vzdálenými databázemi D1.

npx wrangler d1 create [NAME]

[NAME]string povinné
Název nové databáze D1
--locationstring
Nápověda pro primární umístění nové DB. Možnosti: weur: západní Evropa eeur: východní Evropa apac: Asie a Pacifik oc: Oceánie wnam: západní Severní Amerika enam: východní Severní Amerika
--jurisdictionstring
Umístění, do kterého se má omezit běh a ukládání dat databáze D1, aby vyhovovalo místním předpisům. Pokud jsou nastaveny jurisdictions, location hint se ignoruje. Možnosti: eu: Evropská unie fedramp: datová centra vyhovující FedRAMP us: Spojené státy
--use-remoteboolean
Při přidávání nově vytvořeného prostředku do konfigurace použijte remote binding
--update-configboolean
Automaticky aktualizovat konfigurační soubor o nově přidaný prostředek
--bindingstring
Název vazby (binding) tohoto prostředku ve vašem Workeru

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 info`

Získat informace o databázi D1 včetně její aktuální velikosti a stavu

Tento příkaz pracuje se vzdálenými databázemi D1.

npx wrangler d1 info [NAME]

[NAME]string povinné
Název DB
--jsonboolean výchozí: false
Vracení výstupu jako JSON

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 list`

Vypsat všechny databáze D1 ve vašem účtu

Tento příkaz pracuje se vzdálenými databázemi D1.

npx wrangler d1 list

--jsonboolean výchozí: false
Vracení výstupu jako JSON

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 delete`

Odstranit databázi D1

Tento příkaz pracuje se vzdálenými databázemi D1.

npx wrangler d1 delete [NAME]

[NAME]string povinné
Název nebo binding DB
--skip-confirmationboolean alias: --yvýchozí: false
Přeskočit potvrzení

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 execute`

Spusťte příkaz nebo soubor SQL

Aby tento příkaz proběhl úspěšně, musíte zadat buď --command, nebo --file.

npx wrangler d1 execute [DATABASE]

[DATABASE]string povinné
Název nebo binding DB
--commandstring
SQL dotaz, který chcete spustit, nebo více dotazů oddělených znakem ';'
--filestring
Soubor .sql k importu
--yesboolean alias: --y
Na všechny výzvy odpovězte „ano“
--localboolean
Spouštějte příkazy/soubory proti lokální databázi pro použití s wrangler dev
--remoteboolean
Spouštějte příkazy/soubory proti vzdálené databázi D1 pro použití se vzdálenými bindings nebo s nasazeným Workerem
--persist-tostring
Zadejte adresář pro lokální persistenci (pro použití s --local)
--jsonboolean výchozí: false
Vracení výstupu jako JSON
--previewboolean výchozí: false
Spouštějte příkazy/soubory proti náhledové databázi D1

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 export`

Exportujte obsah nebo schéma své databáze jako soubor .sql

npx wrangler d1 export [NAME]

[NAME]string povinné
Název databáze D1, která se má exportovat
--localboolean
Exportujte data z lokální databáze, kterou používáte s wrangler dev
--remoteboolean
Exportujte data ze vzdálené databáze D1
--skip-confirmationboolean alias: --yvýchozí: false
Přeskočit potvrzení
--outputstring povinné
Cesta k souboru SQL pro váš export
--tablestring
Zadejte, které tabulky se mají zahrnout do exportu
--no-schemaboolean
Vypsat pouze obsah tabulky, nikoli schéma databáze
--no-databoolean
Vypsat pouze schéma tabulky, nikoli obsah samotných databází

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 time-travel info`

Získejte informace o databázi k určitému bodu v čase pomocí Time Travel

Tento příkaz pracuje se vzdálenými databázemi D1.

Více informací o Time Travel najdete v https://developers.cloudflare.com/d1/reference/time-travel/

npx wrangler d1 time-travel info [DATABASE]

[DATABASE]string povinné
Název nebo binding DB
--timestampstring
Přijímá časové razítko ve formátu Unix (sekundy od epochy) nebo RFC3339 (např. 2023-07-13T08:46:42.228Z), pro které se má načíst bookmark
--jsonboolean výchozí: false
Vracení výstupu jako JSON

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 time-travel restore`

Obnovte databázi k určitému bodu v čase

Tento příkaz pracuje se vzdálenými databázemi D1.

Více informací o Time Travel najdete v https://developers.cloudflare.com/d1/reference/time-travel/

npx wrangler d1 time-travel restore [DATABASE]

[DATABASE]string povinné
Název nebo binding DB
--bookmarkstring
Bookmark k použití pro Time Travel
--timestampstring
Přijímá časové razítko ve formátu Unix (sekundy od epochy) nebo RFC3339 (např. 2023-07-13T08:46:42.228Z), pro které se má načíst bookmark (za posledních 30 dní)
--jsonboolean výchozí: false
Vracení výstupu jako JSON

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 migrations create`

Vytvořte novou migraci

Tímto se ve složce 'migrations' vygeneruje nový verzovaný soubor. Soubor migrace pojmenujte podle popisu své změny. Díky tomu svou migraci ve složce 'migrations' snáze najdete. Příklad názvu souboru vypadá takto:

0000_create_user_table.sql

Název souboru bude obsahovat číslo verze a název migrace, který zadáte.

npx wrangler d1 migrations create [DATABASE] [MESSAGE]

[DATABASE]string povinné
Název nebo binding DB
[MESSAGE]string povinné
Migrační zpráva

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 migrations list`

Zobrazit seznam neaplikovaných migračních souborů

npx wrangler d1 migrations list [DATABASE]

[DATABASE]string povinné
Název nebo binding DB
--localboolean
Ověření migrací proti lokální DB pro použití s wrangler dev
--remoteboolean
Ověření migrací proti vzdálené DB pro použití s wrangler dev --remote
--previewboolean výchozí: false
Ověření migrací proti preview D1 DB
--persist-tostring
Zadejte adresář pro lokální persistenci (tento příznak musíte použít společně s --local)

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 migrations apply`

Aplikovat všechny neaplikované migrace D1

Tento příkaz vás vyzve k potvrzení migrací, které se chystáte použít. Potvrďte, že chcete pokračovat. Po aplikování bude pořízena záloha.

Průběh každé migrace se vypíše do konzole.

Při spuštění příkazu apply v prostředí CI/CD nebo na jiném neinteraktivním příkazovém řádku se krok potvrzení přeskočí, ale záloha se přesto pořídí.

Pokud aplikování migrace skončí chybou, tato migrace se vrátí zpět a zůstane aplikována poslední úspěšná migrace.

npx wrangler d1 migrations apply [DATABASE]

[DATABASE]string povinné
Název nebo binding DB
--localboolean
Spouštějte příkazy/soubory proti lokální databázi pro použití s wrangler dev
--remoteboolean
Spouštějte příkazy/soubory proti vzdálené databázi pro použití s wrangler dev --remote
--previewboolean výchozí: false
Spouštějte příkazy/soubory proti náhledové databázi D1
--persist-tostring
Zadejte adresář pro lokální persistenci (tento příznak musíte použít společně s --local)

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření

`d1 insights`

Experimentální

Získat informace o dotazech spuštěných v databázi D1

Tento příkaz pracuje se vzdálenými databázemi D1.

npx wrangler d1 insights [NAME]

[NAME]string povinné
Název DB
--time-periodstring výchozí: 1d
Načtěte data od aktuálního okamžiku do zadaného časového období
--sort-typestring výchozí: sum
Zvolte operaci, podle které chcete přehledy seřadit
--sort-bystring výchozí: time
Zvolte pole, podle kterého chcete přehledy seřadit
--sort-directionstring výchozí: DESC
Zvolte směr řazení
--limitnumber výchozí: 5
získat přehledy o prvních X dotazech
--jsonboolean výchozí: false
vrátit výstup jako JSON

Globální přepínače

--vboolean alias: --version
Zobrazí číslo verze
--cwdstring
Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře
--configstring alias: --c
Cesta ke konfiguračnímu souboru Wrangler
--envstring alias: --e
Prostředí, které se má použít pro operace a pro výběr souborů .env a .dev.vars
--env-filestring
Cesta k souboru .env, který se má načíst. Lze zadat vícekrát, hodnoty z dřívějších souborů se přepisují hodnotami z pozdějších souborů.
--experimental-provisionboolean aliasy: --x-provisionvýchozí: true
Experimentální: povolit automatické zajišťování prostředků
--experimental-auto-createboolean alias: --x-auto-createvýchozí: true
Automaticky vytvořit koncepty vazeb s novými prostředky
--install-skillsboolean výchozí: false
Před spuštěním příkazu nainstalujte skills Cloudflare pro rozpoznané AI coding agenty
--profilestring
Použijte konkrétní profil ověření