Criar um cluster e uma base de dados do Azure Data Explorer

Artigo
11/20/2023

O Azure Data Explorer é um serviço de análise de dados rápido e totalmente gerido que permite realizar análises em tempo real em volumes grandes de transmissão de dados a partir de aplicações, sites, dispositivos IoT e muito mais. Para utilizar o Azure Data Explorer, primeiro crie um cluster e crie uma ou mais bases de dados nesse cluster. Em seguida, pode ingerir (carregar) dados numa base de dados e executar consultas na mesma.

Neste artigo, irá aprender a criar um cluster e uma base de dados com C#, Python, Go, a CLI do Azure, o PowerShell ou um modelo do Azure Resource Manager (ARM). Para saber como criar um cluster e uma base de dados com o portal do Azure, veja Início Rápido: Criar um cluster e uma base de dados do Azure Data Explorer.

Para exemplos de código baseados em versões anteriores do SDK, veja o artigo arquivado.

Pré-requisitos

Pré-requisitos por método de criação de clusters e bases de dados:

Uma subscrição do Azure. Crie uma conta gratuita do Azure.
Visual Studio 2022 Community Edition. Ative o desenvolvimento do Azure durante a configuração do Visual Studio.
Instale o pacote Microsoft.Azure.Management.Kusto NuGet.
Uma aplicação Microsoft Entra e principal de serviço que pode aceder aos recursos. Guarde o ID do Diretório (inquilino), o ID da Aplicação e o Segredo do Cliente.

Uma subscrição do Azure. Crie uma conta gratuita do Azure.
Pode utilizar o Azure Cloud Shell para executar o código neste artigo sem ter de instalar nada no seu ambiente local.
Se optar por instalar e utilizar a CLI do Azure localmente, siga os passos em Configurar parâmetros. Este artigo requer a versão 2.0.4 ou posterior da CLI do Azure. Execute az --version para verificar a sua versão. Se precisar de instalar ou atualizar, veja Instalar a CLI do Azure.

Configurar os parâmetros da CLI

Os passos seguintes não são necessários se estiver a executar comandos no Azure Cloud Shell. Se estiver a executar a CLI localmente, siga estes passos para configurar o ambiente:

Instale a extensão para utilizar a versão mais recente da CLI do Kusto:
```
az extension add -n kusto
```
Execute o seguinte comando para iniciar sessão no Azure:
```
az login
```
Defina a subscrição onde pretende que o cluster seja criado. Substitua MyAzureSub pelo nome da subscrição do Azure que pretende utilizar:
```
az account set --subscription MyAzureSub
```
Defina o grupo de recursos onde pretende que o cluster seja criado. Substitua testrg pelo nome do grupo de recursos que pretende utilizar:
```
az group create --name testrg --location westus
```

Criar um cluster do Azure Data Explorer

Esta secção orienta-o ao longo do processo de criação de um cluster do Azure Data Explorer. Selecione o separador relevante para o seu método preferencial para criar o cluster.

Crie o cluster com o seguinte código:

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";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(resourceGroupName)).Value;
var clusters = resourceGroup.GetKustoClusters();    
var clusterName = "mykustocluster";
var skuName = KustoSkuName.StandardE8adsV5;
var skuTier = KustoSkuTier.Standard;
var capacity = 5;
var clusterData = new KustoClusterData(
    location: AzureLocation.CentralUS,
    sku: new KustoSku(skuName, skuTier) { Capacity = capacity }
);
await clusters.CreateOrUpdateAsync(WaitUntil.Completed, clusterName, clusterData);

Definição	Valor sugerido	Descrição do campo
clusterName	mykustocluster	O nome pretendido do cluster.
skuName	Standard_E8ads_v5	O SKU que será utilizado para o cluster.
tier	Standard	O escalão SKU.
capacidade	número	O número de instâncias do cluster.
resourceGroupName	testrg	O nome do grupo de recursos onde o cluster será criado.

Nota

Criar um cluster é uma operação de execução prolongada, pelo que é altamente recomendado utilizar CreateOrUpdateAsync, em vez de CreateOrUpdate.

Execute o seguinte comando para verificar se o cluster foi criado com êxito:
```
clusterData = (await clusters.GetAsync(clusterName)).Value.Data;
```
Confirme a criação bem-sucedida do cluster ao verificar se o resultado contém provisioningState como Succeeded.

Crie o cluster com o seguinte comando:

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import Cluster, AzureSku
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
)

location = 'Central US'
sku_name = 'Standard_E8ads_v5'
capacity = 5
tier = "Standard"
resource_group_name = 'testrg'
cluster_name = 'mykustocluster'
cluster = Cluster(location=location, sku=AzureSku(name=sku_name, capacity=capacity, tier=tier))

kusto_management_client = KustoManagementClient(credentials, subscription_id)

cluster_operations = kusto_management_client.clusters

poller = cluster_operations.begin_create_or_update(resource_group_name, cluster_name, cluster)
poller.wait()

Definição	Valor sugerido	Descrição do campo
cluster_name	mykustocluster	O nome pretendido do cluster.
sku_name	Standard_E8ads_v5	O SKU que será utilizado para o cluster.
tier	Standard	O escalão de SKU.
capacidade	número	O número de instâncias do cluster.
resource_group_name	testrg	O nome do grupo de recursos onde o cluster será criado.

Nota

Criar um cluster é uma operação de execução prolongada. Método begin_create_or_update devolve uma instância do LROPoller, veja LROPoller class (Classe LROPoller ) para obter mais informações.

Execute o seguinte comando para verificar se o cluster foi criado com êxito:

cluster_operations.get(resource_group_name = resource_group_name, cluster_name= cluster_name, custom_headers=None, raw=False)

Confirme a criação bem-sucedida do cluster ao verificar se o resultado contém provisioningState como Succeeded.

O código seguinte mostra como criar um cluster. Para clonar o repositório de código, veja Manage an Azure Data Explorer cluster using Azure Go SDK (Gerir um cluster do Azure Data Explorer com o SDK do Azure Go).

Defina as variáveis de ambiente necessárias, incluindo as informações do principal de serviço dos pré-requisitos. Introduza o ID da subscrição, o grupo de recursos e a região onde pretende criar o cluster.

export AZURE_CLIENT_ID="<enter service principal client ID>"
export AZURE_CLIENT_SECRET="<enter service principal client secret>"
export AZURE_TENANT_ID="<enter tenant ID>"

export SUBSCRIPTION="<enter subscription ID>"
export RESOURCE_GROUP="<enter resource group name>"
export LOCATION="<enter azure location e.g. Southeast Asia>"

export CLUSTER_NAME_PREFIX="<enter prefix (cluster name will be [prefix]-ADXTestCluster)>"
export DATABASE_NAME_PREFIX="<enter prefix (database name will be [prefix]-ADXTestDB)>"

Dica

Utilize autenticação. NewAuthorizerFromCLIWithResource se tiver a CLI do Azure instalada e configurada para autenticação. Nessa situação, não precisa de criar um principal de serviço.

Execute o seguinte código para criar o cluster:

import (
 "context"
 "log"
 "os"
 "strconv"

 "github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
 "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
 "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/kusto/armkusto"
 "github.com/olekukonko/tablewriter"
)

const (
 subscriptionEnvVar      = "AZURE_SUBSCRIPTION_ID"
 resourceGroupEnvVar     = "AZURE_RESOURCE_GROUP"
 locationEnvVar          = "AZURE_LOCATION"
 clusterNamePrefixEnvVar = "CLUSTER_NAME_PREFIX"
 dbNamePrefixEnvVar      = "DATABASE_NAME_PREFIX"

 clusterName  = "ADXTestCluster"
 databaseName = "ADXTestDB"
)

func init() {
 subscription = os.Getenv(subscriptionEnvVar)
 if subscription == "" {
  log.Fatalf("missing environment variable %s", subscriptionEnvVar)
 }

 rgName = os.Getenv(resourceGroupEnvVar)
 if rgName == "" {
  log.Fatalf("missing environment variable %s", resourceGroupEnvVar)
 }

 location = os.Getenv(locationEnvVar)
 if location == "" {
  log.Fatalf("missing environment variable %s", locationEnvVar)
 }

 clusterNamePrefix = os.Getenv(clusterNamePrefixEnvVar)
 if clusterNamePrefix == "" {
  log.Fatalf("missing environment variable %s", clusterNamePrefixEnvVar)
 }

 dbNamePrefix = os.Getenv(dbNamePrefixEnvVar)
 if dbNamePrefix == "" {
  log.Fatalf("missing environment variable %s", dbNamePrefixEnvVar)
 }
}

func getClustersClient(subscription string) *armkusto.ClustersClient {
 cred, err := azidentity.NewDefaultAzureCredential(nil)
 if err != nil {
  log.Fatal(err)
 }

 client, err := armkusto.NewClustersClient(subscription, cred, nil)
 if err != nil {
  log.Fatal(err)
 }

 return client
}

// 1 instance, Basic tier with compute type Dev(No SLA)_Standard_D11_v2
func createCluster(sub, name, location, rgName string) {
 ctx := context.Background()

 numInstances := int32(1)
 client := getClustersClient(sub)
 result, err := client.BeginCreateOrUpdate(
  ctx,
  rgName,
  name,
  armkusto.Cluster{
   Location: &location,
   SKU: &armkusto.AzureSKU{
    Name:     to.Ptr(armkusto.AzureSKUNameDevNoSLAStandardD11V2),
    Capacity: &numInstances,
    Tier:     to.Ptr(armkusto.AzureSKUTierBasic),
   },
  },
  nil,
 )
 if err != nil {
  log.Fatal("failed to start cluster creation ", err)
 }

 log.Printf("waiting for cluster creation to complete - %s\n", name)
 r, err := result.PollUntilDone(ctx, nil)
 if err != nil {
  log.Fatal(err)
 }

 log.Printf("created cluster %s\n", *r.Name)
}

createCluster(subscription, clusterNamePrefix+clusterName, location, rgName)

Liste os clusters para garantir a criação com êxito:

func listClusters(sub, rgName string) {
 log.Printf("listing clusters in resource group %s\n", rgName)
 ctx := context.Background()

 result := getClustersClient(sub).NewListByResourceGroupPager(rgName, nil)

 data := [][]string{}

 for result.More() {
  temp, err := result.NextPage(ctx)
  if err != nil {
   log.Fatal(err)
  }
  for _, c := range temp.Value {
   data = append(data, []string{*c.Name, string(*c.Properties.State), *c.Location, strconv.Itoa(int(*c.SKU.Capacity)), *c.Properties.URI})
  }
 }

 table := tablewriter.NewWriter(os.Stdout)
 table.SetHeader([]string{"Name", "State", "Location", "Instances", "URI"})

 for _, v := range data {
  table.Append(v)
 }
 table.Render()
}

listClusters(subscription, rgName)

Crie o cluster com o seguinte comando:

az kusto cluster create --cluster-name azureclitest --sku name="Standard_E8ads_v5" tier="Standard" --resource-group testrg --location westus

Definição	Valor sugerido	Descrição do campo
name	azureclitest	O nome pretendido do cluster.
sku	Standard_E8ads_v5	O SKU que será utilizado para o cluster. Parâmetros: name - O nome do SKU. tier - O escalão SKU.
resource-group	testrg	O nome do grupo de recursos onde o cluster será criado.
localização	westus	A localização onde o cluster será criado.

Existem outros parâmetros opcionais que pode utilizar, como a capacidade do cluster.

Execute o seguinte comando para verificar se o cluster foi criado com êxito:
```
az kusto cluster show --cluster-name azureclitest --resource-group testrg
```
Confirme a criação bem-sucedida do cluster ao verificar se o resultado contém provisioningState como Succeeded.

Crie o cluster com o seguinte comando:

 New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_E8ads_v5'

Definição	Valor sugerido	Descrição do campo
Name	mykustocluster	O nome pretendido do cluster.
Sku	Standard_E8ads_v5	O SKU que será utilizado para o cluster.
ResourceGroupName	testrg	O nome do grupo de recursos onde o cluster será criado.

Existem outros parâmetros opcionais que pode utilizar, como a capacidade do cluster.

Execute o seguinte comando para verificar se o cluster foi criado com êxito:
```
Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
```
Confirme a criação bem-sucedida do cluster ao verificar se o resultado contém provisioningState como Succeeded.

Para saber como implementar o seguinte modelo do ARM com o PowerShell, veja Utilizar o modelo do ARM. Em alternativa, pode implementar o modelo no portal do Azure ao selecionar Implementar no Azure.

Modelo ARM

Pode utilizar este modelo para as suas próprias implementações ou personalizá-lo para satisfazer as suas necessidades. Para a sintaxe JSON e as propriedades a utilizar num modelo, veja Tipos de recursos Microsoft.Kusto.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "[concat('kusto', uniqueString(resourceGroup().id))]",
            "metadata": {
                "description": "Name of the cluster to create"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Name of the database to create"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('clusters_kustocluster_name')]",
            "type": "Microsoft.Kusto/clusters",
            "sku": {
                "name": "Standard_E8ads_v5",
                "tier": "Standard",
                "capacity": 2
            },
            "apiVersion": "2022-12-29",
            "location": "[parameters('location')]",
            "tags": {
                "Created By": "GitHub quickstart template"
            },
            "properties": {
                "trustedExternalTenants": [],
                "optimizedAutoscale": {
                    "version": 1,
                    "isEnabled": true,
                    "minimum": 2,
                    "maximum": 10
                },
                "enableDiskEncryption": false,
                "enableStreamingIngest": false,
                "virtualNetworkConfiguration": {
                    "subnetId": "<subnet resource id>",
                    "enginePublicIpId": "<Engine service's public IP address resource id>",
                    "dataManagementPublicIpId": "<Data management's service public IP address resource id>"
                },
                "keyVaultProperties": {
                    "keyName": "<Key name>",
                    "keyVaultUri": "<Key vault uri>",
                    "userIdentity": "<ResourceId of user assigned managed identity>"
                },
                "enablePurge": false,
                "enableDoubleEncryption": false,
                "engineType": "V3"
            },
            "identity": {
                "type": "SystemAssigned, UserAssigned",
                "userAssignedIdentities": {
                    "<ResourceId of managed identity>": {}
                }
            }
        },
        {
            "name": "[concat(parameters('clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'))]",
            "type": "Microsoft.Kusto/clusters/databases",
            "apiVersion": "2022-12-29",
            "location": "[parameters('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.Kusto/clusters', parameters('clusters_kustocluster_name'))]"
            ],
            "properties": {
                "softDeletePeriodInDays": 365,
                "hotCachePeriodInDays": 31
            }
        }
    ]
}

Utilizar o modelo do ARM

Os passos seguintes explicam como implementar o modelo do ARM com o PowerShell.

Abra o Azure Cloud Shell e siga as instruções para iniciar sessão.

Selecione Copiar para copiar o script do PowerShell.

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${projectName}rg"
$clusterName = "${projectName}cluster"
$parameters = @{}
$parameters.Add("clusters_kustocluster_name", $clusterName)
$templateUri = "https://azure.microsoft.com/resources/templates/kusto-cluster-database/"
New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -TemplateParameterObject $parameters
Write-Host "Press [ENTER] to continue ..."

Clique com o botão direito do rato na consola da shell e, em seguida, selecione Colar.

Nota

Demora alguns minutos a criar um cluster e uma base de dados do Azure Data Explorer.

Para verificar a implementação, utilize o seguinte script de Azure PowerShell. Se o Cloud Shell ainda estiver aberto, não precisa de copiar/executar a primeira linha (Read-Host).

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"

Install-Module -Name Az.Kusto
$resourceGroupName = "${projectName}rg"
$clusterName = "${projectName}cluster"

Get-AzKustoCluster -ResourceGroupName $resourceGroupName -Name $clusterName
Write-Host "Press [ENTER] to continue ..."

Criar uma base de dados do Azure Data Explorer

Nesta secção, irá criar uma base de dados no cluster criado na secção anterior.

Crie a base de dados com o seguinte código:

var cluster = (await clusters.GetAsync(clusterName)).Value;
var databases = cluster.GetKustoDatabases();
var databaseName = "mykustodatabase";
var softDeletePeriod = TimeSpan.FromDays(3650);
var hotCachePeriod = TimeSpan.FromDays(3650);
var databaseData = new KustoReadWriteDatabase
{
    Location = clusterData.Location, SoftDeletePeriod = softDeletePeriod, HotCachePeriod = hotCachePeriod
};
await databases.CreateOrUpdateAsync(WaitUntil.Completed, databaseName, databaseData);

Nota

Se estiver a utilizar a versão C# 2.0.0 ou inferior, utilize a Base de Dados em vez de ReadWriteDatabase.

Definição	Valor sugerido	Descrição do campo
clusterName	mykustocluster	O nome do cluster onde a base de dados será criada.
databaseName	mykustodatabase	O nome da base de dados.
resourceGroupName	testrg	O nome do grupo de recursos onde o cluster será criado.
softDeletePeriod	3650:00:00:00	A quantidade de tempo durante a qual os dados serão mantidos disponíveis para consulta.
hotCachePeriod	3650:00:00:00	A quantidade de tempo que os dados serão mantidos na cache.

Execute o seguinte comando para ver a base de dados que criou:

databaseData = (await databases.GetAsync(databaseName)).Value.Data as KustoReadWriteDatabase;

Crie a sua base de dados com o seguinte comando:

from azure.mgmt.kusto import KustoManagementClient
from azure.common.credentials import ServicePrincipalCredentials
from azure.mgmt.kusto.models import ReadWriteDatabase
from datetime import timedelta

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

location = 'Central US'
resource_group_name = 'testrg'
cluster_name = 'mykustocluster'
soft_delete_period = timedelta(days=3650)
hot_cache_period = timedelta(days=3650)
database_name = "mykustodatabase"

kusto_management_client = KustoManagementClient(credentials, subscription_id)

database_operations = kusto_management_client.databases
database = ReadWriteDatabase(location=location,
      soft_delete_period=soft_delete_period,
      hot_cache_period=hot_cache_period)

poller = database_operations.begin_create_or_update(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name, parameters = database)
poller.wait()

Nota

Se estiver a utilizar a versão 0.4.0 ou inferior do Python, utilize a Base de Dados em vez de ReadWriteDatabase.

Definição	Valor sugerido	Descrição do campo
cluster_name	mykustocluster	O nome do cluster onde a base de dados será criada.
database_name	mykustodatabase	O nome da base de dados.
resource_group_name	testrg	O nome do grupo de recursos onde o cluster será criado.
soft_delete_period	3650 dias, 0:00:00	A quantidade de tempo durante a qual os dados serão mantidos disponíveis para consulta.
hot_cache_period	3650 dias, 0:00:00	A quantidade de tempo que os dados serão mantidos na cache.

Execute o seguinte comando para ver a base de dados que criou:

database_operations.get(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name)

O código seguinte mostra como criar uma base de dados. As importações de pacotes e a iniciação de variáveis de ambiente são as mesmas da secção anterior. Para clonar o repositório de código, veja Manage an Azure Data Explorer cluster using Azure Go SDK (Gerir um cluster do Azure Data Explorer com o SDK do Azure Go).

Execute o seguinte código para criar a base de dados:

func createDatabase(sub, rgName, clusterName, location, dbName string) {
 ctx := context.Background()

 client := getDBClient(sub)
 future, err := client.BeginCreateOrUpdate(ctx, rgName, clusterName, dbName, &armkusto.ReadWriteDatabase{Kind: to.Ptr(armkusto.KindReadWrite), Location: &location}, nil)

 if err != nil {
  log.Fatal("failed to start database creation ", err)
 }

 log.Printf("waiting for database creation to complete - %s\n", dbName)
 resp, err := future.PollUntilDone(ctx, nil)
 if err != nil {
  log.Fatal(err)
 }

 kdb := resp.GetDatabase()
 log.Printf("created DB %s with ID %s and type %s\n", *kdb.Name, *kdb.ID, *kdb.Type)
}

createDatabase(subscription, rgName, clusterNamePrefix+clusterName, location, dbNamePrefix+databaseName)

Liste as bases de dados para garantir a criação com êxito:

func listDatabases(sub, rgName, clusterName string) {
 log.Printf("listing databases in cluster %s\n", clusterName)

 ctx := context.Background()
 result := getDBClient(sub).NewListByClusterPager(rgName, clusterName, nil)

 data := [][]string{}

 for result.More() {
  temp, err := result.NextPage(ctx)
  if err != nil {
   log.Fatal(err)
  }
  for _, db := range temp.Value {
   if *db.GetDatabase().Kind == armkusto.KindReadWrite {
    data = append(data, []string{*db.GetDatabase().Name, string(*db.GetDatabase().Kind), *db.GetDatabase().Location, *db.GetDatabase().Type})
   }
  }
 }

 table := tablewriter.NewWriter(os.Stdout)
 table.SetHeader([]string{"Name", "State", "Location", "Type"})

 for _, v := range data {
  table.Append(v)
 }
 table.Render()
}

listDatabases(subscription, rgName, clusterNamePrefix+clusterName)

Crie a sua base de dados com o seguinte comando:

az kusto database create --cluster-name azureclitest --database-name clidatabase --resource-group testrg --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=westus

Definição	Valor sugerido	Descrição do campo
nome do cluster	azureclitest	O nome do cluster onde a base de dados será criada.
database-name	clidatabase	O nome da base de dados.
resource-group	testrg	O nome do grupo de recursos onde o cluster será criado.
read-write-database	P365DP31Dwestus	O tipo de base de dados. Parâmetros: soft-delete-period - Significa a quantidade de tempo que os dados serão mantidos disponíveis para consulta. Veja política de retenção para obter mais informações. hot-cache-period - Significa a quantidade de tempo que os dados serão mantidos na cache. Veja a política de cache para obter mais informações. location - A localização onde a base de dados será criada.

Execute o seguinte comando para ver a base de dados que criou:

az kusto database show --database-name clidatabase --resource-group testrg --cluster-name azureclitest

Crie a sua base de dados com o seguinte comando:

New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00

Definição	Valor sugerido	Descrição do campo
ClusterName	mykustocluster	O nome do cluster onde a base de dados será criada.
Name	mykustodatabase	O nome da base de dados.
ResourceGroupName	testrg	O nome do grupo de recursos onde o cluster será criado.
SoftDeletePeriod	3650:00:00:00	A quantidade de tempo durante a qual os dados serão mantidos disponíveis para consulta.
HotCachePeriod	3650:00:00:00	A quantidade de tempo que os dados serão mantidos na cache.

Execute o seguinte comando para ver a base de dados que criou:

Get-AzKustoDatabase -ClusterName mykustocluster -ResourceGroupName testrg -Name mykustodatabase

Passo seguinte

Criar tabelas

Partilhar via

Criar um cluster e uma base de dados do Azure Data Explorer

Pré-requisitos

Configurar os parâmetros da CLI

Configurar os parâmetros

Criar um cluster do Azure Data Explorer

Modelo ARM

Utilizar o modelo do ARM

Criar uma base de dados do Azure Data Explorer

Passo seguinte

Comentários

Recursos adicionais