Compartilhar via


Como usar a atividade script

Neste artigo, você aprenderá a adicionar uma nova atividade de Script SQL e uma nova conexão, bem como configurar o conteúdo do script. A atividade de Script pode ser usada para executar scripts SQL de consulta e não consulta em uma instância SQL de back-end do SQL Azure ou local.

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 de script a um pipeline com interface do usuário

  1. Abra um pipeline de dados existente ou crie um pipeline de dados novo.

  2. Clique em adicionar uma atividade de pipeline e pesquise Script.

    Captura de tela mostrando onde selecionar a atividade de script na tela.

  3. Como alternativa, você pode pesquisar a atividade de script na faixa de atividades do pipeline na parte superior e selecionar para adicioná-lo à tela do pipeline.

    Captura de tela mostrando onde selecionar a atividade de script na faixa.

  4. Selecione a nova atividade de script na tela se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia Geral de uma atividade de script.

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Configurar a atividade de script

  1. Selecione a guia Configurações e escolha uma conexão existente na lista suspensa ou crie uma nova.

  2. Após selecionar sua conexão, você pode escolher Consulta para obter um resultado de dados, ou NonQuery para qualquer operação de catálogo.

    Captura de tela mostrando a guia de configurações de uma atividade de script.

  3. Em seguida, você pode inserir conteúdo na caixa de expressões de script. Temos várias maneiras de inserir conteúdo de script na caixa de expressões:

    1. Você pode adicionar conteúdo dinâmico clicando na caixa ou clicando no ícone de "conteúdo dinâmico" no lado direito. Um menu suspenso aparecerá, conforme visto na captura de tela abaixo, que mostra o conteúdo dinâmico e as funções que você pode usar facilmente para criar suas expressões. Se você está familiarizado com o Power Automate, a experiência é muito semelhante.

      Captura de tela mostrando o conteúdo do menu suspenso dinâmico na atividade de script.

    2. Você também pode editar diretamente seu código de script no editor de código clicando no ícone de lápis no lado direito, conforme visto na captura de tela abaixo. Depois de clicar nele, uma nova caixa de diálogo aparecerá para que você possa escrever e editar seu código facilmente.

      Captura de tela mostrando o código de edição na atividade de script.

    3. Você também pode usar o construtor de expressões que utiliza a conclusão do código IntelliSense para realce, verificação de sintaxe e preenchimento automático para criar expressões. Confira as diretrizes no documento Expression Language para usar o construtor de expressões.

Salvar e executar ou agendar o pipeline

Após configurar quaisquer outras atividades exigidas pelo pipeline, alterne para a guia Página Inicial na parte superior do editor do 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.

Captura de tela mostrando como salvar e executar o pipeline.

Como monitorar execuções de pipeline