Usar a atividade Definir Variável no Fabric
Use a atividade Definir Variável para definir o valor de uma variável existente do tipo Cadeia de caracteres, Booliano ou Matriz definida em um pipeline no Data Factory do Microsoft Fabric, ou use a atividade Definir Variável para definir um valor retornado do pipeline. As variáveis de pipeline podem ser usadas para acompanhar qualquer resultado ou dado que você encontre e precise usar novamente mais tarde durante a execução do pipeline, ou para retornar como seu resultado.
Os cenários de uso para a atividade Definir Variável podem variar muito dependendo de seus requisitos. Por exemplo, talvez você queira tomar um caminho específico se o número de linhas ou valor agregado de um campo em dados retornados anteriormente for maior ou menor que uma quantidade específica, mas talvez seja necessário escolher o caminho alternativo posteriormente no pipeline depois que várias outras etapas que são sempre necessárias forem concluídas. Usando uma variável de pipeline, você pode armazenar o resultado em uma variável e usá-lo posteriormente para escolher o caminho alternativo, dependendo do valor da variável. Você também pode usar a atividade Definir Variável para definir um valor de retorno de pipeline que consiste em uma ou mais variáveis constituintes. Isso pode ser usado em pipelines subsequentes que usam a saída do seu pipeline.
Pré-requisitos
Para começar, você deve concluir os seguintes pré-requisitos:
- Uma conta de locatário com uma assinatura ativa. Crie uma conta gratuitamente.
- Um espaço de trabalho é criado.
Adicionar uma atividade Definir Variável a um pipeline com interface do usuário
Para usar uma atividade de Definição de Variável em um pipeline, conclua as seguintes etapas:
Criando a atividade
Crie uma nova pipeline em seu espaço de trabalho.
Procure por Definir Variável no painel Atividades do pipeline e selecione-a para adicioná-la à tela do pipeline. Talvez seja necessário expandir a lista de atividades disponíveis usando o botão + na extrema direita da barra de ferramentas se o tamanho da janela não for grande o suficiente para exibi-la diretamente.
Selecione a nova atividade na tela se ela ainda não estiver selecionada.
Confira as diretrizes de Configurações geraispara definir a guia de configurações Gerais.
Definir configurações de variável
Na guia Configurações, você pode escolher uma variável de pipeline ou especificar um valor retornado para o pipeline diretamente. Este exemplo mostra um único valor retornado chamado MyVariable, com um tipo de dados de cadeia de caracteres, e o valor "Algum valor".
Você pode adicionar vários valores para o Valor retornado do pipeline usando o botão + Novo (ou o botão Excluir para removê-los). Da mesma forma, ao definir uma Variável de pipeline, você pode escolher as variáveis definidas anteriormente na caixa suspensa Nome ou adicionar novas com o botão + Novo. Se você quiser criar variáveis de pipeline independentemente da atividade Definir Variável, clique no fundo da área de trabalho do pipeline (para mostrar as páginas de propriedades do pipeline) e use a guia Variáveis nas configurações do pipeline para criar as variáveis. Em seguida, você pode selecioná-las na lista suspensa em Configurações de Definir Variável ao escolher a Variável de pipeline.
Salvar e executar ou agendar o pipeline
Embora Set Variable normalmente seja usado com outras atividades, ela pode ser executada diretamente como está. Para executar o pipeline aqui, alterne para a guia Início na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode exibir o histórico de execuções aqui ou definir outras configurações.
