Tambahkan prinsipal database untuk Azure Data Explorer

Azure Data Explorer adalah layanan eksplorasi data yang cepat dan sangat dapat diskalakan untuk data log dan telemetri. Dalam artikel ini, Anda akan mempelajari cara menambahkan prinsipal database untuk Azure Data Explorer dengan menggunakan templat C#, Python, atau Azure Resource Manager (ARM).

Prasyarat

Prasyarat bervariasi berdasarkan metode yang digunakan untuk menambahkan prinsipal. Pilih tab yang relevan untuk metode pilihan Anda.

C#

Daftar berikut menguraikan prasyarat untuk menambahkan prinsip kluster dengan C#.

• Akun Microsoft atau identitas pengguna Microsoft Entra. Langganan Azure tidak diperlukan.
• Kluster dan database Azure Data Explorer. Membuat kluster dan database.
• Visual Studio 2022 Community Edition. Aktifkan pengembangan Azure selama penyiapan Visual Studio.
• Aplikasi Microsoft Entra dan prinsipal layanan yang dapat mengakses sumber daya. Simpan ID Direktori (penyewa),ID Aplikasi, dan Rahasia Klien.
• Instal Azure.ResourceManager.Kusto.
• Instal paket Azure.Identity NuGet untuk autentikasi.

Python

Daftar berikut menguraikan prasyarat untuk menambahkan prinsip kluster dengan Python.

• Akun Microsoft atau identitas pengguna Microsoft Entra. Langganan Azure tidak diperlukan.
• Kluster dan database Azure Data Explorer. Membuat kluster dan database.
• Aplikasi Microsoft Entra dan prinsipal layanan yang dapat mengakses sumber daya. Simpan ID Direktori (penyewa),ID Aplikasi, dan Rahasia Klien.
• Instal paket azure-common dan azure-mgmt-kusto .

ARM

Daftar berikut menguraikan prasyarat untuk menambahkan prinsip kluster dengan templat ARM.

• Sebuah langganan Azure. Membuat akun Azure gratis.
• Kluster dan database Azure Data Explorer. Membuat kluster dan database.

Menambahkan prinsipal database

C#

Jalankan kode berikut untuk menambahkan entitas database:

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
);

Pengaturan	Nilai yang disarankan	Deskripsi bidang
tenantId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID penyewa Anda. Juga dikenal sebagai ID direktori.
subscriptionId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID langganan yang Anda gunakan untuk pembuatan sumber daya.
clientId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID klien aplikasi yang dapat mengakses sumber daya di penyewa Anda.
clientSecret	PlaceholderClientSecret	Rahasia klien dari aplikasi yang dapat mengakses sumber daya di dalam tenant Anda.
resourceGroupName	testrg	Nama grup sumber daya yang berisi kluster Anda.
Nama Kluster	mykustocluster	Nama kluster Anda.
databaseNama	mykustodatabase	Nama database Anda.
Nama Penugasan Utama Database	penugasanprinsipalDatabaseMyKusto	Nama sumber daya utama database Anda.
principalId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID utama, yang dapat berupa email pengguna, ID aplikasi, atau nama grup keamanan.
peran	Admin	Peran prinsipal database Anda, yang dapat berupa 'Admin', 'Ingestor', 'Monitor', 'User', 'UnrestrictedViewers', 'Viewer'.
tenantIdForPrincipal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID penyewa dari prinsipal.
jenisUtama	App	Jenis prinsipal, yang dapat berupa 'Pengguna', 'Aplikasi', atau 'Grup'

Python

Contoh berikut menunjukkan kepada Anda cara menambahkan prinsipal database secara terprogram.

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))

Pengaturan	Nilai yang disarankan	Deskripsi bidang
ID Penyewa	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID penyewa Anda. Juga dikenal sebagai ID direktori.
subscription_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID langganan yang Anda gunakan untuk pembuatan sumber daya.
ID klien	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID klien aplikasi yang dapat mengakses sumber daya di penyewa Anda.
client_secret (kunci rahasia klien)	xxxxxxxxxxxxxxxx	Rahasia klien dari aplikasi yang dapat mengakses sumber daya di dalam tenant Anda.
nama_kelompok_sumber_daya	testrg	Nama grup sumber daya yang berisi kluster Anda.
nama_kluster	mykustocluster	Nama kluster Anda.
nama_basis_data	mykustodatabase	Nama database Anda.
nama_penugasan_utama	databasePrincipalAssignment1	Nama sumber daya utama database Anda.
principal_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID utama, yang dapat berupa email pengguna, ID aplikasi, atau nama grup keamanan.
peran	Admin	Peran prinsipal database Anda, yang dapat berupa 'Admin', 'Ingestor', 'Monitor', 'User', 'UnrestrictedViewers', 'Viewer'.
ID_penyewa_untuk_prinsipal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxx	ID penyewa dari entitas utama.
principal_type	App	Jenis prinsipal, yang dapat berupa 'Pengguna', 'Aplikasi', atau 'Grup'

Templat ARM

Contoh berikut menunjukkan templat Azure Resource Manager untuk menambahkan prinsipal database. Anda dapat mengedit dan menyebarkan templat di portal Microsoft Azure dengan menggunakan formulir.

{
    "$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')]"
            }
        }
    ]
}

Konten terkait

• Menambahkan prinsip kluster