Creating a connection in DataStax Studio

A connection from each notebook to a DataStax Enterprise (DSE) cluster is required. A notebook persists its data to the database cluster.

Connect notebooks only to DSE clusters that run the relevant workload. For example:

  • To run Gremlin cells, create a connection to a DSE cluster that is configured for and running DSE Graph (legacy/classic) or DataStax Graph (core).

  • To run AlwaysOn SQL queries in Studio, create a connection to a DSE cluster that is configured for and running the AlwaysOn SQL service.

Each notebook has only one connection. A connection can serve multiple notebooks.

You can configure more than one host in a Studio connection. Hosts initialize the DSE driver connection, so more than one host provides redundancy and failover protection.


The DSE cluster must be installed and running. The username and password for internal authentication are defined in the DSE cluster. See About DSE Unified Authentication.


To create a connection from a Studio notebook to a DSE cluster:

  1. Browse to the URL for the Studio installation:


    where 9091 is the default DataStax Studio server port.

  2. In the menu (☰), select Connections.

    The existing connections are displayed in a list. The list is sorted in alphabetical order and shows the port and host for each connection.

  3. Click + in the top center of the page.

  4. In the Create Connection dialog, enter the connection information:


    Name of the connection from the notebook to a DSE cluster.

    Host/IP (comma delimited)

    The host names or IP addresses of the DSE cluster to connect to. All hosts must be in a single datacenter. Default: localhost.


    Optional. DSE username for logging in.


    Optional. DSE password for logging in.


    IP connection port. Default: 9042.

    For example, to connect to a single-node DSE cluster on the local host using the default port.


    My First Connection




  5. Click Test to verify the connection works.

  6. Optional: To configure a secure encrypted connection, select the Use SSL check box.

    The Truststore and Keystore fields display. See Using SSL connections in DataStax Studio.

  7. Click Save.

    A connection is created from the notebook to the DSE cluster.


Select Edit Connection in the notebook header to edit the current connection, add a new connection, or select a different connection directly from within the notebook.

You can click the connection name in notebook header to open the connection dialog and make changes.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000,