Azure Veri Gezgini için veritabanı sorumluları ekleme

Azure Veri Gezgini, günlük ve telemetri verileri için hızlı ve yüksek oranda ölçeklenebilir veri keşfetme hizmetidir. Bu makalede C#, Python veya Azure Resource Manager (ARM) şablonu kullanarak Azure Veri Gezgini için veritabanı sorumluları eklemeyi öğreneceksiniz.

Önkoşullar

Önkoşullar, sorumluyu eklemek için kullanılan yönteme göre değişir. Tercih ettiğiniz yöntem için ilgili sekmeyi seçin.

C#

Aşağıdaki listede C# ile küme sorumlusu ekleme önkoşulları özetlenmiştir.

• Microsoft hesabı veya Microsoft Entra kullanıcı kimliği. Azure aboneliği gerekmez.
• Azure Veri Gezgini kümesi ve veritabanı. Küme ve veritabanı oluşturma.
• Visual Studio 2022 Community Edition. Visual Studio kurulumu sırasında Azure geliştirmeyi açın.
• Kaynaklara erişebilen bir Microsoft Entra Uygulaması ve hizmet sorumlusu. Dizin (kiracı) Kimliği, Uygulama Kimliği ve İstemci Gizli Anahtarı'nı kaydedin.
• Azure.ResourceManager.Kusto'u yükleyin.
• Kimlik doğrulaması için Azure.Identity NuGet paketini yükleyin.

Python

Aşağıdaki listede Python ile küme sorumlusu ekleme önkoşulları özetlenmiştir.

• Microsoft hesabı veya Microsoft Entra kullanıcı kimliği. Azure aboneliği gerekmez.
• Azure Veri Gezgini kümesi ve veritabanı. Küme ve veritabanı oluşturma.
• Kaynaklara erişebilen bir Microsoft Entra Uygulaması ve hizmet sorumlusu. Dizin (kiracı) Kimliği, Uygulama Kimliği ve İstemci Gizli Anahtarı'nı kaydedin.
• azure-common ve azure-mgmt-kusto paketlerini yükleyin.

ARM

Aşağıdaki listede ARM şablonuyla küme sorumlusu ekleme önkoşulları özetlenmiştir.

• Bir Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
• Azure Veri Gezgini kümesi ve veritabanı. Küme ve veritabanı oluşturma.

Veritabanı sorumlusu ekleme

C#

Veritabanı sorumlusu eklemek için aşağıdaki kodu çalıştırın:

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 databaseName = "mykustodatabase";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
var cluster = (await resourceGroup.GetKustoClusterAsync(clusterName)).Value;
var database = (await cluster.GetKustoDatabaseAsync(databaseName)).Value;
var databasePrincipalAssignments = database.GetKustoDatabasePrincipalAssignments();
var databasePrincipalAssignmentName = "mykustodatabaseprincipalassignment";
var principalId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //User email, application ID, or security group name
var role = KustoDatabasePrincipalRole.Admin; //Admin, Ingestor, Monitor, User, UnrestrictedViewers, Viewer
var tenantIdForPrincipal = new Guid("xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx");
var principalType = KustoPrincipalAssignmentType.App; //User, App, or Group
var databasePrincipalAssignmentData = new KustoDatabasePrincipalAssignmentData
{
    DatabasePrincipalId = principalId, Role = role, PrincipalType = principalType, TenantId = tenantIdForPrincipal
};
await databasePrincipalAssignments.CreateOrUpdateAsync(
    WaitUntil.Completed, databasePrincipalAssignmentName, databasePrincipalAssignmentData
);

Setting	Önerilen değer	Alan açıklaması
tenantId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kiracı kimliğiniz. Dizin kimliği olarak da bilinir.
subscriptionId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kaynak oluşturmak için kullandığınız abonelik kimliği.
clientId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kiracınızdaki kaynaklara erişebilen uygulamanın istemci kimliği.
clientSecret	PlaceholderClientSecret	Kiracınızdaki kaynaklara erişebilen uygulamanın istemci sırrı.
resourceGroupName	testrg	Kümenizi içeren kaynak grubunun adı.
kümeAdı	mykustocluster	Kümenizin adı.
databaseName	mykustodatabase	Veritabanınızın adı.
VeritabanıBaşvuruAtamaAdı	mykustodatabaseprincipalassignment	Veritabanı asıl kaynağınızın adı.
principalId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kullanıcı e-postası, uygulama kimliği veya güvenlik grubu adı olabilecek asıl kimlik.
role	Yönetici	Veritabanı kullanıcınızın rolü, 'Admin', 'Ingestor', 'Monitor', 'User', 'UnrestrictedViewers' veya 'Viewer' olabilir.
tenantIdForPrincipal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Sorumlunun kiracı kimliği.
principalTürü	Uygulama	'Kullanıcı', 'Uygulama' veya 'Grup' olabilecek asıl unsurun türü

Python

Aşağıdaki örnekte, program aracılığıyla veritabanı sorumlusu ekleme adımları gösterilmektedir.

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import DatabasePrincipalAssignment
from azure.common.credentials import ServicePrincipalCredentials

#Directory (tenant) ID
tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Application ID
client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Client Secret
client_secret = "xxxxxxxxxxxxxx"
subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
credentials = ServicePrincipalCredentials(
        client_id=client_id,
        secret=client_secret,
        tenant=tenant_id
    )
kusto_management_client = KustoManagementClient(credentials, subscription_id)

resource_group_name = "testrg"
#The cluster and database that is created as part of the Prerequisites
cluster_name = "mykustocluster"
database_name = "mykustodatabase"
principal_assignment_name = "clusterPrincipalAssignment1"
#User email, application ID, or security group name
principal_id = "xxxxxxxx"
#AllDatabasesAdmin, AllDatabasesMonitor or AllDatabasesViewer
role = "AllDatabasesAdmin"
tenant_id_for_principal = tenantId
#User, App, or Group
principal_type = "App"

#Returns an instance of LROPoller, check https://learn.microsoft.com/python/api/msrest/msrest.polling.lropoller?view=azure-python
poller = kusto_management_client.database_principal_assignments.create_or_update(resource_group_name=resource_group_name, cluster_name=cluster_name, database_name=database_name, principal_assignment_name= principal_assignment_name, parameters=DatabasePrincipalAssignment(principal_id=principal_id, role=role, tenant_id=tenant_id_for_principal, principal_type=principal_type))

Setting	Önerilen değer	Alan açıklaması
kiracı_kimlik_numarası	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kiracı kimliğiniz. Dizin kimliği olarak da bilinir.
subscription_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kaynak oluşturmak için kullandığınız abonelik kimliği.
client_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kiracınızdaki kaynaklara erişebilen uygulamanın istemci kimliği.
client_secret	xxxxxxxxxxx	Kiracınızdaki kaynaklara erişebilen uygulamanın istemci sırrı.
kaynak_grubu_adı	testrg	Kümenizi içeren kaynak grubunun adı.
küme_adı	mykustocluster	Kümenizin adı.
veritabanı_adı	mykustodatabase	Veritabanınızın adı.
temel_atama_adı	databasePrincipalAssignment1	Veritabanı asıl kaynağınızın adı.
principal_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Kullanıcı e-postası, uygulama kimliği veya güvenlik grubu adı olabilecek asıl kimlik.
role	Yönetici	'Admin', 'Ingestor', 'Monitor', 'User', 'UnrestrictedViewers', 'Viewer' olabilecek veritabanı sorumlunuzun rolü.
Ana_kirala_id_principal_için	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxxx	Sorumlunun kiracı kimliği.
principal_type	Uygulama	Prensibin türü, 'Kullanıcı', 'Uygulama' veya 'Grup' olabilir.

Aşağıdaki örnekte veritabanı sorumlusu eklemeye yönelik bir Azure Resource Manager şablonu gösterilmektedir. Formu kullanarak şablonu Azure portalında düzenleyebilir ve dağıtabilirsiniz.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
		"principalAssignmentName": {
            "type": "string",
            "defaultValue": "principalAssignment1",
            "metadata": {
                "description": "Specifies the name of the principal assignment"
            }
        },
        "clusterName": {
            "type": "string",
            "defaultValue": "mykustocluster",
            "metadata": {
                "description": "Specifies the name of the cluster"
            }
        },
		"databaseName": {
            "type": "string",
            "defaultValue": "mykustodatabase",
            "metadata": {
                "description": "Specifies the name of the database"
            }
        },
		"principalIdForDatabase": {
            "type": "string",
            "metadata": {
                "description": "Specifies the principal id. It can be user email, application (client) ID, security group name"
            }
        },
		"roleForDatabasePrincipal": {
            "type": "string",
			"defaultValue": "Admin",
            "metadata": {
                "description": "Specifies the database principal role. It can be 'Admin', 'Ingestor', 'Monitor', 'User', 'UnrestrictedViewers', 'Viewer'"
            }
        },
		"tenantIdForDatabasePrincipal": {
            "type": "string",
            "metadata": {
                "description": "Specifies the tenantId of the database principal"
            }
        },
		"principalTypeForDatabase": {
            "type": "string",
			"defaultValue": "App",
            "metadata": {
                "description": "Specifies the principal type. It can be 'User', 'App', 'Group'"
            }
        }
    },
    "variables": {
    },
    "resources": [{
            "type": "Microsoft.Kusto/Clusters/Databases/principalAssignments",
            "apiVersion": "2019-11-09",
            "name": "[concat(parameters('clusterName'), '/', parameters('databaseName'), '/', parameters('principalAssignmentName'))]",
            "properties": {
                "principalId": "[parameters('principalIdForDatabase')]",
                "role": "[parameters('roleForDatabasePrincipal')]",
				"tenantId": "[parameters('tenantIdForDatabasePrincipal')]",
				"principalType": "[parameters('principalTypeForDatabase')]"
            }
        }
    ]
}

İlgili içerik

• Küme sorumluları ekleme