Compartilhar via

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

  • Artigo

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 string, 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 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 não suportados 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 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.
  • O Microsoft Entra ID tabela virtual fornecido por Microsoft permite apenas 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.

Para cada limitação fonte de dados

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

  • 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 seguinte mensagem de erro (vinda do conector SQL): "A solicitação de APIM não foi bem-sucedida: BadRequest: Nenhuma chave primária existe na tabela." Para funcionalidade, um campo GUID ou 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 sua mesa. 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."
  • SQL Tabelas do servidor sem campos de string de chave não primária para uso como Nome Primário: Se a tabela SQL não tiver um campo de string disponível para uso como Nome Primário, exibiremos o seguinte erro na configuração etapa: "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 servidor SQL, acesse SQL Referência do conector do servidor.
  • As colunas bigint do tipo de dados SQL na tabela de origem são mapeadas como um tipo de dados decimal em Dataverse tabelas virtuais. 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 um tabela virtual neste momento:
    • Hora
    • Datetime2
    • Imagem
    • Geometria
    • Geografia
    • RowVersion
  • Os seguintes tipos de coluna estão incluídos em um tabela virtual, mas são exibidos apenas como campos de texto:
    • HierarchyID
    • XML
    • Sqlvariant

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ê obtém um dos seguintes erros quando Power Apps (make.powerapps.com) está recuperando uma lista de tabelas ou quando você Select Conclui para criar uma tabela:

    • "Recurso não encontrado para 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. Select 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. Select a aba Histórico .
    3. Pesquisar por 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 mercado comercial Microsoft procure por Virtual Connector Provider e, em seguida, Select Obtenha agora para importar a solução para 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 There há um grande número de conexões no ambiente do Dataverse 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. Select 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. Select a aba Histórico .
    3. Pesquisar por 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 mercado comercial Microsoft procure por Virtual Connector Provider e, em seguida, Select Obtenha agora para importar a solução para 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 do tabela virtual.
    Solução: Isso pode ocorrer quando outros trabalhos existentes causam atraso na criação do tabela virtual. Aguarde alguns minutos e tente novamente.

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

    1. Select Configurações (ícone de engrenagem) >Configurações avançadas de Power Apps.
    2. No menu superior, Select 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, Select tabela virtual fontes de dados.
    6. Clique duas vezes em cada fonte de dados (todos começam com VCP_DS_..."), quando localizar aquele com o erro, Delete that fonte de dados.
    7. Recrie seu 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 foi criada anteriormente. Continuar com a criação recria a tabela, o que faz com que quaisquer alterações feitas na tabela no fonte de dados sejam atualizadas no 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 na sua tabela de origem para criar um tabela virtual.

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

    Criação de tabela pendente

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

    A criação da tabela falhou devido ao erro 429

  • A tarefa do sistema de criação da tabela foi bem-sucedida, mas você recebe erros de tempo de execução relacionados a colunas inválidas ou ausentes.
    Solução: Se ocorrer uma falha ao criar 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 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 Administração>Configurações do sistema>Personalizações>Habilitar registro no log de rastreamento do plug-in, exclua o tabela virtual e tente criá-lo novamente.

Próximas etapas

Crie tabelas virtuais usando o provedor de conector virtual (versão preliminar)

Configurar um relacionamento da tabela virtual