Executar uma atividade de Falha no Azure Data Factory e no Synapse Analytics
Ocasionalmente, você pode querer lançar um erro em um pipeline intencionalmente. Uma atividade de Pesquisa pode não retornar dados correspondentes ou uma atividade Personalizada pode terminar com um erro interno. Seja qual for o motivo, agora você pode usar uma atividade Fail em um pipeline e personalizar sua mensagem de erro e código de erro.
APLICA-SE A: 
Azure Data Factory Azure Synapse Analytics
Gorjeta
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!
Criar uma atividade de falha com a interface do usuário
Para usar uma atividade Fail em um pipeline, conclua as seguintes etapas:
Procure por Falha no painel Atividades do pipeline e arraste uma atividade Falha para a tela do pipeline.
Selecione a nova atividade Reprovado na tela, se ainda não estiver selecionada, e a guia Configurações para editar seus detalhes.
Insira uma mensagem de falha e um código de erro. Esses valores podem ser expressões de cadeia de caracteres literais ou qualquer combinação de expressões dinâmicas , funções, variáveis de sistema ou saídas de outras atividades.
Sintaxe
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Propriedades do tipo
| Property | Description | Valores permitidos | Necessário |
|---|---|---|---|
| nome | O nome da atividade Fail. | Cadeia (de carateres) | Sim |
| tipo | Deve ser definido como Fail. | Cadeia (de carateres) | Sim |
| mensagem | A mensagem de erro que apareceu na atividade Fail. Pode ser um conteúdo dinâmico a ser avaliado em tempo de execução. | Cadeia (de carateres) | Sim |
| errorCode | O código de erro que categoriza o tipo de erro da atividade Fail. Pode ser um conteúdo dinâmico a ser avaliado em tempo de execução. | Cadeia (de carateres) | Sim |
Compreender o código de erro Atividade de falha
Os autores do pipeline normalmente definem a mensagem de erro e o código de erro da atividade Fail. Para entender os significados específicos dos códigos de erro, entre em contato com o desenvolvedor do pipeline. No entanto, nos seguintes casos de borda, o Azure Data Factory define a mensagem de erro e/ou o código de erro.
| Descrição da situação | Mensagem de Erro | Código de erro |
|---|---|---|
O conteúdo (dinâmico) em message e errorCode é interpretado corretamente. |
A mensagem de erro definida pelo usuário | O código de erro definido pelo usuário |
O conteúdo dinâmico em ambos message e errorCode não pode ser interpretado. |
"Falha ao interpretar <activity_name> mensagem de falha ou código de erro" | ErrorCodeNotString |
O conteúdo dinâmico em message não pode ser interpretado como uma cadeia de caracteres. |
"<activity_name> parâmetro de mensagem de falha não pôde ser interpretado como uma cadeia de caracteres" | O código de erro definido pelo usuário |
O conteúdo dinâmico em resolve para null, uma cadeia de caracteres vazia ou espaços em message branco. |
"Falha ao interpretar <activity_name> mensagem de falha ou código de erro" | O código de erro definido pelo usuário |
O conteúdo dinâmico em errorCode não pode ser interpretado como uma cadeia de caracteres. |
A mensagem de erro definida pelo usuário | ErrorCodeNotString |
O conteúdo dinâmico em resolve para null, uma cadeia de caracteres vazia ou espaços em errorCode branco. |
A mensagem de erro definida pelo usuário | ErrorCodeNotString |
O valor para message ou errorCode que é fornecido pelo usuário não é string-able.* |
O pipeline falha com: "Valor inválido para a propriedade/<>errorCodemessage" |
|
O message campo está em falta.* |
"A mensagem de falha não foi fornecida" | O código de erro definido pelo usuário |
O errorCode campo está em falta.* |
A mensagem de erro definida pelo usuário | ErrorCodeNotString |
* Esta situação não deve ocorrer se o pipeline for desenvolvido com a interface de usuário da Web (UI) do Data Factory.
Conteúdos relacionados
Veja outras atividades de fluxo de controle suportadas, incluindo: