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

Este artigo descreve as limitações conhecidas e dicas de solução de problemas ao trabalhar com tabelas virtuais no Microsoft Dataverse.

Veja a seguir uma lista de limitações conhecidas para tabelas virtuais criadas usando o provedor de conector virtual.

Limitações gerais

• A tabela ou lista usada deve incluir pelo menos um campo de cadeia de caracteres, a ser usado como campo primário, e um campo GUID. Sem esses campos de cadeia de caracteres, a tabela virtual não pode ser criada e um erro é gerado durante o estágio de recuperação de detalhes da tabela.
  • O SharePoint usa o campo ID numérico oculto presente em todas as listas
  • O SQL pode usar um campo GUID ou inteiro
  • O Excel deve ter um campo GUID
• O Dataverse só poderá criar colunas que incluam tipos de dados compatíveis com o Dataverse. Isso inclui os seguintes tipos de dados:
  • Cadeia de caracteres
  • Texto com várias linhas (memorando)
  • Número inteiro/inteiro
  • Decimal
  • Float
  • Data/hora
  • Sim/Não (booliano)
  • Opções (seleção de vários valores)
  • Hiperlink/Url
• Tipos de dados sem suporte para tabelas virtuais:
  • Arquivo e anexos
  • Imagem
• O número máximo de caracteres permitido para uma coluna de texto em uma tabela virtual é 4.000 caracteres. Se a tabela de origem tiver um limite máximo de caracteres maior que esse valor, qualquer operação de criação ou atualização que exceda o limite máximo de caracteres resultará em um erro de validação e a operação falhará.
• As consultas de tabela virtual são limitadas a retornar 1,000 registros. Se você tiver um relacionamento (polimórfico) multitabela personalizado 1:N ou N com uma tabela virtual, qualquer consulta que exceder esse limite terá falha e fornecerá um erro. Use a filtragem em sua consulta para reduzir o conjunto de registros como uma solução alternativa para essa limitação.
• A funcionalidade de auditoria não está disponível para tabelas virtuais porque o Dataverse só pode executar e armazenar dados de auditoria para dados armazenados localmente.
• Não é possível calcular valores acumulados e campos calculados para tabelas virtuais. Isso ocorre porque os valores acumulados são um cálculo do servidor no Dataverse, que exige que os dados sejam armazenados localmente.
• A tabela virtual ID do Microsoft Entra fornecida pela Microsoft só dá acesso de leitura.
• Tabelas virtuais do Dataverse podem exibir valores em campos que excedem os valores máximos normais do Dataverse. Esse comportamento ocorre porque os valores apresentados não são armazenados localmente. Por exemplo, o valor máximo inteiro do Dataverse é 100.000.000.000, mas pode recuperar e exibir 9.000.000.000.000 do SharePoint. No entanto, se o usuário tentar editar o número para um tamanho maior do que o tamanho máximo aceito no Dataverse, será fornecido um erro indicando que não é possível salvar o registro porque ele excede o tamanho máximo.
• A funcionalidade de importação e exportação dos dados da tabela não é compatível com tabelas virtuais.

Limitações para cada fonte de dados

A seguir estão as limitações para cada fonte de dados.

SQL Server

• As tabelas virtuais SQL podem usar uma GUID ou um campo Inteiro para a chave primária tendo em vista a funcionalidade.
• Tabelas do SQL Server sem chaves primárias: qualquer campo que não seja da cadeia de caracteres pode ser selecionado como a chave primária. A tabela virtual deve ser criada com êxito. RetrieveMultiple funciona, as outras operações falham com a mensagem de erro a seguir (proveniente do conector SQL): "A solicitação APIM não foi bem-sucedida: BadRequest: Não existe chave primária na tabela." Para funcionalidade, um GUID ou campo inteiro deve ser usado como chave primária.
• Tabelas do SQL Server usando uma chave primária de cadeia de caracteres: a chave primária de cadeia de caracteres do SQL é a única opção disponível para a chave primária de tabela virtual. As chaves primárias de cadeia de caracteres do SQL Server têm suporte somente se os valores puderem ser analisados como GUID. Se puderem ser analisadas como GUID, criação da tabela virtual terá êxito, mas terá falha no runtime com os seguintes erros:
  • Power Apps (make.powerapps.com): "Não conseguimos abrir a tabela. Tente recarregar ou reabrir."
  • Rastreamento de rede: "as chaves primárias de cadeia de caracteres só terão suporte se puderem ser analisadas como GUID."
• Tabelas do SQL Server sem campos da cadeia de caracteres de chave não primária a ser usado como o Nome Primário: se a tabela SQL não tiver um campo da cadeia de caracteres disponível a ser usado como o Nome Primário, vamos exibir o seguinte erro na etapa de configuração: "A tabela não tem um campo primário"
• As exibições SQL podem ser usadas para criar uma tabela virtual, mas fornecerão apenas operações de leitura.
• Para limitações do conector do SQL Server, acesse Referência do conector do SQL Server.
• As colunas bigint do tipo de dados SQL na tabela de origem são mapeadas como um tipo de dados decimal no Dataverse. Quando o suporte da plataforma estiver disponível para mapeamento bigint para um número inteiro, as colunas criadas anteriormente na tabela virtual deverão ser excluídas e novas colunas deverão ser criadas.
• Os seguintes tipos de coluna não podem ser incluídos em uma tabela virtual no momento:
  • Hora
  • Datetime2
  • Imagem
  • Geometria
  • Geografia
  • RowVersion
• Os seguintes tipos de coluna são incluídos em uma tabela virtual, mas são mostrados somente como campos de texto:
  • HierarchyID
  • XML
  • Sqlvariant

Microsoft Excel Online (Business)

• Atualmente, o Excel não tem suporte na experiência de tabela virtual baseada em tabela.
• Os arquivos do Excel devem ser armazenados em um OneDrive para participar de uma conexão de tabela virtual.
• A coluna de chave primária deve ser incluída no formulário de criação se você não configurou a coluna para incrementar automaticamente durante o design da tabela de origem subjacente. Você deverá inserir um valor válido na coluna de chave primária para que uma operação de inserção tenha êxito.
• Se a criação do catálogo de entidades levar muito tempo, você pode verificar o status de conclusão do trabalho navegando até Configurações>Configurações avançadas>Configurações>Trabalhos do Sistema.
• A chave primária só pode ser uma coluna contendo valores GUID: como os metadados da tabela do Excel mostram todas as colunas como string, nosso design atual pressupõe que a chave primária sempre será um GUID representado como uma string.

  Observação

  Nenhuma validação é executada quando a tabela virtual é criada, se uma coluna não GUID for selecionada, a tabela falhará em tempo de execução com este erro: "Chaves primárias de string são suportadas somente se puderem ser analisadas como GUID".

• Suporte para coluna gerada automaticamente PowerAppsId__: a coluna gerada automaticamente PowerAppsId é usada se encontrada (é a única opção disponível para chave primária). É necessário fornecer um valor de PowerAppsId na criação do registro, mesmo que o valor seja substituído por um gerado automaticamente. Isso não acontece se a coluna chave primária não for a coluna gerada automaticamente PowerAppsId.
• Os seguintes tipos de coluna não podem ser incluídos em uma tabela virtual no momento:
  • Hora (são criados como campos de data e hora).
• As limitações específicas do conector do Excel vão para: Referência do conector do Excel Online (Business).

Microsoft SharePoint

• No momento, você não pode selecionar uma vista Tudo para colunas SharePoint em uma tabela virtual. Este é um problema conhecido.
• Os seguintes tipos de coluna não podem ser incluídos em uma tabela virtual no momento:
  • Pessoa
  • Imagem
  • Metadados gerenciados
  • Local: coordenadas
  • Anexo
• Colunas específicas do SharePoint que são mostradas na tabela virtual:
  • ID do Ativo de Conformidade é uma coluna interna do SharePoint para fins de rastreamento. Ela pode ser ignorada.
  • ID é a chave primária externa do SharePoint. Ela é somente leitura e pode ser ignorada.

Salesforce (versão preliminar)

• Para limitações do conector do Salesforce, acesse Referência do conector do Salesforce.
• Os campos que fazem referência a outros objetos do Salesforce estão bloqueados.

Oracle (versão preliminar)

• Para limitações do conector do Oracle, acesse Referência do conector Oracle.
• A tabela Oracle precisa ter uma chave primária definida.
• A tabela Oracle precisa ter pelo menos um campo de tipo de cadeia de caracteres, além da chave primária.

Solução de Problemas

• Só existe um (1) registro em sua tabela virtual, embora você tenha mais registros na tabela de origem.
  Solução: verifique sua tabela de origem e certifique-se de que ela tenha uma chave primária definida.

• Você recebe um dos seguintes erros quando o Power Apps (make.powerapps.com) está recuperando uma lista de tabelas ou quando seleciona Concluir para criar uma tabela:

  • "Recurso não encontrado para o segmento msdyn_get_required_fields"
  • "Erro na chamada... verifique se a conexão... existe no ambiente"
  • "A sequência não corresponde a nenhum elemento para msdyn_get_required_fields"
    Solução: em alguns casos, você pode não ter a solução mais atualizada para o provedor de conector virtual. Para determinar se sua solução de provedor de conector virtual precisa de uma atualização:
  1. 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. Selecione a guia Histórico.
  3. Pesquisar para ConnectorProvider.
  4. Veja as informações para ver se a solução precisa ser atualizada.
  5. Se o histórico indicar que uma atualização é necessária, acesse o marketplace comercial da Microsoft, procure Provedor de Conector Virtual e, em seguida, selecione Instale agora para importar a solução para o seu ambiente.
  6. Siga as etapas para criar a tabela virtual novamente.

• Uma mensagem é exibida "Conexão 'xyz' não encontrada no ambiente atual" ao recuperar a lista de conexões.
  Solução: isso ocorre quando há um grande número de conexões no ambiente Dataverse do usuário. Isso foi corrigido com a versão 1029 da solução do Provedor de Conector. Para determinar se sua solução de provedor de conector virtual precisa de uma atualização:

  1. 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. Selecione a guia Histórico.
  3. Pesquisar para ConnectorProvider.
  4. Veja as informações para ver se a solução precisa ser atualizada.
  5. Se o histórico indicar que uma atualização é necessária, acesse o marketplace comercial da Microsoft, procure Provedor de Conector Virtual e, em seguida, selecione Instale agora para importar a solução para o seu ambiente.
  6. Siga as etapas para criar a tabela virtual novamente.

• Você será notificado de que ocorreu um tempo limite durante a criação da tabela virtual.
  Solução: isso pode ocorrer quando outros trabalhos existentes atrasam a criação da tabela virtual. Aguarde alguns minutos e tente novamente.

• Você será notificado de que "Ocorreu um erro inesperado"
  Solução: isso ocorre quando a fonte de dados da tabela virtual foi criada com valores inválidos. Para resolver isso, você precisa localizar a fonte de dados de tabela virtual que está causando o erro, excluí-lo e, em seguida, recriar a tabela virtual.

  1. Selecione Configurações (ícone de engrenagem) >Configurações avançadas do Power Apps.
  2. No menu superior, selecione Configurações.
  3. Acesse Soluções. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
  4. Vá para a solução que inclui a tabela virtual (se você não estava usando uma solução, vá até Solução Padrão do Common Data Services).
  5. No painel esquerdo, selecione Fontes de dados da tabela virtual.
  6. Clique duas vezes em cada fonte de dados (todas elas começam com VCP_DS_..."), quando você localizar aquela com o erro, exclua essa fonte de dados.
  7. Recrie sua tabela virtual.

• Uma mensagem é exibida "Esta tabela já existe, você está recriando a tabela. O campo primário e o nome do esquema não podem ser alterados."
  Solução: esta tabela já foi criada anteriormente. Continuar com a criação recria a tabela, isso resulta em quaisquer alterações de tabela feitas na fonte de dados serem atualizadas na tabela virtual (isso inclui adição ou remoção de campos). O nome personalizado e os valores do campo primário não serão editáveis.

• Mensagem de erro: "primary_key_name não pode estar vazio"
  Solução: você escolheu uma tabela ou lista que não inclui um valor GUID para a chave primária. Você precisa adicionar uma coluna GUID adicional em sua tabela de origem para criar uma tabela virtual.

• Você criou uma tabela virtual do Excel, mas não a vê na área Tabelas no Power Apps.
  Solução: como a criação da tabela virtual é assíncrona, você pode verificar o status do processo em Trabalhos do Sistema. Procure trabalhos do sistema com um Nome iniciado por Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin e um valor de coluna Referente igual ao nome da nova tabela virtual. Se o status ainda for Em Andamento, aguarde a conclusão do trabalho. Se houver um erro, você pode obter detalhes selecionando o sistema, hiperlink do nome do trabalho. Neste exemplo, a criação da tabela ainda está pendente:

  

  Aqui, a criação da tabela falhou devido ao erro 429 "Muitas solicitações":

  

• O trabalho do sistema de criação de tabela foi bem-sucedido, mas você recebe erros de tempo de execução relacionados a colunas inválidas ou ausentes.
  Solução: se ocorrer uma falha durante a criação de um campo de tabela, o processo de criação da tabela não falhará e tentará continuar com os campos restantes. Isso ocorre porque o sistema não quer bloquear a criação da tabela virtual quando alguns tipos de coluna não são suportados. Para obter detalhes sobre o erro, ative o registro em Administração>Configurações do Sistema>Personalizações>Habilitar registro em logs para log de rastreamento de plug-in, exclua a tabela virtual e tente criá-la novamente.

Próximas etapas

Criar tabelas virtuais usando o provedor de conectores virtuais (versão preliminar)

Configurar um relacionamento da tabela virtual