Create an Aiven for ClickHouse® Developer tier service

Create an Aiven for ClickHouse® Developer tier service using the Aiven Console, the Aiven CLI, or Terraform.

For features, specifications, and limitations, see Aiven for ClickHouse® Developer tier.

Prerequisites

• An Aiven account. Sign up or sign in using the Aiven Console.
• A project where you can create paid services.
• Billing set up for your organization. See Billing and payment.
• To use the Aiven CLI, the Aiven CLI installed and authenticated.
• To use Terraform, Terraform installed and a personal token.

Create a Developer tier service

Console

1. In your project, click Services.

2. Click Create service.

3. Select Aiven for ClickHouse®.

4. In Service tier, select Developer.

5. In Cloud, select a geographical area, such as Europe.

   note

   On the Developer tier, Cloud lists broad geographical areas only. You can't choose a specific cloud provider or region.

6. In Plan, select Developer-4.

7. In Service basics, enter a service name.

   You can't change the service name after you create the service.

8. Review the Service summary and the estimated monthly price.

9. Click Create service.

The Aiven Console selects the ClickHouse version automatically. You can't change it during service creation.

When the status is Running, your service is ready.

CLI

Run the following command:

avn service create SERVICE_NAME \
  --project PROJECT_NAME \
  --service-type clickhouse \
  --cloud CLOUD_NAME \
  --plan developer-4

Replace the following:

• SERVICE_NAME: A name for your service. You can't change it later.
• PROJECT_NAME: The name of your project.
• CLOUD_NAME: The cloud for your geographical area, such as do-fra for Europe.

Terraform

Add the following resource to your configuration. For provider setup, see Aiven Provider for Terraform.

resource "aiven_clickhouse" "dev" {
  project      = var.aiven_project_name
  cloud_name   = "do-fra"
  plan         = "developer-4"
  service_name = "my-clickhouse-dev"
}

To apply your Terraform configuration:

1. Initialize Terraform by running:

   terraform init

   The output is similar to the following:

   
   Initializing the backend...
   
   Initializing provider plugins...
   - Finding aiven/aiven versions matching ">= 4.0.0, < 5.0.0"...
   - Installing aiven/aiven v4.9.2...
   - Installed aiven/aiven v4.9.2
   ...
   Terraform has been successfully initialized!
   ...

2. To create an execution plan and preview the changes, run:

   terraform plan

3. To deploy your changes, run:

   terraform apply --auto-approve

For the full resource schema, see the aiven_clickhouse resource documentation.

When you change plan to a Startup plan, also set cloud_name to a cloud that supports it.

After you create the service

When the service status is Running, you can:

• Connect a client: On the Overview page, click Quick connect and follow the instructions. See Connect to Aiven for ClickHouse®.
• Create databases and tables: See Manage Aiven for ClickHouse® databases and tables.
• Integrate other services: Connect data sources and Aiven services. See Aiven for ClickHouse® service integrations.

Upgrade your Developer tier service

Upgrade to the Startup plan or higher when the Developer tier no longer meets your compute, storage, or availability needs. For upgrade considerations, see Upgrade to a higher service tier.

1. Open your Developer tier service.
2. On the Overview page, in Service plan usage, click Change plan.
3. In the Quick upgrade dialog, do one of the following:
   • Review the recommended Startup plan, and click Upgrade.
   • Click Customize instead to choose another configuration.
4. Follow the instructions in the Aiven Console.

You can also click Change plan in Service settings > Service summary.

When you upgrade, your service migrates to another cloud provider. Your credentials and Aiven DNS records stay the same, so your connection details don't change.

Note

You can't downgrade to the Developer tier after you upgrade.

For more information, see Change the plan for your Aiven for ClickHouse® service.

Related pages

• Aiven for ClickHouse® Developer tier
• Get started with Aiven for ClickHouse®
• Change the plan for your Aiven for ClickHouse® service