From a888fd4b054855c54015c025edd32822508329c2 Mon Sep 17 00:00:00 2001 From: Tomasz Kopacki Date: Fri, 19 Jun 2026 14:38:29 +0200 Subject: [PATCH 1/7] Create a page including the ENSDb SQL Viewer --- .../starlight/sidebar-topics/integrate.ts | 4 ++++ .../docs/integrate/unigraph/sql-viewer.mdx | 23 +++++++++++++++++++ 2 files changed, 27 insertions(+) create mode 100644 docs/ensnode.io/src/content/docs/docs/integrate/unigraph/sql-viewer.mdx diff --git a/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts b/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts index 9585e195b..4367fe630 100644 --- a/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts +++ b/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts @@ -169,6 +169,10 @@ export const integrateSidebarTopic = { }, ], }, + { + label: "SQL Viewer", + link: "/docs/integrate/unigraph/sql-viewer", + }, { label: "Schema Reference", link: "/docs/integrate/unigraph/schema-reference", diff --git a/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/sql-viewer.mdx b/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/sql-viewer.mdx new file mode 100644 index 000000000..7c5015365 --- /dev/null +++ b/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/sql-viewer.mdx @@ -0,0 +1,23 @@ +--- +title: SQL Viewer +description: Use a web-based SQL client to query ENS Unigraph from a read-only ENSDb Snapshot. +tableOfContents: false +--- + +Use a web-based SQL client to query the [ENS Unigraph](/docs/integrate/unigraph/concepts#indexed-data-model) from a read-only [ENSDb Snapshot](/docs/integrate/integration-options/ensdb-cli). This is a convenient way to explore the indexed data model and run queries without needing to set up your own Postgres client. + +### Get started + +1. Click the "_ENSDb Alpha (read-only snapshot)_" button below to connect to a read-only ENSDb Snapshot Server. + + :::caution[ENS state may be out of date] + The ENSDb Snapshot Server hosts an [ENSDb instance](/docs/services/ensdb/concepts/database-schemas#ensdb-instance) created from an [ENSDb Snapshot](/docs/integrate/integration-options/ensdb-cli). The ENSDb Snapshot is taken at a certain point in time from the current [ENSNode Alpha hosted instance](/docs/hosted-instances#ensnode-alpha). It means that the latest state of ENS won't be reflected in the ENSDb instance, but it is a convenient way to explore the ENS Unigraph data model and run queries without needing to set up your own ENSDb instance. + ::: + +2. Browse tables in the [ENSDb Writer Schema](/docs/services/ensdb/concepts/database-schemas#ensdb-writer-schema) (named as `alpha` in this example ENSDb instance) and the [ENSNode Schema](http://localhost:4321/docs/services/ensdb/concepts/database-schemas#ensnode-schema) (always named as `ensnode`). + +3. Use "_SQL Console_" to run queries against the ENS Unigraph data model. + +4. Use "_Schema_" to view the schema of each table, including columns and indexes. + +