Crie um cluster e base de dados Azure Data Explorer utilizando o PowerShellCreate an Azure Data Explorer cluster and database by using PowerShell

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.Azure Data Explorer is a fast, fully managed data analytics service for real-time analysis on large volumes of data streaming from applications, websites, IoT devices, and more. Para utilizar o Azure Data Explorer, primeiro crie um cluster e crie uma ou mais bases de dados nesse cluster.To use Azure Data Explorer, you first create a cluster, and create one or more databases in that cluster. Em seguida, ingira (carregue) os dados para uma base de dados, de modo a poder executar consultas neles.Then you ingest (load) data into a database so that you can run queries against it. Neste artigo, cria-se um cluster e uma base de dados utilizando o Powershell.In this article, you create a cluster and a database by using Powershell. Pode executar cmdlets e scripts PowerShell no Windows, Linux ou em Azure Cloud Shell com Az.Kusto para criar e configurar clusters e bases de dados do Azure Data Explorer.You can run PowerShell cmdlets and scripts on Windows, Linux, or in Azure Cloud Shell with Az.Kusto to create and configure Azure Data Explorer clusters and databases.

Pré-requisitosPrerequisites

Nota

Este artigo foi atualizado para utilizar o novo módulo AZ do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Pode continuar a utilizar o módulo AzureRM, que continuará a receber correções de erros até, pelo menos, dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para obter mais informações sobre o novo módulo Az e a compatibilidade do AzureRM, veja Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, veja Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Utilizar o Azure Cloud ShellUse Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Pode utilizar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem ter de instalar nada no ambiente local.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Para iniciar o Azure Cloud Shell:To start Azure Cloud Shell:

OpçãoOption Exemplo/LigaçãoExample/Link
Selecione Experimentar no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. A seleção de Experimente não copia automaticamente o código para o Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo da opção Experimente para o Azure Cloud Shell
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Iniciar Cloud Shell numa nova janelaLaunch Cloud Shell in a new window
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo no Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie o Cloud Shell.Start Cloud Shell.

  2. Selecione o botão Copiar num bloco de código para copiar o código.Select the Copy button on a code block to copy the code.

  3. Cole o código na sessão do Cloud Shell ao selecionar Ctrl+Shift+V no Windows e Linux ou Cmd+Shift+V no macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Selecione Introduzir para executar o código.Select Enter to run the code.

Se optar por instalar e utilizar o Azure CLI localmente, este artigo requer a versão Azure CLI 2.0.4 ou posterior.If you choose to install and use the Azure CLI locally, this article requires the Azure CLI version 2.0.4 or later. Execute az --version para verificar a sua versão.Run az --version to check your version. Se precisar de instalar ou atualizar, veja Instalar a CLI do Azure.If you need to install or upgrade, see Install the Azure CLI.

Parâmetros de configuraçãoConfigure parameters

Os seguintes passos não são necessários se estiver a executar comandos em Azure Cloud Shell.The following steps are not required if you're running commands in Azure Cloud Shell. Se estiver a executar o CLI localmente, siga os passos 1 & 2 para iniciar sposição no Azure e para definir a sua subscrição atual:If you're running the CLI locally, follow steps 1 & 2 to sign in to Azure and to set your current subscription:

  1. Execute o seguinte comando para iniciar sessão no Azure:Run the following command to sign in to Azure:

    Connect-AzAccount
    
  2. Desaça a subscrição onde pretende que o seu cluster seja criado:Set the subscription where you want your cluster to be created:

     Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    
  3. Ao executar o Azure CLI localmente ou na Azure Cloud Shell, é necessário instalar o módulo Az.Kusto no seu dispositivo:When running Azure CLI locally or in the Azure Cloud Shell, you need to install the Az.Kusto module on your device:

     Install-Module -Name Az.Kusto
    

Criar o cluster Azure Data ExplorerCreate the Azure Data Explorer cluster

  1. Crie o seu cluster utilizando o seguinte comando:Create your cluster by using the following command:

     New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location 'Central US' -Sku D13_v2 -Capacity 10
    
    DefiniçãoSetting Valor sugeridoSuggested value Descrição do campoField description
    NomeName mykustoclustermykustocluster O nome desejado do seu aglomerado.The desired name of your cluster.
    SkuSku D13_v2D13_v2 O SKU que será usado para o seu aglomerado.The SKU that will be used for your cluster.
    ResourceGroupNameResourceGroupName testrtestrg O nome do grupo de recursos onde o cluster será criado.The resource group name where the cluster will be created.

    Existem parâmetros opcionais adicionais que pode utilizar, como a capacidade do cluster.There are additional optional parameters that you can use, such as the capacity of the cluster.

  2. Executar o seguinte comando para verificar se o seu cluster foi criado com sucesso:Run the following command to check whether your cluster was successfully created:

    Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
    

Se o resultado contiver provisioningState com o Succeeded valor, então o cluster foi criado com sucesso.If the result contains provisioningState with the Succeeded value, then the cluster was successfully created.

Criar a base de dados no cluster Azure Data ExplorerCreate the database in the Azure Data Explorer cluster

  1. Crie a sua base de dados utilizando o seguinte comando:Create your database by using the following command:

    New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00
    
    DefiniçãoSetting Valor sugeridoSuggested value Descrição do campoField description
    ClusterNameClusterName mykustoclustermykustocluster O nome do seu cluster onde a base de dados será criada.The name of your cluster where the database will be created.
    NomeName base de dados mykustomykustodatabase O nome da sua base de dados.The name of your database.
    ResourceGroupNameResourceGroupName testrtestrg O nome do grupo de recursos onde o cluster será criado.The resource group name where the cluster will be created.
    SoftDeletePeriodSoftDeletePeriod 3650:00:00:003650:00:00:00 O tempo que esses dados serão mantidos disponíveis para consulta.The amount of time that data will be kept available to query.
    HotCachePeriodHotCachePeriod 3650:00:00:003650:00:00:00 A quantidade de tempo que os dados serão mantidos em cache.The amount of time that data will be kept in cache.
  2. Faça o seguinte comando para ver a base de dados que criou:Run the following command to see the database that you created:

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

Agora tem um aglomerado e uma base de dados.You now have a cluster and a database.

Limpar os recursosClean up resources

  • Se planeia seguir os nossos outros artigos, mantenha os recursos que criou.If you plan to follow our other articles, keep the resources you created.

  • Para limpar recursos, elimine o cluster.To clean up resources, delete the cluster. Quando elimina um cluster, também elimina todas as bases de dados nele.When you delete a cluster, it also deletes all the databases in it. Utilize o seguinte comando para eliminar o seu cluster:Use the following command to delete your cluster:

    Remove-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster
    

Próximos passosNext steps