Conectar-se a bancos de dados SQL a partir de fluxos de trabalho nos Aplicativos Lógicos do Azure

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

Este guia mostra como acessar seu banco de dados SQL de um fluxo de trabalho nos Aplicativos Lógicos do Azure usando o conector do SQL Server. Em seguida, você pode criar fluxos de trabalho automatizados que são executados quando acionados por eventos em seu banco de dados SQL ou em outros sistemas e executar ações para gerenciar seus dados e recursos SQL.

Por exemplo, seu fluxo de trabalho pode executar ações que obtêm, inserem e excluem dados ou que podem executar consultas SQL e procedimentos armazenados. Seu fluxo de trabalho pode verificar novos registros em um banco de dados não-SQL, fazer algum trabalho de processamento, usar os resultados para criar novos registros em seu banco de dados SQL e enviar alertas por email sobre os novos registros.

Se você é novo nos Aplicativos Lógicos do Azure, consulte os seguintes artigos para começar:

• O que é o Azure Logic Apps?
• Guia de início rápido: criar um exemplo de fluxo de trabalho do aplicativo lógico de consumo usando o portal do Azure
• Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão usando o portal do Azure

Edições SQL suportadas

O conector do SQL Server oferece suporte às seguintes edições SQL:

• Servidor SQL
• Base de Dados SQL do Azure
• Instância Gerida do SQL no Azure

Referência técnica do conector

O conector do SQL Server tem versões diferentes, com base no tipo de aplicativo lógico e no ambiente de host.

Limitações

Para obter mais informações, revise a referência do conector gerenciado do SQL Server ou a referência do conector interno do SQL Server.

Pré-requisitos

• Uma conta e subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.

• Banco de dados SQL Server, Banco de Dados SQL do Azure ou Instância Gerenciada SQL.

  O conector do SQL Server requer que suas tabelas contenham dados para que as operações do conector possam retornar resultados quando chamadas. Por exemplo, se você usar o Banco de Dados SQL do Azure, poderá usar os bancos de dados de exemplo incluídos para tentar as operações do conector do SQL Server.

• As informações necessárias para criar uma conexão de banco de dados SQL, como o servidor SQL e o nome do banco de dados. Se você estiver usando a Autenticação do Windows ou a Autenticação do SQL Server para autenticar o acesso, também precisará do seu nome de usuário e senha. Normalmente, você pode encontrar essas informações na cadeia de conexão.

  Importante

  Se você usar uma cadeia de conexão do SQL Server copiada diretamente do portal do Azure, precisará adicionar manualmente sua senha à cadeia de conexão. Para informações confidenciais, como essa cadeia de caracteres, certifique-se de usar 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 esse recurso não estiver disponível, certifique-se de proteger as cadeias de conexão por meio de outras medidas, como o Cofre da Chave do Azure, que você pode usar com as configurações do aplicativo em fluxos de trabalho Padrã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 dentro da definição de fluxo de trabalho do aplicativo lógico padrão. 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.

  • Para um banco de dados SQL no Azure, a cadeia de conexão tem o seguinte formato:

    Server=tcp:{your-server-name}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

    1. Para localizar essa cadeia de caracteres no portal do Azure, abra seu banco de dados.

    2. No menu do banco de dados, em Propriedades, selecione Cadeias de conexão.

  • Para um servidor SQL local, a cadeia de conexão tem o seguinte formato:

    Server={your-server-address};Database={your-database-name};User Id={your-user-name};Password={your-password};

• Em fluxos de trabalho padrão, para usar os gatilhos internos do SQL, você deve habilitar o controle de alterações na tabela em que deseja usar o gatilho. Para obter mais informações, consulte Habilitar e desabilitar o controle de alterações.

• O fluxo de trabalho do aplicativo lógico onde você deseja acessar seu banco de dados SQL. Para iniciar seu fluxo de trabalho com um gatilho do SQL Server, você precisa começar com um fluxo de trabalho em branco. Para usar uma ação do SQL Server, inicie seu fluxo de trabalho com qualquer gatilho.

• Para se conectar a um servidor SQL local, aplicam-se os seguintes requisitos extras, com base no fato de você ter um fluxo de trabalho de aplicativo lógico Consumo ou Padrão.

  • Fluxo de trabalho de consumo:

    Nos Aplicativos Lógicos do Azure multilocatário, você precisa do gateway de dados local instalado em um computador local e de um recurso de gateway de dados já criado no Azure.

  • Fluxo de trabalho padrão:

    Você pode usar o conector interno do SQL Server ou o conector gerenciado.

    • Para usar a autenticação do Microsoft Entra ou a autenticação de identidade gerenciada com seu aplicativo lógico, você precisa configurar seu SQL Server para trabalhar com esses tipos de autenticação. Para obter mais informações, consulte Autenticação - referência do conector gerenciado do SQL Server.

    • Para usar o conector interno, você pode autenticar sua conexão com uma identidade gerenciada, ID do Microsoft Entra ou uma cadeia de conexão. Você pode ajustar o pool de conexões especificando parâmetros na cadeia de conexão. Para obter mais informações, consulte Pool de conexões.

    • Para usar o conector gerenciado do SQL Server, siga os mesmos requisitos de um fluxo de trabalho de aplicativo lógico de consumo em Aplicativos Lógicos do Azure multilocatário. Para outros requisitos de conector, examine a referência do conector gerenciado do SQL Server.

Adicionar um gatilho do SQL Server

As etapas a seguir usam o portal do Azure, mas com a extensão apropriada de Aplicativos Lógicos do Azure, você também pode usar as seguintes ferramentas para criar fluxos de trabalho de aplicativos lógicos:

• Fluxos de trabalho de consumo: Visual Studio Code
• Fluxos de trabalho padrão: Visual Studio Code

Quando você salva seu fluxo de trabalho, esta etapa publica automaticamente suas atualizações em seu aplicativo lógico implantado, que está ativo no Azure. Com apenas um gatilho, seu fluxo de trabalho apenas verifica o banco de dados SQL com base em sua agenda especificada. Você precisa adicionar uma ação que responda ao gatilho.

Adicionar uma ação do SQL Server

As etapas a seguir usam o portal do Azure, mas com a extensão apropriada dos Aplicativos Lógicos do Azure, você também pode usar as seguintes ferramentas para criar fluxos de trabalho de aplicativos lógicos:

• Fluxos de trabalho de consumo: Visual Studio Code
• Fluxos de trabalho padrão: Visual Studio Code

Neste exemplo, o fluxo de trabalho do aplicativo lógico começa com o gatilho Recorrência e chama uma ação que obtém uma linha de um banco de dados SQL.

Ligar à sua base de dados

Quando você adiciona um gatilho ou ação que se conecta a um serviço ou sistema e não tem uma conexão existente ou ativa, os Aplicativos Lógicos do Azure solicitam que você forneça as informações de conexão, que variam de acordo com o tipo de conexão, por exemplo:

• As credenciais da sua conta
• Um nome a ser usado para a conexão
• O nome do servidor ou sistema
• O tipo de autenticação a ser usado
• Uma cadeia de conexão

Depois de fornecer essas informações, continue com as seguintes etapas com base no banco de dados de destino:

• Conectar-se ao Banco de Dados SQL do Azure baseado em nuvem ou à Instância Gerenciada do SQL
• Conectar-se ao SQL Server local

Conectar-se ao Banco de Dados SQL do Azure ou à Instância Gerenciada do SQL

Para acessar uma Instância Gerenciada SQL sem usar o gateway de dados local, você precisa configurar pontos de extremidade públicos na Instância Gerenciada SQL do Azure. O ponto de extremidade público usa a porta 3342, portanto, certifique-se de especificar esse número de porta ao criar a conexão a partir do seu aplicativo lógico.

Na caixa de informações de conexão, conclua as seguintes etapas:

1. Em Nome da conexão, forneça um nome a ser usado para sua conexão.

2. Para Tipo de autenticação, selecione a autenticação necessária e habilitada em seu banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada SQL:

   Autenticação	Descrição
   Cadeia de ligação	Com suporte apenas em fluxos de trabalho padrão com o conector incorporado do SQL Server. Requer a string de conexão com o seu servidor SQL e o seu banco de dados.
   Active Directory OAuth	Com suporte apenas em fluxos de trabalho padrão com o conector incorporado do SQL Server. Para obter mais informações, consulte a seguinte documentação: - Autenticação para o conector do SQL Server - Ativar OAuth 2.0 com o Microsoft Entra ID
   Identidade gerenciada de aplicativos lógicos	Suportado pelo conector gerido do SQL Server. Em fluxos de trabalho padrão, esse tipo de autenticação está disponível para o conector interno do SQL Server, mas a opção é chamada Identidade gerenciada. Requer os seguintes itens: - Uma identidade gerenciada válida que está habilitada em seu recurso de aplicativo lógico e tem acesso ao seu banco de dados. - Acesso da função de Colaborador do Banco de Dados SQL ao recurso do SQL Server --- Acesso de colaborador ao grupo de recursos que inclui o recurso do SQL Server. Para obter mais informações, consulte a seguinte documentação: - Autenticação de identidade gerenciada para o conector do SQL Server - Server-Level Funções
   Entidade de serviço (aplicação Microsoft Entra)	Suportado pelo conector gerido do SQL Server. Requer uma aplicação Microsoft Entra e um principal de serviço. Para obter mais informações, consulte Criar um aplicativo e entidade de serviço do Microsoft Entra que pode acessar recursos usando o portal do Azure.
   Microsoft Entra integrado	Suportado pelo conector gerido do SQL Server. Requer uma identidade gerenciada válida no Microsoft Entra que esteja habilitada em seu recurso de aplicativo lógico e tenha acesso ao seu banco de dados. Para obter mais informações, consulte estes artigos: - Visão geral da Segurança SQL do Azure - Autenticação - Autorizar o acesso ao banco de dados do SQL do Azure - Autenticação e autorização - Autenticação do Microsoft Entra para Azure SQL
   Autenticação do SQL Server	Suportado pelo conector gerido do SQL Server. Requer os seguintes itens: - Um recurso de gateway de dados criado anteriormente no Azure para sua conexão, independentemente de seu aplicativo lógico estar em Aplicativos Lógicos do Azure multilocatário. - Um nome de usuário válido e senha forte que são criados e armazenados em seu banco de dados SQL Server. Para obter mais informações, consulte os seguintes artigos: - Visão geral da Segurança SQL do Azure - Autenticação - Autorizar o acesso ao banco de dados do SQL do Azure - Autenticação e autorização

   O exemplo a seguir mostra como a caixa de informações de conexão pode aparecer se você usar o conector gerenciado do SQL Server e selecionar a autenticação integrada do Microsoft Entra :

   

3. Depois de selecionar Microsoft Entra integrado, selecione Entrar. Com base no fato de você usar o Banco de Dados SQL do Azure ou a Instância Gerenciada do SQL, selecione suas credenciais de usuário para autenticação.

4. Selecione estes valores para o seu banco de dados:

   Propriedade	Necessário	Descrição
   Nome do servidor	Sim	O endereço do seu servidor SQL, por exemplo, Fabrikam-Azure-SQL.database.windows.net
   Nome da base de dados	Sim	O nome do seu banco de dados SQL, por exemplo, Fabrikam-Azure-SQL-DB
   Nome da tabela	Sim	A tabela que você deseja usar, por exemplo, SalesLT.Customer

   Gorjeta

   Para fornecer informações sobre o banco de dados e a tabela, você tem estas opções:

   • Encontre essas informações na cadeia de conexão do seu banco de dados. Por exemplo, no portal do Azure, localize e abra seu banco de dados. No menu do banco de dados, selecione Cadeias de conexão ou Propriedades, onde você pode encontrar a seguinte cadeia de caracteres:

     Server=tcp:{your-server-address}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

   • Por padrão, as tabelas nos bancos de dados do sistema são filtradas, portanto, elas podem não aparecer automaticamente quando você seleciona um banco de dados do sistema. Como alternativa, você pode inserir manualmente o nome da tabela depois de selecionar Inserir valor personalizado na lista de banco de dados.

   Esta caixa de informações do banco de dados é semelhante ao exemplo a seguir:

   

5. Agora, continue com as etapas que você ainda não concluiu em Adicionar um gatilho SQL ou Adicionar uma ação SQL.

Conectar-se ao SQL Server local

Na caixa de informações de conexão, conclua as seguintes etapas:

1. Para conexões com seu servidor SQL local que exigem o gateway de dados local, verifique se você concluiu esses pré-requisitos.

   Caso contrário, seu recurso de gateway de dados não aparecerá na lista Gateway de Conexão quando você criar sua conexão.

2. Em Tipo de Autenticação, selecione a autenticação necessária e habilitada no SQL Server:

   Autenticação	Descrição
   Autenticação do SQL Server	Suportado por o conector gerido do SQL Server e o conector integrado do SQL Server. Requer os seguintes itens: - Um recurso de gateway de dados criado anteriormente no Azure para sua conexão, independentemente de seu aplicativo lógico estar em Aplicativos Lógicos do Azure multilocatário. - Um nome de usuário válido e senha forte que são criados e armazenados em seu SQL Server. Para obter mais informações, consulte Autenticação do SQL Server.
   Autenticação do Windows	Suportado pelo conector gerido do SQL Server. Requer os seguintes itens: - Um recurso de gateway de dados criado anteriormente no Azure para sua conexão, independentemente de seu aplicativo lógico estar em Aplicativos Lógicos do Azure multilocatário. - Um nome de utilizador e palavra-passe válidos do Windows para confirmar a sua identidade através da sua conta Windows. Para obter mais informações, consulte Autenticação do Windows.

3. Selecione ou forneça os seguintes valores para seu banco de dados SQL:

   Propriedade	Necessário	Descrição
   Nome do servidor SQL	Sim	O endereço do seu servidor SQL, por exemplo, Fabrikam-Azure-SQL.database.windows.net
   Nome da base de dados SQL	Sim	O nome do banco de dados do SQL Server, por exemplo, Fabrikam-Azure-SQL-DB
   Nome de utilizador	Sim	Seu nome de usuário para o servidor SQL e o banco de dados
   Palavra-passe	Sim	Sua senha para o servidor SQL e o banco de dados
   Subscrição	Sim, para autenticação do Windows	A assinatura do Azure para o recurso de gateway de dados que você criou anteriormente no Azure
   Gateway de conexão	Sim, para autenticação do Windows	O nome do recurso de gateway de dados que você criou anteriormente no Azure Dica: Se o gateway não aparecer na lista, verifique se você configurou corretamente o gateway.

   Gorjeta

   Você pode encontrar essas informações na cadeia de conexão do seu banco de dados:

   • Server={your-server-address}
   • Database={your-database-name}
   • User ID={your-user-name}
   • Password={your-password}

   O exemplo a seguir mostra como a caixa de informações de conexão pode aparecer se você selecionar a autenticação do Windows .

   

4. Quando estiver pronto, selecione Criar.

5. Continue com as etapas que você ainda não concluiu em Adicionar um gatilho SQL ou Adicionar uma ação SQL.

Lidar com dados em massa

Às vezes, você trabalha com conjuntos de resultados tão grandes que o conector não retorna todos os resultados ao mesmo tempo. Ou, você quer um melhor controle sobre o tamanho e a estrutura de seus conjuntos de resultados. A lista a seguir inclui algumas maneiras de lidar com conjuntos de resultados tão grandes:

• Para ajudá-lo a gerenciar os resultados como conjuntos menores, ative a paginação. Para obter mais informações, consulte Obter mais dados, itens ou registros usando paginação nos Aplicativos Lógicos do Azure. Para obter mais informações, consulte Paginação SQL para transferência de dados em massa com aplicativos lógicos.

• Crie um procedimento armazenado que organize os resultados da maneira desejada. O conector do SQL Server fornece muitos recursos de back-end que você pode acessar usando os Aplicativos Lógicos do Azure para que você possa automatizar mais facilmente as tarefas de negócios que funcionam com tabelas do banco de dados SQL.

  Quando uma ação SQL obtém ou insere várias linhas, o fluxo de trabalho do aplicativo lógico pode iterar por essas linhas usando um loop até dentro desses limites. No entanto, quando seu aplicativo lógico precisa trabalhar com conjuntos de registros tão grandes, por exemplo, milhares ou milhões de linhas, que você deseja minimizar os custos resultantes de chamadas para o banco de dados.

  Para organizar os resultados da maneira desejada, você pode criar um procedimento armazenado que é executado em sua instância SQL e usa a SELECT - ORDER BY instrução. Esta solução dá-lhe mais controlo sobre o tamanho e a estrutura dos seus resultados. Seu aplicativo lógico chama o procedimento armazenado usando a ação Executar procedimento armazenado do conector do SQL Server. Para obter mais informações, consulte SELECT - ORDER BY Clause.

  Nota

  O conector do SQL Server tem um limite de tempo limite de procedimento armazenado inferior a 2 minutos. Alguns procedimentos armazenados podem levar mais tempo do que esse limite para serem concluídos, causando um 504 Timeout erro. Você pode contornar esse problema usando um gatilho de conclusão de SQL, consulta de passagem SQL nativa, uma tabela de estado e trabalhos do lado do servidor.

  Para essa tarefa, você pode usar o Azure Elastic Job Agent for Azure SQL Database. Para SQL Server local e Instância Gerenciada SQL, você pode usar o SQL Server Agent. Para saber mais, consulte Manipular tempos limite de procedimento armazenado de longa execução no conector do SQL Server para Aplicativos Lógicos do Azure.

Lidar com dados dinâmicos em massa

Quando você chama um procedimento armazenado usando o conector do SQL Server, a saída retornada às vezes é dinâmica. Neste cenário, siga estes passos:

1. No portal do Azure, abra seu aplicativo lógico e fluxo de trabalho no designer.

2. Exiba o formato de saída executando uma execução de teste. Copie e salve a saída da amostra.

3. No designer, sob a ação em que você chama o procedimento armazenado, adicione a ação interna chamada Analisar JSON.

4. Na ação Analisar JSON, selecione Usar carga útil de exemplo para gerar esquema.

5. Na caixa Inserir ou colar uma carga JSON de exemplo, cole a saída da amostra e selecione Concluído.

   Nota

   Se você receber um erro informando que os Aplicativos Lógicos do Azure não podem gerar um esquema, verifique se a sintaxe da saída do exemplo está formatada corretamente. Se ainda não for possível gerar o esquema, na caixa Esquema , insira manualmente o esquema.

6. Quando tiver terminado, guarde o fluxo de trabalho.

7. Para fazer referência às propriedades de conteúdo JSON, siga estas etapas:

   1. Selecione dentro das caixas de edição onde deseja fazer referência às propriedades JSON.
   2. Selecione o ícone de relâmpago para abrir a lista de conteúdo dinâmico.
   3. Na lista, na seção Analisar JSON , selecione os tokens de dados para as propriedades de conteúdo JSON desejadas.

Conteúdo relacionado

• Conectores gerenciados para Aplicativos Lógicos do Azure
• Conectores incorporados nas Azure Logic Apps