Partilhar via


Configurar armazenamento de base de dados SQL para fluxos de trabalho padrão no Azure Logic Apps (pré-visualização)

Aplica-se a: Aplicativos Lógicos do Azure (Padrão)

Importante

Esta funcionalidade está em pré-visualização e está sujeita aos Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

Quer crie aplicações de lógica padrão alojadas no Azure Logic Apps, no App Service Environment v3 ou na sua própria infraestrutura, precisa sempre de um fornecedor de armazenamento para guardar artefactos do fluxo de trabalho, estado e dados de execução. Quando configura a sua própria base de dados SQL como fornecedor de armazenamento, ganha mais flexibilidade e controlo sobre o ambiente de execução do seu fluxo de trabalho, throughput, escalabilidade, desempenho e gestão.

Este guia descreve porquê e como configurar uma base de dados SQL como fornecedor de armazenamento. Pode completar esta tarefa durante a criação da aplicação Logic com o portal Azure ou durante a implementação com o Visual Studio Code.

Por que configurar armazenamento de bases de dados SQL

Uma base de dados SQL oferece os seguintes benefícios:

Benefício Description
Portabilidade O SQL tem muitos fatores forma, incluindo máquinas virtuais, plataforma como serviço (PaaS) e contêineres. Você pode executar bancos de dados SQL em praticamente qualquer lugar que queira executar fluxos de trabalho de aplicativos lógicos.
Controlo O SQL fornece controle granular sobre a taxa de transferência, o desempenho e o dimensionamento do banco de dados durante períodos específicos ou para cargas de trabalho específicas. O preço do SQL é baseado no uso e na taxa de transferência da CPU, o que fornece preços mais previsíveis do que o Armazenamento do Azure, onde os custos são baseados em cada operação.
Reutilizar ativos existentes Aplique ferramentas e recursos familiares da Microsoft para integrações modernas com SQL. Reutilize ativos em implementações tradicionais on-premises e implementações modernas na cloud com o Azure Hybrid Benefits. O SQL também fornece ferramentas maduras e com bom suporte, como o SQL Server Management Studio (SSMS), interfaces de linha de comando e SDKs.
Conformidade O SQL fornece mais opções do que o Armazenamento do Azure para você fazer backup, restaurar, fazer failover e criar redundâncias. Você pode aplicar os mesmos mecanismos de nível empresarial que outros aplicativos corporativos ao armazenamento do seu aplicativo lógico.

Quando escolher SQL

A tabela seguinte descreve cenários em que pode escolher SQL:

Scenario Armazenamento recomendado
Executar fluxos de trabalho de aplicação lógica padrão no Azure com mais controlo sobre o débito de armazenamento e desempenho. Escolha SQL porque o Azure Storage não fornece ferramentas para ajustar de forma precisa o débito e o desempenho.
Executar fluxos de trabalho padrão em ambientes híbridos, incluindo infraestrutura local ou infraestrutura própria. Para mais informações, consulte:

- Configura a tua própria infraestrutura para aplicações de lógica padrão para implementação híbrida
- Criar fluxos de trabalho padrão para implementação híbrida
Escolha SQL porque pode decidir onde alojar a sua base de dados SQL, por exemplo, on-local, numa máquina virtual, num contentor ou em ambiente multicloud. Considere executar seus fluxos de trabalho de aplicativos lógicos próximos aos sistemas que você deseja integrar ou reduzir sua dependência da nuvem.
Depende de custos previsíveis de armazenamento. Escolha SQL quando quiser mais controlo sobre os custos de escalabilidade. Os custos SQL baseiam-se em cada computação e operações de entrada-saída por segundo (IOPs). Os custos do Armazenamento do Azure baseiam-se no número de operações, o que pode funcionar melhor para pequenas cargas de trabalho que podem ser dimensionadas para zero.
Prefiro SQL ao Azure Storage. SQL é um ecossistema bem conhecido e fiável onde pode aplicar a mesma governação e gestão em todas as operações das suas aplicações lógicas nos bastidores.
Reutilizar ambientes SQL existentes. Escolha SQL se já possui licenças SQL que quer reutilizar ou modernizar para a cloud. Também pode querer aplicar os Benefícios Híbridos do Azure às suas integrações com aplicações lógicas.
Tudo o resto Escolha Azure Storage, que é o fornecedor de armazenamento padrão.

Pré-requisitos

  • Uma conta do Azure e uma assinatura ativa. Cria uma conta gratuita.

  • Um servidor SQL e ambiente de base de dados para a tua aplicação lógica. No entanto, antes de configurar seu ambiente, conclua as seguintes etapas:

    1. Crie uma instância do SQL Server.

      Edições SQL Server suportadas:

    2. Se o seu servidor SQL for suportado e alojado no Azure, certifique-se de configurar as seguintes permissões:

      1. No portal do Azure, vá para o recurso do SQL Server.

      2. Na barra lateral do servidor, em Segurança, selecione Firewalls e redes virtuais.

      3. No painel aberto, em Permitir que serviços e recursos Azure acedam a este servidor, selecione Sim.

      4. Salve suas alterações.

    3. Se o seu servidor SQL não estiver alojado no Azure, certifique-se de que quaisquer firewalls ou configurações de rede permitem que os serviços e recursos do Azure acedam ao seu servidor e base de dados.

    4. Se tiver SQL Express para desenvolvimento local, ligue-se à instância nomeada por defeito localhost\SQLExpress.

    5. Crie ou reutilize uma base de dados existente.

      Deve ter uma base de dados ativa e viável antes de poder configurar o SQL Storage Provider.

    6. Siga os passos para configurar o seu ambiente SQL neste artigo.

    7. Para desenvolvimento local, precisas de instalar o Visual Studio Code localmente no teu computador.

      Observação

      Certifique-se de instalar as mais recentes Ferramentas Core do Azure Functions e de garantir que tem suporte a SQL, escolhendo o Microsoft Installer (MSI), que é func-cli-X.X.XXXX-x*.msi. Para mais informações sobre os requisitos do Visual Studio Code, consulte Criar fluxos de trabalho padrão em aplicações Azure Logic com Visual Studio Code.

Configurar seu ambiente SQL

  1. Antes de configurar o SQL Storage Provider, confirme que completou os passos exigidos nos pré-requisitos.

  2. Configure permissões para o seu servidor SQL.

    O SQL Storage Provider suporta atualmente autenticação SQL através de strings de ligação. Também pode escolher a Autenticação do Windows para desenvolvimento e testes locais. No momento, o suporte para ID do Microsoft Entra e identidades gerenciadas não está disponível.

    Deve ter uma identidade com as permissões para criar e gerir artefactos de workflow na base de dados SQL alvo. Por exemplo, um administrador tem todas as permissões necessárias para criar e gerenciar esses artefatos.

    A lista seguinte descreve os artefactos que o runtime Azure Logic Apps tenta criar com a string de ligação SQL que fornece. Certifique-se de que a identidade na cadeia de ligação SQL tem as permissões necessárias para criar os seguintes artefactos:

    • Crie e exclua os seguintes esquemas: dt, dce dq.
    • Adicione, altere e exclua tabelas nesses esquemas.
    • Adicione, altere e exclua tipos de tabela definidos pelo usuário nesses esquemas.

    Para obter mais informações sobre permissões direcionadas, consulte Permissões do SQL Server no Mecanismo de Banco de Dados.

    Importante

    Quando tiver informações sensíveis, como cadeias de ligação que incluam nomes de utilizador e palavras-passe, certifique-se de escolher o fluxo de autenticação mais seguro disponível. A Microsoft recomenda que você autentique o acesso aos recursos do Azure com uma identidade gerenciada quando possível e atribua uma função que tenha o menor privilégio necessário.

    Se esta funcionalidade não estiver disponível, certifique-se de proteger as cadeias de ligação através de outras medidas, como o Azure Key Vault, que pode adicionar às definições da sua aplicação. Em seguida, você pode fazer referência direta a cadeias de caracteres seguras, como cadeias de conexão e chaves. Semelhante aos modelos ARM, onde você pode definir variáveis de ambiente no momento da implantação, você pode definir as configurações do aplicativo na definição do fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar valores de infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento e muito mais. Para obter mais informações, consulte Tipos de aplicativo para a plataforma de identidade da Microsoft.

  3. Ligue-se ao seu servidor SQL e base de dados.

    • Certifique-se de que seu banco de dados SQL permite o acesso necessário para o desenvolvimento.

    • Se tiver uma base de dados Azure SQL, cumpra os seguintes requisitos:

      • Para desenvolvimento e testes locais, permita explicitamente conexões do endereço IP do computador local. Você pode definir suas regras de firewall IP no SQL Server do Azure.

      • No portal do Azure, permita que seu recurso de aplicativo lógico acesse o banco de dados SQL com uma cadeia de conexão fornecida permitindo serviços do Azure.

      • Configure quaisquer outros controles de acesso à rede do banco de dados SQL conforme necessário para seu cenário.

    • Se tiver Azure SQL Managed Instance, permita que os serviços Azure (logicapp) se liguem à sua base de dados SQL através de endpoints públicos seguros.

Configurar o SQL durante a criação no portal do Azure

Ao criar seu aplicativo lógico padrão, você pode configurar o SQL como seu provedor de armazenamento.

  1. Na caixa de pesquisa do portal Azure , introduza logic apps, e selecione Logic apps.

    A captura de ecrã mostra a caixa de pesquisa do portal Azure com aplicações Logic como termo de pesquisa e a categoria selecionada chamada Aplicações Lógica.

  2. Na barra de ferramentas da página Aplicativos lógicos , selecione Adicionar.

  3. Na página Criar Aplicação Lógica , em Standard, selecione a opção de alojamento que deseja.

  4. No separador Básicos, forneça a seguinte informação, que pode variar consoante as suas escolhas.

    Propriedade Obrigatório Valor Description
    Subscription Yes < Nome da subscrição Azure> A subscrição do Azure para a tua aplicação Logic.
    Grupo de Recursos Yes < Grupo de Recursos do Azure> O grupo de recursos do Azure para a sua aplicação lógica e recursos relacionados. O nome deve ser único entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses ((()) e pontos (.).

    Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
    Type Yes Standard Este tipo de aplicação lógica segue o modelo de uso padrão, faturação e preços.
    Nome da Aplicação Lógica Yes < logic-app-name> O nome do seu aplicativo lógico. Esse nome de recurso deve ser exclusivo entre regiões e pode conter apenas letras, números, hífenes (-), sublinhados (_), parênteses (()) e pontos (.).

    Este exemplo cria um aplicativo lógico chamado Fabrikam-Workflows.

    Nota: O nome da sua aplicação lógica recebe automaticamente o sufixo, .azurewebsites.net porque o recurso da aplicação lógica Standard é alimentado pelo runtime de instância única das Azure Logic Apps, que utiliza o modelo de extensibilidade Azure Functions e é alojado como uma extensão no runtime das Azure Functions. O Azure Functions usa a mesma convenção de nomenclatura de aplicativo.
    Região Yes < Azure-region> A localização do grupo de recursos e dos próprios recursos. Este exemplo implanta o aplicativo lógico de exemplo no Azure e usa West US.

    - Para implantar em um recurso ASEv3 , que deve existir primeiro, selecione esse recurso de ambiente na lista Região .
    Plano do Windows Yes < nome-plano> O nome do plano a ser usado. Selecione um nome de plano existente ou forneça um nome para um novo plano.

    Este exemplo usa o nome My-App-Service-Plan.

    Nota: Não escolha um plano de App Service baseado em Linux. Apenas o plano do Serviço de Aplicativo baseado no Windows é suportado.
    Plano de preços Yes < Nível de preços> O escalão de preços para a tua aplicação Logic e fluxos de trabalho. A sua escolha afeta o preço, computação, memória e armazenamento da sua aplicação lógica e dos fluxos de trabalho.

    Para obter mais informações, consulte Planos de hospedagem e níveis de preços.

    O exemplo a seguir mostra a página Create Logic App com a guia Basics :

    A captura de tela mostra o portal do Azure e a página Criar Aplicativo Lógico com a guia Noções básicas.

  5. Quando estiver pronto, selecione Avançar: Armazenamento. No separador Armazenamento , forneça as seguintes informações sobre a solução de armazenamento e o plano de alojamento da sua aplicação lógica.

    Propriedade Obrigatório Valor Description
    Tipo de armazenamento Yes Armazenamento SQL e Azure O armazenamento de artefatos e dados do fluxo de trabalho.

    - Se selecionou uma localização personalizada como sua região, selecione SQL.

    - Se selecionou uma região Azure ou localização ASEv3, selecione SQL e Azure Storage.

    Nota: Se estiver a implementar para uma região Azure, ainda precisa de uma conta Azure Storage. Este requisito completa a hospedagem única da configuração da aplicação lógica na plataforma Azure Logic Apps. A definição, o estado, o histórico de execução e outros artefatos de tempo de execução do fluxo de trabalho são armazenados em seu banco de dados SQL.

    Para implementações numa localização personalizada alojada num cluster Azure Arc, só precisa de uma base de dados SQL para armazenamento.
    Conta de armazenamento Yes < Azure-storage-account-name> A conta Azure Storage para transações de armazenamento.

    Esse nome de recurso deve ser exclusivo entre regiões e ter de 3 a 24 caracteres com apenas números e letras minúsculas. Selecione uma conta existente ou crie uma nova conta.

    Este exemplo cria uma conta de armazenamento chamada fabrikamstorageacct.
    Cadeia de conexão SQL Yes < String de ligação SQL> Sua cadeia de conexão SQL, que atualmente oferece suporte apenas à autenticação SQL, não OAuth ou autenticação de identidade gerenciada.

    Observação: certifique-se de inserir uma cadeia de conexão correta porque o portal do Azure não validará essa cadeia de caracteres para você.

    O exemplo a seguir mostra a página Criar Aplicativo Lógico com a guia Armazenamento :

    A captura de tela mostra o portal do Azure e a página Criar Aplicativo Lógico com a guia Armazenamento.

  6. Conclua as etapas de criação restantes em Criar um fluxo de trabalho padrão de exemplo em Aplicativos Lógicos do Azure de locatário único.

Quando terminar, seu novo recurso e fluxo de trabalho do aplicativo lógico estará ativo no Azure e usará seu banco de dados SQL como um provedor de armazenamento.

Configurar o SQL para desenvolvimento local no Visual Studio Code

As etapas a seguir mostram como configurar o SQL como um provedor de armazenamento para desenvolvimento local e teste no Visual Studio Code:

  1. Configure seu ambiente de desenvolvimento para trabalhar com Aplicativos Lógicos do Azure de locatário único.

    1. Atenda aos pré-requisitos para trabalhar no Visual Studio Code com a extensão Azure Logic Apps (Standard).

    2. Configure o Visual Studio Code para trabalhar com a extensão Azure Logic Apps (Standard).

    3. No Visual Studio Code, conecte-se à sua conta do Azure e crie um projeto de aplicativo lógico em branco.

  2. No Visual Studio Code, abra o painel Explorer, se ainda não estiver aberto.

  3. No painel do Explorador, na raiz do projeto da sua aplicação lógica, mova o ponteiro do rato sobre qualquer área em branco sob todos os ficheiros e pastas do projeto, abra o menu de atalho e selecione Usar armazenamento SQL para o seu projeto da aplicação lógica.

    A captura de ecrã mostra o Visual Studio Code, o painel do Explorador e o ponteiro do rato na raiz do projeto numa área em branco, abriu o menu de atalho e selecionou a opção Usar armazenamento SQL para o seu projeto de aplicação lógica.

  4. Quando o prompt aparecer, insira sua cadeia de conexão SQL. Podes escolher uma instância local de SQL Express ou qualquer outra base de dados SQL que tenhas.

    A captura de ecrã mostra um prompt de ligação SQL string.

    Após a confirmação, o Visual Studio Code cria a seguinte configuração no arquivo de local.settings.json do seu projeto. Você pode atualizar essa configuração a qualquer momento.

    A captura de ecrã mostra o projeto da aplicação lógica e o ficheiro aberto chamado local.settings.json com a definição de strings de ligação SQL.

Configurar o SQL durante a implantação a partir do Visual Studio Code

Você pode publicar diretamente seu projeto de aplicativo lógico do Visual Studio Code no Azure. Esta ação implementa o seu projeto de aplicação lógica para um recurso de aplicação lógica padrão.

  • Se estiver a publicar o seu projeto como um novo recurso de aplicação de lógica padrão no Azure e quiser uma base de dados SQL como fornecedor de armazenamento, introduza a sua string de ligação SQL quando publicar a sua aplicação. Para obter as etapas completas, siga Configurar o SQL para a implantação de novos aplicativos lógicos.

  • Se já configuraste as tuas definições SQL, podes publicar o teu projeto de Logic App num recurso de Standard Logic App já implementado no Azure. Esta ação substitui seu aplicativo lógico existente.

    Observação

    O SQL Express local não funcionará com aplicativos lógicos implantados e hospedados no Azure.

Configurar SQL para a implementação de novos recursos de aplicações de lógica padrão

  1. No Visual Studio Code, abra o painel Explorer, se ainda não estiver aberto.

  2. No painel do Explorador, na raiz do projeto da sua aplicação lógica, mova o ponteiro do rato sobre qualquer área em branco abaixo de todos os ficheiros e pastas do projeto, abra o menu de atalhos e selecione Implementar para a aplicação lógica.

  3. Se for solicitado, selecione a subscrição Azure para a implementação da sua aplicação lógica.

  4. Na lista que o Visual Studio Code abre, certifique-se de selecionar a opção avançada para Criar novo Aplicativo Lógico (Padrão) no Azure Advanced. Caso contrário, você não será solicitado a configurar o SQL.

    A captura de ecrã mostra a opção de implementação selecionada para criar uma nova aplicação Standard Logic no Azure Advanced.

  5. Quando solicitado, forneça um nome globalmente único para a sua nova aplicação de lógica, que é o nome do recurso da aplicação de lógica padrão. Este exemplo utiliza Fabrikam-Workflows-App.

    A captura de ecrã mostra um prompt para um nome globalmente único para a tua aplicação Logic.

  6. Selecione um local para seu aplicativo lógico. Você também pode começar a digitar para filtrar a lista.

    • Para implantar no Azure, selecione a região do Azure onde você deseja implantar. Se criou um recurso do Ambiente de Serviços de Aplicações v3 (ASEv3) e quiser implementar lá, selecione o seu ASEv3.

    O exemplo a seguir mostra a lista de locais filtrada para West US.

    Captura de tela que mostra o prompt para selecionar um local de implantação com regiões do Azure disponíveis e local personalizado para implantações do Azure Arc.

  7. Selecione o tipo de plano de hospedagem para seu novo aplicativo lógico.

    1. Se você selecionou um ASEv3 como o local do seu aplicativo, selecione Plano do Serviço de Aplicativo e, em seguida, selecione seu recurso ASEv3. Caso contrário, selecione Padrão de fluxo de trabalho.

      Captura de tela que mostra o prompt para selecionar 'Padrão de fluxo de trabalho' ou 'Plano do Serviço de Aplicativo'.

    2. Crie um nome para o seu plano ou selecione um plano existente.

      Este exemplo seleciona Criar novo Plano do Serviço de Aplicativo, pois não há planos existentes disponíveis.

      Captura de tela que mostra o prompt para criar um nome para o plano de hospedagem com

  8. Forneça um nome para o seu plano de hospedagem e, em seguida, selecione uma camada de preço para o plano selecionado.

    Para obter mais informações, consulte Planos de hospedagem e níveis de preços.

  9. Quando for solicitado um grupo de recursos do Azure, para um desempenho ideal, selecione o mesmo grupo de recursos do Azure que seu projeto para sua implantação.

    Observação

    Embora possas criar ou escolher um grupo de recursos diferente, fazê-lo pode afetar o desempenho. Se você criar ou escolher um grupo de recursos diferente, mas cancelar depois que o prompt de confirmação for exibido, sua implantação também será cancelada.

  10. Quando lhe for pedido para selecionar uma conta de armazenamento para a sua aplicação lógica, escolha uma das seguintes opções:

    • Se selecionaste uma localização personalizada, seleciona a opção SQL .

    • Se você quiser implantar no Azure, selecione a opção SQL e Armazenamento do Azure.

      Observação

      Essa opção é necessária apenas para implantações do Azure. No Azure, o Azure Storage é necessário para completar uma hospedagem única da configuração da aplicação lógica na plataforma Azure Logic Apps. O estado do fluxo de trabalho contínuo, o histórico de execução e outros artefatos de tempo de execução são armazenados em seu banco de dados SQL.

      Para implementações num local personalizado alojado num cluster Azure Arc, só precisas de uma base de dados SQL para armazenamento.

  11. Quando solicitado, selecione Criar nova conta de armazenamento ou uma conta de armazenamento existente, se disponível.

    Captura de ecrã que mostra o painel

  12. No prompt de confirmação de armazenamento SQL, selecione Sim. No prompt da cadeia de conexão, insira a cadeia de conexão SQL.

    Observação

    Certifique-se de inserir uma cadeia de conexão correta porque o Visual Studio Code não validará essa cadeia de caracteres para você.

    Captura de tela mostrando o Visual Studio Code e o prompt da cadeia de conexão SQL.

  13. Conclua os restantes passos de implementação em Publicar em um novo recurso de aplicação lógica padrão.

Quando terminar, seu novo recurso e fluxo de trabalho do aplicativo lógico estará ativo no Azure e usará seu banco de dados SQL como um provedor de armazenamento.

Validar implementações

Depois de implementares o recurso da tua aplicação Standard Logic no Azure, podes verificar se as tuas definições estão corretas:

  1. No portal do Azure, abra seu recurso de aplicativo lógico.

  2. No menu de navegação de recursos, em Configurações, selecione Configuração.

  3. No painel Configuração, em Configurações do aplicativo, localize a configuração do aplicativo Workflows.Sql.ConnectionString e confirme se a cadeia de conexão SQL aparece e está correta.

  4. Em seu ambiente SQL, confirme se as tabelas SQL foram criadas com o nome do esquema começando com 'dt' e 'dq'.

Por exemplo, a captura de tela a seguir mostra as tabelas que o tempo de execução dos Aplicativos Lógicos do Azure de locatário único criou para um recurso de aplicativo lógico com um único fluxo de trabalho:

Captura de tela mostrando tabelas SQL criadas pelo tempo de execução dos Aplicativos Lógicos do Azure de locatário único.

O serviço de Aplicativos Lógicos do Azure de locatário único também cria tipos de tabela definidos pelo usuário. Por exemplo, a captura de tela a seguir mostra os tipos de tabela definidos pelo usuário que o tempo de execução dos Aplicativos Lógicos do Azure de locatário único criou para um recurso de aplicativo lógico com um único fluxo de trabalho:

Captura de tela mostrando os tipos de tabela definidos pelo usuário SQL criados pelo tempo de execução dos Aplicativos Lógicos do Azure de locatário único.