Transformar dados por meio da atividade Procedimento Armazenado do SQL Server no Azure Data Factory ou no 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 do 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 sobre dados de transformação, que apresenta uma visão geral da transformação de dados e das atividades de transformação com suporte.

Você pode usar a Atividade de Procedimento Armazenado para invocar um procedimento armazenado em um dos seguintes armazenamentos de dados em sua empresa ou em uma VM (máquina virtual) Azure):

• Banco de Dados SQL do Azure
• Azure Synapse Analytics
• banco de dados SQL Server. Se você estiver usando SQL Server, instale o runtime de integração auto-hospedada no mesmo computador que hospeda o banco de dados ou em um computador separado que tenha acesso ao banco de dados. O Integration Runtime (auto-hospedado) é um componente que conecta fontes de dados locais ou em uma VM do Azure aos serviços de nuvem de maneira segura e gerenciada. Consulte o artigo Self-hosted Integration Runtime (Integration Runtime auto-hospedado) para obter detalhes.

Quando a procedimento armazenado tiver parâmetros de saída, em vez de usar a atividade de procedimento armazenado, use a atividade de pesquisa e a atividade de script. A atividade de procedimento armazenado ainda não dá suporte à chamada de SPs com o parâmetro de saída.

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

Falha na execução contra o SQL Server. Entre em contato com SQL Server equipe se precisar de mais suporte. Número do erro SQL: 201. Mensagem de erro: Procedimento ou função 'sp_name' espera o parâmetro '@output_param_name', que não foi fornecido.

Criar uma atividade de Procedimento Armazenado com a interface do usuário

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

1. Pesquise Procedimento Armazenado no painel Atividades do pipeline e arraste uma atividade Procedimento Armazenado para a tela do pipeline.

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

   

3. Selecione um serviço vinculado existente ou crie um novo para um Banco de Dados SQL do Azure, Azure Synapse Analytics ou SQL Server.

4. Escolha um procedimento armazenado e forneça 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 seguinte tabela descreve essas propriedades JSON:

Mapeamento de tipo de dados de parâmetro

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

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

Conteúdo relacionado

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

• U-SQL Activity (Atividade do U-SQL)
• Atividade de Hive
• Atividade Pig
• Atividade MapReduce
• Atividade de Transmissão do Hadoop
• Atividade do Spark
• .NET atividade personalizada
• Stored procedure activity (Atividade de procedimento armazenado)