Udostępnij za pośrednictwem


Przekształcanie danych za pomocą działania Procedury Składowanej SQL Servera w usłudze Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Wskazówka

Data Factory w usłudze Microsoft Fabric jest następną generacją Azure Data Factory z prostszą architekturą, wbudowaną sztuczną inteligencją i nowymi funkcjami. Jeśli dopiero zaczynasz integrować dane, zacznij od Fabric Data Factory. Istniejące obciążenia ADF można zaktualizować do Fabric, aby uzyskać dostęp do nowych możliwości w zakresie nauki o danych, analiz w czasie rzeczywistym oraz raportowania.

Działania przekształcania danych w potoku Data Factory lub Synapse są używane do przekształcania i przetwarzania nieprzetworzonych danych w przewidywania i wnioski. Działanie procedury składowanej jest jednym z działań przekształcania, które obsługują potoki. Ten artykuł opiera się na artykule dotyczącym przekształcania danych , który zawiera ogólne omówienie transformacji danych i obsługiwanych działań przekształcania.

Uwaga

Jeśli dopiero zaczynasz korzystać z Azure Data Factory, przeczytaj najpierw Wprowadzenie do Azure Data Factory i wykonaj samouczek: Samouczek: przekształcanie danych, zanim przeczytasz ten artykuł. Aby dowiedzieć się więcej o usłudze Synapse Analytics, przeczytaj Co to jest Azure Synapse Analytics.

Możesz użyć działania Procedury składowanej, aby wywołać procedurę składowaną w jednym z następujących magazynów danych w przedsiębiorstwie lub na maszynie wirtualnej Azure:

  • Azure SQL Database
  • Azure Synapse Analytics
  • SQL Server Database. Jeśli używasz SQL Server, zainstaluj własne środowisko Integration Runtime na tej samej maszynie, która hostuje bazę danych lub na oddzielnej maszynie, która ma dostęp do bazy danych. Self-Hosted Integration Runtime to składnik, który łączy źródła danych lokalnie/na Azure maszynie wirtualnej z usługami w chmurze w bezpieczny i zarządzany sposób. Aby uzyskać szczegółowe informacje, zobacz artykuł na temat samodzielnie hostowanego środowiska uruchomieniowego integracji.

Ważne

Podczas kopiowania danych do Azure SQL Database lub SQL Server można skonfigurować SqlSink w działaniu kopiowania w celu wywołania procedury składowanej przy użyciu właściwości sqlWriterStoredProcedureName. Aby uzyskać szczegółowe informacje na temat właściwości, zobacz następujące artykuły dotyczące łącznika: Azure SQL Database, SQL Server. Wywoływanie procedury składowanej podczas kopiowania danych do Azure Synapse Analytics przy użyciu działania kopiowania nie jest obsługiwane. Można jednak użyć działania procedury składowanej, aby wywołać procedurę składowaną w Azure Synapse Analytics.

Podczas kopiowania danych z Azure SQL Database lub SQL Server lub Azure Synapse Analytics można skonfigurować SqlSource w działaniu kopiowania w celu wywołania procedury składowanej odczytu danych ze źródłowej bazy danych przy użyciu właściwości sqlReaderStoredProcedureName>Azure SQL Database, SQL Server, Azure Synapse Analytics

Gdy procedura składowana ma parametry wyjściowe, zamiast używać działania procedury składowanej, użyj działania wyszukiwania i działania skryptu. Działanie procedury składowanej nie obsługuje na razie wywoływania procedur składowanych z parametrem wyjściowym.

Jeśli wywołasz procedurę składowaną z parametrami wyjściowymi przy użyciu działania procedury składowanej, wystąpi następujący błąd.

Wykonywanie kończy się niepowodzeniem względem programu SQL Server. Jeśli potrzebujesz dalszej pomocy technicznej, skontaktuj się z zespołem SQL Server. Numer błędu SQL: 201. Komunikat o błędzie: Procedura lub funkcja "sp_name" oczekuje parametru "@output_param_name", który nie został podany.

Tworzenie zadania procedury składowanej przy użyciu interfejsu użytkownika

Aby użyć zadania Procedury składowanej w kanale, wykonaj następujące kroki:

  1. Wyszukaj Procedurę składowaną w okienku działania potoku i przeciągnij działanie procedury składowanej do kanwy potoku.

  2. Wybierz nowe zadanie Procedura składowana na kanwie, jeśli nie jest jeszcze wybrane, a następnie kartę Ustawienia, aby edytować jego szczegóły.

    Przedstawia interfejs użytkownika działania Procedury składowanej.

  3. Wybierz istniejącą lub utwórz nową połączoną usługę z Azure SQL Database, Azure Synapse Analytics lub SQL Server.

  4. Wybierz procedurę składowaną i podaj wszystkie parametry dla jego wykonania.

Szczegóły składni

Oto format JSON definiujący działanie procedury składowanej:

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

        }
    }
}

W poniższej tabeli opisano następujące właściwości JSON:

Właściwości Opis Wymagane
nazwa Nazwa działania Tak
opis Tekst opisujący, do czego służy działanie Nie.
typ W przypadku działania procedury składowanej typ działania to SqlServerStoredProcedure Tak
linkedServiceName Odwołanie do Azure SQL Database, Azure Synapse Analytics lub SQL Server zarejestrowanych jako połączone usługi w usłudze Data Factory. Aby dowiedzieć się więcej o tej połączonej usłudze, zobacz artykuł Dotyczący połączonych usług obliczeniowych. Tak
storedProcedureName Określ nazwę procedury składowanej do wywołania. Tak
parametryProcedurySkładowanej Określ wartości parametrów procedury składowanej. Użyj "param1": { "value": "param1Value","type":"param1Type" } polecenia , aby przekazać wartości parametrów i ich typ obsługiwany przez źródło danych. Jeśli musisz przekazać wartość null dla parametru, użyj polecenia "param1": { "value": null } (wszystkie małe litery). Nie.

Mapowanie typu danych parametrów

Typ danych parametru to wewnętrzny typ usługi, który jest mapowany na typ danych w używanym źródle danych. Mapowania typów danych dla Twojego źródła danych można znaleźć w dokumentacji łączników. Na przykład:

Zapoznaj się z następującymi artykułami, które wyjaśniają sposób przekształcania danych na inne sposoby: