Trasformazione dei dati utilizzando l'attività di stored procedure SQL Server in Azure Data Factory o Synapse Analytics

APPLICABILE A: Azure Data Factory Azure Synapse Analytics

Le attività di trasformazione dei dati in una pipeline di Data Factory o Synapse trasformano ed elaborano i dati grezzi in previsioni e approfondimenti. L'attività Stored Procedure è una delle attività di trasformazione supportate dalle pipeline. Questo articolo si basa sull'articolo relativo alla trasformazione dei dati, che offre una panoramica generale della trasformazione dei dati e delle attività di trasformazione supportate.

È possibile usare l'attività Stored Procedure per richiamare una stored procedure in uno dei seguenti archivi dati nella tua organizzazione o su una macchina virtuale Azure.

• database SQL di Azure
• Azure Synapse Analytics
• SQL Server Database. Se si usa SQL Server, installare il runtime di integrazione self-hosted nello stesso computer che ospita il database o in un computer separato che ha accesso al database. Il runtime di integrazione Self-Hosted è un componente che connette origini dati locali o su macchina virtuale Azure con servizi cloud in modo gestito e sicuro. Per i dettagli, vedere l'articolo Runtime di integrazione self-hosted.

Se la procedura memorizzata presenta parametri di output, invece di utilizzare l'attività di procedura memorizzata, utilizzare l'attività Ricerca e l'attività Script. L'attività Procedura memorizzata non supporta ancora la chiamata delle procedure memorizzate con parametri Output.

Se si chiama una procedura memorizzata con parametri di output utilizzando l'attività Procedura memorizzata, viene visualizzato il seguente errore.

Errore di esecuzione su sql server. Se è necessario ulteriore supporto, contattare SQL Server team. Numero errore SQL: 201. Messaggio di errore: la routine o la funzione 'sp_name' prevede il parametro '@output_param_name', che non è stato specificato.

Crea un'attività Procedura memorizzata tramite l'interfaccia utente

Per usare un'attività Stored Procedure in una pipeline, seguire le seguenti procedure:

1. Cercare Procedura memorizzata nel riquadro Attività della pipeline, quindi trascinare un'attività Procedura memorizzata nel canvas della pipeline.

2. Selezionare la nuova attività Stored procedure nell'area di disegno se non è già selezionata e la relativa scheda Impostazioni per modificarne i dettagli.

   

3. Selezionare un servizio collegato esistente o crearne uno nuovo in un database SQL di Azure, Azure Synapse Analytics o SQL Server.

4. Scegliere una procedura memorizzata e specificare i parametri per la sua esecuzione.

Dettagli sintassi

Di seguito è riportato il formato JSON per la definizione di un'attività di Stored Procedure:

{
    "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" }

        }
    }
}

La tabella seguente illustra queste proprietà JSON:

Mapping dei tipi di dati dei parametri

Il tipo di dati specificato per il parametro corrisponde al tipo di servizio interno associato al tipo di dati presente nell'origine dati in uso. È possibile trovare i mapping dei tipi di dati per l'origine dati descritta nella documentazione dei connettori. Ad esempio:

• Azure Synapse Analytics
• mapping dei tipi di dati database SQL di Azure
• Mapping dei tipi di dati Oracle
• mappatura dei tipi di dati di SQL Server

Contenuto correlato

Vedere gli articoli seguenti, che illustrano altre modalità di trasformazione dei dati:

• Attività U-SQL
• Attività Hive
• Attività di Pig
• Attività MapReduce
• Attività di Hadoop Streaming
• Attività Spark
• Attività personalizzata .NET
• Attività stored procedure