Partitioning key

As explained in Akka in Action, Second Edition

A partition key is a value used to deterministically assign an entity or actor to a distribution partition.

A partitioning key is a stable value that keeps related work together while distributing independent work. In consistent-hashing routing, a message is mapped to a String message key; messages that must be joined, such as those sharing an ID, must always produce the same key. The router hashes that key, selects a virtual node, and sends the message to the routee responsible for it. section 6.3.4

Figure 6.7 Steps the consistent hashing router follows to decide which routee to select

The routing path makes the key’s role explicit: message key, hash code, virtual node, then routee. Virtual nodes improve the chance of even distribution and accommodate routee additions or removals. section 6.3.4

Choose and apply a key with these constraints:

• Derive it from the identity that defines related messages, such as a message ID, rather than from changing message content. section 6.3.4
• Implement a mapping function for each message type; consistent hashing requires the message-to-key mapping explicitly. section 6.3.4
• Configure the virtual-node factor for the router, because each routee serves a configured number of virtual nodes. section 6.3.4

Route aggregation by message ID

An obfuscator and an enricher can each route output to an aggregator using the same message ID as the key. Similar messages then reach the same routee and aggregator, so their pieces can be combined correctly. A group router uses the aggregator ServiceKey together with the consistent-hashing mapping. section 6.3.4

Partitioning also appears at the cluster level. Cluster sharding automatically distributes actors across nodes using a partition key, and uses that same key to communicate with those actors. This combines placement, load balancing, and resilience when nodes leave the cluster. section 8.1

How Akka in Action, Second Edition covers it

How deep it goes

Explains key extraction, hashing, virtual-node selection, and routee assignment; defers cluster sharding details.

Examples

Uses an obfuscator, enricher, and aggregator that share message IDs to join related outputs.

What it assumes

Introduces the key mapping within an Akka router scenario without requiring prior failure-handling experience.

What you can do after

Apply it via Akka routers by implementing a stable message-to-key mapping and configuring consistent hashing.

How it connects

Connects consistent hashing with routers, virtual nodes, ServiceKey, cluster sharding, and load balancing.

liveBookmanning.com

Read Akka in Action, Second Edition on liveBook Get the book at manning.com

Also explained in

• 

  liveBookmanning.com
  ScyllaDB in ActionA partition key is the key component that determines a row’s partition and enables routing a query to the node owning that partition.
• 

  liveBookmanning.com
  Kafka for ArchitectsA message key is a Kafka record value used to determine partition placement and associate records for ordering.
• 

  liveBookmanning.com
  Apache Kafka in ActionA message key is an optional Kafka message attribute used to categorize a message and determine its partition.
• 

  liveBookmanning.com
  Amazon Web Services in Action, Third Edition: An in-depth guide to AWSA partition key is a DynamoDB primary-key attribute whose value determines an item's partition and can uniquely identify an item when no sort key exists.
• 

  liveBookmanning.com
  Microsoft Azure in ActionA partition key is the entity-key component that identifies the physical partition in which an Azure Table Storage entity is stored.
• 

  liveBookmanning.com
  LatencyA partitioning key is the data field or value used to determine which partition stores a record.
• 

  liveBookmanning.com
  100 SQL Server Mistakes and How to Avoid ThemA partitioning key is the column or expression whose values determine the partition containing each table row.
• 

  liveBookmanning.com
  PostgreSQL Mistakes and How to Avoid ThemA partition key is a column or expression whose values determine how rows are assigned to table partitions.
• 

  liveBookmanning.com
  Spring in Action, Sixth EditionA partition key is the component of a Cassandra primary key that determines the partition in which a row is stored.

Compare how 10 books explain partitioning key →

Related concepts

• log compactionuses · Log compaction is a storage technique that retains the latest record for each key while removing superseded records.
• partitionuses · A partition is a distinct subdivision of a larger data, storage, or work unit that can be stored, managed, or processed separately.
• primary keypart of · A primary key is a designated column or attribute, or combination of them, that uniquely identifies each row or item in a table or data store.
• dataset splitconfigures · A dataset split is the division of a dataset into distinct subsets assigned different purposes, such as training, validation, or testing.

This explainer was generated by Manning's knowledge graph from the text of Akka in Action, Second Edition. The section links point to the parts of the book it draws on.