Workers KV

cloudflare NoSQL databasecloudflare-workers-kv

Eventually consistent global key-value namespace cached at every edge location.

Provider: cloudflare
Kind: NoSQL database
Category: Data
Official docs: https://developers.cloudflare.com/kv/concepts/how-kv-works/

Properties · 4 set by this component

property	type	values	required	kind default	this component
backupEnabled	boolean	—	no	false	inherited
backupRetentionDays	integer	—	no	—	inherited
bucketing · advanced	boolean	—	no	false	inherited
conflictResolution	enum	none \| last-writer-wins \| vector-clock \| app-merge	no	—	inherited
consistency	enum	eventual \| tunable \| strong	no	eventual	▸ eventual
encryptionAtRest	boolean	—	no	false	inherited
instances	integer	—	no	—	inherited
managed	boolean	—	no	false	▸ true
maxKeySizeBytes · component property	integer	—	no	512	inherited
maxNamespacesPerAccount · component property	integer	—	no	1000	inherited
maxValueSizeMib · component property	integer	—	no	25	inherited
minCacheTtlSeconds · component property	integer	—	no	30	inherited
model	enum	key-value \| wide-column \| document	yes	—	▸ key-value
partitionKey	string	—	no	—	inherited
propagationDelaySeconds · component property	integer	—	no	60	inherited
quorumReads · advanced	integer	—	no	—	inherited
quorumWrites · advanced	integer	—	no	—	inherited
replication	enum	single-region \| multi-region-single-leader \| multi-region-multi-leader \| leaderless	no	single-region	▸ multi-region-single-leader
replicationFactor	integer	—	no	—	inherited
tombstoneTtlDays · advanced	integer	—	no	—	inherited

Rules that apply · 2

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

Multi-leader store without a conflict policywarning

multi-leader-store-without-conflict-policy

Multi-leader replication accepts concurrent writes in several regions. With no conflict resolution policy declared, divergent replicas are reconciled by accident rather than by design.

— all of these hold:
— the node's `replication` is "multi-region-multi-leader"
— any of these hold:
— the node's `conflictResolution` has no value
— the node's `conflictResolution` is "none"

Read-heavy datastore without a cachewarning

read-heavy-path-without-cache

The design states a read-heavy workload and application servers read this datastore directly, yet the design has no cache anywhere. Every read pays a database round trip.

— all of these hold:
— the design requirement `traffic.readWriteRatio` is a number greater than 10
— the node has at least one synchronous incoming edge from an app-server
— this does not hold:
— the design contains a node of kind cache

Use it in a design

nodes:
  - { id: "workers-kv", component: "cloudflare-workers-kv" }

Other NoSQL database products · 46

ApsaraDB for HBasealibaba-apsaradb-hbasealibabacloudnosql-database ApsaraDB for MongoDBalibaba-apsaradb-mongodbalibabacloudnosql-database Lindormalibaba-lindormalibabacloudnosql-database Tablestorealibaba-tablestorealibabacloudnosql-database Amazon CloudFront KeyValueStoreaws-cloudfront-keyvaluestoreawsnosql-database Amazon Cognito Syncaws-cognito-syncawsnosql-database Amazon DocumentDBaws-documentdbawsnosql-database AWS HealthLakeaws-healthlakeawsnosql-database Amazon Keyspaces (for Apache Cassandra)aws-keyspacesawsnosql-database Amazon DynamoDBdynamodbawsnosql-database Azure Cosmos DBazure-cosmos-dbazurenosql-database Azure DocumentDBazure-documentdbazurenosql-database Azure Health Data Servicesazure-health-data-servicesazurenosql-database Azure Managed Instance for Apache Cassandraazure-managed-cassandraazurenosql-database Azure Table Storageazure-table-storageazurenosql-database Apache Accumuloaccumulonosql-database Aerospike Databaseaerospikenosql-database Apache Cassandracassandranosql-database Couchbasecouchbasenosql-database Apache CouchDBcouchdbnosql-database DataStax Enterprisedatastax-enterprisenosql-database FoundationDBfoundationdbnosql-database Apache HBasehbasenosql-database MarkLogic Servermarklogicnosql-database MongoDBmongodbnosql-database MongoDB Atlasmongodb-atlasnosql-database Generic NoSQL databasenosql-databasenosql-database NoSQL storenosql-storenosql-database OrientDBorientdbnosql-database RavenDBravendbnosql-database RethinkDBrethinkdbnosql-database Riak KVriaknosql-database ScyllaDBscylladbnosql-database TiKVtikvnosql-database YDBydbnosql-database Google Cloud Bigtablebigtablegcpnosql-database Google Cloud Firestorefirestoregcpnosql-database Cloud Healthcare APIgoogle-cloud-healthcare-apigcpnosql-database Firebase Realtime Databasegoogle-firebase-realtime-databasegcpnosql-database Firestore in Datastore modegoogle-firestore-datastore-modegcpnosql-database

and 6 more → NoSQL database page

Source

1# yaml-language-server: $schema=../../schema/component.schema.json
2# Workers KV namespace: a central key-value store cached at every edge location. "How KV works"
3# states reads are eventually consistent with writes and a change can take up to 60 seconds to be
4# visible elsewhere; "KV - Limits" gives 512 byte keys, 25 MiB values and a 30 second minimum cacheTtl.
5schemaVersion: "1"
6type: "component"
7id: "cloudflare-workers-kv"
8kind: "nosql-database"
9provider: "cloudflare"
10docs: "https://developers.cloudflare.com/kv/concepts/how-kv-works/"
11aliases: ["KV"]
12defaults:
13  managed: true
14  model: "key-value"
15  consistency: "eventual"
16  replication: "multi-region-single-leader"
17properties:
18  propagationDelaySeconds:
19    type: "integer"
20    default: 60
21  minCacheTtlSeconds:
22    type: "integer"
23    default: 30
24  maxKeySizeBytes:
25    type: "integer"
26    default: 512
27  maxValueSizeMib:
28    type: "integer"
29    default: 25
30  maxNamespacesPerAccount:
31    type: "integer"
32    default: 1000

The same page as markdown, for an agent: /catalogue/components/cloudflare-workers-kv.md