Transformer des données à l’aide de l’activité de procédure stockée SQL Server dans Azure Data Factory ou Synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Vous utilisez des activités de transformation dans un pipeline Data Factory ou Synapse pour transformer et traiter des données brutes en prévisions et en analyses. L’activité de procédure stockée est l’une des activités de transformation prises en charge par les pipelines. Cet article s’ajoute à l’article Transformer des données qui présente une vue d’ensemble de la transformation de données et des activités de transformation prises en charge.

Vous pouvez utiliser l’activité de procédure stockée pour appeler une procédure stockée dans l’une des banques de données suivantes dans votre entreprise ou sur une machine virtuelle Azure :

• Azure SQL Database
• Azure Synapse Analytics
• Base de données SQL Server Si vous utilisez SQL Server, installez le runtime d’intégration auto-hébergé sur l’ordinateur qui héberge la base de données ou sur un autre ordinateur ayant accès à la base de données. Le runtime d’intégration auto-hébergé est un composant qui connecte des sources de données locales ou se trouvant sur une machine virtuelle Azure à des services cloud de manière gérée et sécurisée. Pour plus d’informations, consultez l’article Runtime d’intégration auto-hébergé.

Lorsque la procédure stockée a des paramètres de sortie, au lieu d’utiliser l’activité de procédure stockée, utilisez l’activité de recherche et l’activité de script. L’activité de procédure stockée ne prend pas encore en charge l’appel de procédures stockées avec un paramètre de sortie.

Si vous appelez une procédure stockée avec des paramètres de sortie à l’aide d’une activité de procédure stockée, l’erreur suivante se produit.

Échec de l’exécution sur SQL Server. Contactez l’équipe SQL Server si vous avez besoin d’un support supplémentaire. Numéro d'erreur SQL : 201. Message d’erreur : La procédure ou la fonction « nom_procédure_stockée » attend le paramètre « @nom_paramètre_sortie », qui n’a pas été fourni.

Créer une activité de procédure stockée avec l’interface utilisateur

Pour utiliser une activité de procédure stockée dans un pipeline, effectuez les étapes suivantes :

1. Recherchez Procédure stockée dans le volet Activités du pipeline, puis faites glisser une activité de procédure stockée vers le canevas du pipeline.

2. Sélectionnez la nouvelle activité de procédure stockée pour le canevas si elle ne l’est pas déjà, et son onglet Paramètres pour en modifier les détails.

   

3. Sélectionnez un service lié existant ou créez un service lié à Azure SQL Database, Azure Synapse Analytics ou SQL Server.

4. Choisissez une procédure stockée et fournissez tous les paramètres pour son exécution.

Détails de la syntaxe

Voici le format JSON pour la définition d’une activité de procédure stockée :

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

        }
    }
}

Le tableau suivant décrit ces paramètres JSON :

Mappage du type de données du paramètre

Le type de données que vous spécifiez pour le paramètre est le type de service interne correspondant à celui de la source de données que vous utilisez. Vous trouverez les mappages de types de données pour votre source de données décrits dans la documentation relative aux connecteurs. Par exemple :

• Azure Synapse Analytics
• Mappage de types de données Azure SQL Database
• Mappage de types de données Oracle
• Mappages de types de données SQL Server

Contenu connexe

Consultez les articles suivants qui expliquent comment transformer des données par d’autres moyens :

• Activité U-SQL
• Activité Hive
• Activité pig
• Activité MapReduce
• Activité de diffusion en continu Hadoop
• Activité Spark
• Activité personnalisée .NET
• Activité de procédure stockée