.alter-merge cluster policy request_classification command

Applies to: ✅ Microsoft FabricAzure Data Explorer

Enables or disables the cluster's request classification policy.

Enables or disables the eventhouse's request classification policy.

Permissions

You must have Cluster AllDatabasesAdmin permissions to run this command.

Note

The admin role inherits Cluster AllDatabasesAdmin permissions.

Syntax

.alter-merge cluster policy request_classification '{"IsEnabled": [true|false] }

Learn more about syntax conventions.

Returns

The command returns one row showing the details of the cluster request classification policy.

The command returns one row showing the details of the eventhouse request classification policy.

Following is the schema of the output returned:

Name Type Description
PolicyName string Name of the policy. For cluster request classification policy this value is ClusterRequestClassificationPolicy.
EntityName string Name of the entity for which the policy is set. For cluster request classification policy this value is an empty string.
Policy string JSON representation of the policy object.
ChildEntities string Child entities for which this policy is set. For cluster request classification policy this value is an empty string.
EntityType string Type of entity for which this policy is set. For cluster request classification policy this value is an empty string.
Name Type Description
PolicyName string Name of the policy. For eventhouse request classification policy this value is ClusterRequestClassificationPolicy.
EntityName string Name of the entity for which the policy is set. For eventhouse request classification policy this value is an empty string.
Policy string JSON representation of the policy object.
ChildEntities string Child entities for which this policy is set. For eventhouse request classification policy this value is an empty string.
EntityType string Type of entity for which this policy is set. For eventhouse request classification policy this value is an empty string.

Examples

Enable the policy

Enable request classification policy for the cluster:

Enable request classification policy for the eventhouse:

.alter-merge cluster policy request_classification '{"IsEnabled":true}'

Output

PolicyName EntityName Policy ChildEntities EntityType
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query","Ad-hoc queries","default")"}

Disable the policy

Disable request classification policy for the cluster:

Disable request classification policy for the eventhouse:

.alter-merge cluster policy request_classification '{"IsEnabled":false}'

Output

PolicyName EntityName Policy ChildEntities EntityType
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": false, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query","Ad-hoc queries","default")"}