Partilhar via

Adicionar principais de cluster para o Azure Data Explorer

  • Artigo

O Azure Data Explorer é um serviço de exploração de dados rápido e altamente dimensionável para dados telemétricos e de registo. Neste artigo, irá aprender a adicionar principais de cluster para o Azure Data Explorer através de C#, Python ou um modelo do Azure Resource Manager (ARM).

Para obter exemplos de código com base em versões anteriores do SDK, veja o artigo arquivado.

Pré-requisitos

Os pré-requisitos variam com base no método utilizado para adicionar o principal. Selecione o separador relevante para o seu método preferido.

A lista seguinte descreve os pré-requisitos para adicionar um principal de cluster com C#.

Adicionar um principal de cluster

Execute o seguinte código para adicionar um principal de cluster:

var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
var clientSecret = "PlaceholderClientSecret"; //Client Secret
var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var credentials = new ClientSecretCredential(tenantId, clientId, clientSecret);
var resourceManagementClient = new ArmClient(credentials, subscriptionId);
var resourceGroupName = "testrg";
//The cluster that is created as part of the Prerequisites
var clusterName = "mykustocluster";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
var cluster = (await resourceGroup.GetKustoClusterAsync(clusterName)).Value;
var clusterPrincipalAssignments = cluster.GetKustoClusterPrincipalAssignments(); 
var clusterPrincipalAssignmentName = "mykustoclusterprincipalassignment";
var principalId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //User email, application ID, or security group name
var role = KustoClusterPrincipalRole.AllDatabasesAdmin; //AllDatabasesAdmin or AllDatabasesViewer
var tenantIdForPrincipal = new Guid("xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx");
var principalType = KustoPrincipalAssignmentType.App; //User, App, or Group
var clusterPrincipalAssignmentData = new KustoClusterPrincipalAssignmentData
{
    ClusterPrincipalId = principalId, Role = role, PrincipalType = principalType, TenantId = tenantIdForPrincipal
};
await clusterPrincipalAssignments.CreateOrUpdateAsync(
    WaitUntil.Completed, clusterPrincipalAssignmentName, clusterPrincipalAssignmentData
);
Definição Valor sugerido Descrição do campo
tenantId xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx O ID do inquilino. Também conhecido como ID de diretório.
subscriptionId xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx O ID de subscrição que utiliza para a criação de recursos.
clientId xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx O ID de cliente da aplicação que pode aceder aos recursos no seu inquilino.
clientSecret PlaceholderClientSecret O segredo do cliente da aplicação que pode aceder aos recursos no seu inquilino.
resourceGroupName testrg O nome do grupo de recursos que contém o cluster.
clusterName mykustocluster O nome do cluster.
clusterPrincipalAssignmentName mykustoclusterprincipalassignment O nome do recurso principal do cluster.
principalId xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx O ID principal, que pode ser o e-mail do utilizador, o ID da aplicação ou o nome do grupo de segurança.
role AllDatabasesAdmin A função do principal de cluster, que pode ser "AllDatabasesAdmin", "AllDatabasesMonitor" ou "AllDatabasesViewer".
tenantIdForPrincipal xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx O ID de inquilino do principal.
principalType Aplicação O tipo de principal, que pode ser "Utilizador", "Aplicação" ou "Grupo"

Conteúdo relacionado