Partilhar via


Comando de request_classification de Diretiva de Cluster .alter

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Altera a política de classificação de solicitações do cluster.

Altera a política de classificação de solicitações da Eventhouse.

Permissões

Você deve ter Cluster AllDatabasesAdmin permissões para executar esse comando.

Observação

A função admin herda Cluster AllDatabasesAdmin permissões.

Sintaxe

.alter cluster policy request_classification SerializedPartialPolicy<|ClassificationFunctionBody

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
SerializedPartialPolicy string ✔️ Defina uma política JSON serializada. Para obter as propriedades da política, consulte política de classificação de solicitação.
ClassificationFunctionBody string ✔️ O corpo da função a ser usada para classificar solicitações.

Devoluções

O comando retorna uma linha mostrando os detalhes da política de classificação de solicitação de cluster.

O comando retorna uma linha mostrando os detalhes da política de classificação de solicitação do Eventhouse.

A seguir está o esquema da saída retornada:

Designação Tipo Descrição
Nome da Política string Nome da política. Para a política de classificação de solicitação de cluster, esse valor é ClusterRequestClassificationPolicy.
EntityName string Nome da entidade para a qual a política está definida. Para a política de classificação de solicitação de cluster, esse valor é uma cadeia de caracteres vazia.
Política string Representação JSON do objeto de política.
Entidades-criança string Entidades filhas para as quais esta política está definida. Para a política de classificação de solicitação de cluster, esse valor é uma cadeia de caracteres vazia.
Tipo de entidade string Tipo de entidade para a qual esta política está definida. Para a política de classificação de solicitação de cluster, esse valor é uma cadeia de caracteres vazia.
Designação Tipo Descrição
Nome da Política string Nome da política. Para a política de classificação de solicitação do Eventhouse, esse valor é ClusterRequestClassificationPolicy.
EntityName string Nome da entidade para a qual a política está definida. Para a política de classificação de solicitação da Eventhouse, esse valor é uma cadeia de caracteres vazia.
Política string Representação JSON do objeto de política.
Entidades-criança string Entidades filhas para as quais esta política está definida. Para a política de classificação de solicitação da Eventhouse, esse valor é uma cadeia de caracteres vazia.
Tipo de entidade string Tipo de entidade para a qual esta política está definida. Para a política de classificação de solicitação da Eventhouse, esse valor é uma cadeia de caracteres vazia.

Exemplos

Definir uma política com vários grupos de carga de trabalho

Defina uma política que, com base na avaliação de várias condições, atribua o usuário a um entre muitos grupos de carga de trabalho diferentes ou por padrão:

.alter cluster policy request_classification '{"IsEnabled":true}' <|
    case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), "First workload group",
         request_properties.current_database == "MyDatabase" and request_properties.current_principal has 'aadapp=', "Second workload group",
         request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query", "Third workload group",
         request_properties.current_application == "KustoQueryRunner", "Fourth workload group",
         request_properties.request_description == "this is a test", "Fifth workload group",
         hourofday(now()) between (17 .. 23), "Sixth workload group",
         "default")

Output

Nome da Política EntityName Política Entidades-criança Tipo de entidade
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_database", "request_description", "current_application", "current_principal", "request_type"], "IsEnabled": true, "ClassificationFunction": "case(current_principal_is_member_of('aadgroup=somesecuritygroup@contoso.com'), "First workload group", request_properties.current_database == "MyDatabase" e request_properties.current_principal tem 'aadapp=', "Second workload group", request_properties.current_application == "Kusto.Explorer" e request_ properties.request_type == "Query", "Third workload group", request_properties.current_application == "KustoQueryRunner", "Fourth workload group", request_properties.request_description == "this is a test", "Fifth workload group", hourofday(now()) between (17 .. 23), "Sixth workload group", "default")"}

Definir uma política com um único grupo de carga de trabalho

Defina uma política que, com base na avaliação de uma condição composta, atribua o usuário a um grupo de carga de trabalho personalizado ou padrão:

.alter cluster policy request_classification '{"IsEnabled":true}' <|
    iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query",
        "Ad-hoc queries",
        "default")

Output

Nome da Política EntityName Política Entidades-criança Tipo de entidade
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" e request_properties.request_type == "Query","Ad-hoc queries","default")"}