Transformieren Sie Daten mithilfe der SQL Server Stored Procedure Aktivität in Azure Data Factory oder Synapse Analytics

Gilt für: Azure Data Factory Azure Synapse Analytics

Sie verwenden Transformationsaktivitäten in einer Data Factory- oder Synapse-Pipeline, um Rohdaten in Vorhersagen und Erkenntnisse zu transformieren und zu verarbeiten. Die Stored Procedure-Aktivität ist eine der Transformationsaktivitäten, die Pipelines unterstützen. Dieser Artikel baut auf dem Artikel Transformieren von Daten auf, der eine allgemeine Übersicht über die Datentransformation und die unterstützten Transformationsaktivitäten bietet.

Sie können die Aktivität der gespeicherten Prozedur verwenden, um eine gespeicherte Prozedur in einem der folgenden Datenspeicher in Ihrem Unternehmen oder auf einem Azure virtuellen Computer (VM) aufzurufen:

• Azure SQL-Datenbank
• Azure Synapse Analytics
• SQL Server Datenbank. Wenn Sie SQL Server verwenden, installieren Sie die Selbst gehostete Integrationslaufzeit auf demselben Computer, auf dem die Datenbank gehostet wird, oder auf einem separaten Computer, der Zugriff auf die Datenbank hat. Die selbstgehostete Integration Runtime ist eine Komponente, die lokale Datenquellen bzw. Datenquellen auf virtuellen Azure Computern mit Clouddiensten auf sichere und verwaltete Weise verbindet. Im Artikel Selbstgehostete Integration Runtime finden Sie Details.

Wenn die gespeicherte Prozedur über Ausgabeparameter verfügt, anstatt gespeicherte Prozeduraktivitäten zu verwenden, verwenden Sie Lookupaktivitäten und Skriptaktivitäten. Die Aktivität der gespeicherten Prozedur unterstützt das Aufrufen von SPs mit Ausgabeparametern noch nicht.

Wenn Sie eine gespeicherte Prozedur mit Ausgabeparametern mithilfe der Aktivität der gespeicherten Prozedur aufrufen, tritt der folgende Fehler auf.

Ausführungsfehler gegen SQL Server. Wenden Sie sich an SQL Server Team, wenn Sie weitere Unterstützung benötigen. SQL-Fehlernummer: 201. Fehlermeldung: Die Prozedur oder Funktion „sp_name“ erwartet den Parameter „@output_param_name“, der nicht angegeben wurde.

Erstellen Sie eine Aktivität „Gespeicherte Prozedur“ mit der Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Aktivität „gespeicherte Prozedur“ in einer Pipeline zu verwenden:

1. Suchen Sie im Bereich mit den Pipelineaktivitäten nach Gespeicherte Prozedur, und ziehen Sie eine Gespeicherte Prozedur-Aktivität auf die Pipeline-Arbeitsfläche.

2. Wählen Sie auf der Zeichenfläche die neue Aktivität „Gespeicherte Prozedur“ aus (wenn sie noch nicht ausgewählt wurde) sowie die Registerkarte Einstellungen, um die Details zu bearbeiten.

   

3. Wählen Sie einen vorhandenen oder erstellen Sie einen neuen verknüpften Dienst mit einem Azure SQL-Datenbank, Azure Synapse Analytics oder SQL Server.

4. Wählen Sie eine gespeicherte Prozedur aus, und geben Sie alle Parameter für ihre Ausführung an.

Syntaxdetails

So sieht das JSON-Format zum Definieren der Aktivität „Gespeicherte Prozedur“ aus:

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

        }
    }
}

In der folgenden Tabelle werden diese JSON-Eigenschaften beschrieben:

Zuordnung von Parameterdatentypen

Der Datentyp, den Sie für den Parameter angeben, ist der interne Diensttyp, der dem Datentyp in der verwendeten Datenquelle zugeordnet ist. Sie finden die Datentypzuordnungen für Ihre Datenquelle in der Dokumentation zu Connectors. Zum Beispiel:

• Azure Synapse Analytics
• Azure SQL-Datenbank-Datentypzuordnung
• Oracle-Datentypzuordnung
• SQL Server-Datentypzuordnung

Zugehöriger Inhalt

In den folgenden Artikeln erfahren Sie, wie Daten auf andere Weisen transformiert werden:

• U-SQL-Aktivität
• Hive-Aktivität
• Pig-Aktivität
• MapReduce-Aktivität
• Hadoop-Streamingaktivität
• Spark-Aktivität
• .NET benutzerdefinierte Aktivität
• Aktivität „Gespeicherte Prozedur“