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 String, Bool ou Array definida em um pipeline no Data Factory do Microsoft Fabric, ou use a atividade Definir Variável para definir um valor retornado do pipeline. Variáveis de pipeline podem ser usadas para acompanhar qualquer resultado ou dados que você encontrar e precisar usar novamente mais tarde durante a execução do pipeline ou retornar como resultado.
Os cenários de uso para a atividade Definir Variável podem variar muito, dependendo de suas necessidades. Por exemplo, talvez você queira seguir um caminho específico se o número de linhas ou o valor agregado de um campo em dados retornados anteriormente for maior ou menor do que um valor específico, mas talvez seja necessário escolher o caminho alternativo posteriormente em seu 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 retornado do 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 workspace é 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 um pipeline no seu workspace.
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 + suspenso na extremidade direita da barra de ferramentas se o tamanho da janela não for grande o suficiente para exibi-la diretamente.
Selecione a nova atividade no painel da tela se ela ainda não estiver selecionada.
Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.
Configurações de Definir 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 "Some value".
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, selecione a tela de fundo na tela do pipeline (para mostrar as páginas de propriedades do pipeline) e use a guia Variáveis nas configurações do pipeline para criá-las. Em seguida, você pode selecioná-las na lista suspensa em Configurações de Definir Variável ao escolher Variável de pipeline.
Salvar e executar ou agendar o pipeline
Embora Definir Variável seja normalmente usada em conjunto com outras atividades, ela pode ser executada diretamente como está. Para executar o pipeline aqui, alterne para a guia Página Inicial 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.
