SQL Server

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automate
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Aplicações Power	Premium	Todas as regiões do Power Apps
Automatize o poder	Premium	Todas as regiões do Power Automate

Metadados do conector
Editora	Microsoft

Conector em profundidade

Este artigo descreve as operações para o conector gerenciado do SQL Server, que está disponível para Aplicativos Lógicos do Azure, Power Automatizar e Power Apps. O conector interno do SQL Server está disponível apenas para fluxos de trabalho de aplicativos lógicos padrão em Aplicativos Lógicos do Azure.

• Para obter mais informações sobre esse conector no Power Apps, consulte Conectar-se ao SQL Server a partir do Power Apps.
• Para obter mais informações sobre o conector interno e o conector gerenciado do SQL Server nos Aplicativos Lógicos do Azure, consulte Conectar-se a bancos de dados SQL a partir de fluxos de trabalho em Aplicativos Lógicos do Azure.

Authentication

Se você quiser criar conexões que não sejam do Microsoft Entra ID (Microsoft Entra ID), use a opção de autenticação da cadeia de conexão. Certifique-se de fornecer os mesmos valores de nome de servidor e nome de banco de dados conforme definido em sua conexão.

Autenticação do Microsoft Entra ID

Limitações conhecidas com a autenticação do Microsoft Entra ID

Devido às limitações atuais do pipeline de autenticação, os usuários convidados do Microsoft Entra ID não são suportados para conexões do Microsoft Entra ID com o SQL Server. Para resolver esse problema, use a autenticação do SQL Server ou a autenticação do Windows.

Habilitar a autenticação de ID do Microsoft Entra para SQL Server

1. Configure e provisione sua conta como um membro SQL Microsoft Entra ID (Microsoft Entra ID). Para obter mais informações, consulte Configurar e gerenciar a autenticação do Microsoft Entra ID com o Azure SQL.

2. No servidor SQL, configure o administrador do Microsoft Entra ID.

   1. No portal do Azure, vá para o servidor SQL onde você deseja habilitar a autenticação do Microsoft Entra ID.
   2. No menu de recursos do SQL Server, em Configurações, selecione ID do Microsoft Entra.
   3. Na barra de ferramentas do painel ID do Microsoft Entra , selecione Definir administrador.
   4. Localize e selecione uma conta de usuário do Microsoft Entra ID no locatário atual para torná-lo um administrador do servidor. Salve suas alterações.

3. Em seu locatário do Microsoft Entra ID, crie e registre um aplicativo Microsoft Entra ID para acessar seu banco de dados SQL. Para obter mais informações, consulte SQL Server - Configurar a autenticação do Microsoft Entra ID.

   1. No portal do Azure, vá para o locatário do Microsoft Entra ID onde você deseja criar o aplicativo Microsoft Entra ID.

   2. No menu do inquilino, em Gerir, selecione Registos de> aplicaçõesNovo registo.

   3. No painel Registrar um aplicativo , forneça um nome para o aplicativo. Lembre-se desse nome para que você possa mais tarde criar um usuário e conceder acesso de função ao seu banco de dados SQL.

   4. Quando terminar, selecione Registrar, que cria o aplicativo Microsoft Entra ID.

   5. No painel Registros de aplicativos , selecione seu novo aplicativo Microsoft Entra ID. No menu do aplicativo, selecione Certificados & segredosNovo segredo do > cliente.

   6. Forneça uma descrição para o segredo e selecione uma expiração.

4. Entre no servidor SQL e no banco de dados com as credenciais da conta de usuário do Microsoft Entra ID que você configurou como administrador do servidor.

5. Em seu banco de dados SQL, crie um usuário contido para representar o aplicativo Microsoft Entra ID. Esta etapa requer o Microsoft SQL Server Management Studio (SSMS).

   As etapas a seguir atribuem as funções de db_datareader e db_datawriter para o aplicativo Microsoft Entra ID com o nome example-Azure-AD-application-name. Ao executar os comandos especificados, lembre-se de substituir example-Azure-AD-application-name pelo nome do seu aplicativo Microsoft Entra ID e atribuir as funções necessárias para suas necessidades.

   1. Inicie o SSMS e conecte-se ao servidor SQL onde o aplicativo Microsoft Entra ID acessará.

   2. Em Autenticação, use o Ative Directory - Universal com suporte a MFA e a conta Microsoft Entra ID que você configurou como administrador do servidor.

   3. No Pesquisador de Objetos, expanda a pasta Bancos de Dados .

   4. Localize seu banco de dados, abra o menu de atalho do banco de dados e selecione Nova consulta.

   5. Na janela de consulta, execute o seguinte comando para vincular o aplicativo Microsoft Entra ID a um novo usuário no banco de dados:

      CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDER
      

   6. Desmarque a janela de consulta. Em seguida, execute o seguinte comando para atribuir a db_datareader função ao aplicativo Microsoft Entra ID:

      ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]
      

   7. Repita a etapa anterior para atribuir a db_datawriter função ao aplicativo Microsoft Entra ID:

      ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
      

Autenticação de identidade gerida

Atualmente, apenas os Aplicativos Lógicos do Azure dão suporte à autenticação de identidade gerenciada para o conector do SQL Server.

Autenticação do Service Principal

Configurar a identidade gerenciada em seu aplicativo lógico

1. No portal do Azure, vá para o recurso do aplicativo lógico.

2. Habilite a identidade atribuída pelo sistema ou a identidade atribuída pelo usuário. Se você não tiver uma identidade atribuída pelo usuário, primeiro terá que criar essa identidade. Para obter mais informações, consulte Autenticar o acesso aos recursos do Azure com identidades gerenciadas nos Aplicativos Lógicos do Azure.

3. Se você selecionou a identidade atribuída pelo usuário, certifique-se de que adicionou essa identidade ao recurso do aplicativo lógico.

   1. No portal do Azure, navegue até o recurso de aplicativo lógico onde você deseja usar a identidade gerenciada.
   2. No menu de navegação do aplicativo lógico, em Configurações, selecione Identidade.
   3. Na guia Usuário atribuído, selecione Adicionar.
   4. Selecione a identidade gerenciada a ser usada e selecione Adicionar.

Configurar o SQL Server para autenticação de identidade gerenciada

1. No servidor SQL, configure o administrador do Microsoft Entra ID.

   1. No portal do Azure, navegue até o servidor SQL onde você deseja habilitar a autenticação do Microsoft Entra ID.
   2. No menu de recursos do SQL Server, em Configurações, selecione ID do Microsoft Entra.
   3. Na barra de ferramentas do painel ID do Microsoft Entra , selecione Definir administrador.
   4. Localize e selecione uma conta de usuário do Microsoft Entra ID no locatário atual para torná-lo um administrador do servidor. Salve suas alterações.

2. Em seu banco de dados SQL, crie um usuário contido para representar a identidade gerenciada. Esta etapa requer o Microsoft SQL Server Management Studio (SSMS).

   As etapas a seguir atribuem a função de a uma identidade gerenciada db_datareader com o nome example-managed-identity-name. Ao executar os comandos especificados, lembre-se de substituir example-managed-identity-name pelo nome da identidade gerenciada e atribuir a função correta para suas necessidades. Por exemplo, db_datareader não é possível executar operações de gravação.

   1. Inicie o SSMS e conecte-se ao servidor SQL onde a identidade gerenciada será acessada.

   2. Em Autenticação, use o Ative Directory - Universal com suporte a MFA e a conta Microsoft Entra ID que você configurou como administrador do servidor.

   3. No Pesquisador de Objetos, expanda a pasta Bancos de Dados .

   4. Localize seu banco de dados, abra o menu de atalho do banco de dados e selecione Nova consulta.

   5. Na janela de consulta, execute o seguinte comando para vincular a identidade gerenciada a um novo usuário no banco de dados:

      CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER
      

   6. Desmarque a janela de consulta. Em seguida, execute o seguinte comando para atribuir uma função à identidade de gerenciamento:

      ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]
      

      Observação

      Se você atribuir funções à identidade gerenciada no nível do banco de dados, a identidade não terá os escopos necessários para listar todos os bancos de dados. Ao selecionar na lista Nome do banco de dados em um gatilho ou ação SQL, você receberá um erro como o exemplo a seguir:

      Couldn't retrieve values. Error code: 'Unauthorized', Message: 'Credentials are missing or not valid'.
      Inner exception: The credentials provided for the SQL source are invalid
      

      Para resolver esse problema, você tem as seguintes opções:

      • Atribua uma função de nível de servidor que possa listar todos os bancos de dados à identidade gerenciada.
      • No gatilho ou ação SQL, insira o nome do banco de dados usando a opção Inserir valor personalizado .

Para obter mais informações, consulte a seguinte documentação:

• Autenticar o acesso aos recursos do Azure usando identidades gerenciadas nos Aplicativos Lógicos do Azure
• Tutorial: Usar uma identidade gerenciada atribuída ao sistema de VM do Windows para acessar o SQL do Azure
• Configurar e gerenciar a autenticação do Microsoft Entra ID com o Azure SQL
• Funções no nível de banco de dados
• Funções no nível do servidor

Suporte de Rede Virtual

Quando o conector é usado em um Power Platform ambiente vinculado a uma rede virtual, aplicam-se limitações:

• As seguintes ações são as únicas ações apoiadas:

  • Excluir linha (V2)
  • Executar uma consulta SQL (V2)
  • Obter linha (V2)
  • Obter linhas (V2)
  • Obter tabelas (V2)
  • Inserir linha (V2)
  • Linha de atualização (V2)
  • Executar procedimento armazenado (V2)

• Qualquer ação fora desta lista retornará um erro "403 Não autorizado"

• Não há suporte para gateway de dados local

• Ao usar a autenticação integrada do Microsoft Entra ID, digite o nome do banco de dados manualmente como um valor personalizado

Problemas conhecidos e limitações com ações

Breve descrição	Operations	Descrição longa
Obter resultados determinísticos em uma saída de ação	Obter linhas (V2)	O uso do parâmetro é recomendado para obter resultados determinísticos na saída da Order By ação. Se Order By não for especificado, chaves primárias ou chaves exclusivas serão usadas pelo SQL Server por padrão. Resultados não determinísticos podem causar problemas, como duplicação de registros na saída da ação quando a paginação está habilitada. As exibições SQL não oferecem suporte à chave primária, que é a limitação do próprio SQL Server.
Executar uma consulta SQL suporte limitado	Executar uma consulta SQL (V2)	Não há suporte para SQL Server local.
Requisitos gerais da CRUD	Obter linha (V2) Obter linhas (V2) Linha de atualização (V2) Excluir linha (V2)	Os valores de cadeia de caracteres serão cortados no caso do uso da instância SQL do Azure. Portanto, cadeias de caracteres em branco serão convertidas em cadeias vazias. Para operações INSERT e UPDATE, o conector retornará as linhas atualizadas. Isso requer que a conexão também precise ter permissão para ler dados do SQL Server. Uma chave primária é necessária para as seguintes operações: - GetItem - PatchItem - DeleteItem
Suporte a parâmetros de transformação de agregação	Obter linhas (V2)	Somente as seguintes transformações de agregação são suportadas: - filter: Permite filtrar o conjunto de entradas. Suporta as mesmas expressões que $filter. Exemplo: filter(ColName1 eq 1). - agregado: Permite a agregação usando um dos seguintes métodos: average, max, min, sum, countdistinct. Exemplo: aggregate(ColName2 with max as MaxValue). Você pode combinar vários operadores separados por barras para expressar que eles são aplicados consecutivamente. Isso significa que o resultado de cada transformação é a entrada para a próxima transformação. Exemplo: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
Tipo de dados do parâmetro formal substituído ao executar uma consulta SQL	Executar uma consulta SQL [DEPRECATED] Executar uma consulta SQL (V2)	O tipo de dados inserido ao definir um parâmetro formal em uma consulta SQL pode ser substituído, uma vez que a implementação subjacente do conector determina o tipo por meio do valor fornecido do parâmetro.
O operador IN usando parâmetros formais requer que os valores passados sejam definidos separadamente	Executar uma consulta SQL (V2)	Ao utilizar parâmetros formais com o operador IN, todos os valores passados precisam ser definidos separadamente, em vez de como um único parâmetro formal que abriga vários valores separados por vírgula. Exemplo: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Falha ao usar o banco de dados do Azure Sql DataWareHouse	Inserir linha (V2)	O uso do Banco de Dados SQL Datawarehouse do Azure no Power Apps resulta em falha devido a uma incompatibilidade de sintaxe na execução do conector no banco de dados. Crie um fluxo com o conector do SQL Datawarehouse do Azure no Power Automate, acione-o a partir do PowerApps ou forme uma consulta e use-o na Ação Executar uma consulta SQL (V2).

Problemas conhecidos e limitações com gatilhos

Breve descrição	Operations	Descrição longa
Modificar um item: operações de linha	Quando um item é modificado (V2)	Dispara em operações de linha INSERT e UPDATE.
Modificar um item: requisitos de coluna	Quando um item é modificado (V2)	É necessária uma coluna ROWVERSION.
Criar um item: requisito de coluna	Quando um item é criado (V2)	É necessária uma coluna IDENTIDADE.
Criar um item	Quando um item é criado (V2)	Use o valor da coluna de identidade da linha inserida mais recente como um limite (estado de gatilho) para identificar as linhas recém-inseridas posteriormente. A lógica pressupõe que a identidade de cada nova linha tem de ser maior do que a anterior. Portanto, caso a sequência de identidade seja redefinida para uma tabela devido ao comando t-sql explícito ou truncamento de tabela, a lógica de gatilho ignorará novas linhas para o fluxo existente. Há duas soluções alternativas diferentes possíveis: primeiro, você pode redefinir o estado do gatilho de fluxo atualizando o cartão de ação de gatilho (por exemplo, renomeá-lo, atualizar parâmetros ou adicionar uma nova conexão) e salvar as alterações. Ou, você pode restaurar a sequência de identidade da tabela de destino usando a seguinte abordagem.

Problemas e limitações gerais conhecidos

• Inserir e atualizar para uma tabela não funcionará se você definiu um gatilho do lado do servidor SQL na tabela.

  Para resolver esse problema, você tem as seguintes opções:

  • Use um procedimento armazenado ou uma consulta nativa.
  • Remova o gatilho da tabela SQL.

• As limitações a seguir se aplicam ao uso do conector SQL com um servidor SQL local:

  • A versão mínima com suporte para o SQL Server local é o SQL Server 2005.
  • O limite de tamanho da solicitação é de 2 MB por meio do SQL Server local.
  • O limite de tamanho de resposta é de 8 MB através do SQL Server local.

• As limitações a seguir se aplicam à invocação de um procedimento armazenado em um servidor SQL local por meio de um gateway:

  • Os valores de saída para OUTPUT parâmetros não são retornados. Você ainda pode especificar valores de entrada para OUTPUT parâmetros.
  • O valor ResultSets é Untyped.
  • O valor de retorno não está disponível.
  • Apenas o primeiro conjunto de resultados é retornado.
  • Não há suporte para esquemas dinâmicos para conjuntos de resultados.

• Os seguintes tipos de dados não podem ser usados como predicados de opção de consulta:

  • date
  • datetime
  • datetime2
  • smalldatetime

• Não há suporte para a configuração de Forçar Criptografia. Por padrão, o Banco de Dados SQL e a Instância Gerenciada SQL protegem os dados do cliente criptografando os dados em movimento com TLS (Transport Layer Security). Para obter mais informações, consulte Visão geral da segurança do SQL do Azure.

• O suporte a vários conjuntos de resultados está atualmente limitado para a execução de consultas nativas SQL. Somente os conjuntos de resultados, até o primeiro conjunto de resultados vazio, são retornados.

  Para resolver esse problema, use procedimentos armazenados.

• Após a execução de consultas SQL e procedimentos armazenados, o esquema do conjunto de resultados deve conter nomes de colunas não vazias exclusivos.

• Para qualquer operação dentro do procedimento armazenado que retorna algum conjunto de resultados, como qualquer instrução interna SELECT , o esquema do conjunto de resultados deve conter nomes de coluna não vazios exclusivos.

• Se o tempo de execução exceder 110 segundos para uma consulta SQL ou procedimento armazenado, as ações expirarão.

  Em Aplicativos Lógicos do Azure, para contornar essa limitação e aprender a executar procedimentos armazenados de longa execução, consulte Procedimentos armazenados SQL de longa execução em Aplicativos Lógicos.

• Nos Aplicativos Lógicos do Azure, você pode acessar o ponto de extremidade privado no SQL Server somente de dentro de um ambiente de serviço de integração (ISE). Para obter mais informações, consulte Acesso a redes virtuais do Azure.

• Ao criar uma consulta com muitos filtros, o seguinte erro pode ocorrer: "A árvore de sintaxe de consulta OData excedeu o limite de contagem de nós de '100'. Por favor, tente simplificar as expressões de parâmetros de consulta OData". Para evitar esse problema, otimize as condições de filtragem para reduzir seu número (por exemplo, usando intervalos).

• Não é recomendado armazenar grandes quantidades de dados (mais de 30 megabytes) nos campos da tabela de destino (e.g. xml ou tipos de dados de texto). Pode levar a uma degradação significativa do desempenho de ações e gatilhos, causando erros de tempo limite 504. Por favor, use o parâmetro 'Select Query' para incluir apenas campos relativamente pequenos e evitar grandes campos de dados de saída. Ou, em vez disso, use armazenamentos de arquivos especializados, como o Armazenamento de Blob do Azure.

• As operações CRUD não são suportadas para fontes do Azure Synapse devido à falta de suporte à cláusula OUTPUT. É altamente recomendável usar o conector dedicado do SQL Data Warehouse do Azure .

• As visualizações do navegador Power Platform e Logic Apps são limitadas a um tamanho de lista de 10.000 tabelas.

• Não há suporte para esquemas de banco de dados que não estejam em conformidade com os identificadores padrão OData (nome da coluna começando com número, contendo caractere de par substituto, etc.). Os clientes podem usar um View para abstrair o nome da(s) coluna(s) ou podem usar propriedades SQL Extended para lidar com o uso de caracteres de plano suplementares mantendo-os separados do esquema de banco de dados, consulte: Adicionar uma propriedade estendida a uma coluna em uma tabela.

• Ao usar o conector SQL como uma fonte de dados para tabelas virtuais, os valores do servidor e do banco de dados devem corresponder entre o conjunto de dados de origem e a conexão que está sendo usada. Ao usar a autenticação SQL, os valores do conjunto de dados podem ser definidos como padrão, padrão, pois a conexão já conterá valores de servidor e banco de dados. Se os valores de conexão do conjunto de dados forem explicitamente declarados, eles deverão corresponder aos da conexão, caso contrário, erros como "Algo deu errado. Não conseguimos abrir a sua mesa. Tente recarregar ou reabrir." ou "fonte de dados inválida" pode ocorrer.

• Quando ocorrem alterações de esquema em modos de exibição usados em fluxos do Power Automatic, os gatilhos podem não ser acionados até que uma nova conexão seja criada em relação ao modo de exibição atualizado - apenas atualizar a conexão não é suficiente para redefinir o gatilho em relação aos modos de exibição atualizados.

• Atualmente, o protocolo TDS (Tabular Data Stream) 8.0 não é suportado pelo conector SQL.

Limites especiais de limitação

• Em casos diferentes, o conector SQL tem limites de limitação diferentes. Na tabela a seguir, as operações nativas incluem procedimento armazenado SQL e consulta SQL. CRUD significa criar, ler, atualizar e excluir operações.

• Junto com os limites abaixo, a limitação do nível connectionID também é aplicada com base no tempo total gasto por solicitações anteriores em um determinado período de tempo.

Serviço	Meio Ambiente	Operations	Nome	Convocatórias	Período de renovação (segundos)
Aplicativos lógicos & Power Automate	Ambiente compartilhado	Nativo	Chamadas de API por conexão	500	10
Aplicativos lógicos & Power Automate	Ambiente compartilhado	CRUD	Chamadas de API por conexão	100	10
Aplicativos lógicos & Power Automate	Ambiente compartilhado	Nativo	Chamadas simultâneas por conexão	200	-
Aplicativos lógicos & Power Automate	Ambiente compartilhado	CRUD	Chamadas simultâneas por conexão	125	-
Power Apps	Ambiente compartilhado	Todos	Chamadas de API por usuário	300	30
Power Apps	Ambiente compartilhado	Todos	Chamadas simultâneas por conexão	125	-

Por exemplo, se uma conexão fizer 200 chamadas ao mesmo tempo e cada chamada demorar 50 segundos para ser executada, todas as outras chamadas falharão com um erro 429 nos próximos 50 segundos. Depois que uma ou mais consultas terminam a execução e os resultados são retornados, todas as chamadas subsequentes são processadas.

Mapeamentos de tipo de dados do Power Apps

Consulte a documentação do Power Apps SQL

Funções e operações do Power Apps delegáveis ao SQL Server

Consulte a documentação de delegação do Power Apps SQL

Parâmetros formais nas operações

As ações Executar uma consulta SQL [DEPRECATED] e Executar uma consulta SQL (V2) permitem o uso de parâmetros formais. Eles são definidos como pares chave-valor, onde key é o nome do parâmetro e value é o tipo de dados SQL, como INT ou NVARCHAR(255). Depois de definir o nome e o tipo de dados, um novo campo de entrada para o valor é mostrado.

Migrar as operações do V1 para V2 equivalente

Siga as etapas aqui para migrar de uma operação V1 para seu equivalente V2.

Tipo de operação	Operação V1	Equivalente de operação V2
Ação	Excluir linha [DEPRECATED]	Excluir linha (V2)
Ação	Executar uma consulta SQL [DEPRECATED]	Executar uma consulta SQL (V2)
Ação	Executar procedimento armazenado	Executar procedimento armazenado (V2)
Ação	Obter linha [DEPRECATED]	Obter linha (V2)
Ação	Obter linhas [DEPRECATED]	Obter linhas (V2)
Ação	Inserir linha [DEPRECATED]	Inserir linha (V2)
Ação	Lista tabelas expostas pela conexão [DEPRECATED]	Obter tabelas (V2)
Ação	Linha de atualização [DEPRECATED]	Linha de atualização (V2)
Acionador	Quando um item é criado [DEPRECATED]	Quando um item é criado (V2)
Acionador	Quando um item é modificado [DEPRECATED]	Quando um item é modificado (V2)

Identificar ações V1

Power Automate

Para operações do Power Automatic, abra as operações Code View do SQL Server e verifique o host.operationId valor. Se o valor corresponder a uma das IDs de operação do SQL Server V1 listadas acima, essa operação precisará ser migrada para seu equivalente V2.

Por exemplo, PatchItem a operação precisa ser migrada para PatchItem_V2.

Logic Apps

Para obter uma visão geral dos aplicativos lógicos que contêm pelo menos uma operação do SQL Server V1:

1. Abra o Portal do Azure

2. Abra o Azure Resource Graph Explorer

3. Insira sua ID de assinatura no espaço reservado e execute a consulta abaixo para obter um resumo dos Aplicativos Lógicos que precisam de sua atenção e a contagem de ações do SQL Server V1 em cada um deles.

   • Script do Azure Resource Graph Explorer para identificar Aplicativos Lógicos com ações V1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend actionsJson=propertiesJson["definition"]["actions"]
     | mv-expand actionsJson
     | where notnull(actionsJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(actionsJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend actionConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(actionsJson))
     | where notnull(actionConnectionName)
     | parse actionConnectionName with "@parameters('$connections')['"parsedActionConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedActionConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, actionsJson
     | summarize v1ActionCount = count() by resourceGroup, logicAppName = name
     

   • Script do Azure Resource Graph Explorer para identificar Aplicativos Lógicos com gatilhos V1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend triggersJson=propertiesJson["definition"]["triggers"]
     | mv-expand triggersJson
     | where notnull(triggersJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(triggersJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend triggerConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(triggersJson))
     | where notnull(triggerConnectionName)
     | parse triggerConnectionName with "@parameters('$connections')['"parsedTriggerConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedTriggerConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, triggersJson
     | summarize v1TriggerCount = count() by resourceGroup, logicAppName = name
     

Migrar para operações V2 no UX

Migre aplicativos lógicos e automatize o Power Automate

1. Abra o fluxo do Aplicativo Lógico ou do Power Automate que contém a ação V1.

2. Adicione uma ação antes ou depois da ação V1 que você deseja atualizar.

   

3. Clique no conector do SQL Server e procure o equivalente V2 da ação que está sendo migrada.

   

4. Selecione a conexão a ser usada na ação V2.

   Sugestão

   As ações V2 suportam tipos de autenticação do Microsoft Entra ID. As Aplicações Lógicas também suportam as Aplicações Lógicas do Azure e suportam a autenticação de identidade gerida em ações V2.

   Veja mais na seção Autenticação .

5. Insira o nome do servidor.

   • Se você estiver usando Windows Authentication ou SQL Server Authentication, selecione o nome do servidor na lista suspensa.

     

   • Se você estiver usando Service principalo , Microsoft Entra ID ou Managed Identity tipo de autenticação, clique em "Inserir valor personalizado" na lista suspensa e, em seguida, digite o nome do servidor.

     

6. Insira seu banco de dados selecionando-o na lista suspensa.

   

7. Insira o restante dos parâmetros para que eles sejam os mesmos que a ação V1.

8. Depois de concluir a configuração da ação V1, exclua a ação V2.

   

   Importante

   Excluir a ação V1 fará com que todo o conteúdo dinâmico da V1 seja excluído; O conteúdo dinâmico V2 precisará ser adicionado novamente.

Migrar Power Apps

1. Abra o aplicativo que precisa ser atualizado.

2. Exclua todas as fontes de dados SQL.

   Observação

   As fórmulas que usam as fontes de dados excluídas mostrarão um erro, isso é esperado e será corrigido nas próximas etapas.

   

3. Abra a guia Recursos futuros nas Configurações e digite "SQL" na caixa de pesquisa. O recurso "Habilitar conector avançado do Microsoft SQL Server" surgirá.

   

4. Ative o recurso "Habilitar conector avançado do Microsoft SQL Server".

   Observação

   Esta funcionalidade está ativada por predefinição para todas as novas Power Apps.

   

5. Readicione a fonte de dados.

   

6. Verifique o comportamento do aplicativo, especialmente em tabelas que lidam com tipos de dados DateTime.

7. Salve o aplicativo.

Migrar operações através da Vista de Código nas Aplicações Lógicas do Azure

Para cenários mais complexos, as ações podem ser migradas atualizando a definição do fluxo de trabalho.

1. Identifique o nome das operações (gatilho e/ou ações) que precisam ser migradas no Aplicativo Lógico.

2. Abra o designer do aplicativo lógico a ser modificado e clique em "Visualização de código".

   

3. Para cada ação que precisa ser migrada:

   1. Encontre a propriedade action ou trigger path
   2. Substitua /datasets/default/ na propriedade path por /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/.

4. Quando todas as operações estiverem atualizadas, clique em "Designer".

   

5. Verifique se todas as operações foram migradas com êxito.

   • O nome do servidor e do banco de dados deve ser preenchido com os valores da conexão.
   • Todos os outros parâmetros também devem ser preenchidos.

   

6. Salve e teste o aplicativo lógico.

Aqui está um exemplo para migrar linhas Get [DEPRECATED].

1. Abra "Visualização de código".

2. Encontre a ação "Obter linhas [DEPRECATED]".

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/datasets/default/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

3. Atualize o segmento de conjuntos de dados do caminho com o substituto fornecido acima.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

4. Clique em "Designer" para voltar à visualização inicial e verificar se a ação foi preenchida corretamente.

Migrar operações através da edição da definição de fluxo

1. Identifique o nome das operações (gatilho e/ou ações) que precisam ser migradas no Aplicativo Lógico.

2. Exporte seu fluxo como um pacote (ZIP).

   

3. Extraia o arquivo ZIP.

4. Abra a pasta onde o ZIP foi extraído.

5. Navegue até Microsoft.Flow, em seguida flows, e, em seguida, a pasta nomeada GUID.

6. Abra o arquivo definition.json em um editor de texto.

   • Para melhorar a legibilidade, formate o JSON.

7. Para cada ação que precisa ser migrada:

   1. Encontre a propriedade action ou trigger

   2. Atualize inputs.host.operationId a propriedade para o equivalente V2. Você pode encontrar o valor na documentação da operação.

      

   3. Adicione a inputs.parameters duas propriedades:

      • server com valor default
      • database com valor default

8. Salve o arquivo definition.json

9. Navegue de volta para onde manifest.json e Microsoft.Flow estão localizados

10. Selecione Microsoft.Flow e manifest.jsone compacte em um arquivo ZIP.

    Importante

    Verifique se o novo arquivo ZIP tem exatamente a mesma estrutura de arquivos e pastas que o arquivo ZIP original.

    A pasta Microsoft.Flow e o arquivo manifest.json devem estar na raiz do novo arquivo ZIP. A falha em ter a mesma estrutura causará erros ao carregar o pacote.

    

11. Navegue até os seus fluxos no Power Automate.

12. Importe o fluxo atualizado importando o pacote. Selecione o ZIP recém-criado e carregue o pacote.

    

13. Selecione a configuração de importação (importe/crie uma nova) e selecione as conexões que serão usadas pelo fluxo.

14. Quando a importação for concluída, abra o fluxo novo/atualizado.

15. Verifique se as ações foram atualizadas

• O nome do servidor e do banco de dados deve ser preenchido com os valores da conexão.

• Todos os outros parâmetros também devem ser preenchidos.

  

Aqui está um exemplo para migrar Executar uma consulta SQL [DEPRECATED].

1. Abra "Visualização de código".

2. Encontre a ação "Executar uma consulta SQL [DEPRECATED]".

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery"
         },
         "parameters": {
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   

3. Atualize o ID da operação com o equivalente ao ID de operação V2 e, em seguida, adicione os parâmetros do servidor e do banco de dados com o default valor conforme as instruções acima.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery_V2"
         },
         "parameters": {
           "server": "default",
           "database": "default",
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   
   

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Autenticação de certificado de cliente	Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha	Todas as regiões	Compartilhável
Microsoft Entra ID Integrado	Use o Microsoft Entra ID para acessar seu banco de dados SQL.	Todas as regiões, exceto Governo dos EUA (GCC)	Não compartilhável
Microsoft Entra ID Integrado (Azure Commercial)	Use a ID do Microsoft Entra para acessar seu banco de dados SQL no Azure Commercial.	Apenas Governo dos EUA (CCG)	Não compartilhável
Microsoft Entra ID Integrated (Azure Government)	Use a ID do Microsoft Entra para acessar seu banco de dados SQL no Azure Government.	Apenas Governo dos EUA (CCG)	Não compartilhável
Entidade de serviço (aplicativo Microsoft Entra ID)	Use o aplicativo Microsoft Entra ID para acessar seu banco de dados SQL.	Todas as regiões	Compartilhável
Autenticação do SQL Server	Use um nome de conta e senha para acessar seu banco de dados SQL.	Todas as regiões	Compartilhável
Autenticação do Windows	Use um nome de conta e senha do Microsoft Entra ID local para acessar seu banco de dados SQL.	Todas as regiões	Compartilhável
Autenticação do Windows (não compartilhada)	Use um nome de conta e senha do Microsoft Entra ID local para acessar seu banco de dados SQL.	Todas as regiões	Não compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Autenticação de certificado de cliente

ID de autenticação: certOauth

Aplicável: Todas as regiões

Forneça credenciais do Microsoft Entra ID usando certificado PFX e senha

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Tenant	cadeia (de caracteres)		Verdade
ID do Cliente	cadeia (de caracteres)	A ID do cliente do aplicativo Microsoft Entra ID
Segredo do certificado do cliente	certificado do cliente	O segredo do certificado do cliente permitido por este aplicativo	Verdade

ID do Microsoft Entra Integrado

ID de autenticação: oauth

Aplicável: Todas as regiões, exceto Governo dos EUA (GCC)

Use o Microsoft Entra ID para acessar seu banco de dados SQL.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrado (Azure Commercial)

Auth ID: oauthCom

Aplicável: apenas Governo dos EUA (GCC)

Use a ID do Microsoft Entra para acessar seu banco de dados SQL no Azure Commercial.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrated (Azure Government)

ID de autenticação: oauth

Aplicável: apenas Governo dos EUA (GCC)

Use a ID do Microsoft Entra para acessar seu banco de dados SQL no Azure Government.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Entidade de serviço (aplicativo Microsoft Entra ID)

Auth ID: oauthSP

Aplicável: Todas as regiões

Use o aplicativo Microsoft Entra ID para acessar seu banco de dados SQL.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Tenant	cadeia (de caracteres)		Verdade
ID do Cliente	cadeia (de caracteres)		Verdade
Segredo do Cliente	securestring		Verdade

Autenticação do SQL Server

ID de autenticação: sqlAuthentication

Aplicável: Todas as regiões

Use um nome de conta e senha para acessar seu banco de dados SQL.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Nome do servidor SQL	cadeia (de caracteres)	Especifique o nome do servidor SQL (server[:p ort])	Verdade
Nome do banco de dados SQL	cadeia (de caracteres)	Nome do banco de dados SQL	Verdade
Nome de utilizador	securestring	Credencial de nome de usuário	Verdade
Palavra-passe	securestring	Credencial de senha	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway para obter mais detalhes

Autenticação do Windows

ID de autenticação: windowsAuthentication

Aplicável: Todas as regiões

Use um nome de conta e senha do Microsoft Entra ID local para acessar seu banco de dados SQL.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome	Tipo	Description	Obrigatório
Nome do servidor SQL	cadeia (de caracteres)	Especifique o nome do servidor SQL (server[:p ort])	Verdade
Nome do banco de dados SQL	cadeia (de caracteres)	Nome do banco de dados SQL	Verdade
Nome de utilizador	securestring	Credencial de nome de usuário	Verdade
Palavra-passe	securestring	Credencial de senha	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway para obter mais detalhes	Verdade

Autenticação do Windows (não compartilhada)

ID de autenticação: windowsAuthenticationNonShared

Aplicável: Todas as regiões

Use um nome de conta e senha do Microsoft Entra ID local para acessar seu banco de dados SQL.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Nome de utilizador	securestring	Credencial de nome de usuário	Verdade
Palavra-passe	securestring	Credencial de senha	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway para obter mais detalhes	Verdade

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Nome do servidor SQL	cadeia (de caracteres)	Nome do servidor SQL	Verdade
Nome do banco de dados SQL	cadeia (de caracteres)	Nome do banco de dados SQL	Verdade
Tipo de autenticação	cadeia (de caracteres)	Tipo de autenticação para se conectar ao seu banco de dados
Nome de utilizador	securestring	Credencial de nome de usuário	Verdade
Palavra-passe	securestring	Credencial de senha	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway para obter mais detalhes

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	10 segundos

Ações

Excluir linha (V2)	Esta operação exclui uma linha de uma tabela.
Excluir linha [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Excluir linha (V2). Esta operação exclui uma linha de uma tabela.
Executar procedimento armazenado	Esta operação executa um procedimento armazenado.
Executar procedimento armazenado (V2)	Esta operação executa um procedimento armazenado.
Executar uma consulta SQL (V2)	Executar uma consulta SQL (V2)
Executar uma consulta SQL [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Executar uma consulta SQL (V2). Executar uma consulta SQL
Inserir linha (V2)	Esta operação insere uma nova linha em uma tabela.
Inserir linha [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Inserir linha (V2). Esta operação insere uma nova linha em uma tabela.
Linha de atualização (V2)	Esta operação atualiza uma linha existente em uma tabela.
Linha de atualização [DEPRECATED]	Esta ação foi preterida. Em vez disso, use a linha Atualizar (V2). Esta operação atualiza uma linha existente em uma tabela.
Lista tabelas expostas pela conexão [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter tabelas (V2). Lista tabelas expostas pela conexão
Obter linha (V2)	Esta operação obtém uma linha de uma tabela.
Obter linha [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter linha (V2). Esta operação obtém uma linha de uma tabela.
Obter linhas (V2)	Esta operação obtém linhas de uma tabela.
Obter linhas [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Obter linhas (V2). Esta operação obtém linhas de uma tabela.
Obter tabelas (V2)	Esta operação obtém tabelas de um banco de dados.
Transformar dados com o Power Query	Transforme dados usando o Power Query. Nota: Esta operação não funciona ao conectar usando o SQL Microsoft Entra ID.

Excluir linha (V2)

Excluir linha [DEPRECATED]

Executar procedimento armazenado

Executar procedimento armazenado (V2)

Executar uma consulta SQL (V2)

Executar uma consulta SQL [DEPRECATED]

Inserir linha (V2)

Inserir linha [DEPRECATED]

Linha de atualização (V2)

Linha de atualização [DEPRECATED]

Lista tabelas expostas pela conexão [DEPRECATED]

Obter linha (V2)

Obter linha [DEPRECATED]

Obter linhas (V2)

Obter linhas [DEPRECATED]

Obter tabelas (V2)

Transformar dados com o Power Query

Acionadores

Quando um item é criado (V2)	Aciona um fluxo quando um item é criado em SQL
Quando um item é criado [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Quando um item é criado (V2). Aciona um fluxo quando um item é criado em SQL
Quando um item é modificado (V2)	Aciona um fluxo quando um item é modificado/inserido no SQL
Quando um item é modificado [DEPRECATED]	Esta ação foi preterida. Por favor, use Quando um item é modificado (V2) em vez disso. Aciona um fluxo quando um item é modificado/inserido no SQL

Quando um item é criado (V2)

Quando um item é criado [DEPRECATED]

Quando um item é modificado (V2)

Quando um item é modificado [DEPRECATED]

Definições

Table

Lista de Tabelas