Get started
Yandex Managed Service for ClickHouse

Connecting to DataLens

Yandex DataLens is a business intelligence service. That lets you upload, process, and visualize data for analysing and testing hypotheses. It can help you make marketing decisions for your product.

To use an existing cluster as a data source for DataLens:

  1. Activate DataLens.
  2. Allow access to the cluster from DataLens.
  3. Create a connection to the cluster in DataLens.

Activating DataLens

Limit

You can only create one DataLens instance in the cloud.

To activate DataLens in your cloud:

  1. Select a folder on the cloud page.
  2. Select DataLens.
  3. Click Activate DataLens.

The DataLens instance will be activated in the selected folder.

Allowing access to a cluster from DataLens

To enable DataLens to connect to your cluster and work with its data, activate the Access from DataLens option when creating a cluster or changing its settings.

Creating a connection to a cluster

  1. Make sure that DataLens is activated in the appropriate folder and allowed to access the cluster.

  2. Go to the folder page and select Managed Service for ClickHouse.

  3. Click on the name of the cluster and select the DataLens tab.

  4. Click Create connection.

    I don't have the "Create connection" button

    If instead of the Create connection button you see a message saying "DataLens not activated", it means that you either haven't activated DataLens or connected it in a different folder. To connect your cluster to a DataLens instance from another folder, follow the instructions in the DataLens documentation.

  5. Specify connection settings.

  6. In the upper-right corner, select the connection scope from the drop-down list:

    • Available only to me.
    • Available to the company.

  7. Check that the settings are correct by clicking Check connection.

  8. After successfully checking the connection, click Create.

Once the connection is created, you can:

See an example of data visualization from ClickHouse.

Viewing a list of cluster connections

  1. Go to the folder page and select Managed Service for ClickHouse.
  2. Click on the name of the cluster and select the DataLens tab.

Updating a cluster connection

  1. Go to the folder page and select Managed Service for ClickHouse.
  2. Click on the name of the cluster and select the DataLens tab.
  3. Select a connection from the list.
  4. Change the connection settings and scope.
  5. Check that the settings are correct by clicking Check connection.
  6. After successfully checking the connection, click Save.

Deleting a cluster connection

  1. Go to the folder page and select Managed Service for ClickHouse.
  2. Click on the name of the cluster and select the DataLens tab.
  3. Select a connection from the list.
  4. Click the at the top of the page and select Delete.
  5. Confirm the deletion.

Connection settings

  1. Specify a name for the connection.
  2. If the cluster and DataLens are in the same folder:
    1. Go to the Select in Cloud tab.
    2. Select the cluster and its host from the drop-down lists or create a new cluster in the folder with DataLens by clicking Create new.
    3. Select a user from the drop-down list.
    4. Enter this user's password.
  3. If the cluster and DataLens are in different folders, use the settings from the instructions in the DataLens documentation.

Leave the HTTP interface port and HTTPS setting values unchanged.

If the Read only setting is selected for the user, make sure its value is 0 or 2.
Otherwise, the connection won't work.

In this article: