Configurar o armazenamento de banco de dados SQL para aplicativos lógicos Standard em Aplicativos Lógicos do Azure de locatário único (versão prévia)

Aplica-se a: Aplicativos Lógicos do Azure (Standard)

Ao escolher o tipo de recurso de Aplicativo Lógico (Standard) para criar fluxos de trabalho que são executados em Aplicativos Lógicos do Azure de locatário único, Ambiente do Serviço de Aplicativo v3 ou fora do Azure, você também precisa criar uma conta de Armazenamento do Microsoft Azure para salvar artefatos relacionados a fluxo de trabalho, estados e dados de runtime. No entanto, se você quiser mais flexibilidade e controle sobre o ambiente de tempo de execução, a taxa de transferência, o desempenho e o gerenciamento de fluxos de trabalho do aplicativo lógico, poderá usar o provedor de Armazenamento de SQL em vez da Armazenamento do Microsoft Azure para transações de armazenamento relacionadas ao fluxo de trabalho.

Este artigo fornece uma visão geral de como você pode usar o armazenamento do SQL como provedor primário para Aplicativos Lógicos do Azure como uma alternativa ao Armazenamento do Azure. Além disso, mostra como configurar o SQL para usar seu armazenamento durante a criação do aplicativo lógico no portal do Azure ou a implantação do aplicativo por meio do Visual Studio Code.

Se não estiver familiarizado com aplicativos lógicos, confira a seguinte documentação:

• O que são Aplicativos Lógicos do Azure
• Ambiente de locatário único versus multilocatário e o ambiente de serviço de integração para os Aplicativos Lógicos do Azure

Por que usar o SQL

Como uma opção de armazenamento alternativa disponível para Aplicativos Lógicos do Azure de locatário único, o SQL oferece os seguintes benefícios:

Quando usar o SQL

A tabela a seguir descreve algumas razões pelas quais você pode querer usar SQL:

Pré-requisitos

• Uma conta Azure e assinatura ativa. Se não tiver uma, inscreva-se em uma conta gratuita.

• Um ambiente SQL a ser usado com seu aplicativo lógico. No entanto, antes de configurar seu ambiente, conclua as seguintes etapas:

  1. Criar uma instância do SQL Server.

     Os tipos com suporte incluem SQL Server, banco de sados SQL do Azure, Instância Gerenciada de SQL do Azure e outros.

     • Caso se o servidor de SQL estiver hospedado no Azure usando um dos tipos com suporte, certifique-se de configurar as seguintes permissões:

       1. No portal do Azure, acesse o seu recurso SQL server.

       2. No menu de navegação de recursos, em Segurança, selecione Firewalls e redes virtuais.

       3. No painel que abre, em Permitir que serviços e recursos do Azure acessem este servidor, selecioneSim.

       4. Salve suas alterações.

     • Se o servidor de SQL não estiver hospedado no Azure, verifique se os firewalls ou as configurações de rede em seu servidor permitem que os serviços e recursos do Azure acessem o servidor e o banco de dados.

     • Se você estiver usando o SQL Express para desenvolvimento local, conecte-se à instância nomeada padrão localhost\SQLExpress.

  2. Criar ou usar um banco de dados existente.

     É necessário ter um banco de dados utilizável para poder configurar o provedor de Armazenamento de SQL.

  3. Agora você pode seguir as etapas para configurar seu ambiente de SQL neste artigo.

• Para desenvolvimento local, o Visual Studio Code, instalado em seu computador local.

  Observação

  Certifique-se de instalar a versão mais recente do Azure Functions Core Tools para garantir SQL suporte usando a versão do Microsoft Installer (MSI), que é func-cli-X.X.XXXX-x*.msi. Para obter mais informações sobre os requisitos de instalação do Visual Studio Code, examine criar fluxos de trabalho de integração com Aplicativos Lógicos do Azure de locatário único (Standard) no Visual Studio Code.

Configurar seu ambiente de SQL

1. Antes de configurar SQL provedor de Armazenamento, conclua as etapas necessárias nos Pré-requisitos.

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

   Atualmente, o provedor de Armazenamento de SQL dá suporte à autenticação SQL em cadeias de conexão. Você também pode usar a autenticação Windows para desenvolvimento e teste locais. No momento, o suporte para o Microsoft Entra ID e identidades gerenciadas não está disponível.

   Você deve usar uma identidade que tenha permissões para criar e gerenciar artefatos relacionados ao fluxo de trabalho no banco de dados de SQL de destino. Por exemplo, um administrador tem todas as permissões necessárias para criar e gerenciar esses artefatos. A lista a seguir descreve os artefatos que o tempo de execução de Aplicativos Lógicos do Azure de locatário único tenta criar usando a cadeia de conexão de SQL que você fornece. Verifique se a identidade usada na cadeia de conexão SQL tem as permissões necessárias para criar os seguintes artefatos:

   • Crie e exclua os seguintes esquemas: dt, dc e 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 houver informações confidenciais, como cadeias de conexão que incluam nomes de usuário e senhas, certifique-se de usar o fluxo de autenticação mais seguro disponível. A Microsoft recomenda autenticar o acesso aos recursos do Azure com uma identidade gerenciada quando possível e atribuir uma função que tenha o privilégio mínimo necessário.

   Se essa funcionalidade estiver indisponível, certifique-se de proteger as cadeias de conexão por meio de outras medidas, como o Azure Key Vault, que você pode usar com as configurações do aplicativo. Em seguida, você pode fazer referência direta a cadeias de caracteres seguras, como cadeias de conexão e chaves. De modo semelhante aos modelos do ARM, em que é possível definir variáveis de ambiente no momento da implantação, você pode definir as configurações de aplicativo na definição de fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar os valores da infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento, entre outros. Para obter mais informações, confira Tipos de aplicativo para a plataforma de identidade da Microsoft.

3. Conectar-se ao SQL.

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

   • Se você estiver usando o banco de dados de SQL do Azure, conclua os seguintes requisitos:

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

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

     • Configure os outros controles de acesso à rede de banco de dados SQL de acordo com as necessidades do seu cenário.

   • Se você está usando a Instância Gerenciada de SQL do Azure, permita que os serviços do Azure (logicapp) se conectem ao seu banco de dados do SQL pelos pontos de extremidade públicos protegidos.

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

Ao criar seu aplicativo lógico usando o tipo de recurso do Aplicativo Lógico (Standard) no Azure, você pode configurar SQL como seu provedor de armazenamento.

1. Entre no portal do Azure com sua conta do Azure.

2. Na caixa de pesquisa do portal do Azure, insira logic apps e selecione Aplicativos lógicos.

   

3. Na página Aplicativos Lógicos, selecione Adicionar.

4. Na página Criar Aplicativo Lógico, na guia Básico, forneça as seguintes informações sobre seu recurso de aplicativo lógico:

   Propriedade	Obrigatório	Valor	Descrição
   Assinatura	Sim	<Azure-subscription-name>	A assinatura do Azure usada para seu aplicativo lógico.
   Grupo de Recursos	Sim	<Azure-resource-group-name>	O grupo de recursos do Azure em que o aplicativo lógico e os recursos relacionados são criados. O nome deste recurso precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hifens (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
   Tipo	Sim	Standard	Este tipo de recurso de aplicativo lógico é executado no ambiente dos Aplicativos Lógicos do Azure de locatário único e usa o Modelo padrão de uso, cobrança e preços.
   Nome do Aplicativo Lógico	Sim	<logic-app-name>	O nome a ser usado para o aplicativo lógico. O nome deste recurso precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hifens (-), sublinhados (_), parênteses (()) e pontos (.). Este exemplo cria um aplicativo lógico chamado Fabrikam-Workflows. Observação: o nome do aplicativo lógico obtém automaticamente o sufixo, .azurewebsites.net, porque o recurso Aplicativo lógico (Standard) é alimentado pelo runtime do Aplicativos Lógicos do Azure de locatário único, que usa o modelo de extensibilidade do Azure Functions e é hospedado como uma extensão no runtime do Azure Functions. O Azure Functions usa a mesma convenção de nomenclatura de aplicativo.
   Publicar	Yes	<deployment-environment>	O destino de implantação para seu aplicativo lógico. Por padrão, o Fluxo de trabalho é selecionado para implantação nos Aplicativos Lógicos do Azure de locatário único. O Azure cria um recurso de aplicativo lógico vazio no qual você precisa adicionar seu primeiro fluxo de trabalho. Observação: atualmente, a opção Contêiner do Docker requer um local personalizado em um cluster Kubernetes habilitado para Azure Arc, que você pode usar com os Aplicativos Lógicos habilitados para Azure Arc (versão prévia). Os locais de recurso do seu aplicativo lógico, do local personalizado e do cluster devem ser todos iguais.
   Região	Sim	<Azure-region>	O local a ser usado ao criar o grupo de recursos e os recursos. Este exemplo implanta o aplicativo lógico de exemplo no Azure e usa Oeste dos EUA. - Se você selecionou Contêiner do Docker, selecione o local personalizado. – Para implantar em um recurso ASEv3, que deve existir primeiro, selecione esse recurso de ambiente na lista Região.

   O exemplo a seguir mostra a página Criar Aplicativo Lógicocom a guia Noções básicas:

   

5. Quando estiver pronto, selecione Próxima: hospedagem. Na guia Hospedagem, forneça as informações a seguir sobre a solução de armazenamento e o plano de hospedagem a serem usados para o aplicativo lógico.

   Propriedade	Obrigatório	Valor	Descrição
   Tipo de armazenamento	Sim	Armazenamento do Microsoft Azure e SQL	O tipo de armazenamento que você deseja usar para dados e artefatos relacionados ao fluxo de trabalho. -Se você tiver selecionado anteriormente um local personalizado como sua região, selecione SQL. -se você selecionou anteriormente uma região do azure ou local ASEv3, selecione SQL e Armazenamento do Microsoft Azure. Observação: se você estiver implantando em uma região do Azure, ainda precisará de uma conta de Armazenamento do Microsoft Azure, que é usada para concluir a hospedagem única da configuração do aplicativo lógico na plataforma Aplicativos Lógicos do Azure. A definição de fluxo de trabalho, estado, histórico de execução e outros artefatos de tempo de execução são armazenados em seu banco de dados SQL. Para implantações em um local personalizado hospedado em um cluster de Azure Arc, você só precisa SQL como seu provedor de armazenamento.
   Conta de armazenamento	Sim	<Azure-storage-account-name>	A conta de Armazenamento do Microsoft Azure a ser usada 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. Este exemplo cria uma conta de armazenamento chamada fabrikamstorageacct.
   Cadeia de Conexão SQL	Sim	<sql-connection-string>	Sua cadeia de conexão SQL, que atualmente dá 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 portal do Azure não validará essa cadeia de caracteres para você.
   Tipo de plano	Yes	<hosting-plan>	O plano de hospedagem a ser usado na implantação do aplicativo lógico. Para saber mais, confira Planos de hospedagem e tipos de preço.
   Plano do Windows	Yes	<plan-name>	O nome do plano a ser usado. Selecione o nome de um plano existente ou forneça o nome para um novo plano. Este exemplo usa o nome Fabrikam-Service-Plan.
   SKU e tamanho	Yes	<pricing-tier>	O tipo de preço a ser usado para seu aplicativo lógico. Sua seleção afeta o preço, a computação, a memória e o armazenamento que o aplicativo lógico e os fluxos de trabalho usam. Para alterar o tipo de preço padrão, selecione Alterar o tamanho. Em seguida, você pode selecionar outros tipos de preço, com base na carga de trabalho necessária. Para saber mais, confira Planos de hospedagem e tipos de preço.

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

   

6. Conclua as etapas de criação restantes em Criar um fluxo de trabalho de integração com os Aplicativos Lógicos do Azure (Standard) de locatário único no portal do Azure.

Ao terminar, o novo recurso de aplicativo lógico e o fluxo de trabalho ficarão ativos no Azure e usará seu banco de dados SQL como um provedor de armazenamento.

Configurar o SQL para o desenvolvimento local no Visual Studio Code

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

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

   1. Conheça os pré-requisitos para trabalhar o Visual Studio Code com a extensão dos Aplicativos Lógicos do Azure (Standard).

   2. Configure o Visual Studio Code para trabalhar com a extensão dos Aplicativos Lógicos do Azure (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 Explorer, na raiz do seu projeto de aplicativo de lógico, mova o ponteiro do mouse sobre qualquer área em branco sob de todos os outros arquivos e pastas do projeto, abra o menu de atalho e selecione Usar armazenamento de SQL para seu projeto de Aplicativo lógico.

   

4. Quando o prompt for exibido, insira sua cadeia de conexão do SQL. É possível optar por usar uma instância do SQL Expresso local ou qualquer outro banco de dados SQL que você tenha.

   

   Após a confirmação, Visual Studio Code cria a seguinte configuração no arquivo local.settings.json do projeto. É possível atualizar essa configuração a qualquer momento.

   

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

Você pode publicar diretamente seu projeto de aplicativo lógico do Visual Studio Code no Azure. Essa ação implanta o seu projeto de aplicativo lógico usando o tipo de recurso Aplicativo Lógico (Standard).

• Se você estiver publicando o projeto como um novo recurso de Aplicativo Lógico (Standard) no Azure e quiser usar o SQL como um provedor de armazenamento, insira sua cadeia de conexão SQL ao publicar seu aplicativo. Para etapas completas, sigaConfigurar o SQL para a implantação do novo aplicativo lógico.

• Se você já tiver definido sua SQL, poderá publicar seu projeto de aplicativo lógico em um recurso do Aplicativo Lógico (Standard) á implantado no Azure. Essa ação substitui seu aplicativo lógico existente.

  Observação

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

Configurar o SQL para a nova implantação de recursos do Aplicativo Lógico (Standard)

1. Na Barra de Atividade do Visual Studio Code, selecione o ícone do Azure.

2. Na barra de ferramentas do painel Azure: Aplicativos Lógicos (Standard) , selecione Implantar no Aplicativo Lógico.

   

3. Se solicitado, selecione a assinatura do Azure a ser usada para a implantação do aplicativo lógico.

4. Na lista que Visual Studio Code, selecione a opção avançada para Criar novo Aplicativo Lógico (Standard) no Azure Avançado. Caso contrário, você não será solicitado a configurar SQL.

   

5. Quando receber a solicitação, forneça um nome globalmente exclusivo para o aplicativo lógico, que é o nome a ser usado no recurso do Aplicativo Lógico (Standard). Este exemplo usa o Fabrikam-Workflows-App.

   

6. Selecione uma localização do 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 na qual você deseja implantar. Se você criou anteriormente um recurso de ASEv3 (Ambiente do Serviço de Aplicativo v3) e deseja implantá-lo, selecione o ASEv3.

   • Para implantar em Azure Arc os Aplicativos Lógicos habilitados, selecione o local personalizado configurado anteriormente.

   O exemplo a seguir mostra a lista de locais filtrada paraOeste dos EUA.

   

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

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

      

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

      Este exemplo seleciona Cria novo plano do Serviço de Aplicativo, pois nenhum outro plano está disponível.

      

8. Forneça um nome para o plano de hospedagem e um tipo de preço para o plano selecionado.

   Para saber mais, confira Planos de hospedagem e tipos de preço.

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

   Observação

   Embora você possa criar ou usar um grupo de recursos diferente, isso pode afetar o desempenho. Se você criar ou escolher um grupo de recursos diferente, mas cancelar após aparecer o prompt de confirmação, sua implantação também será cancelada.

10. Quando for solicitado que você selecione uma conta de armazenamento para seu aplicativo lógico, escolha uma das seguintes opções:

    • Se você tiver selecionado anteriormente um local personalizado, selecione a opção SQL.

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

      Observação

      Essa opção é necessária apenas para implantações do Azure. No Azure, o Armazenamento do Microsoft Azure é necessário para concluir uma hospedagem única da configuração do aplicativo lógico na plataforma Aplicativos Lógicos do Azure. O estado de 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 implantações em um local personalizado hospedado em um cluster de Azure Arc, você só precisa SQL como seu provedor de armazenamento.

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

    

12. Em seguida, selecione Simno prompt de confirmação de armazenamento de SQL. No prompt da cadeia de conexão, insira sua SQL de conexão.

    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ê.

    

13. Concluir as etapas de implantação restantes em Publicar em um novo recurso de Aplicativo Lógico (Standard).

Ao terminar, o novo recurso de aplicativo lógico e o fluxo de trabalho ficarão ativos no Azure e usará seu banco de dados SQL como um provedor de armazenamento.

Validar implantações

Depois de implantar o recurso do Aplicativo Lógico (Standard) no Azure, você poderá verificar se as configurações estão corretas:

1. Abra o recurso de aplicativo lógico no portal do Azure.

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

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

4. Em seu 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 runtime de Aplicativos Lógicos do Azure único criou para um recurso de aplicativo lógico com um único fluxo de trabalho:

O serviço de Aplicativos Lógicos do Azure 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 runtime de Aplicativos Lógicos do Azure único criou para um recurso de aplicativo lógico com um único fluxo de trabalho:

Próximas etapas

• Criar fluxos de trabalho de integração com os Aplicativos Lógicos do Azure (Standard) de locatário único no Visual Studio Code
• Editar as configurações de host e de aplicativo de aplicativos lógicos nos Aplicativos Lógicos do Azure de locatário único