Udostępnij za pośrednictwem

Przekształcanie danych przy użyciu działania Procedura składowana programu SQL Server w usłudze Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Wskazówka

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

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 usługi Azure Data Factory, zapoznaj się z artykułem Wprowadzenie do usługi Azure Data Factory i wykonaj samouczek: Samouczek: przekształcanie danych przed przeczytaniem tego artykułu. Aby dowiedzieć się więcej na temat usługi Synapse Analytics, przeczytaj co to jest usługa 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 platformy Azure:

  • Azure SQL Database
  • Azure Synapse Analytics
  • Baza danych programu SQL Server. Jeśli używasz programu 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 maszynie wirtualnej platformy Azure 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 usługi Azure SQL Database lub programu SQL Server można skonfigurować narzędzie 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 usługi 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 usłudze Azure Synapse Analytics.

Podczas kopiowania danych z usługi Azure SQL Database lub SQL Server lub Azure Synapse Analytics można skonfigurować usługę SqlSource w działaniu kopiowania, aby wywołać procedurę składowaną w celu odczytywania danych ze źródłowej bazy danych przy użyciu właściwości sqlReaderStoredProcedureName . Aby uzyskać więcej informacji, zobacz następujące artykuły dotyczące łączników: 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 programu 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 usługą 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 usługi Azure SQL Database lub Azure Synapse Analytics lub SQL Server zarejestrowanej jako usługa połączona 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:

Powiązana zawartość

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

  • Last updated on