Tarefa Azure DevOps para explorador de dados AzureAzure DevOps Task for Azure Data Explorer

A Azure DevOps Services fornece ferramentas de colaboração de desenvolvimento, tais como oleodutos de alto desempenho, repositórios privados gratuitos de Git, placas kanban configuráveis e extensas capacidades de teste automatizados e contínuos.Azure DevOps Services provides development collaboration tools such as high-performance pipelines, free private Git repositories, configurable Kanban boards, and extensive automated and continuous testing capabilities. Azure Pipelines é uma capacidade Azure DevOps que lhe permite gerir o CI/CD para implementar o seu código com oleodutos de alto desempenho que funcionam com qualquer idioma, plataforma e nuvem.Azure Pipelines is an Azure DevOps capability that enables you to manage CI/CD to deploy your code with high-performance pipelines that work with any language, platform, and cloud. Azure Data Explorer - Comandos Admin é a tarefa Azure Pipelines que lhe permite criar oleodutos de libertação e implementar as alterações da sua base de dados nas bases de dados do Azure Data Explorer.Azure Data Explorer - Admin Commands is the Azure Pipelines task that enables you to create release pipelines and deploy your database changes to your Azure Data Explorer databases. Está disponível gratuitamente no Visual Studio Marketplace.It's available for free in the Visual Studio Marketplace.

Este documento descreve um exemplo simples sobre a utilização da tarefa Azure Data Explorer – Comandos Admin para implementar as alterações de esquema na sua base de dados.This document describes a simple example on the use of the Azure Data Explorer – Admin Commands task to deploy your schema changes to your database. Para obter os oleodutos CI/CD completos, consulte a documentação do Azure DevOps.For complete CI/CD pipelines, refer to Azure DevOps documentation.

Pré-requisitosPrerequisites

Criar pastasCreate folders

Crie as seguintes pastas de amostra (Funções, Políticas, Tabelas) no seu repositório Git.Create the following sample folders (Functions, Policies, Tables) in your Git repository. Copie os ficheiros daqui para as respetivas pastas, como se vê abaixo, e cometa as alterações.Copy the files from here into the respective folders as seen below and commit the changes. Os ficheiros de amostra são fornecidos para executar o seguinte fluxo de trabalho.The sample files are provided to execute the following workflow.

Criar pastas

Dica

Ao criar o seu próprio fluxo de trabalho, recomendamos tornar o seu código idempotente.When creating your own workflow, we recommend making your code idempotent. Por exemplo, utilize .create-merge table em vez de .criar tabela, e use .create-or-alter function em vez de .criar função.For example, use .create-merge table instead of .create table, and use .create-or-alter function instead of .create function.

Criar um pipeline de versãoCreate a release pipeline

  1. Inscreva-se na sua organização Azure DevOps.Sign in to your Azure DevOps organization.

  2. Selecione Pipelines > Pipelines Releases do menu esquerdo e selecione Novo pipeline.Select Pipelines > Releases from left-hand menu and select New pipeline.

    Novo pipeline

  3. A nova janela do gasoduto de desbloqueio abre-se.The New release pipeline window opens. No separador Pipelines, no painel de modelo Selecione um painel de modelo, selecione Trabalho Vazio.In the Pipelines tab, in the Select a template pane, select Empty job.

    Selecione um modelo

  4. Selecione o botão de estágio.Select Stage button. No painel de estágio, adicione o nome de palco.In Stage pane, add the Stage name. Selecione Guardar para guardar o seu oleoduto.Select Save to save your pipeline.

    Nomeie o palco

  5. Selecione Adicione um botão de artefacto.Select Add an artifact button. No painel de artefactos Adicionar, selecione o repositório onde o seu código existe, preencha informações relevantes e clique em Adicionar.In the Add an artifact pane, select the repository where your code exists, fill out relevant information, and click Add. Selecione Guardar para guardar o seu oleoduto.Select Save to save your pipeline.

    Adicionar um artefacto

  6. No separador Variáveis, selecione + Adicionar para criar uma variável para URL endpoint que será usada na tarefa.In the Variables tab, select + Add to create a variable for Endpoint URL that will be used in the task. Escreva o Nome e o Valor do ponto final.Write the Name and the Value of the endpoint. Selecione Guardar para guardar o seu oleoduto.Select Save to save your pipeline.

    Criar variável

    Para encontrar o seu Endpoint_URL, a página geral do seu Cluster Azure Data Explorer no portal Azure contém o cluster Azure Data Explorer URI.To find your Endpoint_URL, the overview page of your Azure Data Explorer Cluster in the Azure portal contains the Azure Data Explorer cluster URI. Construa o URI no seguinte https://<Azure Data Explorer cluster URI>?DatabaseName=<DBName> formato.Construct the URI in the following format https://<Azure Data Explorer cluster URI>?DatabaseName=<DBName>. Por exemplo, https: / /kustodocs.westus.kusto.windows.net?DatabaseName=SampleDBFor example, https://kustodocs.westus.kusto.windows.net?DatabaseName=SampleDB

    Azure Data Explorer cluster URI

Criar tarefas para implementarCreate tasks to deploy

  1. No separador Pipeline, clique em 1 trabalho, 0 tarefa para adicionar tarefas.In the Pipeline tab, click on 1 job, 0 task to add tasks.

    Adicionar tarefas

  2. Crie três tarefas para implementar Tabelas, Funçõese Políticas, por esta ordem. TablesCreate three tasks to deploy Tables, Functions, and Policies, in this order.

  3. No separador Tarefas, selecione + por trabalho de Agente.In the Tasks tab, select + by Agent job. Procure o Azure Data Explorer.Search for Azure Data Explorer. No Marketplace, instale a extensão Azure Data Explorer – Comandos Admin.In Marketplace, install the Azure Data Explorer – Admin Commands extension. Em seguida, selecione Adicionar no Comando de Explorador de Dados Run Azure.Then, select Add in Run Azure Data Explorer Command.

    Adicionar comandos de administração

  4. Clique no Comando Kusto à esquerda e atualize a tarefa com as seguintes informações:Click on Kusto Command on the left and update the task with the following information:

    • Nome do visor: Nome da tarefaDisplay name: Name of the task
    • Caminho do ficheiro: Na tarefa Tabelas, especifique /Tabelas/.csl uma vez que os ficheiros de criação de tabela estão na pasta tabela.File path: In the Tables task, specify /Tables/.csl since the table creation files are in the Table folder.
    • URL de ponto final: introduza a EndPoint URL variável criada no passo anterior.Endpoint URL: enter the EndPoint URLvariable created in previous step.
    • Selecione Utilizar o ponto final do serviço e selecione + Novo.Select Use Service Endpoint and select + New.

    Atualizar tarefa de comando Kusto

  5. Complete as seguintes informações na janela de ligação do Add Azure Data Explorer:Complete the following information in the Add Azure Data Explorer service connection window:

    DefiniçãoSetting Valor sugeridoSuggested value
    Nome da ligaçãoConnection name Insira um nome para identificar este ponto final de serviçoEnter a name to identify this service endpoint
    Cluster UrlCluster Url O valor pode ser encontrado na secção geral do seu Azure Data Explorer Cluster no portal AzureValue can be found in the overview section of your Azure Data Explorer Cluster in the Azure portal
    ID principal de serviçoService Principal Id Insira o ID da App AAD (criado como pré-requisito)Enter the AAD App ID (created as prerequisite)
    Chave de aplicativo principal de serviçoService Principal App Key Insira a Chave de Aplicações AAD (criada como pré-requisito)Enter the AAD App Key (created as prerequisite)
    Id inquilino da AADAAD tenant Id Insira o seu inquilino AAD (como microsoft.com, contoso.com...)Enter your AAD tenant (such as microsoft.com, contoso.com...)

    Selecione Deixe todos os oleodutos utilizarem esta caixa de verificação de ligação.Select Allow all pipelines to use this connection checkbox. Selecione OK.Select OK.

    Adicionar ligação de serviço

  6. Repita os passos 1-5 mais duas vezes para implantar ficheiros das pastas Funções e Políticas.Repeat steps 1-5 another two times to deploy files from the Functions and Policies folders. Selecione Guardar.Select Save. No separador Tarefas, consulte as três tarefas criadas: Implementar tabelas, implementar funçõese implementar políticas. Deploy TablesIn the Tasks tab, see the three tasks created: Deploy Tables, Deploy Functions, and Deploy Policies.

    Implementar todas as pastas

  7. Selecione + > Desbloqueie o desbloqueio para criar um desbloqueio.Select + Release > Create release to create a release.

    Criar um lançamento

  8. No separador 'Registos', verifique se o estado de implantação é bem sucedido.In the Logs tab, check the deployment status is successful.

    A implementação é bem sucedida

Concluiu agora a criação de um oleoduto de libertação para a implantação de três tarefas para a pré-produção.You have now completed creation of a release pipeline for deployment of three tasks to pre-production.