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, você pode definir uma regra para modelo semântico em um estágio de produção para apontar para um banco de dados de produção em vez de um no estágio de teste. A regra é definida na etapa de produção, sob o modelo semântico apropriado. Depois que a regra é definida, o conteúdo implantado do teste à produção herda o valor conforme definido na regra de implantação. Esta regra aplica-se sempre desde que não seja alterada 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 aplicam até que você implante os modelos semânticos da origem ao estágio de destino.
- Criar uma regra de implantação na nova interface do usuário
- Criar uma regra de implantação na interface do usuário original
No estágio de pipeline para o qual você deseja criar uma regra de implantação, selecione Regras de implantação.
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.
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.
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-o 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.
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, você não pode abrir o relatório 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.
Os seguintes cenários não são suportados:
- Regras de fonte de dados para fluxos de dados que têm outros fluxos de dados como fontes.
- Regras de fonte de dados para pastas de modelo de dados comum (CDM) em um fluxo de dados.
- Regras de fonte de dados para modelos semânticos que usam fluxos de dados como fonte.
- Criação de regras de fonte de dados em um modelo semântico que usa consulta nativa e DirectQuery juntos.
- Não há suporte para regras de parâmetro para relatórios paginados.
- Adicionar regras de fonte de dados para modelos semânticos e fluxos de dados em fontes de dados que são parametrizadas.