Transforme dados utilizando a atividade SQL Server Stored Procedure no Azure Data Factory ou Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Você usa atividades de transformação de dados em um pipeline do Data Factory ou Synapse para transformar e processar dados brutos em previsões e insights. A Atividade de Procedimento Armazenado é uma das atividades de transformação suportadas pelos pipelines. Este artigo baseia-se no artigo de transformação de dados , que apresenta uma visão geral da transformação de dados e das atividades de transformação suportadas.

Pode usar a Atividade de Procedimento Armazenado para invocar um procedimento armazenado num dos seguintes armazenamentos de dados na sua empresa ou numa máquina virtual Azure (VM):

• Base de Dados SQL do Azure
• Azure Synapse Analytics
• Base de Dados SQL Server. Se estiver a usar SQL Server, instale o runtime de integração auto-hospedado na mesma máquina que hospeda a base de dados ou numa máquina separada que tenha acesso à base de dados. O runtime de integração Self-Hosted é um componente que liga fontes de dados no local/ou em VMs do Azure com serviços na nuvem de forma segura e gerida. Consulte o artigo sobre tempo de execução de integração auto-hospedada para obter detalhes.

Quando o procedimento armazenado tiver parâmetros de saída, utilize a atividade de consulta e a atividade de script em vez da atividade de procedimento armazenado. A atividade de procedimento armazenado ainda não suporta a chamada de SPs com o parâmetro Output.

Se você chamar um procedimento armazenado com parâmetros de saída usando a atividade de procedimento armazenado, ocorrerá o seguinte erro.

Falha de execução no sql server. Por favor, contacte a equipa do SQL Server se precisar de mais apoio. Número de erro SQL: 201. Mensagem de erro: Procedimento ou função 'sp_name' espera parâmetro '@output_param_name', que não foi fornecido.

Criar uma atividade de Stored Procedure com interface de utilizador

Para usar uma atividade de Procedimento Armazenado em um pipeline, conclua as seguintes etapas:

1. Procure Procedimento Armazenado no painel Atividades do pipeline e arraste uma atividade de Procedimento Armazenado para o quadro do pipeline.

2. Selecione a nova atividade Procedimento Armazenado na tela, caso ainda não esteja selecionada, e a guia Configurações para editar os seus detalhes.

   

3. Selecione um serviço existente ou crie um novo serviço ligado a uma Base de Dados SQL do Azure, Azure Synapse Analytics ou SQL Server.

4. Escolha um procedimento armazenado e forneça todos os parâmetros para sua execução.

Detalhes da sintaxe

Aqui está o formato JSON para definir uma atividade de procedimento armazenado:

{
    "name": "Stored Procedure Activity",
    "description":"Description",
    "type": "SqlServerStoredProcedure",
    "linkedServiceName": {
        "referenceName": "AzureSqlLinkedService",
        "type": "LinkedServiceReference"
    },
    "typeProperties": {
        "storedProcedureName": "usp_sample",
        "storedProcedureParameters": {
            "identifier": { "value": "1", "type": "Int" },
            "stringData": { "value": "str1" }

        }
    }
}

A tabela a seguir descreve essas propriedades JSON:

Mapeamento de tipo de dados de parâmetro

O tipo de dados especificado para o parâmetro é o tipo de serviço interno que mapeia para o tipo de dados na fonte de dados que você está usando. Você pode encontrar os mapeamentos de tipo de dados para sua fonte de dados descritos na documentação dos conectores. Por exemplo:

• Azure Synapse Analytics
• Base de Dados SQL do Azure mapeamento de tipos de dados
• Mapeamento de tipo de dados Oracle
• SQL Server mapeamento de tipos de dados

Conteúdos relacionados

Consulte os seguintes artigos que explicam como transformar dados de outras maneiras:

• Atividade U-SQL
• Atividade da colmeia
• Atividade de Porco
• Atividade MapReduce
• Atividade de streaming do Hadoop
• Atividade Spark
• .NET Custom Activity
• Atividade de procedimento armazenado