Usar a atividade da Web para chamar APIs REST em pipelines

A Web Activity pode ser utilizada para chamar um ponto final REST personalizado a partir de um pipeline do Azure Data Factory ou do Synapse. Pode passar conjuntos de dados e serviços ligados para serem consumidos e acedidos pela atividade.

Pré-requisitos

Para começar, você deve preencher 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 da Web a um pipeline através do UI

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

Criar a atividade

1. Crie um novo pipeline em seu espaço de trabalho.

2. Pesquise por Web no painel Atividades do pipeline e selecione-o para o adicionar ao ecrã do pipeline.

   

3. Selecione a nova atividade da Web na tela se ela ainda não estiver selecionada.

   

   Nota

   A atividade na Web pode simplesmente aparecer como um ícone na barra de ferramentas, como mostrado na imagem anterior, se a resolução da tela não permitir que seu nome seja totalmente escrito.

Consulte as orientações de configurações gerais para configurar a guia Configurações gerais.

Configurações de atividade da Web

1. Selecione a guia Configurações , selecione uma conexão existente na lista suspensa Conexão ou crie uma nova conexão e especifique seus detalhes de configuração.

   

2. Quando você escolhe + Novo para criar uma nova conexão, você vê a caixa de diálogo de criação de conexão onde você pode fornecer a URL base e as credenciais para se conectar.

   

   Nota

   O nome da conexão pode ter no máximo 80 caracteres.

Usando gateway de dados no local ou de rede virtual (VNET)

1. Ao criar sua conexão, agora você pode optar por usar um gateway de dados local (OPDG) ou um gateway de dados VNET. Para obter orientação sobre como criar e configurar seu OPDG, consulte como criar gateway de dados local

2. Se você quiser usar um gateway VNET, consulte como criar um gateway de dados VNET.

3. Depois de criar e configurar com êxito o seu gateway, deverá aparecer na lista suspensa de Gateway de Dados na caixa de diálogo de conexão.

   

4. Depois de escolher ou criar sua conexão e gateway de dados, preencha os campos obrigatórios restantes, adicione os cabeçalhos necessários ou defina as configurações avançadas. A atividade da Web suporta os métodos GET, POST, PUT, DELETE e PATCH.

5. Depois de escolher ou criar sua conexão, preencha os campos obrigatórios restantes, adicione os cabeçalhos necessários ou defina as configurações avançadas. A atividade da Web suporta os métodos GET, POST, PUT, DELETE e PATCH.

Salvar e depois executar ou agendar o pipeline

Normalmente, você usa a saída da atividade da Web com outras atividades, mas uma vez configurada, ela também pode ser executada diretamente sem outras atividades. Se você estiver executando-o para invocar uma API REST que execute alguma ação e não exija nenhuma saída da atividade, seu pipeline também poderá conter apenas a atividade da Web. Para executar a atividade, 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 visualizar o histórico de execução aqui ou definir outras configurações.

Conteúdos relacionados

• Como monitorizar execuções de pipeline