Compartilhar via


Solucionar problemas de gerenciamento do ciclo de vida

Use este artigo para solucionar problemas no processo de gerenciamento do ciclo de vida.

Para entender as considerações e limitações de vários problemas de gerenciamento do ciclo de vida, examine os links na tabela a seguir:

Tópico Integração do Git Pipelines de implantação
Limitações gerais Limitações gerais do Git limitações de pipelines de implantação
Permissões necessárias permissões permissões
Limitações do workspace Espaços de trabalho Espaços de trabalho
Itens suportados pelo Fabric itens com suporte itens com suporte
Modelo semântico Limitações do modelo semântico

Integração do Git

Problemas de acesso

Não consigo acessar meu repositório do Azure DevOps

Descrição do problema: quando vou para a guia de Integração do Git, recebo uma mensagem de erro e não consigo acessar o Azure DevOps.

Causa: se o método de autenticação no Power BI for mais fraco que o método de autenticação no Azure DevOps, as funcionalidades entre eles não funcionarão.
Solução alternativa: o administrador precisa alinhar o método de autenticação no Power BI e no Azure DevOps. As políticas de autenticação para o Microsoft Entra ID (anteriormente conhecido como Azure Active Directory) são definidas em Gerenciar métodos de autenticação.

Excedi o limite de requisições do Git

Descrição do problema: quando tento atualizar ou me comprometer com o Git, recebo uma mensagem de erro informando que excedi o limite de taxa do Git.

Captura de tela da mensagem de erro informando que o limite de taxa do Git excedeu.

Causa: seu provedor git limita o número de ações do Git que você pode executar em um determinado período de tempo. O limite de taxa pode ser atingido executando um grande número de operações git ou executando operações que envolvem um grande número de itens. Para obter informações sobre os limites de taxa do GitHub, consulte Sobre os limites de taxa primária. Para os limites do Azure DevOps, consulte Os limites de taxa e de uso.

Solução: aguarde o tempo especificado na mensagem de erro e tente novamente. Se você continuar a ver esse erro, entre em contato com seu provedor Git para obter mais informações.

Problemas de conexão

Falha na conexão: não é possível se conectar ao repositório

Descrição do problema: quando tento me conectar a um repositório Git, recebo uma mensagem informando que não é possível se conectar porque o workspace está em uma região diferente.
Causa: se o workspace e o repositório estiverem localizados em regiões diferentes, a opção entre regiões deverá ser habilitada.
Solução: habilite ações do Git em workspaces que residem em outras localizações geográficas.

Falha de conexão: diz que algo deu errado quando tento me conectar

Descrição do problema: depois de selecionar Conectar na guia de integração do Git, a caixa de diálogo Algo deu errado é exibida. Além disso, quando você seleciona o botão de controle do código-fonte, o painel indica que você precisa sincronizar com o GIT branch.

Captura de tela da mensagem de erro exibida quando o espaço de trabalho não consegue se conectar.

Captura de tela da mensagem de erro exibida quando o espaço de trabalho não está conectado a uma GIT branch.

Causa: se a pasta à qual você está tentando se conectar tiver subdiretórios, mas nenhum item do Fabric, a conexão falhará.

Solução: abra o repositório Git no Azure DevOps e navegue até a pasta do Git definida na conexão. Se a pasta do Git contiver subdiretórios, verifique se pelo menos um deles representa uma pasta de itens. Se o diretório contiver arquivos item.config.json e item.metadata.json, será um diretório de item. Se o diretório não contiver esses arquivos, ele será um subdiretório. Se a pasta do Git não contiver diretórios de item, você não poderá se conectar a ela. Remova os subdiretórios ou conecte-se a uma pasta diferente que não contenha subdiretórios.

O ícone de controle do código-fonte não tem um número

Descrição do problema: o número no ícone Controle de origem indica o número de alterações que foram feitas no espaço de trabalho desde a última confirmação. Se o ícone não tiver um número, pode ter havido um problema ao se conectar ao branch.
Solução: desconecte e reconecte-se.

Captura de tela do ícone de controle de origem sem um número.

Falha de conexão: diz que preciso de uma licença Premium para me conectar ao Git

Descrição do problema: meu workspace foi conectado anteriormente a um repositório do Git, mas agora ele diz que preciso de uma licença Premium para me conectar.
Causa: você só poderá se conectar a repositórios do Git se tiver uma licença Premium válida. Se sua licença tiver expirado ou você alterar sua licença para uma licença que não inclua a integração do Git, você não poderá mais se conectar a esse repositório. Isso também se aplica a licenças de avaliação.
Solução: desconecte-se do Git e trabalhe sem controle do código-fonte ou compre uma licença Premium.

Ramificação: não vejo a ramificação à qual quero me conectar

Descrição do problema: não vejo o workspace ao qual quero me conectar na guia de ramificação do painel de Controle do código-fonte.
Causa: a lista de ramificação mostra apenas os workspaces que você tem permissão para exibir.
Solução: Certifique-se de que a área de trabalho desejada existe e que você tem permissão para visualizá-la. Caso contrário, peça ao proprietário do espaço de trabalho para lhe conceder permissão. Veja Limitações do branch para obter mais informações.

Ramificação: meu novo espaço de trabalho não foi sincronizado com o repositório do Git

Descrição do problema: ao fazer a ramificação para um novo espaço de trabalho, estou navegando ao novo espaço de trabalho, mas a integração do Git não está habilitada lá. Causa: a opção de integração do Git pode estar habilitada para o espaço de trabalho de origem, mas não para todo o locatário, pois o administrador de locatários pode delegar o controle da opção aos administradores do espaço de trabalho. Se este for o caso, o novo espaço de trabalho não terá a integração com o Git habilitada e você precisará habilitá-la de forma manual nas configurações do espaço de trabalho antes de sincronizá-lo com o Git. Solução: habilite a integração do Git nas configurações de espaço de trabalho do novo espaço de trabalho.

Problemas de pasta de conexão

Falha de conexão: está perguntando se quero criar uma nova pasta quando tento me conectar a um branch Git

Descrição do problema: depois de selecionar Conectar na guia de integração do Git, uma caixa de diálogo aparece indicando um caminho de pasta inválido.

Captura de tela da mensagem de erro exibida quando o espaço de trabalho não pode se conectar a uma pasta.

Causa: A pasta que você está tentando conectar não existe, foi excluída ou difere em sensibilidade a maiúsculas e minúsculas das pastas existentes no repositório. Essa mensagem poderá aparecer se você estiver se conectando a um novo branch ou se a pasta tiver sido excluída do branch.

Solução:

  • Para criar uma nova pasta e conectá-la ao workspace, selecione Criar e sincronizar.
  • Para conectar o workspace a uma pasta diferente, selecione Cancelar e escolha outra pasta nas configurações do workspace da guia de integração do Git.

Meu status do Git diz que tenho alterações não confirmadas, mas não fiz nenhuma alteração no meu workspace

Descrição do problema: quero atualizar meu workspace, mas ele diz que tenho alterações não confirmadas. Não fiz nenhuma alteração no meu workspace.

Causa: Se o seu workspace tiver pastas e a pasta Git conectada ainda não tiver subpastas, elas serão consideradas diferentes. Se o workspace tiver pastas, mas o branch do Git não tiver, você verá a mensagem de alterações não confirmadas. Se você tentar atualizar o espaço de trabalho antes de confirmar as alterações, ocorre um conflito. Depois que a pasta Git tiver a mesma estrutura de pastas que o workspace, você não receberá mais essa mensagem.

Solução: para resolver o problema, confirme as alterações no Git. Se você não puder fazer alterações diretamente no branch conectado, recomendamos usar a opção branch de check-out. Para obter mais informações, consulte Alterações de pasta: manipulação segura.

Problemas de confirmação

O botão Confirmar está desabilitado

Descrição do problema: se houver atualizações feitas no GIT branch, as confirmações serão desabilitadas até que você atualize o workspace.
solução: para habilitar confirmações, atualize seu workspace.

Tamanho máximo de confirmação excedido

Descrição do problema: ao tentar fazer commit de itens no Git, recebo um erro informando que o tamanho máximo da confirmação foi excedido.

Captura de tela ou mensagem de erro que diz Tamanho de commit máximo excedido.

Causa: o tamanho total dos arquivos a serem confirmados é limitado a 50 MB.
solução: se você estiver tentando confirmar vários itens ao mesmo tempo, considere emiti-los em lotes menores. Se o commit contiver um item com muitos arquivos, entre em contato com o suporte.

Problemas de atualização

Os botões Confirmar e Atualizar estão desabilitados

Descrição do problema: alterar o mesmo item no workspace e o GIT branch pode gerar um possível conflito. Se forem feitas alterações no workspace e no GIT branch no mesmo item, as atualizações serão desabilitadas até que o conflito seja resolvido.
Solução: resolva conflitos e tente novamente.

Falha na atualização: corrigir IDs lógicas duplicadas

Descrição do problema: ao tentar atualizar, uma caixa de diálogo aparece indicando falha porque o diretório Git contém itens com IDs lógicas duplicadas.

Captura de tela da mensagem de erro no painel de controle do código-fonte sobre IDs lógicas duplicadas.

Causa: a ID lógica de cada item no workspace deve ser exclusiva. Quando você copia um item na área de trabalho, a ID lógica é alterada automaticamente para uma ID exclusiva. Quando você copia o diretório de um item no Git, a ID lógica não é alterada. Se você copiar um arquivo de item no Git e tentar atualizar para o workspace, a ID lógica será duplicada, causando um erro.

solução: Para resolver o problema, é necessário alterar o ID lógico do item ou dos itens duplicados no Git antes de atualizar o workspace. Você tem duas opções:

Captura de tela da mensagem de erro oferecendo duas opções para corrigir IDs lógicas.

  • Se você tiver permissão para fazer confirmações diretas no branch, selecione Corrigir com confirmação direta. Isso modificará o arquivo do sistema do item para criar uma ID lógica exclusiva no Git. Os dados do workspace não são modificados até que você atualize do Git.

  • Se você não tiver permissão para fazer confirmações diretas no branch, selecione Criar branch e ir para o Git. Isso abrirá um novo branch e alterará a ID lógica. Em seguida, você precisa mesclar as alterações no Git antes que elas possam ser vistas no Fabric. Em seguida, quando você atualiza do Git, os dados do workspace são modificados.

Descrição do problema: depois de selecionar Atualizar tudo ou Desfazer, uma caixa de diálogo aparece indicando falha porque a ação interromperia um vínculo de dependência.

Captura de tela da mensagem de erro exibida quando a atualização quebrava as dependências.

Solução: abra a visão de linhagem para encontrar o item ou os itens que seriam excluídos do workspace na atualização e estão vinculados a itens que não serão excluídos do workspace.

Captura de tela da exibição de linhagem.

Para resolve o problema, exclua os itens problemáticos:

  • Se o item não tiver suporte do Git (por exemplo, Painéis), exclua-o manualmente do espaço de trabalho.
  • Se o item tiver suporte do Git (por exemplo, relatórios), exclua-o do git (se ele existir) ou do espaço de trabalho.

Selecione Atualizar Tudo.
Para obter mais informações, confira Atualizar manualmente a partir do Git.

Falha após a atualização: as dependências não estão apontando para os itens corretos

Descrição do problema: após a atualização do Git, ao examinar a exibição de linhagem, as dependências de alguns itens não são as esperadas. Por exemplo, o modelo de proxy não aponta mais para o modelo correto.

Motivo: a Integração do Git não dá suporte a modelos de consulta direta e proxy no momento.

Solução: para corrigir as dependências, execute uma das seguintes ações:

  • Edite o arquivo bim do ProxyDataset no repositório Git para que ele aponte para o conjunto de dados correto e, em seguida, no workspace, atualize a partir do Git para receber a alteração.
  • Use a API Atualizar Fonte de Dados para atualizar os detalhes de conexão do modelo proxy no workspace.

Resolver problemas de erros

Corrigir IDs lógicas duplicadas

Descrição do problema: ao tentar confirmar alterações no Git, você recebe uma mensagem de erro informando que há IDs lógicas duplicadas no workspace.

Captura de tela da mensagem de erro quando há dois ou mais itens no workspace com a mesma ID lógica.

Causa: a ID lógica é uma ID exclusiva para cada item no workspace. Quando você copia um item no Git, a pasta inteira é duplicada exatamente, incluindo a ID lógica. Quando você tenta atualizar o workspace, o sistema verifica se há IDs lógicas duplicadas e impede que você confirme alterações se encontrar alguma.

Solução: para corrigir o problema, você precisa alterar a ID lógica de um dos itens.

  • Se você tiver permissão de gravação no repositório, selecione Corrigir com confirmação direta. Um novo branch é criado automaticamente. Altere a ID lógica do item copiado no novo branch e confirme as alterações.

  • Se você não tiver permissão de gravação no repositório, selecione Criar branch e vá para Git*. Um novo branch é criado automaticamente. Altere a ID lógica do item copiado no novo branch e crie uma solicitação de pull para mesclar as alterações.

Desfazer problemas

Falha ao desfazer: depois de selecionar "Desfazer" uma caixa de diálogo aparece indicando falha porque a dependência não pode ser encontrada

Descrição do problema: o erro a seguir aparecerá após uma ação de desfazer se houver uma dependência não confirmada na guia Alterações que não foi selecionada na ação "Desfazer".

Captura de tela da mensagem de erro quando desfazer falha porque a dependência não foi encontrada.

Solução: selecione todas as dependências do banco de dados selecionado e tente novamente.

Descrição do problema: o seguinte erro aparece após uma ação desfazer, atualizar ou alternar branch:

Captura de tela da mensagem de erro exibida quando desfazer uma ação falha porque quebraria um vínculo de dependência.

Causa: há um item sem suporte no espaço de trabalho que depende de um item que não está mais no espaço de trabalho causando um problema de dependência.

Solução: abra o Modo de exibição de linhagem para localizar o item ou os itens que foram selecionados para serem "desfeitos" e estão vinculados aos itens que não estão selecionados.

Captura de tela da exibição de linhagem.

Para resolve o problema, exclua os itens problemáticos:

  • Se o item não selecionado tiver suporte do Git (por exemplo, relatórios), selecione-o para ser excluído também.
  • Se o item não selecionado não tiver suporte do Git (por exemplo, Painéis), exclua-o manualmente do workspace.

Para saber mais sobre dependências, confira Entender dependências.

Pipelines de implantação

Não consigo ver o botão de pipelines de implantação

As condições a seguir devem ser atendidas para ver o botão pipelines de implantação.

Não consigo ver a marca de estágio do pipeline em meu workspace

Pipelines de implantação exibem uma marca de estágio de pipeline nos workspaces que estão atribuídos a um pipeline. Para ver essas marcas, você precisará ser um administrador de pipeline. As marcas para os estágios de Desenvolvimento e Teste estarão sempre visíveis. No entanto, você só vê a marca de Produção se tiver acesso ao pipeline.

Captura de tela da marca de produção em um workspace do pipeline de produção.

Conexões perdidas após a implantação

Descrição do problema: em um pipeline completo, depois de cancelar a atribuição de um workspace de um estágio e, em seguida, implantá-lo, os pipelines de implantação restabelecem as conexões entre os itens no estágio de origem do qual você implantou e o estágio de destino. No entanto, às vezes, os pipelines de implantação não podem restabelecer as conexões entre os itens nos estágios de origem e de destino. Isso pode acontecer, por exemplo, quando você exclui acidentalmente um item.

Solução: para restabelecer essas conexões, desatribua e reatribua o mesmo workspace no estágio de destino.

Não consigo atribuir um workspace a um estágio

Causa: quando você atribui um workspace a um estágio de pipelines de implantação, os pipelines de implantação verificam os itens (como relatórios e dashboards) no workspace. Caso existam dois itens do mesmo tipo com o mesmo nome em um estágio adjacente, os pipelines de implantação não conseguem determinar qual deles deve corresponder ao item no espaço de trabalho designado, e a mensagem de erro não é possível atribuir o espaço de trabalho será exibida. Por exemplo, se você estiver tentando atribuir um espaço de trabalho ao estágio de teste e um de seus relatórios for chamado de "vendas regionais", se houver mais de um relatório com o mesmo nome nos estágios de desenvolvimento ou produção, a atribuição falhará. Atribuir seu espaço de trabalho também falhará se o espaço de trabalho que você está atribuindo tiver dois modelos semânticos intitulados "modelo semântico de vendas regionais" e se houver um modelo semântico com o mesmo nome nos estágios de desenvolvimento ou produção.
Solução: para resolver esse erro, altere o nome do item que não corresponde ao item no estágio que você está tentando atribuir. Você pode selecionar os links na mensagem de erro para abrir os itens no Fabric.

Uma captura de tela da mensagem de erro *Não é possível atribuir o workspace* nos pipelines de implantação.

Vejo o símbolo 'diferente' depois de atribuir um espaço de trabalho com modelos semânticos semelhantes aos modelos semânticos em etapas adjacentes.

Causa: a maioria dos modelos semânticos usa o recurso de metadados de modelo semântico aprimorado, também conhecido como modelo v3. No entanto, relatórios mais antigos podem estar usando o tipo antigo de metadados de modelo semântico, às vezes chamados de modelo v1. Se você estiver atribuindo um workspace que usa o modelo de metadados de modelo semântico antigo (v1), os pipelines de implantação não poderão avaliar se o modelo semântico é semelhante em estágios adjacentes. Nesses casos, o símbolo de interface do usuário diferente é exibido, mesmo quando os modelos semânticos são idênticos.
Solução: para resolver esse problema, implemente os modelos semânticos que estão mostrando o símbolo diferente.

Não consigo ver todos os meus workspaces quando tento atribuir um workspace a um pipeline

Causa: pode haver vários motivos pelos quais talvez você não veja um workspace na lista de workspaces que você pode atribuir a um pipeline.

Solução: para atribuir um workspace a um pipeline, as seguintes condições devem ser atendidas:

  • Você é um administrador do workspace

  • O workspace não está atribuído a outro pipeline

  • O workspace reside em uma capacidade do Fabric

Os workspaces que não atenderem a essas condições não serão exibidos na lista de workspaces que você pode selecionar.

Minha primeira implantação falhou

Causa: sua primeira implantação pode ter falhado por vários motivos.
Solução: alguns possíveis motivos para a falha com suas soluções estão listados na tabela a seguir.

Erro Ação
Você não tem permissões de capacidade. Se você trabalha em uma organização que tem uma capacidade do Fabric, peça a um administrador de capacidade que adicione seu espaço de trabalho a uma capacidade ou solicite permissões de atribuição para a capacidade. Depois que o workspace estiver em uma capacidade, reimplante.

Se você não trabalha em uma organização com uma capacidade do Fabric, considere realizar a aquisição do Premium Por Usuário (PPU).
Você não tem permissões de workspace. Para implantar, você precisa ser um membro do workspace. Peça ao administrador do workspace para conceder a você as permissões apropriadas.
O administrador do Fabric desabilitou a criação de workspaces. Entre em contato com o administrador do Fabric para obter suporte.
Você está usando a implantação seletiva e não está selecionando todos os itens vinculados. Faça um dos seguintes procedimentos:

desmarque o conteúdo vinculado ao modelo semântico ou fluxo de dados. O conteúdo não selecionado (como modelos semânticos, relatórios ou painéis) não será copiado para a próxima fase.

Selecione o modelo semântico ou o fluxo de dados vinculado aos itens selecionados. Seus itens selecionados serão copiados para o próximo estágio.

Tenho "itens sem suporte" em meu workspace quando tento implantar

Causa: os pipelines de implantação não dão suporte a todos os itens.
Solução: para obter uma lista abrangente de itens com suporte que estão em pipelines de implantação, consulte as seguintes seções:

Itens não relacionados na lista de itens com suporte não são copiados para o próximo estágio.

Quero alterar a fonte de dados nos estágios do pipeline

Causa: não é possível alterar a conexão da fonte de dados no serviço do Power BI.

Solução: se quiser alterar a fonte de dados nos estágios de teste ou de produção, você poderá usar regras de implantação ou APIs. As regras de implantação entrarão em vigor somente após a próxima implantação.

Corrigi um bug em produção, mas agora o botão "implantar no estágio anterior" está desabilitado

Causa: só é possível fazer implantações em estágios anteriores que estejam vazios. Se você tiver conteúdo no estágio de teste, não poderá implantar em estágios anteriores à produção.

Solução: depois de criar o pipeline, use o estágio de desenvolvimento para desenvolver seu conteúdo e os estágios de teste para revisá-lo e testá-lo. Você pode corrigir bugs nesses estágios e, em seguida, implantar o ambiente corrigido no estágio de produção.

Observação

A implantação com versões anteriores dá suporte apenas a implantação completa. Ela não permite a implantação seletiva

Mensagem de erro: 'prossiga com a implantação'

Causa: alterações interruptivas de esquema no estágio de origem, como a substituição de um tipo de coluna de um inteiro para uma cadeia de caracteres, causam perda de dados no modelo semântico de destino após a implantação.

Durante a implantação, os metadados no modelo semântico de origem são verificados nos metadados de destino. Alterações interruptivas de esquema fazem com que a implantação pare. Quando isso acontece, você recebe uma mensagem para continuar a implantação.

Uma captura de tela da mensagem para continuar a implantação nos pipelines de implantação.

Solução: se você continuar com a implantação, perderá os dados no estágio de destino. Você poderá usar essa opção se as alterações feitas no modelo semântico forem intencionais. Após a conclusão da implantação, você precisará atualizar o modelo semântico de destino.

Se as alterações não foram intencionais, feche a janela de mensagem, carregue o arquivo .pbix fixo no workspace de origem e reimplante.

Depois que uma implantação falhar devido a alterações de esquema, o estágio de destino exibirá a mensagem Falha de implantação, seguida pelo link Mostrar detalhes. O link abre a mesma mensagem de continuar a implantação que foi exibida durante a implantação falhada.

Mensagem de erro: 'não é possível iniciar a implantação'

Causa: ao usar a atualização incremental, somente determinadas alterações no modelo semântico que você está implantando são permitidas. Se você fez alterações no modelo semântico que não são permitidas, sua implantação falhará e você receberá esta mensagem:

Uma captura de tela da mensagem de erro de implantação não pode ser iniciada nos pipelines de implantação.

Solução: se você fez alterações no modelo semântico intencionalmente, use uma das seguintes soluções alternativas:

  • Usando o.pbix: publique suas alterações diretamente no modelo semântico de destino. Todas as partições e os dados são perdidos, ou seja, você precisa atualizar o modelo semântico.

  • Usando ferramentas XMLA: faça suas alterações diretamente no modelo semântico na fase de destino.

Meu visual parou de funcionar depois da implantação de um modelo semântico ou de um fluxo de dados.

Causa: os modelos semânticos e os fluxos de dados são itens do Fabric que armazenam dados e contêm tanto os dados quanto os metadados. Durante a implantação, somente os metadados são copiados, os dados não. Como resultado, após a implantação, o modelo semântico ou o fluxo de dados podem ficar sem dados, e um visual de relatório que dependa desses dados poderá aparecer quebrado.
Solução: para resolver esse problema, atualize o fluxo de dados e o modelo semântico no estágio de destino.

Como excluir um pipeline que não tem proprietário (pipeline órfão)?

Causa: ao trabalhar com pipelines de implantação, você pode acabar ficando com um pipeline sem proprietário. Por exemplo, um pipeline pode ficar sem proprietário quando o usuário proprietário sai da empresa sem transferir a propriedade. Quando um pipeline não tem um proprietário, os outros usuários não podem acessá-lo. Como um workspace só pode ser atribuído a um pipeline, se ele for atribuído a um pipeline sem proprietário, ninguém poderá desatribuí-lo e você não poderá usar o workspace em outro pipeline.

Solução: quando um pipeline fica sem um proprietário, um administrador do Fabric pode adicionar um novo proprietário ao pipeline ou excluí-lo. Para adicionar um proprietário ao pipeline, use a API Admin –Pipelines UpdateUserAsAdmin.

Você também pode examinar o script do PowerShell, AddUserToWorkspacePipeline (disponível no repositório do GitHub PowerBI-Developer-Samples), que permite fazer o seguinte:

  • Gerenciar acesso de pipeline – adicione qualquer usuário a um workspace em um pipeline.

  • Recuperar a propriedade do workspace – adicionar qualquer usuário a um workspace em um pipeline sem proprietário, permitindo que ele seja desbloqueado.

Para usar esse script, você precisa fornecer um nome de workspace e um nome principal de usuário (UPN). O script encontra o pipeline ao qual o workspace está atribuído e adiciona permissões de administrador ao usuário especificado.

Erro de incompatibilidade: erro de incompatibilidade de versão de formato semântico de origem e destino

Descrição do problema: o erro Não foi possível iniciar a implantação que afirma que os modelos semânticos de origem e de destino têm formatos de modelagem de dados diferentes, ocorre quando o modelo semântico no estágio de destino tem uma versão de modelo mais alta do que o modelo semântico no estágio de origem. Nesses casos, os pipelines de implantação não são capazes de implantar do estágio de origem para o estágio de destino. Para evitar esse erro, use um modelo semântico que tenha a mesma versão do modelo (ou superior) na fase de origem.

Solução: atualize o modelo semântico no estágio de origem usando um ponto de extremidade de leitura/gravação XMLA ou o Power BI Desktop. Depois de atualizar o modelo semântico, republique-o na fase de origem.

Erro de incompatibilidade: erro de incompatibilidade do modo de conectividade da fonte de dados

Descrição do problema: Durante a implantação, se os pipelines de implantação descobrirem que o modo de conectividade de uma fonte de dados no estágio de destino não é o mesmo que a da fonte de dados no estágio de origem, eles tentam converter o modo de conectividade da fonte de dados no estágio de destino. Se você estiver usando uma fonte de dados com os modos de conectividade conexão dinâmica ou tempo real, os pipelines de implantação não poderão converter o modo de conectividade da fonte de dados do destino.
Solução: use um ponto de extremidade de leitura/gravação XMLA ou o Power BI Desktop para alterar o modo de conexão da fonte de dados no estágio de origem ou excluir a fonte de dados no estágio de destino para que a implantação a substitua.

Falha na implantação do meu modelo semântico

Causa: pode haver alguns motivos possíveis para que a implantação do modelo semântico falhe. As seguintes são possíveis causas para falha:

  • Um modelo semântico grande não está configurado com o formato de modelo semântico grande.
  • O modelo semântico contém uma dependência circular ou de si mesmo (por exemplo, o item A faz referência ao item B e o item B faz referência ao item A). Nesse caso, você verá a seguinte mensagem de erro: Um ou mais itens falharam ao implantar porque resultará em uma dependência bidirecional entre os itens.

Solução:

  • Se o modelo semântico for maior que 4 GB e não estiver usando o formato de modelo semântico grande, ele poderá não ser implantado. Tente configurar seu modelo semântico para usar o formato de modelo semântico grande e, em seguida, reimplante.
  • Se o modelo semântico contiver uma dependência circular ou uma autodependência, remova a dependência e implante novamente.

Tenho um modelo semântico com o modo de conectividade DirectQuery ou Composite, que usa tabelas de variação ou data/hora automáticas

Causa: modelos semânticos que usam o modo de conectividade DirectQuery ou Composite e têm variação ou tabelas de data/hora automática não têm suporte em pipelines de implantação.
Solução: se a implantação falhar e você achar que é porque você tem um modelo semântico com uma tabela de variação, poderá procurar a propriedade variations nas colunas da tabela. Você pode usar um dos métodos a seguir para editar o modelo semântico para que ele funcione em pipelines de implantação.

  • Use o modo de importação em vez do modo DirectQuery ou Composto em seu modelo semântico.

  • Remova as tabelas automáticas de data/hora do modelo semântico. Se necessário, exclua todas as variações restantes de todas as colunas em suas tabelas. Excluir uma variação pode invalidar medidas criadas pelo usuário, colunas calculadas e tabelas calculadas. Use esse método somente se você entender como o modelo semântico funciona, pois isso pode resultar em corrupção de dados em seus visuais.

Relatórios paginados

Não consigo implantar um relatório paginado

Solução: para implantar um relatório paginado, você precisará ser um membro do workspace do qual está implantando (o workspace do estágio de origem). Se você não for membro do workspace no estágio de origem, não poderá implantar o relatório paginado.

Incompatibilidade da fonte de dados: o relatório paginado da fase de destino exibe dados de um modelo semântico do Fabric na fase de origem

Descrição do problema: no momento, os modelos semânticos são tratados como uma fonte de dados externa do Analysis Services, e as conexões com modelos semânticos não são alternadas automaticamente após a implantação.

Quando você implanta um relatório paginado que está conectado a um modelo semântico do Fabric, ele continua a apontar para o modelo semântico ao qual estava conectado originalmente. Use regras de implantação para apontar seu relatório paginado para qualquer modelo semântico que desejar, incluindo, por exemplo, o modelo semântico de estágio alvo.

Solução: se você estiver usando um relatório paginado com um modelo semântico do Fabric, confira Como fazer para criar uma regra de implantação para um relatório paginado com um modelo semântico do Fabric?

Falha na implantação: grande número de relatórios paginados falha

Descrição do problema: uma implantação de um grande número de relatórios paginados com regras pode falhar devido a uma sobrecarga na capacidade.
Solução: adquira um SKU superior ou use a implantação seletiva.

Fluxos de dados

Exibição de linhagem: excluí uma fonte de dados que pertencia a um fluxo de dados, mas eu ainda posso vê-la na exibição de linhagem

Causa: em fluxos de dados, as fontes de dados antigas não são removidas da página de fonte de dados do fluxo de dados. Para dar suporte à exibição de linhagem de fluxos de dados, os itens conectados não são excluídos.

Solução: esse comportamento não afeta os pipelines de implantação. Você ainda pode atualizar, editar e implantar fluxos de dados em um pipeline.

Vejo duas fontes de dados conectadas ao meu fluxo de dados depois de usar as regras de fluxo de dados

Descrição do problema: depois de alterar uma fonte de dados de um fluxo de dados usando uma regra, a exibição da linhagem do fluxo de dados exibe uma conexão entre a fonte de dados de origem e a fonte de dados configurada na regra.

Solução: esse comportamento não afeta os pipelines de implantação.

Datamarts

Problema de implantação: não consigo implantar um datamart no pipeline

Solução: para implantar um datamart, você deve ser o proprietário dele.

Problema de implantação: minha implantação do datamart falhou devido a uma dependência circular

Captura de tela da mensagem de erro sobre dependências circulares ou autodependências.

Solução: existe um item que faz referência a si próprio ou a mais de um item envolvido em uma cadeia de referências circular (por exemplo, o item A faz referência ao item B e o item B faz referência ao item A). Para implantar o datamart, remova a dependência circular e reimplante.

Permissões

Quem pode implantar conteúdo entre os estágios?

O conteúdo pode ser implantado em um estágio vazio ou em um estágio que contenha conteúdo. O conteúdo deve residir em uma capacidade do Fabric.

  • Implantar em um estágio vazio – qualquer usuário Pro que seja membro ou administrador no workspace de origem.

  • Implantar em um estágio com conteúdo – qualquer usuário licenciado do Fabric que é membro ou administrador de ambos os workspaces nos estágios de implantação de origem e de destino.

  • Substituindo um modelo semântico: a implantação substitui cada modelo semântico incluído na fase de destino, mesmo que o modelo semântico não tenha sido alterado. Qualquer usuário que seja membro ou administrador de ambos os workspaces, mas o administrador do locatário poderá restringir isso a somente proprietários do modelo semântico de destino.

Não consigo ver um workspace no pipeline

Causa: as permissões de pipeline e workspace são gerenciadas separadamente. Você pode ter permissões de pipeline, mas não permissões de workspace.
Solução: para obter mais informações, confira a seção de permissões.

Mensagem de erro: 'permissões de membro do workspace necessárias'

Solução: para atribuir um workspace, você precisa pelo menos de permissões de membro de workspace para os workspaces em estágios adjacentes. Permissões de membro de workspace (ou superior) nos estágios adjacentes são necessárias para habilitar pipelines de implantação a fim de estabelecer conexões entre itens em estágios de pipeline vizinhos.

Uma captura de tela da mensagem de permissão de membro do workspace necessária no estágio de teste de um pipeline de implantação.

Regras

Falha na implantação devido a regras quebradas

Solução: se você tiver problemas ao configurar regras de implantação, acesse regras de implantação e siga as limitações das regras de implantação.

Se sua implantação foi bem-sucedida anteriormente e, de repente, está falhando com regras desfeitas, pode ser devido a um modelo semântico sendo republicado. As seguintes alterações no modelo semântico de fonte resultam em uma implantação com falha:

Regras de parâmetro
  • Um parâmetro removido

  • Um nome de parâmetro alterado

Regras de origem de dados

Suas regras de implantação têm valores ausentes. Isso pode ter acontecido se o modelo semântico foi alterado.

Uma captura de tela do erro de regras inválidas é exibida quando uma implantação falha devido a links desfeitos.

Quando uma implantação anteriormente bem-sucedida falha devido a links quebrados, um aviso é exibido. Você pode selecionar Configurar regras para navegar até o painel de regras de implantação no qual o modelo semântico com falha está marcado. Quando você seleciona o modelo semântico, as regras inválidas são marcadas.

Para implantar com êxito, corrija ou remova as regras desfeitas e reimplante-as.

Problema de implantação: configurei regras, mas elas não foram implantadas

Causa: as regras de implantação não serão aplicadas imediatamente após serem configuradas.

Solução: para aplicar as regras de implantação, você precisará implantar os modelos semânticos da fase de origem para a fase de destino que inclui as regras de implantação criadas. Depois de configurar regras de implantação e antes de implantar, o indicador diferente é mostrado ao lado do modelo semântico com as regras configuradas. Isso indica que você precisa implantar esse modelo semântico da fase de origem para a fase de destino. Depois da implantação, se nenhuma outra alteração for feita, o indicador diferente desaparecerá, significando que as regras foram aplicadas com sucesso.

As regras de implantação estão esmaecidas

Solução: para criar uma regra de implantação, você deverá ser o proprietário do item para o qual está criando uma regra de implantação. Se você não for o proprietário do item, as regras de implantação ficarão esmaecidas.

Captura de tela mostrando as regras de implantação dos pipelines esmaecidas.

Se uma das opções de regra estiver esmaecida, poderá ser devido aos motivos a seguir:

  • Regras de fonte de dados – não há nenhuma fonte de dados na qual uma regra possa ser configurada.

  • Regras de parâmetros – não há parâmetros para os quais uma regra possa ser configurada.

A regra da minha fonte de dados para um modelo semântico falhou

Solução: salvar regras de fonte de dados poderá falhar devido a um destes motivos:

  • Seu modelo semântico contém uma função conectada a uma fonte de dados. Nesses casos, não há suporte para regras de fonte de dados.

  • Sua fonte de dados está usando parâmetros. Você não pode criar uma regra de fonte de dados para um modelo semântico que usa parâmetros. Em vez disso, crie uma regra de parâmetro.

Não consigo me conectar a um modelo semântico ao criar uma nova regra de modelo semântico

Causa: ao construir um modelo semântico usando o Power BI Desktop, a cadeia de conexão pode ser configurada. Posteriormente, o modelo semântico pode ser publicado e utilizado por fluxos de implantação no serviço do Power BI. Ao criar a conexão no Power BI Desktop, você poderá especificar parâmetros adicionais. Ao especificar os parâmetros, a origem do modelo semântico precisará ser o primeiro parâmetro listado. Se você listar outros parâmetros antes da fonte do modelo semântico, encontrará erros no serviço do Power BI. Nesses casos, ao configurar uma nova regra de modelo semântico, se você apontar para um modelo semântico que não foi configurado corretamente no Power BI Desktop, os pipelines de implantação não poderão criar a regra.

Solução: formate a conexão de modelo semântico no Power BI Desktop para que a origem do modelo semântico apareça na primeira linha. Em seguida, republique o modelo semântico.

Solucionando erros

Use esta seção para solucionar problemas de regras de pipeline que você criou. Se você não vir um nome de mensagem de erro de regra, revise as limitações da regra de implantação e as fontes de dados com suporte em regras de modelo semântico e de fluxo de dados e tente reconfigurar a regra.

Mensagem de erro Solução
A regra de fonte de dados não pode conter um parâmetro Sua regra não pode ser aplicada porque o nome do servidor ou o nome do banco de dados referenciado na regra é controlado por um parâmetro. Para alterar o nome do servidor ou do banco de dados, use uma regra de parâmetro ou remova o parâmetro de controle do item configurado.
Falha na execução da fonte de dados Uma regra não pode ser aplicada devido a um problema ao recuperar dados da fonte de dados. Remova a regra e verifique se o modelo semântico tem consultas válidas. Em seguida, tente criar a regra novamente.
A propriedade de regra não existe mais Algumas das propriedades de regra configuradas na regra não existem mais. Atualize a página e configure a regra novamente.
Valor ilícito Algum valor usado na regra configurada não é válido. Valide os valores da regra e tente configurar a regra novamente.
Não há suporte para várias fontes de dados Uma regra de modelo semântico não pode ser aplicada devido à configuração da fonte de dados. Remova a regra ou reescreva as consultas do modelo semântico usando as ferramentas padrão do Power BI Desktop.
O modelo semântico de destino só pode ser alterado pelo proprietário Sua regra substituirá alguns modelos semânticos no espaço de trabalho de destino. Você precisa ser o proprietário de todos os modelos semânticos que serão substituídos.