Criar regras de implantação Criar regras

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

Ao implantar conteúdo entre os estágios do pipeline, você pode configurar regras de implantação para alterar o conteúdo enquanto mantém algumas configurações intactas. Por exemplo, caso queira 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, defina uma regra para isso. A regra é definida no estágio de produção em um modelo semântico apropriado. Depois que a regra for definida, o conteúdo implantado do teste para a produção herdará o valor conforme definido na regra de implantação e sempre será aplicado enquanto a regra estiver inalterada e for válida.

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

Item	Regra de fonte de dados	Regra de parâmetro	Regra de lakehouse padrão	Detalhes
Fluxo de dados	✅	✅	❌	Usar para determinar os valores das fontes de dados ou dos 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 dos parâmetros para um conjunto de dados específico.
Relatório paginado	✅	❌	❌	Definidos para as fontes de dados de cada relatório paginado. Use para determinar as fontes de dados do relatório paginado.
Notebook	❌	❌	✅	Use para determinar o lakehouse padrão para um notebook específico.

Observação

As regras de fonte de dados só funcionam quando são alteradas as fontes de dados do mesmo tipo.

Criar uma regra de implantação

Para criar uma regra de implantação, siga as etapas desta 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 para o estágio de destino em que as regras foram criadas. As regras não serão aplicadas até que você implante os modelos semânticos da origem para o estágio de destino.

1. No estágio do 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 os quais você pode criar regras são listados (fluxos de dados, modelo semântico, datamarts, notebooks e relatórios paginados). Para encontrar o item para o qual você deseja definir uma regra, use a funcionalidade de pesquisa ou de filtro.

   

3. Selecione o item para o qual você deseja criar uma regra. Os tipos de regras que você pode criar para esse item são exibidos. Dessa forma, caso esteja criando uma regra para um fluxo de dados, você poderá criar uma regra de fonte de dados ou uma regra de parâmetro. Caso esteja criando uma regra para um notebook, você poderá criar uma regra de lakehouse padrão.

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

   

   • Regras de fonte de dados

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

     • Selecione na lista.

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

     Observação

     • As regras de 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 do pipeline de origem.
     • Você não pode usar a mesma fonte de dados em mais de uma regra.

   • Regras de parâmetro: selecione um parâmetro da lista de parâmetros; o valor atual é exibido. Edite o valor para aquele que você deseja que tenha efeito após cada implantação.

   • Regras de lakehouse padrão: essa regra só se aplica a notebooks. Selecione um lakehouse para conectar ao notebook na preparação de destino e defina-o como padrão. Para obter mais informações, confira Notebook em pipelines de implantação.

Fontes de dados com suporte para fluxo de dados e regras de modelo semântico

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

• Analysis Services (AAS)

• Azure Synapse

• SSAS (SQL Server Analysis Services)

• Azure SQL Server

• SQL Server

• Feed OData

• Oracle

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

• SharePoint

• Teradata

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

Considerações e limitações

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

• Para criar uma regra de implantação, você deve ser o proprietário do item para o qual está criando a 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. Não é possível restaurar essas regras.

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

• Não há suporte para regras de fonte 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 modelo semântico 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 ela 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, você não pode abrir o relatório usando o Paginated Report Builder.

• 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 da implantação, a comparação será feita com base nas regras que foram criadas, mesmo que 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.

Observação

As regras de parâmetros não são suportadas em relatórios paginados.

Conteúdo relacionado

• Introdução aos pipelines de implantação
• Automatizar o pipeline de implantação usando as APIs e o DevOps