SQL Server

O Microsoft SQL Server é um sistema de gerenciamento de banco de dados relacional desenvolvido pela Microsoft. Conecte-se ao SQL Server para gerenciar dados. Você pode executar várias ações, como criar, atualizar, obter e excluir em linhas em uma tabela.

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

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões Power Automate
Aplicativos Lógicos	Standard	Todas as regiões de Aplicativos Lógicos
Power Apps	Premium	Todas as regiões Power Apps
Power Automate	Premium	Todas as regiões Power Automate

Metadados do conector
Publicador	Microsoft

Conector aprofundado

Este artigo descreve as operações para o conector gerenciado do SQL Server, que está disponível para Aplicativos Lógicos do Azure, Power Automate e Power Apps. O conector interno do SQL Server está disponível apenas para fluxos de trabalho do aplicativo lógico Standard nos Aplicativos Lógicos do Azure.

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

Authentication

Se você quiser criar conexões não Microsoft Entra ID (Microsoft Entra ID), use a opção de autenticação de 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 da ID do Microsoft Entra

Devido às limitações atuais do pipeline de autenticação, os usuários convidados da ID do Microsoft Entra não têm suporte para conexões de ID do Microsoft Entra 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 do Microsoft Entra ID para SQL Server

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

2. Em seu SQL Server, configure o administrador da ID do Microsoft Entra.

   1. No portal do Azure, vá para o SQL Server onde você deseja habilitar a autenticação da ID do Microsoft Entra.
   2. No menu de recursos do SQL Server, em Configurações, selecione a 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á-los um administrador de servidor. Salve suas alterações.

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

   1. No portal do Azure, acesse o locatário da ID do Microsoft Entra, no qual você deseja criar o aplicativo Microsoft Entra ID.

   2. No menu locatário, em Gerenciar, selecione Novos registros> deaplicativo.

   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 banco de dados SQL.

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

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

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

4. Entre no sql server 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. No banco de dados SQL, crie um usuário independente 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 do db_datareaderdb_datawriter 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 aplicativo Microsoft Entra ID e atribuir as funções necessárias às suas necessidades.

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

   2. Na Autenticação, use o Active Directory – Universal com suporte de MFA e a conta da ID do Microsoft Entra 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 de ID do Microsoft Entra:

      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 de ID do Microsoft Entra:

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

Autenticação de identidade gerenciada

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

Autenticação da entidade de serviço

Configurar a identidade gerenciada em seu aplicativo lógico

1. No portal do Azure, acesse o recurso de 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 precisará 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, verifique se adicionou essa identidade ao recurso do aplicativo lógico.

   1. No portal do Azure, navegue até o recurso de aplicativo lógico no qual 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. Em seu SQL Server, configure o administrador da ID do Microsoft Entra.

   1. No portal do Azure, navegue até o SQL Server onde você deseja habilitar a autenticação da ID do Microsoft Entra.
   2. No menu de recursos do SQL Server, em Configurações, selecione a 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á-los um administrador de servidor. Salve suas alterações.

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

   As etapas a seguir atribuem a função de db_datareader uma identidade gerenciada 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 SQL Server onde a identidade gerenciada será acessada.

   2. Na Autenticação, use o Active Directory – Universal com suporte de MFA e a conta da ID do Microsoft Entra 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 de nomes de banco de dados em um gatilho ou ação do SQL, você receberá um erro como o seguinte exemplo:

      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 no nível do servidor que pode listar todos os bancos de dados à identidade gerenciada.
      • No gatilho ou ação do SQL, insira o nome do banco de dados usando a opção Inserir valor personalizado .

Para saber mais, 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 pelo sistema de VM do Windows para acessar o SQL do Azure
• Configurar e gerenciar a autenticação da ID do Microsoft Entra com o SQL do Azure
• Funções no nível do banco de dados
• Funções no nível do servidor

Suporte à Rede Virtual

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

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

  • 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 dessa lista retornará um erro "403 Não autorizado"

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

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

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

Descrição curta	Operations	Descrição longa
Obter resultados determinísticos em uma saída de ação	Obter linhas (V2)	O uso do Order By parâmetro é recomendado para obter resultados determinísticos na saída da 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 duplicar registros na saída da ação quando a paginação estiver habilitada. As exibições do SQL não dão suporte à chave primária, que é a limitação do próprio SQL Server.
Executar um suporte limitado à consulta SQL	Executar uma consulta SQL (V2)	Não há suporte para o SQL Server local.
Requisitos gerais do 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 do SQL do Azure. Portanto, as cadeias de caracteres em branco serão convertidas em cadeias de caracteres 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 têm suporte: - filtro: permite filtrar o conjunto de entradas. Dá suporte às mesmas expressões que $filter. Exemplo: filter(ColName1 eq 1). - agregação: permite 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 de encaminhamento 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 [PRETERIDA] Executar uma consulta SQL (V2)	O tipo de dados inserido ao definir um parâmetro formal em uma consulta SQL pode ser substituído, pois a implementação subjacente do conector determina o tipo por meio do valor fornecido do parâmetro.
Operador IN usando parâmetros formais requer que 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írgulas. Exemplo: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Falha ao usar o Banco de Dados Sql DataWareHouse do Azure	Inserir linha (V2)	Usar o Banco de Dados SQL do Azure no Power Apps resulta em falha devido a uma incompatibilidade de sintaxe na execução do conector no BD. Crie um fluxo com o conector do SQL Datawarehouse do Azure no Power Automate, dispare-o do PowerApps ou forme uma consulta e use-a na Ação Executar uma consulta SQL (V2 ).

Problemas conhecidos e limitações com gatilhos

Observação

Desativar e ativar um fluxo não redefinirá o estado do gatilho.

Descrição curta	Operations	Descrição longa
Modificar um item: operações de linha	Quando um item é modificado (V2)	Acionado em operações de linha INSERT e UPDATE.
Modificar um item: requisitos de coluna	Quando um item é modificado (V2)	Uma coluna ROWVERSION é necessária.
Criar um item: requisito de coluna	Quando um item é criado (V2)	Uma coluna IDENTITY é necessária.
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 linhas inseridas recentemente mais tarde. A lógica pressupõe que a identidade de cada nova linha deve ser maior do que a anterior. Portanto, caso a sequência de identidade seja redefinida para uma tabela devido a truncamento de tabela ou comando t-sql explícito, a lógica do 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 do 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 abordagem a seguir.

Limitações e problemas gerais conhecidos

• Inserir e atualizar para uma tabela não funcionará se você definiu um gatilho do lado do SQL Server 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 seguintes limitações se aplicam ao uso do conector SQL com um SQL Server 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 da resposta é de 8 MB por meio do SQL Server local.

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

  • 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 de ResultSets não é tipado.
  • O valor retornado não está disponível.
  • Somente o primeiro conjunto de resultados é retornado.
  • Não há suporte para esquemas dynamics 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 do Force Encryption. Por padrão, o Banco de Dados SQL e a Instância Gerenciada de SQL protegem os dados do cliente criptografando dados em movimento com o TLS (Transport Layer Security). Para obter mais informações, consulte a visão geral de segurança do SQL do Azure.

• No momento, o suporte a vários conjuntos de resultados é limitado para execução de consulta nativa do 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 coluna não vazios 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 terão tempo limite.

  Nos Aplicativos Lógicos do Azure, para contornar essa limitação e aprender a executar procedimentos armazenados de execução longa, consulte procedimentos armazenados de SQL de execução longa nos 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 ISE (ambiente de serviço de integração). Para obter mais informações, consulte Acesso às 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'. 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 é recomendável armazenar grandes quantidades de dados (mais de 30 megabytes) nos campos da tabela de destino (e.g. xml ou tipos de dados de texto). Isso pode levar a uma degradação de desempenho de ações e gatilhos, causando 504 erros de tempo limite. Use o parâmetro 'Selecionar Consulta' para incluir apenas campos relativamente pequenos e evitar campos de dados de saída grandes. Ou use armazenamentos de arquivos especializados, como o Armazenamento de Blobs do Azure.

• Não há suporte para operações CRUD 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 exibições do navegador do Power Platform e dos Aplicativos Lógicos são limitadas a um tamanho de lista de 10.000 tabelas.

• Não há suporte para esquema de banco de dados que não esteja em conformidade com identificadores padrão OData (nome da coluna começando com número, contendo caractere de par alternativo etc.). Os clientes podem usar um Modo de Exibição para abstrair o nome das colunas ou podem usar propriedades estendidas do SQL para lidar com o uso de caracteres de plano complementares 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 fonte de dados para tabelas virtuais, os valores de servidor e 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, 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 sua mesa. Tente recarregar ou reabrir." ou "fonte de dados inválida" pode ocorrer.

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

• Atualmente, não há suporte para o protocolo TDS (Fluxo de Dados Tabulares) 8.0 pelo conector do SQL.

Limites de limitação especiais

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

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

Service	Ambiente	Operations	Nome	Chamadas	Período de renovação (segundos)
Aplicativos Lógicos &Power Automate	Ambiente Compartilhado	Native	Chamadas à API por conexão	500	10
Aplicativos Lógicos &Power Automate	Ambiente Compartilhado	CRUD	Chamadas à API por conexão	100	10
Aplicativos Lógicos &Power Automate	Ambiente Compartilhado	Native	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	All	Chamadas à API por usuário	300	30
Power Apps	Ambiente Compartilhado	All	Chamadas simultâneas por conexão	125	-

Observação

Chamadas simultâneas são o número de solicitações em andamento que uma conexão específica pode fazer. Por exemplo, com chamadas nativas dos Aplicativos Lógicos do Azure, uma única conexão pode fazer 200 chamadas simultâneas. Todas as chamadas subsequentes retornarão um erro 429 se todas as 200 chamadas ainda estiverem em execução. Não existe um limite de tempo porque as chamadas podem levar um tempo arbitrário. No entanto, o objetivo do limite de chamadas é impedir que muitas consultas de execução prolongada sejam feitas de uma única conexão e afetar negativamente outras conexões.

Por exemplo, se uma conexão fizer 200 chamadas ao mesmo tempo e cada chamada levar 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.

Mapeamento de tipo de dados do Power Apps

Consulte a documentação do SQL do Power Apps

Funções e operações do Power Apps delegadas ao SQL Server

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

Parâmetros formais em operações

Executar uma consulta SQL [PRETERIDA] e executar uma consulta SQL (V2) ações permitem o uso de parâmetros formais. Eles são definidos como pares chave-valor, onde key está 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 será mostrado.

Migrar operações V1 para V2 equivalente

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

Importante

Antes de iniciar a migração , sempre salve uma cópia do aplicativo lógico, do fluxo do Power Automate ou do Power App para ter um backup.

Observação

Todas as operações V2 têm dois parâmetros extras: Server Namee Database Name. Isso permite que as operações V2 ofereçam suporte a autenticações de ID do Microsoft Entra.

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

Identificar ações V1

Power Automate

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

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

Aplicativos Lógicos

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

1. Abrir o Portal do Azure

2. Abrir o Gerenciador do Azure Resource Graph

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 da contagem de ações do SQL Server V1 em cada uma delas.

   • 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

Migrar aplicativos lógicos e automação do Power Automate

1. Abra o aplicativo lógico ou o fluxo 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.

   Dica

   As ações V2 dão suporte aos tipos de autenticação de ID do Microsoft Entra. Os Aplicativos Lógicos também dão suporte aos Aplicativos Lógicos do Azure compatíveis com a autenticação de identidade gerenciada 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 principal, Microsoft Entra ID ou Managed Identity tipo de autenticação, clique em "Inserir valor personalizado" na lista suspensa e, em seguida, insira 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 iguais à 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 o 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ão corrigidos 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" será exibido.

   

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

   Observação

   Esse recurso está ativado por padrão para todos os novos Power Apps.

   

5. Leia 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 por meio do Modo de Exibição de Código nos Aplicativos Lógicos 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 "Exibição de código".

   

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

   1. Localizar a propriedade de caminho de ação ou gatilho
   2. Substitua /datasets/default/ na propriedade path por /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/.

4. Depois que todas as operações forem 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.

Dica

Se desejar, depois que as ações forem migradas para a versão V2, o nome e a conexão da operação poderão ser atualizados.

Aqui está um exemplo para migrar Obter linhas [PRETERIDO].

1. Abra "Exibição de Código".

2. Localize a ação "Obter linhas [PRETERIDAS]".

   "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 ao modo de exibição inicial e verificar se a ação foi preenchida corretamente.

Migrar operações por meio 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 em que o ZIP foi extraído.

5. Navegue até Microsoft.Flow, em seguida flows, 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. Localizar a ação ou a propriedade de gatilho

   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. Salvar 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 arquivo e pasta que o arquivo ZIP original.

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

    

11. Navegue até 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 (importar/criar uma nova) e selecione as conexões que serão usadas pelo fluxo.

14. Depois que 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.

  

Dica

Se desejar, depois que as ações forem migradas para a versão V2, o nome e a conexão da operação poderão ser atualizados no UX.

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

1. Abra "Exibição de Código".

2. Localize a ação "Executar uma consulta SQL [PRETERIDA]".

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

3. Atualize a ID da operação com a ID da operação V2 equivalente e adicione os parâmetros de servidor e banco de dados com o default valor, como instruído 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",
         },
         // ..
       }
     }
   }
   
   

Importante

As conexões integradas à ID do Microsoft Entra (Azure Commercial) são desabilitadas em ambientes do GCC (Governo dos EUA) por padrão. Para habilitar esses tipos de conexões, a configuração Conectar ao Azure Comercial deve ser habilitada no Centro de Administração do Power Platform por um administrador de locatários.

Ativar essa configuração permite conexões com recursos no Azure Commercial que operam e enviam dados fora do limite de conformidade do Governo dos EUA da Power Platform. Isso é usado especificamente para permitir o acesso a recursos comerciais de versões da nuvem GCC de Conectores do Power Platform.

O Microsoft Entra ID Integrado (Azure Commercial) é o único tipo de autenticação que funciona de ambientes do Governo dos EUA (GCC) para recursos comerciais do Azure.

Autenticação Comercial do Azure desabilitada por padrão:

A configuração Conectar ao Azure Comercial no centro de administração do Power Platform:

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Autenticação de Certificado do Cliente	Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha	Todas as regiões	Compartilhável
Microsoft Entra ID Integrado	Use a ID do Microsoft Entra para acessar o banco de dados SQL.	Todas as regiões, exceto o Governo dos EUA (GCC)	Não compartilhável
Microsoft Entra ID Integrada (Comercial do Azure)	Use a ID do Microsoft Entra para acessar o banco de dados SQL no Azure Commercial.	Somente governo dos EUA (GCC)	Não compartilhável
Microsoft Entra ID Integrada (Azure Government)	Use a ID do Microsoft Entra para acessar seu banco de dados SQL no Azure Governamental.	Somente governo dos EUA (GCC)	Não compartilhável
Entidade de serviço (aplicativo ID do Microsoft Entra)	Use o aplicativo Microsoft Entra ID para acessar o banco de dados SQL.	Todas as regiões	Compartilhável
Autenticação do SQL Server	Use um nome de conta e senha para acessar o 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 o 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 o banco de dados SQL.	Todas as regiões	Não compartilhável
Padrão [PRETERIDO]	Essa 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 do Cliente

ID de autenticação: certOauth

Aplicável: todas as regiões

Fornecer credenciais de ID do Microsoft Entra usando certificado PFX e senha

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Inquilino	cadeia		Verdade
ID do cliente	cadeia	A ID do cliente do aplicativo Microsoft Entra ID
Segredo do certificado do cliente	clientCertificate	O segredo do certificado do cliente permitido por este aplicativo	Verdade

Microsoft Entra ID Integrado

ID de autenticação: oauth

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

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrada (Comercial do Azure)

ID de autenticação: oauthCom

Aplicável: somente governo dos EUA (GCC)

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Microsoft Entra ID Integrada (Azure Government)

ID de autenticação: oauth

Aplicável: somente governo dos EUA (GCC)

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Entidade de serviço (aplicativo ID do Microsoft Entra)

ID de autenticação: oauthSP

Aplicável: todas as regiões

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

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Inquilino	cadeia		Verdade
ID do cliente	cadeia		Verdade
Segredo de 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 o banco de dados SQL.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Nome do SQL Server	cadeia	Especificar o nome do SQL Server (server[:p ort])	Verdade
Nome do banco de dados SQL	cadeia	Nome do banco de dados SQL	Verdade
Nome de usuário	secureString	Credencial de nome de usuário	Verdade
Senha	secureString	Credencial de palavra-passe	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway 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 o banco de dados SQL.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome	Tipo	Description	Obrigatório
Nome do SQL Server	cadeia	Especificar o nome do SQL Server (server[:p ort])	Verdade
Nome do banco de dados SQL	cadeia	Nome do banco de dados SQL	Verdade
Nome de usuário	secureString	Credencial de nome de usuário	Verdade
Senha	secureString	Credencial de palavra-passe	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway 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 o banco de dados SQL.

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 usuário	secureString	Credencial de nome de usuário	Verdade
Senha	secureString	Credencial de palavra-passe	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes	Verdade

Padrão [PRETERIDO]

Aplicável: todas as regiões

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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 SQL Server	cadeia	Nome do SQL Server	Verdade
Nome do banco de dados SQL	cadeia	Nome do banco de dados SQL	Verdade
Tipo de autenticação	cadeia	Tipo de autenticação para se conectar ao banco de dados
Nome de usuário	secureString	Credencial de nome de usuário	Verdade
Senha	secureString	Credencial de palavra-passe	Verdade
Gateway	gatewaySetting	Gateway local (consulte https://docs.microsoft.com/data-integration/gateway mais detalhes

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	100	10 segundos

Ações

Atualizar linha [PRETERIDA]	Esta ação foi preterida. Em vez disso, use a linha de atualização (V2 ). Esta operação atualiza uma linha existente em uma tabela.
Excluir linha (V2)	Essa operação exclui uma linha de uma tabela.
Excluir linha [PRETERIDO]	Esta ação foi preterida. Em vez disso, use a linha Delete (V2 ). Essa 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 [PRETERIDA]	Esta ação foi preterida. Em vez disso, use Executar uma consulta SQL (V2 ). Executar uma consulta SQL
Inserir linha (V2)	Essa operação insere uma nova linha em uma tabela.
Inserir linha [PRETERIDA]	Esta ação foi preterida. Em vez disso, use a linha Inserir (V2 ). Essa operação insere uma nova linha em uma tabela.
Linha de atualização (V2)	Esta operação atualiza uma linha existente em uma tabela.
Lista tabelas expostas pela conexão [PRETERIDA]	Esta ação foi preterida. Use as tabelas Get (V2 ). Lista tabelas expostas pela conexão
Obter linha (V2)	Essa operação obtém uma linha de uma tabela.
Obter linha [PRETERIDA]	Esta ação foi preterida. Em vez disso, use a linha Get (V2 ). Essa operação obtém uma linha de uma tabela.
Obter linhas (V2)	Essa operação obtém linhas de uma tabela.
Obter linhas [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Obter linhas (V2 ). Essa operação obtém linhas de uma tabela.
Obter tabelas (V2)	Essa operação obtém tabelas de um banco de dados.
Transformar dados usando o Power Query	Transformar dados usando o Power Query. Observação: essa operação não funciona ao se conectar usando a ID do Microsoft Entra do SQL.

Atualizar linha [PRETERIDA]

ID da operação:

PatchItem

Esta ação foi preterida. Em vez disso, use a linha de atualização (V2 ).

Esta operação atualiza uma linha existente em uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela
ID da linha	id	True	string	Identificador exclusivo da linha a ser atualizada
Linha	item	True	dynamic	Linha com valores atualizados

Retornos

As saídas desta operação são dinâmicas.

Excluir linha (V2)

ID da operação:

DeleteItem_V2

Essa operação exclui uma linha de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela
ID da linha	id	True	string	Identificador exclusivo da linha a ser excluída

Excluir linha [PRETERIDO]

ID da operação:

DeleteItem

Esta ação foi preterida. Em vez disso, use a linha Delete (V2 ).

Essa operação exclui uma linha de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela
ID da linha	id	True	string	Identificador exclusivo da linha a ser excluída

Executar procedimento armazenado

ID da operação:

ExecuteProcedure

Esta operação executa um procedimento armazenado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do procedimento	procedure	True	string	Nome do procedimento armazenado
Lista de parâmetros	parameters	True	dynamic	Parâmetros de entrada para o procedimento armazenado

Retornos

As saídas desta operação são dinâmicas.

Executar procedimento armazenado (V2)

ID da operação:

ExecuteProcedure_V2

Esta operação executa um procedimento armazenado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome do procedimento	procedure	True	string	Nome do procedimento armazenado
Lista de parâmetros	parameters	True	dynamic	Parâmetros de entrada para o procedimento armazenado

Retornos

As saídas desta operação são dinâmicas.

Executar uma consulta SQL (V2)

ID da operação:

ExecutePassThroughNativeQuery_V2

Executar uma consulta SQL (V2)

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Query	query	True	dynamic	corpo da consulta

Retornos

As saídas desta operação são dinâmicas.

Executar uma consulta SQL [PRETERIDA]

ID da operação:

ExecutePassThroughNativeQuery

Esta ação foi preterida. Em vez disso, use Executar uma consulta SQL (V2 ).

Executar uma consulta SQL

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Query	query	True	dynamic	corpo da consulta

Retornos

As saídas desta operação são dinâmicas.

Inserir linha (V2)

ID da operação:

PostItem_V2

Essa operação insere uma nova linha em uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela
Linha	item	True	dynamic	Linha a ser inserida na tabela especificada

Retornos

As saídas desta operação são dinâmicas.

Inserir linha [PRETERIDA]

ID da operação:

PostItem

Esta ação foi preterida. Em vez disso, use a linha Inserir (V2 ).

Essa operação insere uma nova linha em uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela
Linha	item	True	dynamic	Linha a ser inserida na tabela especificada

Retornos

As saídas desta operação são dinâmicas.

Linha de atualização (V2)

ID da operação:

PatchItem_V2

Esta operação atualiza uma linha existente em uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela
ID da linha	id	True	string	Identificador exclusivo da linha a ser atualizada
Linha	item	True	dynamic	Linha com valores atualizados

Retornos

As saídas desta operação são dinâmicas.

Lista tabelas expostas pela conexão [PRETERIDA]

ID da operação:

GetTables

Esta ação foi preterida. Use as tabelas Get (V2 ).

Lista tabelas expostas pela conexão

Retornos

Representa uma lista de tabelas.

Corpo

TablesList

Obter linha (V2)

ID da operação:

GetItem_V2

Essa operação obtém uma linha de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela SQL
ID da linha	id	True	string	Identificador exclusivo da linha a ser recuperada

Retornos

As saídas desta operação são dinâmicas.

Obter linha [PRETERIDA]

ID da operação:

GetItem

Esta ação foi preterida. Em vez disso, use a linha Get (V2 ).

Essa operação obtém uma linha de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela SQL
ID da linha	id	True	string	Identificador exclusivo da linha a ser recuperada

Retornos

As saídas desta operação são dinâmicas.

Obter linhas (V2)

ID da operação:

GetItems_V2

Essa operação obtém linhas de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela SQL
Transformação de agregação	$apply		string	Uma sequência de transformações de agregação do OData
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Ignorar Contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Obter linhas [PRETERIDO]

ID da operação:

GetItems

Esta ação foi preterida. Em vez disso, use Obter linhas (V2 ).

Essa operação obtém linhas de uma tabela.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela SQL
Transformação de agregação	$apply		string	Uma sequência de transformações de agregação do OData
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Ignorar Contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Obter tabelas (V2)

ID da operação:

GetTables_V2

Essa operação obtém tabelas de um banco de dados.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados

Retornos

Representa uma lista de tabelas.

Corpo

TablesList

Transformar dados usando o Power Query

ID da operação:

SqlExecutePassThroughPowerQuery

Transformar dados usando o Power Query. Observação: essa operação não funciona ao se conectar usando a ID do Microsoft Entra do SQL.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
consulta	query		mquery	Texto da consulta

Retornos

As saídas desta operação são dinâmicas.

Gatilhos

Quando um item é criado (V2)	Dispara um fluxo quando um item é criado no SQL
Quando um item é criado [PRETERIDO]	Esta ação foi preterida. Use quando um item for criado (V2 ). Dispara um fluxo quando um item é criado no SQL
Quando um item é modificado (V2)	Dispara um fluxo quando um item é modificado/inserido no SQL
Quando um item é modificado [PRETERIDO]	Esta ação foi preterida. Use quando um item for modificado (V2). Dispara um fluxo quando um item é modificado/inserido no SQL

Quando um item é criado (V2)

ID da operação:

GetOnNewItems_V2

Dispara um fluxo quando um item é criado no SQL

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela SQL
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Quando um item é criado [PRETERIDO]

ID da operação:

GetOnNewItems

Esta ação foi preterida. Use quando um item for criado (V2 ).

Dispara um fluxo quando um item é criado no SQL

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela SQL
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Quando um item é modificado (V2)

ID da operação:

GetOnUpdatedItems_V2

Dispara um fluxo quando um item é modificado/inserido no SQL

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do servidor	server	True	string	Nome do SQL Server
Nome do banco de dados	database	True	string	Nome do banco de dados
Nome da tabela	table	True	string	Nome da tabela SQL
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Quando um item é modificado [PRETERIDO]

ID da operação:

GetOnUpdatedItems

Esta ação foi preterida. Use quando um item for modificado (V2).

Dispara um fluxo quando um item é modificado/inserido no SQL

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome da tabela	table	True	string	Nome da tabela SQL
Filtrar Consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Contagem superior	$top		integer	Número total de entradas a serem recuperadas (padrão = todas).
Ordenar por	$orderby		string	Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Selecionar Consulta	$select		string	Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

As saídas desta operação são dinâmicas.

Definições

Table

Representa uma tabela.

Nome	Caminho	Tipo	Description
Nome	Name	string	O nome da tabela. O nome é usado no runtime.
DisplayName	DisplayName	string	O nome de exibição da tabela.
DynamicProperties	DynamicProperties	object	Propriedades de tabela adicionais fornecidas pelo conector para os clientes.

TablesList

Representa uma lista de tabelas.

Nome	Caminho	Tipo	Description
value	value	array of Table	Lista de tabelas