.alter-merge table sharding policy

Change the table sharding policy. Use the sharding policy to manage data sharding for databases and tables.

The sharding policy defines if and how Extents (data shards) in the Azure Data Explorer cluster should be sealed. When a database is created, it contains the default data sharding policy. This policy is inherited by all tables created in the database (unless the policy is explicitly overridden at the table level).

Syntax

.alter-merge table TableName policy sharding PolicyObject

Arguments

  • TableName - Specify the name of the database.
  • PolicyObject - Define a policy object, see also sharding policy.

Returns

Returns a JSON representation of the policy.

Example

The following command changes a single property for the sharding policy for a table:

.alter-merge table MyTable policy sharding 
@'{ "MaxExtentSizeInMb": 1024}'