Criar uma dependência de gatilho de janela em cascata
APLICA-SE A: Azure Data Factory Azure Synapse Analytics
Dica
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!
Este artigo fornece etapas para criar uma dependência em um gatilho de janela em cascata. Para obter informações gerais sobre gatilhos de Janela em Cascata, consulte Como criar um gatilho de janela em cascata.
Para criar uma cadeia de dependência e certificar-se de que um gatilho executará somente após a execução com êxito de outro gatilho no serviço, use esse recurso avançado para criar uma dependência de janela em cascata.
Para obter uma demonstração sobre como criar pipelines dependentes usando o gatilho periódico, assista ao seguinte vídeo:
Criar uma dependência na interface do usuário
Para criar dependência em um gatilho, selecione Gatilho > Avançado > Novo e escolha o gatilho para depender do deslocamento e tamanho apropriados. Selecione Concluir e publique as alterações para que as dependências entrem em vigor.
Propriedades de dependência de janela em cascata
Um gatilho periódico com uma dependência tem as seguintes propriedades:
{
"name": "MyTriggerName",
"properties": {
"type": "TumblingWindowTrigger",
"runtimeState": <<Started/Stopped/Disabled - readonly>>,
"typeProperties": {
"frequency": <<Minute/Hour>>,
"interval": <<int>>,
"startTime": <<datetime>>,
"endTime": <<datetime - optional>>,
"delay": <<timespan - optional>>,
"maxConcurrency": <<int>> (required, max allowed: 50),
"retryPolicy": {
"count": <<int - optional, default: 0>>,
"intervalInSeconds": <<int>>,
},
"dependsOn": [
{
"type": "TumblingWindowTriggerDependencyReference",
"size": <<timespan - optional>>,
"offset": <<timespan - optional>>,
"referenceTrigger": {
"referenceName": "MyTumblingWindowDependency1",
"type": "TriggerReference"
}
},
{
"type": "SelfDependencyTumblingWindowTriggerReference",
"size": <<timespan - optional>>,
"offset": <<timespan>>
}
]
}
}
}
A tabela a seguir fornece a lista de atributos necessários para definir uma dependência de Janela em Cascata.
Nome da Propriedade | Descrição | Tipo | Necessário |
---|---|---|---|
type | Todos os gatilhos da janela em cascata existentes são exibidos neste menu suspenso. Escolha o gatilho para assumir a dependência. | TumblingWindowTriggerDependencyReference ou SelfDependencyTumblingWindowTriggerReference | Sim |
deslocamento | Deslocamento do gatilho de dependência. Forneça um valor no formato de período, bem como deslocamentos negativos e positivos são permitidos. Essa propriedade será obrigatória se o gatilho estiver dependendo de si mesmo e em todos os outros casos for opcional. A autodependência deverá sempre ser um deslocamento negativo. Se nenhum valor for especificado, a janela será igual ao próprio gatilho. | Timespan (hh:mm:ss) |
Autodependência: Sim Outros: Não |
tamanho | Tamanho da janela em cascata de dependência. Forneça um valor de período positivo. Essa propriedade é opcional. | Timespan (hh:mm:ss) |
Não |
Observação
Um gatilho periódico pode depender de, no máximo, cinco outros gatilhos.
Propriedades de autodependência de janela em cascata
Nos cenários em que o gatilho não deverá prosseguir para a próxima janela até que a janela anterior seja concluída com êxito, crie uma autodependência. Um gatilho de autodependência que seja dependente do sucesso das execuções anteriores de si mesmo no período que abrange a hora anterior terá as propriedades indicadas no código a seguir.
Observação
Se o pipeline disparado depende da saída de pipelines em janelas disparadas anteriormente, recomendamos usar apenas a autodependência do gatilho periódico. Para limitar as execuções de gatilho paralelas, defina a simultaneidade máxima do gatilho.
{
"name": "DemoSelfDependency",
"properties": {
"runtimeState": "Started",
"pipeline": {
"pipelineReference": {
"referenceName": "Demo",
"type": "PipelineReference"
}
},
"type": "TumblingWindowTrigger",
"typeProperties": {
"frequency": "Hour",
"interval": 1,
"startTime": "2018-10-04T00:00:00Z",
"delay": "00:01:00",
"maxConcurrency": 50,
"retryPolicy": {
"intervalInSeconds": 30
},
"dependsOn": [
{
"type": "SelfDependencyTumblingWindowTriggerReference",
"size": "01:00:00",
"offset": "-01:00:00"
}
]
}
}
}
Cenários e exemplos de uso
Veja abaixo as ilustrações dos cenários e do uso de propriedades de dependência da janela em cascata.
Deslocamento de dependência
Tamanho da dependência
Autodependência
Dependência de outro gatilho de janela em cascata
Um trabalho de processamento diário de telemetria que depende de outro trabalho diário agregando a saída dos últimos sete dias e que gera fluxos de janela sem interrupção de sete dias:
Dependência de si próprio
Um trabalho diário sem lacunas nos fluxos de saída do trabalho:
Monitorar dependências
É possível monitorar a cadeia de dependência e as janelas correspondentes na página de monitoramento da execução de gatilho. Navegue até Monitoramento > Execuções de Gatilho. Se um gatilho periódico tiver dependências, o nome do gatilho terá um hiperlink para a exibição de monitoramento de dependência.
Clique no nome do gatilho para ver as dependências dele. O painel à direita mostra informações detalhadas da execução de gatilho, como RunID, horário da janela, status etc.
Você pode ver o status das dependências e as janelas de cada gatilho dependente. Se um dos gatilhos de dependências falhar, você precisará executá-lo com êxito novamente para que o gatilho dependente seja executado.
Um gatilho periódico aguardará as dependências por sete dias antes de atingir o tempo limite. Após sete dias, a execução de gatilho falhará.
Observação
Um gatilho periódico não pode ser cancelado, enquanto estiver no estado Aguardando a dependência. A atividade dependente deve ser concluída antes que o gatilho periódico seja cancelado. Isso ocorre de propósito para garantir que as atividades dependentes possam ser concluídas uma vez iniciadas e ajuda a reduzir a probabilidade de resultados inesperados.
Para obter uma forma mais visual para ver a agenda de dependência do gatilho, selecione a exibição de Gantt.
As caixas transparentes mostram as janelas de dependências para cada gatilho dependente downstream, enquanto as caixas de cores sólidas acima mostram as execuções de janela individuais. Estas são algumas dicas para interpretar a exibição do gráfico de Gantt:
- A caixa transparente é renderizada em azul quando as janelas dependentes estão no estado pendente ou de execução
- Depois que todas as janelas forem executadas com sucesso para um gatilho dependente, a caixa transparente ficará verde
- A caixa transparente é renderizada em vermelho quando uma janela dependente falha. Procure uma caixa vermelha sólida para identificar a execução da janela com falha
Para executar novamente uma janela na exibição de gráfico de Gantt, selecione a caixa de cor sólida da janela e um painel de ação será exibido com detalhes e opções de nova execução
Conteúdo relacionado
- Examine Como criar um gatilho periódico
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de