Skip to content

Commit 2a383d7

Browse files
vy-tonOxyjun
andauthored
DO Data Studio docs & changelog (#25837)
* DO Data Studio docs & changelog --------- Co-authored-by: Jun Lee <[email protected]>
1 parent f13fbd9 commit 2a383d7

File tree

4 files changed

+66
-0
lines changed

4 files changed

+66
-0
lines changed
42.5 KB
Loading
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: View and edit Durable Object data in UI with Data Studio (Beta)
3+
description: Access Durable Objects stored data via Cloudflare dashboard.
4+
products:
5+
- durable-objects
6+
- workers
7+
date: 2025-10-16
8+
---
9+
10+
import { DashButton } from "~/components";
11+
12+
![Screenshot of Durable Objects Data Studio](~/assets/images/workers/changelog/do-data-studio.png)
13+
14+
You can now view and write to each Durable Object's storage using a UI editor on the Cloudflare dashboard. Only Durable Objects using [SQLite storage](/durable-objects/best-practices/access-durable-objects-storage/#create-sqlite-backed-durable-object-class) can use Data Studio.
15+
16+
<DashButton url="/?to=/:account/workers/durable-objects" />
17+
18+
Data Studio unlocks easier data access with Durable Objects for prototyping application data models to debugging production storage usage. Before, querying your Durable Objects data required deploying a Worker.
19+
20+
To access a Durable Object, you can provide an object's unique name or ID generated by Cloudflare. Data Studio requires you to have at least the `Workers Platform Admin` role, and all queries are captured with audit logging for your security and compliance needs. Queries executed by Data Studio send requests to your remote, deployed objects and incur normal usage billing.
21+
22+
To learn more, visit the Data Studio [documentation](/durable-objects/observability/data-studio/). If you have feedback or suggestions for the new Data Studio, please share your experience on [Discord](https://discord.com/channels/595317990191398933/773219443911819284)
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Data Studio
3+
pcx_content_type: concept
4+
sidebar:
5+
order: 7
6+
badge: Beta
7+
---
8+
9+
import { DashButton, Steps } from "~/components";
10+
11+
Each Durable Object can access private storage using [Storage API](/durable-objects/api/sqlite-storage-api/) available on `ctx.storage`. To view and write to an object's stored data, you can use Durable Objects Data Studio as a UI editor available on the Cloudflare dashboard.
12+
13+
:::note[Data Studio only supported for SQLite-backed objects]
14+
15+
You can only use Data Studio to access data for [SQLite-backed Durable Objects](/durable-objects/best-practices/access-durable-objects-storage/#create-sqlite-backed-durable-object-class).
16+
17+
At the moment, you can only read/write data persisted using the [SQL API](/durable-objects/api/sqlite-storage-api/#sql-api). Key-value data persisted using the KV API will be made read-only in the future.
18+
:::
19+
20+
## View Data Studio
21+
22+
You need to have at least the `Workers Platform Admin` [role](/fundamentals/manage-members/roles/) to access Data Studio.
23+
24+
<Steps>
25+
1. In the Cloudflare dashboard, go to the **Durable Objects** page.
26+
27+
<DashButton url="/?to=/:account/workers/durable-objects" />
28+
2. Select an existing Durable Object namespace.
29+
3. Select the **Data Studio** button.
30+
4. Provide a Durable Object identifier, either a user-provided [unique name](/durable-objects/api/namespace/#getbyname) or a Cloudflare-generated [Durable Object ID](/durable-objects/api/id/).
31+
</Steps>
32+
33+
- Queries executed by Data Studio send requests to your remote, deployed objects and incur [usage billing](/durable-objects/platform/pricing/) for requests, duration, rows read, and rows written. You should use Data Studio as you would handle your production, running objects.
34+
- In the **Query** tab when running all statements, each SQL statement is sent as a separate Durable Object request.
35+
36+
## Audit logging
37+
38+
All queries issued by the Data Studio are logged with [audit logging v1](/fundamentals/account/account-security/review-audit-logs/) for your security and compliance needs.
39+
40+
- Each query emits two audit logs, a `query executed` action and a `query completed` action indicating query success or failure. `query_id` in the log event can be used to correlate the two events per query.

src/content/release-notes/durable-objects.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@ link: "/durable-objects/release-notes/"
33
productName: Durable Objects
44
productLink: "/durable-objects/"
55
entries:
6+
- publish_date: "2025-10-16"
7+
title: Durable Objects can access stored data with UI editor
8+
description: |-
9+
Durable Objects stored data can be viewed and written using [Data Studio](/durable-objects/observability/data-studio/) on the Cloudflare dashboard. Only Durable Objects using [SQLite storage](/durable-objects/best-practices/access-durable-objects-storage/#create-sqlite-backed-durable-object-class) can use Data Studio.
610
- publish_date: "2025-08-21"
711
title: Durable Objects stubs can now be directly constructed by name
812
description: |-

0 commit comments

Comments
 (0)