Fürtnevek hozzáadása az Azure Data Explorer

Az Azure Adatkezelő egy gyors és hatékonyan skálázható adatáttekintési szolgáltatás napló- és telemetriaadatokhoz. Ebből a cikkből megtudhatja, hogyan adhat hozzá fürtneveket az Azure Data Explorer-hez C#, Python vagy Azure Resource Manager (ARM) sablon használatával.

A korábbi SDK-verziókon alapuló kódmintákért tekintse meg az archivált cikket.

Előfeltételek

Az előfeltételek a rendszerbiztonsági tag hozzáadásához használt módszertől függően változnak. Válassza ki az előnyben részesített metódus megfelelő lapját.

C#

Az alábbi lista ismerteti a fürtnév C# nyelven történő hozzáadásának előfeltételeit.

• Microsoft-fiók vagy Microsoft Entra felhasználói identitás. Nincs szükség Azure-előfizetésre.
• Egy Azure-Data Explorer-fürt és -adatbázis. Hozzon létre egy fürtöt és egy adatbázist.
• Visual Studio 2022 Community Edition. Kapcsolja be az Azure-fejlesztést a Visual Studio beállítása során.
• Egy Microsoft Entra alkalmazás és szolgáltatásnév, amely hozzáfér az erőforrásokhoz. Mentse a címtár (bérlő) azonosítóját, az alkalmazásazonosítót és az ügyfélkulcsot.
• Telepítse az Azure.ResourceManager.Kusto eszközt.
• Az Azure.Identity telepítése hitelesítéshez.

Python

Az alábbi lista a fürtnév Pythonnal való hozzáadásának előfeltételeit ismerteti.

• Microsoft-fiók vagy Microsoft Entra felhasználói identitás. Nincs szükség Azure-előfizetésre.
• Egy Azure-Data Explorer-fürt és -adatbázis. Hozzon létre egy fürtöt és egy adatbázist.
• Egy Microsoft Entra alkalmazás és szolgáltatásnév, amely hozzáfér az erőforrásokhoz. Mentse a címtár (bérlő) azonosítóját, az alkalmazásazonosítót és az ügyfélkulcsot.
• Telepítse az azure-common és az azure-mgmt-kusto csomagokat.

ARM

Az alábbi lista ismerteti a fürtnév ARM-sablonnal való hozzáadásának előfeltételeit.

• Azure-előfizetés. Hozzon létre egy ingyenes Azure-fiókot.
• Egy Azure-Data Explorer-fürt és -adatbázis. Hozzon létre egy fürtöt és egy adatbázist.

Fürtnév hozzáadása

C#

Futtassa a következő kódot egy fürtnév hozzáadásához:

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

Beállítás	Ajánlott érték	Mező leírása
tenantId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az Ön bérlőazonosítója. Más néven könyvtárazonosító.
subscriptionId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az erőforrás-létrehozáshoz használt előfizetés-azonosító.
ügyfél-azonosító	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Annak az alkalmazásnak az ügyfél-azonosítója, amely hozzáfér a bérlő erőforrásaihoz.
clientSecret	PlaceholderClientSecret	Az alkalmazás titkos ügyfélkódja, amely hozzáfér a bérlő erőforrásaihoz.
resourceGroupName	testrg	A fürtöt tartalmazó erőforráscsoport neve.
clusterName	mykustocluster	A fürt neve.
clusterPrincipalAssignmentName	mykustoclusterprincipalassignment	A fürt egyszerű erőforrásának neve.
principalId	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az egyszerű azonosító, amely lehet felhasználói e-mail-cím, alkalmazásazonosító vagy biztonsági csoport neve.
Szerepet	AllDatabasesAdmin	A fürtnév szerepköre, amely lehet "AllDatabasesAdmin", "AllDatabasesMonitor" vagy "AllDatabasesViewer".
tenantIdForPrincipal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	A rendszerbiztonsági tag bérlőazonosítója.
principalType	Alkalmazás	A rendszerbiztonsági tag típusa, amely lehet "Felhasználó", "Alkalmazás" vagy "Csoport"

Python

Futtassa a következő kódot egy fürtnév hozzáadásához:

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import ClusterPrincipalAssignment
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 that is created as part of the Prerequisites
cluster_name = "mykustocluster"
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.cluster_principal_assignments.create_or_update(resource_group_name=resource_group_name, cluster_name=cluster_name, principal_assignment_name= principal_assignment_name, parameters=ClusterPrincipalAssignment(principal_id=principal_id, role=role, tenant_id=tenant_id_for_principal, principal_type=principal_type))

Beállítás	Ajánlott érték	Mező leírása
tenant_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az Ön bérlőazonosítója. Más néven könyvtárazonosító.
subscription_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az erőforrás-létrehozáshoz használt előfizetés-azonosító.
client_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Annak az alkalmazásnak az ügyfél-azonosítója, amely hozzáfér a bérlő erőforrásaihoz.
client_secret	xxxxxxxxxxxxxx	Az alkalmazás titkos ügyfélkódja, amely hozzáfér a bérlő erőforrásaihoz.
resource_group_name	testrg	A fürtöt tartalmazó erőforráscsoport neve.
cluster_name	mykustocluster	A fürt neve.
principal_assignment_name	clusterPrincipalAssignment1	A fürt egyszerű erőforrásának neve.
principal_id	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	Az egyszerű azonosító, amely lehet felhasználói e-mail-cím, alkalmazásazonosító vagy biztonsági csoport neve.
Szerepet	AllDatabasesAdmin	A fürtnév szerepköre, amely lehet "AllDatabasesAdmin", "AllDatabasesMonitor", vagy "AllDatabasesViewer".
tenant_id_for_principal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	A rendszerbiztonsági tag bérlőazonosítója.
principal_type	Alkalmazás	A rendszernév típusa, amely lehet "Felhasználó", "Alkalmazás" vagy "Csoport"

ARM-sablon

Az alábbi példa egy Azure Resource Manager-sablont mutat be a fürtnév hozzáadásához. A sablont az űrlap használatával szerkesztheti és helyezheti üzembe a Azure Portal.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
		"clusterPrincipalAssignmentName": {
            "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"
            }
        },
		"principalIdForCluster": {
            "type": "string",
            "metadata": {
                "description": "Specifies the principal id. It can be user email, application (client) ID, security group name"
            }
        },
		"roleForClusterPrincipal": {
            "type": "string",
			"defaultValue": "AllDatabasesViewer",
            "metadata": {
                "description": "Specifies the cluster principal role. It can be 'AllDatabasesAdmin', 'AllDatabasesMonitor' or 'AllDatabasesViewer'"
            }
        },
		"tenantIdForClusterPrincipal": {
            "type": "string",
            "metadata": {
                "description": "Specifies the tenantId of the principal"
            }
        },
		"principalTypeForCluster": {
            "type": "string",
			"defaultValue": "User",
            "metadata": {
                "description": "Specifies the principal type. It can be 'User', 'App', 'Group'"
            }
        }
    },
    "variables": {
    },
    "resources": [{
            "type": "Microsoft.Kusto/Clusters/principalAssignments",
            "apiVersion": "2019-11-09",
            "name": "[concat(parameters('clusterName'), '/', parameters('clusterPrincipalAssignmentName'))]",
            "properties": {
                "principalId": "[parameters('principalIdForCluster')]",
                "role": "[parameters('roleForClusterPrincipal')]",
				"tenantId": "[parameters('tenantIdForClusterPrincipal')]",
				"principalType": "[parameters('principalTypeForCluster')]"
            }
        }
    ]
}

Kapcsolódó tartalom

• Adatbázisnevek hozzáadása
• Fürtengedélyek kezelése