Odczytywanie danych przy użyciu powiązań wejściowych
Aby nawiązać połączenie ze źródłem danych, należy skonfigurować powiązanie wejściowe. Powiązanie wejściowe umożliwia napisanie minimalnego kodu w celu utworzenia komunikatu. Nie musisz pisać kodu dla zadań, takich jak otwieranie połączenia magazynu; środowisko uruchomieniowe usługi Azure Functions i powiązanie zajmują się tymi zadaniami.
Typy powiązań danych wejściowych
Funkcje łańcucha platformy Azure mogą mieć wiele typów danych wejściowych. Jednak nie wszystkie typy obsługują zarówno dane wejściowe, jak i wyjściowe. Użyj funkcji wejściowej za każdym razem, gdy chcesz pozyskać dane tego typu. W tym miejscu przyjrzymy się typom funkcji wejściowych, które obsługują powiązania wejściowe i kiedy ich używać.
Azure Blob Storage — powiązania usługi Blob Storage umożliwiają odczyt z obiektu blob.
Azure Cosmos DB — powiązania wejściowe usługi Azure Cosmos DB używają interfejsu API SQL do pobierania co najmniej jednego dokumentu usługi Azure Cosmos DB i przekazywania ich do parametru wejściowego funkcji. Identyfikator dokumentu lub parametry zapytania można określić na podstawie wyzwalacza, który wywołuje funkcję.
Mobile Apps — powiązanie wejściowe usługi Mobile Apps ładuje rekord z punktu końcowego tabeli mobilnej i przekazuje go do funkcji.
Azure Table Storage — możesz odczytywać dane i pracować z usługą Azure Table Storage.
Pełna lista obsługiwanych powiązań jest dostępna tutaj
Aby utworzyć powiązanie jako dane wejściowe, należy zdefiniować direction jako in. Parametry dla każdego typu powiązania mogą się różnić.
Co to jest wyrażenie powiązania?
Wyrażenie powiązania to wyspecjalizowany tekst w function.json, parametrach funkcji lub kodzie, który jest obliczany po wywołaniu funkcji w celu uzyskania wartości. Jeśli na przykład masz powiązanie kolejki usługi Service Bus, możesz użyć wyrażenia powiązania, aby uzyskać nazwę kolejki z obszaru Ustawienia aplikacji.
Typy wyrażeń powiązania
Istnieje kilka typów wyrażeń powiązań, w tym:
- Ustawienia aplikacji
- Nazwa pliku wyzwalacza
- Metadane wyzwalacza
- Ładunki JSON
- Nowy identyfikator GUID
- Bieżąca data i godzina
Większość wyrażeń powiązań jest identyfikowana przez zawinięcie nawiasów klamrowych. Jednak wyrażenia powiązań ustawień aplikacji są opakowane w znaki procentowe, a nie nawiasy klamrowe. Jeśli na przykład ścieżka powiązania wyjściowego obiektu blob to %Environment%/newblob.txt, a wartość ustawienia aplikacji środowiska to Programowanie, w kontenerze programistycznym zostanie utworzony obiekt blob.
Podsumowanie
Powiązania danych wejściowych umożliwiają połączenie funkcji ze źródłem danych. Istnieje kilka typów źródeł danych, z którymi można się łączyć, a ich parametry są różne. Aby rozpoznać wartości ze źródeł wejściowych, użyj wyrażeń powiązań w pliku function.json , w parametrach funkcji lub w kodzie.