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

Este artigo descreve as limitações conhecidas e as sugestões de resolução de problemas quando trabalha com tabelas virtuais no Microsoft Dataverse.

Segue-se uma lista das limitações conhecidas das tabelas virtuais criadas utilizando o fornecedor do conectores virtuais.

Limitações gerais

• A tabela ou lista utilizada tem de incluir, pelo menos, um campo de cadeia para ser utilizado como o campo primário e um campo de GUID. Sem esses campos de cadeia de caracteres, o tabela virtual não pode ser criado e um erro é gerado durante o estágio de recuperação de detalhes da tabela.
  • O SharePoint utiliza o campo de ID numérico oculto presente em todas as listas
  • O SQL pode utilizar um campo de GUID ou de número inteiro
  • O Excel tem de ter um campo de GUID
• O Dataverse só pode criar colunas que incluam tipos de dados compatíveis com o Dataverse. Isso inclui os seguintes tipos de dados:
  • Cadeia (de carateres)
  • Texto com várias linhas (memo)
  • Número Completo/Número Inteiro
  • Decimal
  • Float
  • Data/hora
  • Sim/Não (booleano)
  • Escolhas (seleção de múltiplos valores)
  • Hiperligação/URL
• Tipos de dados não suportados para tabelas virtuais:
  • Ficheiro e anexos
  • Image
• O comprimento máximo dos carateres permitido para uma coluna de texto numa tabela virtual é de 4000 carateres. 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 estão limitadas a devolver 1,000 recursos. Se tiver uma relação de tabela múltipla (polimórfica) personalizada 1:N ou N com uma tabela virtual, qualquer consulta que exceda este limite falhará e fornecerá um erro. Utilize a filtragem na sua consulta para reduzir o conjunto de registos como uma solução para esta limitação.
• A funcionalidade de auditoria não está disponível para tabelas virtuais porque Dataverse só pode executar e armazenar dados de auditoria para dados armazenados localmente.
• Não é possível calcular rollups e campos calculados tabelas virtuais. Isto porque os rollups são um cálculo do lado do servidor no Dataverse, o que requer que os dados sejam armazenados localmente.
• O Microsoft Entra ID tabela virtual fornecido por Microsoft só permite acesso de leitura.
• As tabelas virtuais do Dataverse podem apresentar valores em campos que excedam o valor máximo normal do Dataverse. Este comportamento ocorre porque os valores que estão a ser apresentados não foram armazenados localmente. Por exemplo, o valor máximo de número inteiro do Dataverse é 100.000.000.000, mas poderá obter e apresentar 9.000.000.000.000 do SharePoint. No entanto, se o utilizador tentar editar o número para um tamanho maior que o tamanho máximo aceite no Dataverse, é fornecido um erro a indicar que o registo não pode ser guardado porque excede o tamanho máximo.
• A funcionalidade de importação e exportação de dados de tabela não é suportada para tabelas virtuais.

Para cada origem de dados limitações

Seguem-se as limitações para cada origem de dados.

SQL Server

• As tabelas virtuais SQL podem utilizar um GUID ou um campo de Número Inteiro para a Chave Primária para funcionalidade.
• Tabelas SQL Server sem chaves primárias: qualquer campo de não cadeia pode ser selecionado como chave primária. A tabela virtual deve ser criada com êxito. RetrieveMultiple funciona, as outras operações falham com a seguinte mensagem de erro (proveniente do conector SQL): "A solicitação APIM não foi bem-sucedida: BadRequest: Nenhuma chave primária existe na tabela." Para funcionalidade, um GUID ou campo inteiro deve ser usado como chave primária.
• Tabelas do SQL Server que utilizam uma chave primária de cadeia: A chave primária de cadeia do SQL é a única opção disponível para a chave primária de tabela virtual. As chaves primárias de cadeia de SQL Server só são suportadas se os valores puderem ser analisados como GUID. Se não puder ser analisada como um GUID, a criação da tabela virtual é bem-sucedida, mas falha no runtime com os seguintes erros:
  • Power Apps (make.powerapps.com): "Não conseguimos abrir a sua mesa. Tente recarregar ou reabrir."
  • Rastreio de rede: "As chaves primárias de cadeia só são suportadas se puderem ser analisadas como GUID."
• SQL Tabelas do servidor sem campos de cadeia de caracteres de chave não primária para uso como o Nome Principal: Se a tabela SQL não tiver um campo de cadeia de caracteres disponível para usar como Nome Principal, exibiremos o seguinte erro na passo de configuração: "A tabela não tem um campo primário"
• As vistas do SQL podem ser utilizadas para criar uma tabela virtual, mas só fornecem operações de leitura.
• Para limitações do conector do servidor SQL, vá para SQL Referência do conector do servidor.
• SQL tipo de dados As colunas bigint na tabela de origem são mapeadas como um tipo de dados decimal em Dataverse tabelas virtuais. Quando o suporte da plataforma está disponível para o mapeamento bigint para um número inteiro, as colunas criadas anteriormente na tabela virtual precisam de ser eliminadas e devem ser criadas novas colunas.
• Os seguintes tipos de coluna não podem ser incluídos em um tabela virtual no momento:
  • Hora
  • Datetime2
  • Image
  • Geometria
  • Geografia
  • RowVersion
• Os seguintes tipos de coluna são incluídos em um tabela virtual mas são mostrados apenas como campos de texto:
  • HierarchyID
  • XML
  • Sqlvariant

Microsoft Excel Online (Negócios)

• Atualmente, o Excel não é suportado na experiência de tabela virtual orientada por tabela.
• Os arquivos do Excel devem ser armazenados em um OneDrive para participar de uma conexão 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 durante o design da tabela de origem subjacente automaticamente. Tem de introduzir um valor válido na coluna de chave primária para uma operação de inserção ter êxito.
• Se a criação do catálogo de entidades demorar muito tempo, você poderá verificar o estatuto de conclusão do trabalho indo para Configurações>Configurações avançadas>Configurações>Trabalhos do sistema.
• A chave primária só pode ser uma coluna que contém valores GUID: Como os metadados da tabela do Excel mostram todas as colunas como cadeia de caracteres, nosso design atual pressupõe que a chave primária é sempre um GUID representado como uma cadeia de caracteres.

  Nota

  Nenhuma validação é executada quando o tabela virtual é criado, se uma coluna não-GUID for selecionada, a tabela falhará no tempo de execução com este erro: "As chaves primárias de cadeia de caracteres são suportadas somente se puderem ser analisadas como GUID".

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

Microsoft SharePoint

• No momento, não é possível selecionar um modo de exibição Tudo para SharePoint colunas em um tabela virtual. Trata-se de um problema conhecido.
• Os seguintes tipos de coluna não podem ser incluídos em um tabela virtual no momento:
  • Pessoa
  • Image
  • Metadados geridos
  • Localização: coordenadas
  • Anexo
• SharePoint colunas específicas que são mostradas no tabela virtual:
  • O ID do ativo de conformidade é uma coluna interna para fins de SharePoint rastreamento. Pode ser ignorado.
  • ID é a chave primária externa de SharePoint. É só de leitura e pode ser ignorado.

Salesforce (pré-visualização)

• Para conhecer as limitações do conector Salesforce, vá para Referência doconector Salesforce.
• Os campos que referenciam outros objetos do Salesforce estão bloqueados.

Oracle (pré-visualização)

• Para limitações do conector Oracle, vá para 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.

Resolução de Problemas

• Só existe um (1) registo na sua tabela virtual, mesmo que tenha mais na sua tabela de origem.
  Solução: Verifique a tabela de origem e certifique-se de que tem uma chave primária definida.

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

  • "Recurso não encontrado para o segmento msdyn_get_required_fields"
  • "Erro ao chamar... verifique se a ligaçã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 a sua solução de fornecedor de conectores virtuais necessita 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, em seguida, selecione o item pretendido.
  2. Selecione a guia Histórico .
  3. Pesquise ConnectorProvider.
  4. Consulte as informações para ver se a solução necessita de ser atualizada.
  5. Se o histórico indicar que uma atualização é necessária, vá para a pesquisa do mercado comercial Microsoft por Virtual Connector Provider e selecione Obter agora para importar a solução para seu ambiente.
  6. Siga os passos para criar novamente a tabela virtual.

• É apresentada uma mensagem "Ligaçã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 do Dataverse utente. Isto foi corrigido com a versão 1029 da solução Fornecedor de Conectores. Para determinar se a sua solução de fornecedor de conectores virtuais necessita 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, em seguida, selecione o item pretendido.
  2. Selecione a guia Histórico .
  3. Pesquise ConnectorProvider.
  4. Consulte as informações para ver se a solução necessita de ser atualizada.
  5. Se o histórico indicar que uma atualização é necessária, vá para a pesquisa do mercado comercial Microsoft por Virtual Connector Provider e selecione Obter agora para importar a solução para seu ambiente.
  6. Siga os passos para criar novamente a tabela virtual.

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

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

  1. Selecione Configurações (ícone de engrenagem) >Configurações avançadas de Power Apps.
  2. No menu superior, selecione Configurações.
  3. Vá para Soluções. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
  4. Aceda à solução que inclui a sua tabela virtual (se não estava a utilizar uma solução, aceda à Solução Predefinida Common Data Services).
  5. No painel esquerdo, selecione tabela virtual fontes de dados.
  6. Clique duas vezes em cada origem de dados (todos eles começam com VCP_DS_..."), quando você localizar aquele com o erro, exclua esse origem de dados.
  7. Recrie o seu tabela virtual.

• É apresentada uma mensagem "Esta tabela já existe, está a recriar a tabela. Não é possível alterar o campo Primário e o nome do Esquema."
  Solução: Esta tabela foi criada anteriormente. Continuando com a criação recria a tabela, isso resulta em quaisquer alterações de tabela feitas no origem de dados a ser atualizado no tabela virtual (isso inclui adição ou remoção de campos). Os valores de nome personalizado e 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 um tabela virtual.

• Você criou um tabela virtual do Excel, mas não o vê na área Tabelas Power Apps.
  Solução: Como a criação do tabela virtual é assíncrona, você pode verificar o estatuto do processo em Trabalhos do sistema. Procure trabalhos do sistema com um Nome inicial Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin e um valor da coluna Referente igual ao nome do novo tabela virtual. Se o estatuto ainda estiver em andamento, basta aguardar a conclusão do trabalho. Se houver um erro, você pode obter detalhes selecionando o hiperlink sistema, nome da tarefa. Neste exemplo, a criação da tabela continua pendente:

  

  Aqui, a criação da tabela falhou devido ao erro 429 "Demasiados Pedidos":

  

• O trabalho de 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 tente continuar com os campos restantes. Isso ocorre porque o sistema não deseja bloquear a criação de tabela virtual quando alguns tipos de coluna não são suportados. Para obter detalhes sobre o erro, habilite o registro em log nas Personalizações de>Configurações>do Sistema de Administração>Habilite o registro em log para rastreamento de plug-in, exclua o tabela virtual e tente criá-lo novamente.

Passos seguintes

Criar tabelas virtuais usando o provedor de conector virtual (pré-visualização)

Configurar uma relação de tabela virtual