CLion
 
2024.3
Shortcuts: Windows
Get CLion
Join the CLion 2025.1 Early Access Program and try out new features before they are released! Find out more
  1. Language and framework-specific guidelines
  2. Database Tools and SQL
  3. Connection to a database
  4. Data sources
  5. Apache Cassandra
  6. Create an Apache Cassandra data source with SSL

Create an Apache Cassandra data source with SSL

Last modified: 04 December 2024

Enable the Database Tools and SQL plugin

This functionality relies on the Database Tools and SQL plugin, which is bundled and enabled in CLion by default. If the relevant features are not available, make sure that you did not disable the plugin.

  1. Press CtrlAlt0S to open settings and then select Plugins.

  2. Open the Installed tab, find the Database Tools and SQL plugin, and select the checkbox next to the plugin name.

Step 1. Create a Apache Cassandra data source

  1. To connect to the database, create a data source that will store your connection details. You can do this using one of the following ways:

    • In the main menu, go to File | New | Data Source and select Apache Cassandra.

    • In the Database tool window (View | Tool Windows | Database) , click the New icon (the New icon) in the toolbar. Navigate to Data Source and select Apache Cassandra.

    Create a new data source

  2. Check if there is a Download missing driver files link at the bottom of the connection settings area. Click this link to download drivers that are required to interact with a database. For a direct download link, refer to the JetBrains JDBC drivers page.

    Location for the downloaded JDBC drivers is the CLion configuration directory.

    The Download missing driver files link

    You can also use your drivers for the database instead of the provided ones. For more information about connecting to a database with your driver, refer to Add a user driver to an existing connection.

    If there is no Download missing driver files link, then you already have the required drivers.

  3. In Host, Keyspace, User, Password, and Port fields, specify connection details.

Step 2. Verify the version of the JDBC driver

Verify that you use the JDBC driver of version 1.3, or later.

  1. Open data source properties. You can open data source properties by using one of the following options:

    • In the Database tool window (View | Tool Windows | Database) , click the Data Source Properties icon The Data Source Properties icon.

    • Press CtrlAltShift0S.

  2. In the Drivers tab, select Apache Cassandra.

  3. In the Driver files pane, click ver. <version_number> and select Latest or 1.3.

Verify the version of the JDBC driver

Step 3. Set VM options

  1. Open data source properties. You can open data source properties by using one of the following options:

    • In the Database tool window (View | Tool Windows | Database) , click the Data Source Properties icon The Data Source Properties icon.

    • Press CtrlAltShift0S.

  2. In the Drivers tab, select Apache Cassandra.

  3. In the driver settings, click the Advanced tab.

  4. In the VM options field, specify options for authentication.

    • Server authentication: your client verifies that the server is correct and trusted. The truststore must contain a public key of the server or the CA certificate that was used to sign the server key.

      -Djavax.net.ssl.trustStore=<path_to_client_truststore>
-Djavax.net.ssl.trustStorePassword=<truststore_password>

    • Client authentication: the server verifies the client that tries to connect to the server.

      -Djavax.net.ssl.keyStore=<path_to_client_keystore>
-Djavax.net.ssl.keyStorePassword=<keystore_password>
Set VM options

tip

For more information about JSSE system properties, refer to Java Secure Socket Extension (JSSE) Reference Guide.

Step 4. Add the sslenabled option to the JDBC URL

  1. Add the sslenabled=true option to the JDBC URL. For example, jdbc:cassandra://localhost:9042/?sslenabled=true.

  2. Ensure that the connection to the database can be established using the provided details. To do that, click the Test Connection link at the bottom of the connection details area.

    Test Connection link

    In case of any connection issues, refer to the Cannot connect to a database page.

  3. (Optional) By default, only the default keyspace is introspected and available to work with. If you also want to work with other keyspaces, in the Schemas tab, select them for the introspection.

    Schemas tab of the Data Sources and Drivers dialog

  4. Click OK to create the data source.

  5. Find your new data source in the Database tool window () .

    • For more information about the Database tool window, see the corresponding reference topic.

      tip

      To see more keyspaces under your new data source node, click the N of M button and select the ones you need. CLion will introspect and show them.

      Select databases and schemas to introspect and display in the Database tool window

    • For more information about working with database objects in CLion, refer to Database objects.

    • To write and run queries, open the default query console by clicking the data source and pressing F4.

    • To view and edit data of a database object, open Data Editor Dialog by double-clicking the object.

Add the sslenabled option to the JDBC URL

See also

External Links