← Cloudflare Workers KV / kv / reference

Příkazy Wrangler KV

`kv namespace`

Správa jmenných prostorů Workers KV.

`kv namespace create`

Vytvořte nový namespace

npx wrangler kv namespace create [NAMESPACE]

[NAMESPACE]string povinné
Název nového namespace
--previewboolean
Interakce s náhledovým jmenným prostorem
--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í

`kv namespace list`

Vypíše seznam všech jmenných prostorů KV přiřazených k vašemu ID účtu

npx wrangler kv namespace list

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í

`kv namespace delete`

Odstranit zadaný namespace.

npx wrangler kv namespace delete [NAMESPACE]

[NAMESPACE]string
Název namespace, který chcete odstranit
--bindingstring
Název vazby (binding) na jmenný prostor, ze kterého se má mazat
--namespace-idstring
ID namespace, který se má odstranit
--previewboolean
Interakce s náhledovým jmenným prostorem
--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í

`kv namespace rename`

Přejmenovat jmenný prostor KV

npx wrangler kv namespace rename [OLD-NAME]

[OLD-NAME]string
Aktuální název jmenného prostoru, který se má přejmenovat
--namespace-idstring
ID namespace, který se má přejmenovat
--new-namestring povinné
Nový název namespace

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í

`kv key`

Správa párů klíč-hodnota v jmenném prostoru Workers KV.

`kv key put`

Zapište jednu dvojici klíč/hodnota do daného jmenného prostoru

npx wrangler kv key put [KEY] [VALUE]

[KEY]string povinné
Klíč, do kterého se má zapisovat
[VALUE]string
Hodnota, která se má zapsat
--pathstring
Přečte hodnotu ze souboru na dané cestě
--bindingstring
Název vazby (binding) na jmenný prostor, do kterého se má zapisovat
--namespace-idstring
ID namespace, do kterého se má zapisovat
--previewboolean
Interakce s náhledovým jmenným prostorem
--ttlnumber
Doba, po kterou by měly být položky viditelné
--expirationnumber
Doba od unixové epochy, po jejímž uplynutí položka vyprší
--metadatastring
Libovolný JSON přidružený ke klíči
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv key list`

Vypíše seznam všech klíčů v daném jmenném prostoru

npx wrangler kv key list

--bindingstring
Název vazby (binding) na jmenný prostor, který se má vypsat
--namespace-idstring
ID namespace, který se má vypsat
--previewboolean výchozí: false
Interakce s náhledovým jmenným prostorem
--prefixstring
Prefix pro filtrování zobrazených klíčů
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv key get`

Přečte jednu hodnotu podle klíče z daného jmenného prostoru

npx wrangler kv key get [KEY]

[KEY]string povinné
Hodnota klíče, kterou chcete získat.
--textboolean výchozí: false
Dekódujte vrácenou hodnotu jako řetězec utf8
--bindingstring
Název vazby (binding) na jmenný prostor, ze kterého se má číst
--namespace-idstring
ID namespace, ze kterého se má načítat
--previewboolean výchozí: false
Interakce s náhledovým jmenným prostorem
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv key delete`

Odebrat jeden pár klíč-hodnota z daného jmenného prostoru

npx wrangler kv key delete [KEY]

[KEY]string povinné
Hodnota klíče, která se má odstranit.
--bindingstring
Název vazby (binding) na jmenný prostor, ze kterého se má mazat
--namespace-idstring
ID namespace, ze kterého se má odstraňovat
--previewboolean
Interakce s náhledovým jmenným prostorem
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv bulk`

Hromadná správa více párů klíč-hodnota v jmenném prostoru Workers KV.

`kv bulk get`

Načte více párů klíč-hodnota z namespace

npx wrangler kv bulk get [FILENAME]

[FILENAME]string povinné
Soubor obsahující klíče, které se mají získat
--bindingstring
Název vazby (binding) na jmenný prostor, ze kterého se má číst
--namespace-idstring
ID namespace, ze kterého se má načítat
--previewboolean výchozí: false
Interakce s náhledovým jmenným prostorem
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv bulk put`

Nahrání více párů klíč-hodnota do jmenného prostoru

npx wrangler kv bulk put [FILENAME]

[FILENAME]string povinné
Soubor obsahující dvojice klíč/hodnota, které se mají zapsat
--bindingstring
Název vazby (binding) na jmenný prostor, do kterého se má zapisovat
--namespace-idstring
ID namespace, do kterého se má zapisovat
--previewboolean
Interakce s náhledovým jmenným prostorem
--ttlnumber
Doba, po kterou by měly být položky viditelné
--expirationnumber
Doba od unixové epochy, po jejímž uplynutí položka vyprší
--metadatastring
Libovolný JSON přidružený ke klíči
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

`kv bulk delete`

Odstranit více párů klíč-hodnota z namespace

npx wrangler kv bulk delete [FILENAME]

[FILENAME]string povinné
Soubor obsahující klíče, které se mají odstranit
--forceboolean alias: --f
Nežádat o potvrzení před smazáním
--bindingstring
Název vazby (binding) na jmenný prostor, ze kterého se má mazat
--namespace-idstring
ID namespace, ze kterého se má odstraňovat
--previewboolean
Interakce s náhledovým jmenným prostorem
--localboolean
Interakce s lokálním úložištěm
--remoteboolean
Interakce se vzdáleným úložištěm
--persist-tostring
Adresář pro místní perzistenci

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í

Zastaralé funkce

Níže najdete zastaralé příkazy Wrangler pro Workers KV.

`kv:...` zastarání syntaxe

Od verze 3.60.0 Wrangler podporuje kv ... syntax. Pokud používáte verze nižší než 3.60.0, příkaz se řídí kv:... syntaxe.

kv:... syntaxe je od verze 3.60.0 zastaralá a v některé budoucí hlavní verzi bude odstraněna.

Například příkazy využívající kv ... syntaxe vypadá takto:

wrangler kv namespace list
wrangler kv key get <KEY>
wrangler kv bulk put <FILENAME>

Stejné příkazy pomocí kv:... syntaxe vypadá takto:

wrangler kv:namespace list
wrangler kv:key get <KEY>
wrangler kv:bulk put <FILENAME>

Příkazy Wrangler KV

kv namespace

kv namespace create

kv namespace list

kv namespace delete

kv namespace rename

kv key

kv key put

kv key list

kv key get

kv key delete

kv bulk

kv bulk get

kv bulk put

kv bulk delete

Zastaralé funkce

kv:... zastarání syntaxe

`kv namespace`

`kv namespace create`

`kv namespace list`

`kv namespace delete`

`kv namespace rename`

`kv key`

`kv key put`

`kv key list`

`kv key get`

`kv key delete`

`kv bulk`

`kv bulk get`

`kv bulk put`

`kv bulk delete`

`kv:...` zastarání syntaxe