Configurar o armazenamento do banco de dados SQL para fluxos de trabalho Standard nos Aplicativos Lógicos do Azure (versão prévia)

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

Se você criar aplicativos lógicos Standard hospedados nos Aplicativos Lógicos do Azure, no Ambiente do Serviço de Aplicativo v3 ou em sua própria infraestrutura, você sempre precisa de um provedor de armazenamento para salvar artefatos de fluxo de trabalho, dados de estado e runtime. Ao configurar seu próprio banco de dados SQL como provedor de armazenamento, você obtém mais flexibilidade e controle sobre seu ambiente de runtime de fluxo de trabalho, taxa de transferência, dimensionamento, desempenho e gerenciamento.

Este guia descreve por que e como configurar um banco de dados SQL como o provedor de armazenamento. Você pode concluir essa tarefa durante a criação do aplicativo lógico com o portal do Azure ou a implantação com o Visual Studio Code.

Por que configurar o armazenamento do banco de dados SQL

Um banco de dados SQL fornece os seguintes benefícios:

Quando escolher o SQL

A tabela a seguir descreve cenários em que você pode escolher o SQL:

Pré-requisitos

• Uma conta Azure e assinatura ativa. Obtenha uma conta gratuita.

• Um ambiente do SQL Server e do banco de dados para seu aplicativo de lógica. No entanto, antes de configurar seu ambiente, conclua as seguintes etapas:

  1. Criar uma instância do SQL Server.

     Edições do SQL Server com suporte:

     • SQL Server

     • Banco de Dados SQL do Azure

     • Instância Gerenciada de SQL do Azure e outros

  2. Se o SQL Server tiver suporte e estiver hospedado no Azure, certifique-se de configurar as seguintes permissões:

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

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

     3. No painel aberto, em Permitir que os serviços e recursos do Azure acessem esse servidor, selecione Sim.

     4. Salve suas alterações.

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

  4. Se você tiver o SQL Express para desenvolvimento local, conecte-se à instância localhost\SQLExpressnomeada padrão.

  5. Crie ou reutilize um banco de dados existente.

     Você deve ter um banco de dados ativo e viável antes de configurar o Provedor de Armazenamento sql.

  6. Siga as etapas para configurar seu ambiente SQL neste artigo.

  7. Para o desenvolvimento local, você precisa do Visual Studio Code instalado localmente em seu computador.

     Observação

     Certifique-se de instalar as ferramentas principais mais recentes do Azure Functions e de que você possui suporte para SQL selecionando o Instalador da Microsoft (MSI), que é func-cli-X.X.XXXX-x*.msi. Para obter mais informações sobre os requisitos do Visual Studio Code, consulte Criar fluxos de trabalho Standard nos Aplicativos Lógicos do Azure com o Visual Studio Code.

Configurar seu ambiente de SQL

1. Antes de configurar o Provedor de Armazenamento sql, confirme se você terminou as etapas necessárias nos pré-requisitos.

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

   Atualmente, o Provedor de Armazenamento SQL dá suporte à autenticação SQL por meio de cadeias de conexão. Você também pode escolher a Autenticação do 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 ter uma identidade com as permissões para criar e gerenciar artefatos de fluxo de trabalho no banco de dados 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 runtime dos Aplicativos Lógicos do Azure tenta criar com a cadeia de conexão SQL que você fornece. Verifique se a identidade 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 você tiver informações confidenciais, como cadeias de conexão que incluem nomes de usuário e senhas, escolha 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 não estiver disponível, certifique-se de proteger cadeias de conexão por meio de outras medidas, como o Azure Key Vault, que você pode adicionar às configurações do aplicativo. Em seguida, você pode fazer referência direta a cadeias de caracteres seguras, como cadeias de conexão e chaves. Semelhante aos modelos do ARM, em que 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 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, consulte Tipos de aplicativo para a plataforma de identidade da Microsoft.

3. Conecte-se ao servidor SQL e ao banco de dados.

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

   • Se você tiver um banco de dados 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ê tiver a Instância Gerenciada de SQL do Azure, permita que os serviços do Azure (logicapp) se conectem ao banco de dados SQL por meio de pontos de extremidade públicos protegidos.

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

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

1. Na caixa de pesquisa do portal do Azure , insira logic appse selecione Aplicativos lógicos.

   

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

3. Na página Criar Aplicativo Lógico , em Standard, selecione a opção de hospedagem desejada.

4. Na guia Noções básicas , forneça as seguintes informações, que podem variar de acordo com suas seleções:

   Propriedade	Obrigatório	Value	Description
   Subscription	Yes	< Nome da assinatura do Azure>	A assinatura do Azure para seu aplicativo lógico.
   Grupo de Recursos	Yes	< Azure-resource-group-name>	O grupo de recursos do Azure para seu aplicativo lógico e recursos relacionados. O nome deve ser exclusivo entre regiões e pode conter apenas letras, números, hifens (-), sublinhados (_), parênteses (()) e períodos (.). Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
   Tipo	Yes	Standard	Esse tipo de aplicativo lógico segue o modelo padrão de uso, cobrança e preços.
   Nome do Aplicativo Lógico	Yes	< logic-app-name>	O nome do seu 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 recebe automaticamente o sufixo .azurewebsites.net, pois o recurso de aplicativo lógico Standard é da plataforma do runtime de 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.
   Região	Yes	< Região do Azure>	A localização do grupo de recursos e dos recursos. Este exemplo implanta o aplicativo lógico de exemplo no Azure e usa Oeste dos EUA. – Para implantar em um recurso ASEv3, que deve existir primeiro, selecione esse recurso de ambiente na lista Região.
   Plano do Windows	Yes	< nome do plano>	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 My-App-Service-Plan. Observação: não escolha um plano do Serviço de Aplicativo baseado em Linux. Só há suporte para o Plano do Serviço de Aplicativo baseado no Windows.
   Plano de preços	Yes	< tipo de preço>	O nível de preço para seu aplicativo lógico e fluxos de trabalho. Sua seleção afeta os preços, a computação, a memória e o armazenamento para seu aplicativo lógico e fluxos de trabalho. Para obter mais informações, confira Planos de hospedagem e tipos de preços.

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

   

5. Quando estiver pronto, selecione Avançar: Armazenamento. Na guia Armazenamento , forneça as seguintes informações sobre a solução de armazenamento e o plano de hospedagem para seu aplicativo lógico.

   Propriedade	Obrigatório	Value	Description
   Tipo de armazenamento	Yes	Armazenamento do Microsoft Azure e SQL	O armazenamento de artefatos e dados de fluxo de trabalho. - Se você selecionou um local personalizado como sua região, selecione SQL. - Se você selecionou uma região do Azure ou local ASEv3, selecione SQL e Armazenamento do Azure. Observação: se você estiver implantando em uma região do Azure, ainda precisará de uma conta de Armazenamento do Azure. Esse requisito conclui a hospedagem única da configuração do aplicativo lógico na plataforma de 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 do Azure Arc, você só precisa de um banco de dados SQL para armazenamento.
   Conta de armazenamento	Yes	< Azure-storage-account-name>	A conta de Armazenamento do Azure 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	Yes	< 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ê.

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

   

6. Conclua as etapas restantes em Criar um exemplo de fluxo de trabalho Standard nos Aplicativos Lógicos do Azure de locatário único.

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 projeto de aplicativo lógico, mova o ponteiro do mouse sobre qualquer área em branco em todos os arquivos e pastas do projeto, abra o menu de atalho e selecione Usar o armazenamento SQL para seu projeto de aplicativo lógico.

   

4. Quando o prompt for exibido, insira sua cadeia de conexão do SQL. Você pode escolher uma instância do SQL Express 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 seu projeto de aplicativo lógico em um recurso de aplicativo lógico Standard.

• Se você estiver publicando seu projeto como um novo recurso de aplicativo lógico Standard no Azure e quiser um banco de dados 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 configurado as configurações do SQL, poderá publicar seu projeto de aplicativo lógico em um recurso de aplicativo lógico Standard já 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 recurso de aplicativo lógico Standard

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

2. No painel do Explorador, na raiz do projeto de aplicativo lógico, mova o ponteiro do mouse sobre qualquer área em branco abaixo de todos os arquivos e pastas do projeto, abra o menu de atalho e selecione Implantar no aplicativo lógico.

3. Se solicitado, selecione a assinatura do Azure 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 solicitado, forneça um nome global exclusivo para seu novo aplicativo lógico, que é o nome do recurso de aplicativo lógico Standard. Este exemplo usa 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 um recurso do ambiente de Serviço de Aplicativo v3 (ASEv3) e deseja implantá-lo lá, selecione o ASEv3.

   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 obter mais informações, confira Planos de hospedagem e tipos de preços.

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 escolher 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ê selecionou 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 Azure é necessário para concluir uma hospedagem única da configuração do aplicativo lógico na plataforma de 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 do Azure Arc, você só precisa de um banco de dados SQL para armazenamento.

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

    

12. No prompt de confirmação do armazenamento SQL, selecione Sim. 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. Conclua as etapas restantes de implantação 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 de aplicativo lógico Standard no Azure, você pode 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:

Conteúdo relacionado

• O que são Aplicativos Lógicos do Azure?
• Locatário único versus multilocatário nos Aplicativos Lógicos do Azure
• Criar fluxos de trabalho Standard nos Aplicativos Lógicos do Azure com o Visual Studio Code
• Editar configurações de host e aplicativo para aplicativos lógicos Standard