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, 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 uma no estágio de teste. A regra é definida no estágio de produção, no âmbito do modelo semântico apropriado. Depois que a regra é definida, o conteúdo implantado do teste para a produção herda o valor conforme definido na regra de implantação. Essa regra sempre se aplica desde que seja inalterada e 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. Suas regras não se aplicam até que você implante os modelos semânticos da origem para o 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 do 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 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.
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.
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.
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.
Ainda não há suporte para os cenários a seguir:
- 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 (CDM) comuns em um fluxo de dados.
- Regras de fonte de dados para modelos semânticos que usam fluxos de dados como fonte.
- Criando regras de fonte de dados em um modelo semântico que usa a consulta nativa e o DirectQuery juntos.
- As regras de parâmetros não são suportadas em relatórios paginados.
- Adicionando regras de fonte de dados para modelos semânticos e fluxos de dados em fontes de dados que são parametrizadas.