Skip to content

Confusing behavior of warehouse_id vs. warehouse name in ClickHouse Terraform provider #363

@monometa

Description

@monometa

While working with ClickHouse Cloud Terraform provider (clickhouse_service resource), we discovered an inconsistency between the Cloud Console UI and Terraform.

What we expected

  • That renaming a warehouse in UI would either:
    1. be detected by Terraform as a harmless name change (no recreate), or
    2. expose a warehouse_name attribute in Terraform that matches the UI field.

What actually happens

  • After renaming a warehouse in UI, running terraform plan shows no changes — which suggests the provider ignores the display name completely.
  • From our testing:
    • warehouse_id = internal UUID, stable and hidden from UI.
    • Renaming in UI does not break existing pipelines.
    • But Terraform has no way to manage the visible warehouse name, only the internal ID.

Why this is confusing

  • The docs are not explicit that warehouse_id is an internal UUID and not the visible name.
  • This creates uncertainty: is manual renaming supported and safe, or will it lead to resource recreation?
  • Our use case: multi-tenant setup where warehouse naming in UI matters (primary vs. secondary services). We would like to control visible warehouse names via Terraform or at least be sure renames are safe.

Question

  • Is it expected that warehouse_id refers only to the internal UUID?
  • Can the provider expose a warehouse_name field that controls the display name in UI?
  • If not, what is the recommended way to manage warehouse naming in a Terraform-first workflow?

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions