TypeDB Studio
TypeDB Studio is an interactive visual environment for managing and querying TypeDB databases.
With Studio, developers can efficiently manage databases, execute queries, and explore query results, all within a unified environment.
This page provides a quick introduction to TypeDB Studio and an overview of its features. All features of TypeDB Studio are available on both web and desktop.
Quickstart
Connect to TypeDB
Select TypeDB edition below, and follow the instructions:
-
Cloud
-
Enterprise
-
Community Edition
-
In the TypeDB Cloud website, navigate to your cluster and click Connect. Then, click Connect with TypeDB Studio. This will launch TypeDB Studio.
-
Fill in your password and hit Connect. Your password can be found in your downloaded credentials file (if you have one).
-
Launch TypeDB Studio.
-
Enter the address of the HTTP endpoint of your cluster. By default, this is at port 8000.
-
Enter your username and password.
-
Click
Connect
.
-
Launch TypeDB Studio.
-
Enter the address of the HTTP endpoint of your cluster. By default, this is at port 8000 and for local instances you can use
http://localhost:8000
. -
Enter your username and password - defaults are
admin
andpassword
. -
Click
Connect
.
Query tool
You can run queries against the connected TypeDB server using TypeDB Studio’s query tool.
Write a query
You can write TypeQL queries in the Query pane.
The Query pane contains a code editor that offers TypeQL highlighting and simple autocompletion.
Run a query
When your query is ready to run, hit "Run query" in the Query pane.
Results are printed to the Run pane.
Query results
The Run pane offers three different views of results - you can choose between Log, Table and Raw.
The Log contains textual output, similar to TypeDB Console, as well as input log, and error messages.
Table view is well suited for visualising the answers of match and fetch queries in a tabular format, where each row represents an answer, and each column represents a variable.
Raw output allows you to see the raw HTTP response from TypeDB.
Schema pane
The Schema pane lists your schema objects and their capabilities - e.g. owned attributes and played roles.
It acts as a reference panel indicating what you can query.
You can configure its view mode (flat or hierarchical) by clicking the options button in its top bar. Flat layout is typically better for simple schemas, while the hierarchical view is better for more complex schemas with subtyping.
The options pane also allows you to filter what capabilities are displayed. For example, you can set it to only display owned attributes, or to only display roleplayers of relations.
History pane
All queries and transaction operations are timestamped and logged to the History pane. Any errors that occur can be retrieved from this pane.
Transaction controls
By default, transactions are fully managed by TypeDB Studio. A transaction opens when you start running a query, and commits when a schema/write query is done or closes when a read query is done.
For more fine-grained control, you can use the top bar to change the transaction mode from auto to manual. This allows you to open transactions, and perform multiple queries within a transaction before closing or committing.
Only one transaction can be open concurrently within a single instance of TypeDB Studio.
Connection management
To connect, disconnect, or change connection settings, use the connection button in the top bar. While connected to TypeDB, the button changes its label to the server’s address or the custom name provided when setting up the connection.
Error handling
Query-level errors are printed to Log Output. These are typically errors returned directly from TypeDB, and will contain detailed error codes and explanations of the problem (e.g: illegal TypeQL semantics)
Transaction-level errors will trigger an error popup notification.
Both types of errors can be viewed and copied to the clipboard by visiting the History pane on the Query page.
Schema tool
TypeDB Studio’s Schema tool allows you to visualise your TypeDB schema.
It renders the entire schema as a graph visualisation, with nodes representing entities, relations, attributes, etc., and edges representing capabilities such as owned attributes and played roles.
User manager
You can manage database users in TypeDB Studio’s User Manager.
The User Manager allows you to view, create, update, and delete users. It lists all users in a table view.