Criar tabelas virtuais usando o provedor de conectores virtuais

As tabelas virtuais permitem a integração de dados de fontes de dados externas, representando perfeitamente esses dados como tabelas no Microsoft Dataverse, sem replicação de dados. Soluções, aplicativos, fluxos, entre outros, podem usar tabelas virtuais como se fossem tabelas nativas do Dataverse. As tabelas virtuais permitem privilégios totais de criação, leitura, atualização e exclusão, a menos que a fonte de dados conectada o proíba especificamente. Mais informações sobre tabelas virtuais: Crie e edite tabelas virtuais contendo dados de uma fonte de dados externa.

Este documento aborda a nova experiência usando o Power Apps (make.powerapps.com) para criar tabelas virtuais utilizando os seguintes provedores de conectores virtuais:

• SQL Server
• Microsoft SharePoint
• Microsoft Fabric (versão preliminar)
• Salesforce (versão preliminar)
• Oracle (versão preliminar)
• Snowflake (versão preliminar)
• PostgreSQL

Esses provedores de conectores virtuais usam um conector do Power Platform. Mais informações: Referência do conector para provedores de conector virtual usados com tabelas virtuais

Você pode criar uma tabela virtual para o Excel usando um processo herdado com um provedor de conectores virtuais. Mais informações: Criar tabelas virtuais usando o Excel no Microsoft Dataverse

Visão geral

As tabelas virtuais incluem os componentes a seguir:

• Fonte de dados – o local onde os dados externos são armazenados.
• Provedor de dados – define o comportamento da tabela virtual.
• Conexão – configura a capacidade de se conectar à fonte de dados e à autenticação.
• Referência de conexão – fornece uma maneira do Dataverse usar a conexão com a fonte de dados.

Se você criar uma tabela virtual usando um provedor de dados personalizado, precisará escrever plug-ins que definam como cada API do Dataverse interagiria com a API no sistema em que os dados estão armazenados. Este é um processo longo que exige conhecimento de codificação. Os provedores de conectores virtuais simplificam a experiência de criação, automatizando parte da criação e removendo a necessidade de usar código para criar as tabelas virtuais.

Quando você estabelece uma conexão remota com uma fonte externa usando uma fonte de dados de conector, o provedor de conector virtual recupera uma lista de todas as tabelas e listas disponíveis, recuperando definições de tabela (metadados) da fonte de dados externa. Você seleciona essas tabelas e listas para gerar a tabela virtual.

A fonte de dados subjacente é fundamental para permitir que o provedor estabeleça uma conexão remota autenticada com os dados externos. Ela usa uma referência de conexão que armazena detalhes pertinentes sobre a fonte externa. As informações armazenadas na referência de conexão são específicas do tipo de conector e da conexão a que se refere.

Ao configurar a conexão e a referência de conexão para suas fontes de dados, são necessárias informações específicas. Por exemplo, o conector do SQL Server precisa de nome do servidor, nome do banco de dados, método de autenticação, nome de usuário, senha e (opcionalmente) detalhes da conexão do gateway. Cada fonte de dados externa precisa de uma referência de conexão definida para criar a tabela virtual. Ao usar a experiência do Power Apps (make.powerapps.com), é possível gerar automaticamente a referência de conexão, a menos que você deseje fornecer nomenclatura personalizada.

As permissões do conector reforçam a capacidade dos usuários organizacionais de acessar e operar na tabela virtual. A conexão pode ser compartilhada com um usuário ou com a organização inteira. Isso permite a usuários acessar e operar tabelas virtuais usando uma conexão compartilhada. Ao usar funções de segurança, o acesso à tabela virtual pode ser restrito a um conjunto específico de usuários em sua organização. Você pode até especificar quais funções têm privilégios de criação, leitura, atualização ou exclusão dessa maneira.

O gerenciamento do ciclo de vida do aplicativo (ALM) tem suporte para tabelas virtuais criadas usando o provedor de conector virtual. Você pode até mesmo criar as tabelas virtuais diretamente em uma solução ao usar o Power Apps (make.powerapps.com). As tabelas virtuais devem fazer parte de uma solução gerenciada junto com a referência de conexão para distribuir a solução. A solução pode ter outros componentes, como um aplicativo baseado em modelo que usa tabelas virtuais.

Mais informações: sobre o gerenciamento do ciclo de vida do aplicativo (ALM) e soluções:

• Gerenciamento do ciclo de vida do aplicativo (ALM) no Microsoft Power Platform
• Visão geral das soluções

Pré-requisitos

Para criar uma tabela virtual, você deve ter uma licença do Microsoft Dataverse por meio do Power Apps ou do Microsoft Dynamics 365. As licenças do Microsoft 365 ou do Teams não podem ser usadas para criar tabelas virtuais.

Criar uma tabela virtual no Power Apps

A criação de uma tabela virtual no Power Apps (make.powerapps.com) usando o provedor de conector virtual inclui as seguintes etapas:

1. Opte por criar uma tabela usando uma fonte de dados externa
2. Criar a tabela virtual
3. Crie e selecione a referência de conexão (opcional)
4. Escolha os detalhes da conexão e selecione o SQL dos seus dados ou o SharePoint.
5. Configurar seus dados
6. Configurar nomes de colunas e tabelas (opcional)
7. Concluir a configuração

Opte por criar uma tabela usando uma fonte de dados externa

Estas etapas descrevem como criar uma tabela virtual a partir de uma solução. Use etapas semelhantes para criar uma tabela virtual acessando Dados>Tabelas.

1. Entre no Power Apps e, depois, selecione Soluções no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
2. Crie uma nova solução ou abra uma solução não gerenciada existente.
3. Na barra de comandos, selecione Nova>Tabela>Tabela virtual.

Criar a tabela virtual

Assista a um vídeo curto que mostra como criar uma tabela virtual com o provedor de conector virtual.

1. No assistente Nova tabela a partir de dados externos você pode selecionar uma conexão existente, se tiver uma ou optar por Adicionar conexão.

   • Se quiser usar uma conexão existente, selecione a conexão desejada e, depois, Avançar.
   • Se você já tiver uma conexão, mas desejar criar uma nova, selecione Nova conexão na barra de comandos.
   • Se você não tiver conexões e quiser criar uma nova conexão, selecione +Adicionar Conexão ao lado do tipo de conexão desejado.

   Importante

   As conexões compartilhadas com você não estão disponíveis para uso com esse recurso. Somente as conexões criadas pelo usuário atual aparecem no assistente de tabela virtual.

2. Você é direcionado para uma nova guia no navegador. Selecione o método de autenticação. Dependendo do método de autenticação selecionado, você poderá ser solicitado a fornecer as informações de credenciais necessárias para criar a conexão.

SQL Server

Importante

Essas serão as credenciais usadas para toda a autenticação da tabela virtual; portanto, use credenciais com o nível correto de permissões com o SQL Server.

• Microsoft Entra: selecione e entre com suas credenciais.
• SQL Server: nome do servidor, nome do banco de dados, nome do usuário, senha, gateway (somente implantações locais).

Microsoft SharePoint

Importante

Essas serão as credenciais usadas para toda a autenticação da tabela virtual; portanto, use credenciais com o nível certo de permissões no SharePoint.

Observação

No momento, as tabelas virtuais que usam o assistente do provedor de conector virtual oferecem suporte somente a versões online do SharePoint.

• Selecione Conectar diretamente (serviços em nuvem)

  

Microsoft Fabric (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

• Selecione um espaço de trabalho do Microsoft Fabric na lista disponível de espaços de trabalho. Todos os espaços de trabalho aos quais você tem acesso estão disponíveis na lista.
• Escolha um Lakehouse do Microsoft Fabric na lista suspensa. Todos os lakehouses e data warehouses dentro do espaço de trabalho selecionado anteriormente estão disponíveis para escolha.
• Siga as instruções em sua tela. Mais informações: Criar aplicativos e automações, impulsionar a ação com insights do Microsoft Fabric (versão preliminar)

Mais informações: criar aplicativos e automações, impulsionar a ação com insights do Microsoft Fabric

Salesforce (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Selecione Adicionar uma conexão:

• URI de logon: selecione Produção (padrão) ou Área restrita.
• Versão da API do Salesforce: selecione v41.0 (padrão) ou uma versão posterior.

Oracle (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Para conexões da Oracle, você deve fornecer um servidor, tipo de autenticação, nome de usuário, senha e um gateway.

O servidor deve ser fornecido no formato Server:Port/SID. Observe que o nome do servidor ou o endereço IP deve estar acessível a partir do gateway de dados local.

Snowflake (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

• Tipo de autenticação. Garante que o Snowflake seja acessado apenas por pessoas com permissão aprovada. Selecione Entidade de serviço (aplicativo Microsoft Entra ID) para esta opção.
• URL do SaaS do Snowflake. A URL associada à conta do Snowflake para a qual as tabelas virtuais devem ser criadas. Por exemplo, organization.account.snowflakecomputing.com. Não adicione https à URL.
• Banco de dados do Snowflake. O banco de dados onde as tabelas de dados do Snowflake são virtualizadas no Dataverse.
• Nome do depósito. Depósito do Snowflake cuja função tem privilégios de USO.
• Função. Função Snowflake atribuída à função Conta de Serviço.
• Esquema. Esquema que tem as tabelas que o Dataverse precisa acessar para virtualizar os dados.
• Locatário. Locatário do Microsoft Entra ID.
• ID do Cliente. ID do cliente do Microsoft Entra para o locatário do Power Platform.
• Segredo do Cliente. Segredo do cliente do Microsoft Entra ID para o cliente do Power Platform.
• URL do Recurso. ID do aplicativo do recurso do Microsoft Entra ID. Não adicione api:// para a URL.

PostgreSQL

PostgreSQL é um sistema de gerenciamento de banco de dados relacional desenvolvido pelo PostgreSQL Global Development Group. Para conexões PostgreSQL, você deve fornecer um servidor, nome de banco de dados, tipo de autenticação, nome de usuário e senha.

• Insira o local do Servidor e a porta TCP, como postgres-vcp-test.postgres.database.azure.com:5432.
• Insira o Nome do Banco de Dados, como Adventureworks.
• Selecione Tipo de Autenticação como Básica.
• Insira o Nome de usuário e a Senha.
• Criptografar Conexão. Selecione se deseja criptografar as comunicações de cliente e servidor para aumentar a segurança.

3. Como opção, selecione Opções avançadas para usar uma referência de conexão e/ou variável de ambiente.

   Quando você cria uma tabela virtual, uma referência de conexão é criada automaticamente para você com a tabela virtual. Uma referência de conexão é um componente de solução contendo informações sobre o conector. No entanto, talvez você queira criar o seu próprio. Para fazer isso, selecione Configurar manualmente a referência de conexão. Mais informações: Criar e selecionar uma referência de conexão (opcional)

   Você pode associar uma tabela virtual à sua própria variável de ambiente. Selecione Usar variáveis de ambiente para vincular a variável de ambiente diretamente ao provedor de tabela virtual, oferecendo flexibilidade para alterar fontes de dados ao importar a tabela virtual para um novo ambiente. Mais informações: Variável de ambiente

   

4. Selecione Criar.

5. Depois que a conexão for criada, volte para a guia do navegador com o assistente, escolha Atualizar e, em seguida, selecione sua conexão.

Referências de conexão e variáveis de ambiente

Crie e selecione uma referência de conexão (opcional)

Quando você cria uma tabela virtual, uma referência de conexão é criada automaticamente para você com a tabela virtual. Uma referência de conexão é um componente de solução contendo informações sobre o conector.

No entanto, talvez você queira criar sua própria referência de conexão para a tabela virtual.

Observação

• O benefício de nomear opcionalmente sua referência de conexão é porque poderá ser mais fácil encontrá-la posteriormente se você precisar de detalhes sobre ela.
• Se você estiver usando uma conexão existente, poderá selecionar uma referência de conexão existente ou criar uma nova. A criação de uma nova referência de conexão só será usada se você desejar segmentar tabelas virtuais em soluções não relacionadas para uso posterior.

Para criar uma referência de conexão, ao criar a conexão para a tabela virtual, siga estas etapas:

1. Expanda Opções avançadas e selecione Configurar referência de conexão manualmente para criar uma referência de conexão para a tabela virtual.

2. Na página Referência de Conexão, selecione ou nomeie a referência de conexão e, em seguida, selecione Avançar.

   • Se escolher SQL e Microsoft Entra ID como método de autenticação, você precisará fornecer o nome do servidor SQL e o nome do banco de dados. Forneça-os e selecione Avançar.

Variável de ambiente

As variáveis de ambiente desempenham um papel fundamental no processo de gerenciamento do ciclo de vida do aplicativo (ALM), permitindo a movimentação perfeita de aplicativos em diferentes ambientes do Power Platform. Ao criar uma tabela virtual, é possível associá-la à sua própria variável de ambiente. Para aproveitar essa funcionalidade, expanda Opções avançadas e selecione Usar variáveis de ambiente ao escolher uma conexão para sua fonte de dados durante a criação de uma tabela virtual.

Recomendações de variáveis de ambiente com tabelas virtuais

• Criar ou atualizar uma tabela virtual no contexto de uma solução.
• Caso uma tabela virtual existente com variável de ambiente tenha que ser incluída em uma solução, a variável de ambiente associada a essa tabela deverá ser adicionada explicitamente à solução. Na área Soluções, no Power Apps, selecione Adicionar existente>Variável de ambiente, e selecione a variável de ambiente relacionada à tabela virtual. Após esta etapa, selecione a variável de ambiente e, em seguida, escolha Avançado e adicione os objetos necessários.
• Se uma tabela virtual for criada sem uma variável de ambiente especificada, é necessário recriar a tabela virtual e selecionar a opção de variável de ambiente.

Limitação de variáveis de ambiente com tabelas virtuais

• Atualmente, o suporte a variáveis de ambiente com tabelas virtuais só funciona com o SharePoint e conectores virtuais de SQL.

Configurar seus dados

Se estiver criando uma tabela virtual do SharePoint, será solicitado a inserir a URL do seu site do SharePoint ou selecionar um dos sites do SharePoint recém-usados. A lista recém-usada é preenchida coletando informações dos sites recém-usados por meio do Microsoft Graph e suas credenciais do Microsoft Entra . Se estiver colando a URL do SharePoint, inclua somente as informações até o nome do site, como https://microsoft.sharepoint.com/teams/Contoso.

1. Uma página é exibida em que você pode procurar a fonte de dados para uma tabela ou lista específica, ou selecionar uma tabela ou lista da lista fornecida.

2. Marque a caixa de seleção se desejar configurar o nome da tabela, nomes de colunas e campo primário.

3. Selecione Avançar.

Configurar nomes de tabelas e colunas (opcional)

Ao criar uma tabela virtual, por padrão, você pode optar por alterar a tabela sugerida e os nomes de colunas. Para fazer isso, siga estas etapas:

1. Selecione Configurar nomes de tabelas e colunas que serão usados no Dataverse, aceite ou altere as seguintes propriedades de tabela do Dataverse:

   • Nome de exibição: o nome usado para identificar sua tabela virtual.
   • Nome no plural: o nome no plural da tabela virtual, usado em situações apropriadas em que você se refere a um ou mais registros da tabela, como Cliente, é a tabela para vários registros referenciados como Clientes.
   • Nome do esquema: o nome lógico que o Dataverse usa para a tabela virtual, que inclui o prefixo do fornecedor de soluções.
   • Campo primário: este é o valor de texto a ser usado ao procurar registros em sua tabela virtual. Somente campos de cadeia de caracteres podem ser selecionados. Uma chave primária é um campo obrigatório, mas será escolhido pelo Dataverse.

2. Na área Coluna externa, escolha se deseja renomear uma de suas colunas externas da fonte de dados. Os seguintes campos são fornecidos:

   • Nome do esquema (somente leitura). Este é o nome do esquema da coluna na fonte de dados. Esta propriedade é somente leitura.
   • Nome de exibição. O nome usado para identificar sua coluna.
   • Nome do esquema. O nome lógico que o Dataverse usará para a coluna que incluirá o prefixo do fornecedor de soluções. Há uma opção Formato Rápido de Nomes na página, que sugere alterações de nome e pode ser útil se você tiver um grande número de campos que contêm valores prefixados do seu servidor SQL, como <nome da tabela>.<nome da coluna>. Por exemplo, Database12.Products seria alterado para Produtos.

   Dica

   Em vez de inserir as informações, o comando Nomes de formulário rápido sugere alterações de nome e poderá ser útil se você tiver um grande número de campos que incluam valores prefixados do SQL Server como nome da tabela.nome da coluna. Por exemplo, Database12.Products seria alterado para Produtos.

   

3. Selecione Avançar

Concluir a configuração

1. A página Revisar e concluir mostra a tabela à qual você está se conectando na fonte de dados e a tabela que será criada no Dataverse.

   Observação

   Ao selecionar Escolher uma tabela diferente, você retorna à tela de seleção de tabela. Ao selecionar Editar Configuração da Tabela, você acessa a tela Configuração.

2. Se tudo estiver correto, selecione Avançar.

Depois que a tabela é criada, você é levado diretamente para a nova tabela virtual, em que pode exibir seus dados e começar a trabalhar neles.

Observação

Ao tentar criar uma tabela virtual que já existe, você recebe uma mensagem informando que a tabela já existe e que você a recriará. Você não poderá alterar o campo primário ou o nome do esquema nesse caso. A recriação da tabela atualizará todas as alterações de coluna feitas na fonte de dados na tabela.

Referência de conector para provedores de conectores virtuais usados com tabelas virtuais

Para saber mais sobre as ações e limitações com suporte em cada conector, acesse:

• Referência de conector para o conector do SQL Server
• Referência de conector para o conector Microsoft Excel Online Business
• Referência de conector para o conector SharePoint Online
• Referência de conector para o conector do Salesforce
• Referência de conector para o conector da Oracle
• Referência de conector para o conector Snowflake
• Referência de conexão para conector PostgreSQL

Consultar também

Configurar um relacionamento da tabela virtual

Limitações conhecidas e solução de problemas com tabelas virtuais

Guia para desenvolvedores: introdução às tabelas virtuais (entidades)