Execute uma atividade "Fail" no Azure Data Factory e Synapse Analytics

Ocasionalmente, poderá querer gerar um erro num 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

Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.

Criar uma atividade de falha com a interface do usuário

Para usar uma atividade Fail em um pipeline, conclua as seguintes etapas:

  1. Procure por Fail no painel Atividades do pipeline e arraste uma atividade Fail para a tela do pipeline.

  2. Selecione a nova atividade Falha no canvas, se ainda não estiver selecionada, e a aba Configurações para editar os seus detalhes.

    Mostra a interface de utilizador para uma atividade Fail.

  3. 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

Propriedade Descrição Valores permitidos Necessário
nome O nome da atividade "Fail". Cadeia de caracteres Sim
tipo Deve ser definido como Fail. Cadeia de caracteres 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 caracteres Sim
código de erro 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 caracteres Sim

Compreender o código de erro da 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 casos excepcionais seguintes, 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 message resolve para null, uma string vazia ou espaços em 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 errorCode resolve para null, uma string vazia ou espaços em 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 <errorCode/message>"
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:

  • Last updated on