Adatbázisnevek 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á adatbázisneveket az Azure Data Explorer-hez C#, Python vagy Azure Resource Manager (ARM) sablon használatával.

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.
• Telepítse az Azure.Identity NuGet-csomagot 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.

Adatbázisnév hozzáadása

C#

Futtassa a következő kódot egy adatbázisné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 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
);

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.
databaseName	mykustodatabase	Az adatbázis neve.
databasePrincipalAssignmentName	mykustodatabaseprincipalassignment	Az egyszerű adatbázis-erőforrás 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	Felügyelet	Az adatbázisnév szerepköre, amely lehet "Rendszergazda", "Ingestor", "Monitor", "User", "UnrestrictedViewers", "Viewer".
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

Az alábbi példa bemutatja, hogyan adhat hozzá egyszerű adatbázist programozott módon.

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

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.
database_name	mykustodatabase	Az adatbázis neve.
principal_assignment_name	databasePrincipalAssignment1	Az egyszerű adatbázis-erőforrás 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	Felügyelet	Az adatbázisnév szerepköre, amely lehet "Rendszergazda", "Ingestor", "Monitor", "User", "UnrestrictedViewers", "Viewer".
tenant_id_for_principal	xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx	A rendszerbiztonsági tag bérlőazonosítója.
principal_type	Alkalmazás	A rendszerbiztonsági tag típusa, amely lehet "Felhasználó", "Alkalmazás" vagy "Csoport"

ARM-sablon

Az alábbi példa egy Azure Resource Manager-sablont mutat be az adatbázisné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": {
		"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')]"
            }
        }
    ]
}

Kapcsolódó tartalom

• Fürtnevek hozzáadása