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

Napiwek

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 są używane w potoku usługi Data Factory lub Synapse w celu przekształcania i przetwarzania nieprzetworzonych danych w przewidywania i szczegółowych informacji. 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ł Dotyczący własnego środowiska Integration Runtime .

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 lookup acitivty i Script. Działanie procedury składowanej nie obsługuje jeszcze wywoływania adresów IP 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 działania Procedury składowanej za pomocą interfejsu użytkownika

Aby użyć działania Procedura składowana w potoku, wykonaj następujące kroki:

  1. Wyszukaj procedurę składowaną w okienku Działania potoku i przeciągnij działanie Procedura składowana do kanwy potoku.

  2. Wybierz nowe działanie Procedura składowana na kanwie, jeśli nie zostało jeszcze wybrane, a jego karta 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 Wymagania
name Nazwa działania Tak
opis Tekst opisujący, do czego służy działanie Nie.
type 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 połączona usługa 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
storedProcedureParameters 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 określony dla parametru to wewnętrzny typ usługi, który jest mapowane na typ danych w używanym źródle danych. Mapowania typów danych dla źródła danych opisane w dokumentacji łączników można znaleźć. Na przykład:

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