Skip to content
Analytics and IoT synsp

Synapse Analytics Spark Pool naming convention

The CAF abbreviation for Synapse Analytics Spark Pool is synsp. Names can be 1 to 15 characters long and allow alphanumerics only. The name must be unique within the parent resource.

Naming rules

CAF abbreviation synsp
Length 1 to 15 characters
Allowed characters Alphanumerics (a-z, A-Z, 0-9)
Scope of uniqueness Unique within the parent resource
CAF pattern synsp{workload}{environment}{region}{instance}

Rules follow Microsoft's resource naming rules and CAF abbreviations. Some resource types have extra start/end character restrictions, so verify against the official docs before locking in a convention.

Naming Analytics and IoT resources

This category mixes two very different patterns. Event Hubs namespaces and IoT Hubs are globally unique DNS endpoints, the same two layer pattern as Service Bus, a shared namespace holds individually scoped event hubs inside it. Less obviously, every HDInsight cluster type (Hadoop, HBase, Kafka, Spark, Storm, ML Services) is also globally unique, since each one gets its own public HTTPS endpoint, a detail that is easy to miss because a cluster does not look like an endpoint resource the way a storage account does.

Synapse workspaces behave the same way. Data Factory pipelines and datasets, by contrast, are scoped to the factory and benefit more from naming that reflects data lineage, source to destination, than from a length limit you need to fight. The common mistake here is treating Data Explorer and HDInsight clusters as ordinary scoped resources and picking a name that later collides globally, when they should get the same DNS safe treatment as a storage account from the start.

Example names

Generated by the same engine as the name generator, so length and character rules are already applied.

Scenario Generated name Length
Payments API, production synsppayprod001
Dropped region and shortened workload to fit 15 chars.
15/15
Web app, development synspwebadev002
Dropped region and shortened workload to fit 15 chars.
15/15
Analytics with company prefix synspanstage001
Dropped company, region and shortened workload to fit 15 chars.
15/15

Naming in Terraform and Bicep

Build the name from variables so one module produces the right name in every environment. The 15-character limit is enforced in the expression.

Terraform
locals {
  synapse_spark_pool_name = substr("synsp${var.workload}${var.environment}${var.region}001", 0, 15)
}
Bicep
var synapseSparkPoolName = take('synsp${workload}${environment}${region}001', 15)

Generate Synapse Analytics Spark Pool names for your workload

Free, no login. Validation and Terraform, Bicep, or CSV export included.

Open in the generator →

Related Analytics and IoT resources

See the full list of Azure resource naming rules or read the complete CAF naming guide.