Criar regras de implantação

Quando você está trabalhando em um pipeline de implantação, estágios diferentes podem ter configurações diferentes. Por exemplo, cada estágio pode ter bancos de dados diferentes ou parâmetros de consulta diferentes. O estágio de desenvolvimento pode consultar dados de exemplo do banco de dados, enquanto os estágios de teste e produção consultam todo o banco de dados.

Ao implantar conteúdo entre estágios de pipeline, você pode configurar regras de implantação para alterar o conteúdo, mantendo algumas configurações intactas. Por exemplo, se você quiser que um modelo semântico em um estágio de produção aponte para um banco de dados de produção em vez de um no estágio de teste, você pode definir uma regra para isso. A regra é definida na etapa de produção, sob o modelo semântico apropriado. Depois que a regra for definida, o conteúdo implantado do teste à produção herdará o valor conforme definido na regra de implantação e sempre será aplicado, desde que a regra seja inalterada e válida.

Você pode configurar regras de fonte de dados, regras de parâmetros e regras padrão do lakehouse. A tabela a seguir lista o tipo de itens para os quais você pode configurar regras e o tipo de regra que você pode configurar para cada um.

Item	Regra da fonte de dados	Regra de parâmetro	Regra padrão da casa do lago	Detalhes
Fluxo de dados	✅	✅	❌	Use para determinar os valores das fontes de dados ou parâmetros para um fluxo de dados específico.
Modelo semântico	✅	✅	❌	Use para determinar os valores das fontes de dados ou parâmetros para um modelo semântico específico.
Datamart	✅	✅	❌	Use para determinar os valores das fontes de dados ou parâmetros para um datamart específico.
Relatório paginado	✅	❌	❌	Definido para as fontes de dados de cada relatório paginado. Use para determinar as fontes de dados do relatório paginado.
Bloco de Notas	❌	❌	✅	Use para determinar o lakehouse padrão para um bloco de anotações específico.

Nota

As regras de fonte de dados só funcionam quando você altera fontes de dados do mesmo tipo.

Criar uma regra de implantação

Para criar uma regra de implantação, siga as etapas nesta seção. Depois de criar todas as regras de implantação necessárias, implante os modelos semânticos com as regras recém-criadas do estágio de origem até o estágio de destino onde as regras foram criadas. Suas regras não se aplicarão até que você implante os modelos semânticos da origem ao estágio de destino.

1. No estágio de pipeline para o qual você deseja criar uma regra de implantação, selecione Regras de implantação.

   

2. Uma lista de itens para os quais você pode definir regras aparece na janela. Nem todos os itens no pipeline são listados. Somente itens de um tipo para o qual você pode criar regras são listados (fluxos de dados, modelo semântico, datamarts, blocos de anotações e relatórios paginados). Para encontrar o item para o qual pretende definir uma regra, utilize as funcionalidades de pesquisa ou filtro.

   

3. Selecione o item para o qual deseja criar uma regra. Os tipos de regras que você pode criar para esse item são exibidos. Assim, por exemplo, se você estiver criando uma regra para um fluxo de dados, poderá criar uma regra de fonte de dados ou uma regra de parâmetro. Se você estiver criando uma regra para um bloco de anotações, poderá criar uma regra de lakehouse padrão.

4. Selecione o tipo de regra que pretende criar, expanda a lista e, em seguida, selecione Adicionar regra. Há dois tipos de regras que você pode criar:

   

   • Regras de origem de dados

     Na lista de fontes de dados, selecione um nome de fonte de dados a ser atualizado. Use um dos seguintes métodos para selecionar um valor para substituir o do estágio de origem:

     • Selecione a partir de uma lista.

     • Selecione Outro e adicione manualmente a nova fonte de dados. Você só pode alterar para uma fonte de dados do mesmo tipo.

     Nota

     • As regras da fonte de dados ficarão esmaecidas se você não for o proprietário do item para o qual está criando uma regra ou se o item não contiver nenhuma fonte de dados.
     • Para fluxos de dados, modelos semânticos e relatórios paginados, a lista de fontes de dados é retirada do estágio de pipeline de origem.
     • Não é possível usar a mesma fonte de dados em mais de uma regra.

   • Regras de parâmetros Selecione um parâmetro na lista de parâmetros, o valor atual é mostrado. Edite o valor para o valor que você deseja que entre em vigor após cada implantação.

   • Regras padrão do lakehouse Esta regra só se aplica a notebooks. Selecione uma lakehouse para se conectar ao bloco de anotações no estágio de destino e defina-a como padrão. Para obter mais informações, consulte Bloco de anotações em pipelines de implantação.

Fontes de dados suportadas para regras de modelo semântico e de fluxo de dados

As regras de fonte de dados podem ser definidas para as seguintes fontes de dados:

• Azure Analysis Services (AAS)

• Azure Synapse

• SQL Server Analysis Services (SSAS)

• Azure SQL Server

• SQL Server

• Odata Feed

• Oracle

• SapHana (somente modo de importação; não modo de consulta direta)

• SharePoint

• Teradata

Para outras fontes de dados, recomendamos o uso de parâmetros para configurar sua fonte de dados.

Considerações e limitações

Esta seção lista as limitações para as regras de implantação.

• Para criar uma regra de implantação, você deve ser o proprietário do item para o qual está criando uma regra.

• As regras de implantação não podem ser criadas no estágio de desenvolvimento.

• Quando um item é removido ou excluído, suas regras também são excluídas. Essas regras não podem ser restauradas.

• Quando você cancela e reatribui um espaço de trabalho para restabelecer conexões, as regras para esse espaço de trabalho são perdidas. Para usar essas regras novamente, reconfigure-as.

• Não há suporte para regras de fonte de dados para fluxos de dados que tenham outros fluxos de dados como fontes.

• Não há suporte para regras de fonte de dados para pastas de modelo de dados comum (CDM) em um fluxo de dados.

• Não há suporte para regras de fonte de dados para modelos semânticos que usam fluxos de dados como origem.

• Se a fonte de dados ou o parâmetro definido em uma regra for alterado ou removido do item para o qual aponta no estágio de origem, a regra não será mais válida e a implantação falhará.

• Depois de implantar um relatório paginado com uma regra de fonte de dados, não é possível abri-lo usando o Construtor de Relatórios do Power BI.

• As regras de implantação só entrarão em vigor na próxima vez que você implantar nesse estágio. No entanto, se você criar regras e, em seguida, comparar os estágios antes de implantar, a comparação será feita com base nas regras que foram criadas, mesmo que elas ainda não tenham entrado em vigor.

• Não há suporte para a criação de regras de fonte de dados em um modelo semântico que usa consulta nativa e DirectQuery juntos.

Nota

Não há suporte para regras de parâmetro para relatórios paginados.

Conteúdos relacionados

• Introdução aos pipelines de implantação
• Automatize seu pipeline de implantação usando APIs e DevOps