Ler em inglês

Compartilhar via


Criar um cluster do Azure Data Explorer e o banco de dados

O Azure Data Explorer é um serviço de análise de dados rápido e totalmente gerenciado para análise em tempo real de grandes volumes de streaming de dados de aplicativos, sites, dispositivos IoT e muito mais. Para usar o Azure Data Explorer, primeiro crie um cluster e um ou mais bancos de dados nesse cluster. Em seguida, você pode ingerir (carregar) dados em um banco de dados e executar consultas nele.

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

Para obter amostras de código baseadas em versões anteriores do SDK, consulte o artigo arquivado .

Pré-requisitos

Pré-requisitos por método de criação de cluster e banco de dados:

  • Uma assinatura do Azure. Criar uma conta gratuita do Azure.
  • Você pode usar o Azure Cloud Shell para executar o código deste artigo sem precisar instalar nada em seu ambiente local.
  • Se você optar por instalar e usar a CLI do Azure localmente, siga as etapas em Configurar parâmetros. Este tutorial requer a CLI do Azure, versão 2.0.4 ou posterior. Execute az --version para verificar sua versão. Se você precisar instalar ou atualizar, confira Instalar a CLI do Azure.

Configurar os parâmetros da CLI

As etapas a seguir não serão necessárias se você estiver executando comandos no Azure Cloud Shell. Se você estiver executando a CLI localmente, siga estas etapas para configurar o ambiente:

  1. Instale a extensão para usar a versão mais recente da CLI do Kusto:

    CLI do Azure
    az extension add -n kusto
    
  2. Execute o comando a seguir para entrar no Azure:

    CLI do Azure
    az login
    
  3. Defina a assinatura em que deseja criar o cluster. Substitua MyAzureSub pelo nome da assinatura do Azure que deseja usar:

    CLI do Azure
    az account set --subscription MyAzureSub
    
  4. Configure o grupo de recursos onde você deseja que seu cluster seja criado. Substitua testrg pelo nome do grupo de recursos que você deseja usar:

    CLI do Azure
    az group create --name testrg --location westus
    

Criar um cluster do Azure Data Explorer

Esta seção orienta você no processo de criação de um cluster do Azure Data Explorer. Escolha a guia relevante para seu método preferido de criar o cluster.

  1. Crie o cluster usando o seguinte comando:

    CLI do Azure
    az kusto cluster create --cluster-name azureclitest --sku name="Standard_E8ads_v5" tier="Standard" --resource-group testrg --location westus
    
    Configuração Valor sugerido Descrição do campo
    name azureclitest O nome desejado do cluster.
    sku Standard_E8ads_v5 O SKU que será usado para o cluster. Parâmetros: name – O nome do SKU. tier – A camada da SKU.
    resource-group testrg O nome do grupo de recursos em que o cluster será criado.
    local westus O local em que o cluster será criado.

    Há outros parâmetros opcionais que podem ser usados, como a capacidade do cluster.

  2. Execute o comando a seguir para verificar se o cluster foi criado com êxito:

    CLI do Azure
    az kusto cluster show --cluster-name azureclitest --resource-group testrg
    
  3. Confirme a criação bem-sucedida do cluster verificando se o resultado contém provisioningState como Succeeded.

Criar um banco de dados do Azure Data Explorer

Nesta seção, você criará um banco de dados dentro do cluster criado na seção anterior.

  1. Crie o banco de dados usando o seguinte comando:

    CLI do Azure
    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
    
    Configuração Valor sugerido Descrição do campo
    cluster-name azureclitest O nome do cluster em que o banco de dados será criado.
    database-name clidatabase O nome do banco de dados.
    resource-group testrg O nome do grupo de recursos em que o cluster será criado.
    read-write-database P365DP31Dwestus O tipo de banco de dados. Parâmetros: soft-delete-period – Indica o tempo durante o qual os dados serão mantidos disponíveis para consulta. Consulte política de retenção para obter mais informações. hot-cache-period – Indica o tempo durante o qual os dados serão mantidos no cache. Consulte política de cache para obter mais informações. location – O local em que o banco de dados será criado.
  2. Execute o seguinte comando para ver o banco de dados criado:

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

Próxima etapa