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.
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.
Fürtnév hozzáadása
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" |