Create Trino cluster

In the control panel, from the top menu, click Products and select Trino.
Click Create cluster.
Enter the cluster name.
Select a location. Once the cluster is created, the location cannot be changed.
Select a Trino version. Once the cluster is created, the version cannot be changed.
Fill in the blocks:
- Configuration;
- Network;
- Administrator password;
- optional: Catalogs;
- optional: Additional parameters.
Check the cluster price.
Click Create cluster.

Configuration

Select the coordinator configuration.
Select the worker configuration.
Optional: set the number of workers:

3.1. If the cluster should have a fixed number of workers, select Fixed and specify the number of workers.

3.2. If the cluster should have autoscaling configured, select Autoscaling and specify the minimum and maximum number of workers. The number of workers will change automatically only within the specified range depending on the cluster load.

After creating a cluster, you can change the coordinator and worker configuration and the number of workers. For details, see the Scale cluster instructions.

Network

A Trino cluster can only be connected to a private subnet. You can create a new subnet or add the cluster to an existing one. The subnet cannot be changed after the cluster is created.

New private subnet
Existing private subnet

In the Subnet field, select New private subnet.
In the Network field, select an existing network or create a new one.
Optional: change the subnet CIDR.
Optional: to connect to the Trino GUI or Trino CLI from the internet, select the External access to GUI checkbox. You can enable external access after creating the cluster.

Administrator password

Enter the administrator password or click Generate. The password must contain:
- at least eight characters;
- uppercase and lowercase Latin letters;
- digits;
- special characters — @, $, !, %, *, ?, &.
Copy and save the administrator password — it is required to connect to the cluster. You will not be able to view the password in the control panel, but you can change it.

Optional: Catalogs

When creating a cluster, you can add up to 10 catalogs. If you need more than 10 catalogs, add additional catalogs after creating the cluster.

Click Add.
Enter the catalog name. The name can contain:
- lowercase Latin letters only;
- digits;
- underscores;
- up to 63 characters.
Optional: enter a catalog description.
Select the connector type.
Set the connection parameters for the data source. Connection parameters differ depending on the selected connector.

If the catalog requires additional connector parameters that are not available in the control panel, create a ticket. In the ticket, specify the connector type and the required parameters.
- PostgreSQL
- MySQL
- Iceberg
- ClickHouse®
5.1. Enter the DNS address or IP address of the database server.
5.2. Enter the port for connecting to the database server.
5.3. Enter the database name.
5.4. Enter the database username.
5.5. Enter the database user password.
5.1. Enter the DNS address or IP address of the database server.
5.2. Enter the port for connecting to the database server.
5.3. Enter the database username.
5.4. Enter the database user password.
REST
Thrift
5.1. Select the connection type — REST.
5.2. In the URI field, enter the Iceberg REST catalog address in the format https://<rest-catalog-host>:<port>.
Specify:

<rest-catalog-host> — DNS address or IP address of the catalog;

<port> — port for connecting to the catalog.

If you use Cloud for Hive Metastore as the catalog, enter the address in the format https://<ip_address>:8080, where <ip_address> is the private IP address of the Hive Metastore cluster.
5.3. In the Region field, enter the region where the S3-compatible storage is located. If you use Selectel S3 as the S3-compatible storage, enter the pool where S3 is located (for example, ru-1).
5.4. In the Endpoint field, enter the endpoint of the S3-compatible storage in the format https://<domain>.
Specify <domain> — domain of the S3-compatible storage.
If you use Selectel S3 as the S3-compatible storage, enter the endpoint in the format https://s3.<pool>.storage.selcloud.ru, where <pool> is the pool where S3 is located (for example, ru-1). If S3 and the Trino cluster are located in the same pool, the connection to S3 is established over a dedicated network that provides higher bandwidth than the cluster subnet.
5.5. Optional: in the Path to warehouse field, enter the prefix where Iceberg catalog table metadata and data will be placed. We recommend filling out this field to prevent overwriting and deleting data when using a bucket for multiple Iceberg catalogs. If you leave this field empty, metadata will be placed in the root of the bucket.
5.6. In the Access Key field, enter the access key ID. If you use Selectel S3 as data storage, enter the value of the Access key field from the S3 key.
5.7. In the Secret Key field, enter the secret key of the access key. If you use Selectel S3 as data storage, enter the value of the Secret key field from the S3 key.
5.1. Select the connection type — Thrift.
5.2. In the URI field, enter the Hive Metastore address in the format thrift://<metastore-host>:<port>.
Specify:

<metastore-host> — DNS address or IP address of Hive Metastore;

<port> — port for connecting to Hive Metastore.

If you use Cloud for Hive Metastore, enter the address in the format thrift://<ip_address>:9083, where <ip_address> is the private IP address of the Hive Metastore cluster.
5.3. In the Region field, enter the region where the S3-compatible storage is located. If you use Selectel S3 as the S3-compatible storage, enter the pool where S3 is located (for example, ru-1).
5.4. In the Endpoint field, enter the endpoint of the S3-compatible storage in the format https://<domain>.
Specify <domain> — domain of the S3-compatible storage.
If you use Selectel S3 as the S3-compatible storage, enter the endpoint in the format https://s3.<pool>.storage.selcloud.ru, where <pool> is the pool where S3 is located (for example, ru-1). If S3 and the Trino cluster are located in the same pool, the connection to S3 is established over a dedicated network that provides higher bandwidth than the cluster subnet.
5.5. In the Access Key field, enter the access key ID. If you use Selectel S3 as data storage, enter the value of the Access key field from the S3 key.
5.6. In the Secret Key field, enter the secret key of the access key. If you use Selectel S3 as data storage, enter the value of the Secret key field from the S3 key.
5.1. Enter the DNS address or IP address of the database server.
5.2. Enter the port for connecting to the database server.
5.3. Enter the database name.
5.4. Enter the database username.
5.5. Enter the database user password.
Click Add.

Optional: Additional settings

To access cluster logs, enable logging. Logging uses the Logs service.

Select the Collect technical cluster logs in the log service checkbox.
Select a log group or create a new group.
If you selected a new group, enter its name.

ClickHouse® is a registered trademark of ClickHouse, Inc. https://clickhouse.com.