Dodawanie komunikatów do kolejki usługi Azure Storage przy użyciu funkcji

  • Artykuł

W usłudze Azure Functions powiązania danych wejściowych i wyjściowych zapewniają deklaratywną metodę udostępniania danych z usług zewnętrznych na potrzeby kodu. W tym przewodniku Szybki start użyjesz powiązania danych wyjściowych do utworzenia komunikatów w kolejce w momencie wyzwolenia funkcji przez żądanie HTTP. Kontener usługi Azure Storage służy do wyświetlania komunikatów kolejki tworzonych przez funkcję.

Wymagania wstępne

Aby ukończyć ten przewodnik Szybki start:

  • Subskrypcja platformy Azure. Jeśli go nie masz, przed rozpoczęciem utwórz bezpłatne konto .

  • Postępuj zgodnie z instrukcjami znajdującymi się w kroku Tworzenie pierwszej funkcji w witrynie Azure Portal i nie wykonuj kroku Oczyszczanie zasobów. W tym przewodniku Szybki start tworzona jest aplikacja funkcji i funkcja używana w tym miejscu.

Dodawanie powiązania danych wyjściowych

W tej sekcji użyjesz interfejsu użytkownika portalu w celu dodania powiązania danych wyjściowych usługi Queue Storage do wcześniej utworzonej funkcji. To powiązanie umożliwia napisanie minimalnego kodu w celu utworzenia komunikatu w kolejce. Nie będzie konieczne pisanie kodu na potrzeby zadań, takich jak otwieranie połączenia z magazynem, tworzenie kolejki lub pobieranie odwołania do kolejki. Te zadania zostaną wykonane za pomocą środowiska uruchomieniowego usługi Azure Functions i powiązania danych wyjściowych kolejki.

  1. W witrynie Azure Portal otwórz stronę aplikacji funkcji na potrzeby aplikacji funkcji utworzonej w kroku Tworzenie pierwszej funkcji w witrynie Azure Portal. Aby otworzyć stronę, wyszukaj i wybierz pozycję Aplikacja funkcji. Następnie wybierz aplikację funkcji.

  2. Wybierz aplikację funkcji, a następnie wybierz funkcję utworzoną we wcześniejszym przewodniku Szybki start.

  3. Wybierz pozycję Integracja, a następnie wybierz pozycję + Dodaj dane wyjściowe.

    Utwórz powiązanie wyjściowe dla funkcji.

  4. Wybierz typ powiązania usługi Azure Queue Storage i dodaj ustawienia określone w tabeli, która następuje na poniższym zrzucie ekranu:

    Dodaj powiązanie danych wyjściowych kolejki magazynu do funkcji w witrynie Azure Portal.

    Ustawienie Sugerowana wartość Opis
    Nazwa parametru komunikatu outputQueueItem Nazwa parametru powiązania danych wyjściowych.
    Nazwa kolejki outqueue Nazwa kolejki, z którą zostanie nawiązane połączenie na koncie magazynu.
    Połączenie konta magazynu AzureWebJobsStorage Możesz skorzystać z połączenia konta magazynu już używanego przez aplikację funkcji lub utworzyć nowe.

  5. Wybierz przycisk OK , aby dodać powiązanie.

Po zdefiniowaniu powiązania danych wyjściowych musisz zaktualizować kod, tak aby stosować powiązanie do dodawania komunikatów do kolejki.

Dodawanie kodu korzystającego z powiązania danych wyjściowych

W tej sekcji dodasz kod służący do zapisywania komunikatu do kolejki wyjściowej. Komunikat zawiera wartość przekazywaną do wyzwalacza HTTP w ciągu zapytania. Jeśli na przykład ciąg zapytania zawiera wartość name=Azure, komunikat w kolejce będzie następujący: Nazwa przekazana do funkcji: Azure.

  1. W funkcji wybierz pozycję Kod i test , aby wyświetlić kod funkcji w edytorze.

  2. Zaktualizuj kod funkcji w zależności od języka funkcji:

    Dodaj parametr outputQueueItem do sygnatury metody, jak pokazano w poniższym przykładzie.

    public static async Task<IActionResult> Run(HttpRequest req,
    ICollector<string> outputQueueItem, ILogger log)
{
    ...
}

    W treści funkcji tuż przed instrukcją return dodaj kod używający parametru w celu utworzenia komunikatu w kolejce.

    outputQueueItem.Add("Name passed to the function: " + name);

  3. Wybierz przycisk Zapisz, aby zapisać zmiany.

Testowanie funkcji

  1. Po zapisaniu zmian kodu wybierz pozycję Testuj.

  2. Upewnij się, że test pasuje do poniższego obrazu i wybierz pozycję Uruchom.

    Przetestuj powiązanie magazynu kolejek w Azure Portal.

    Zwróć uwagę na to, że treść żądania zawiera name wartość Azure. Ta wartość jest wyświetlana w komunikacie w kolejce tworzonym po wywołaniu funkcji.

    Alternatywą do wyboru w tym miejscu polecenia Uruchom może być wywołanie funkcji, wprowadzając adres URL w przeglądarce i określając wartość name w ciągu zapytania. Metoda zakładająca użycie przeglądarki jest przedstawiona w poprzednim przewodniku Szybkie start.

  3. Sprawdź dzienniki, aby upewnić się, że funkcja zakończyła się pomyślnie.

Środowisko uruchomieniowe funkcji utworzy nową kolejkę o nazwie outqueue w koncie magazynu przy pierwszym użyciu powiązania danych wyjściowych. Użyjesz konta magazynu, aby sprawdzić, czy kolejka i komunikat w nim zostały utworzone.

Znajdowanie konta magazynu połączonego z usługą AzureWebJobsStorage

  1. Przejdź do aplikacji funkcji i wybierz pozycję Konfiguracja.

  2. W obszarze Ustawienia aplikacji wybierz pozycję AzureWebJobsStorage.

    Zrzut ekranu przedstawia stronę Konfiguracja z wybraną usługą AzureWebJobsStorage.

  3. Znajdź i zanotuj nazwę konta.

    Znajdź konto magazynu połączone z usługą AzureWebJobsStorage.

Sprawdzanie kolejki wyjściowej

  1. W grupie zasobów aplikacji funkcji wybierz konto magazynu używane na potrzeby tego przewodnika Szybki start.

  2. W obszarze Usługa kolejki wybierz pozycję Kolejki i wybierz kolejkę o nazwie outqueue.

    Kolejka zawiera komunikat utworzony za pomocą powiązania danych wyjściowych kolejki po uruchomieniu funkcji wyzwalanej przez protokół HTTP. Jeśli funkcja została wywołana przy użyciu domyślnego elementu name o wartości Azure, komunikat w kolejce to Nazwa przekazana do funkcji: Azure.

  3. Ponownie uruchom funkcję. W kolejce pojawi się nowy komunikat.

Czyszczenie zasobów

Inne przewodniki Szybki start w tej kolekcji bazują na tym przewodniku. Jeśli planujesz pracę z kolejnymi przewodnikami Szybki start, samouczkami lub z dowolnymi usługami utworzonymi w tym przewodniku Szybki start, nie usuwaj zasobów.

Zasoby na platformie Azure dotyczą aplikacji funkcji, funkcji, kont magazynu i tak dalej. Są one pogrupowane w grupy zasobów i można usunąć wszystko w grupie, usuwając grupę.

Utworzono zasoby, aby ukończyć te przewodniki Szybki start. Opłaty za te zasoby mogą być naliczane w zależności od stanu konta i cen usług. Jeśli nie potrzebujesz już tych zasobów, oto jak możesz je usunąć:

  1. W witrynie Azure Portal przejdź do strony Grupa zasobów.

    Aby przejść do tej strony ze strony aplikacji funkcji, wybierz kartę Przegląd , a następnie wybierz link w obszarze Grupa zasobów.

    Zrzut ekranu przedstawiający wybieranie grupy zasobów do usunięcia ze strony aplikacji funkcji.

    Aby przejść do tej strony z pulpitu nawigacyjnego, wybierz pozycję Grupy zasobów, a następnie wybierz grupę zasobów użytą w tym artykule.

  2. Na stronie Grupa zasobów przejrzyj listę uwzględnionych zasobów i sprawdź, czy są to te, które chcesz usunąć.

  3. Wybierz pozycję Usuń grupę zasobów i postępuj zgodnie z instrukcjami.

    Usunięcie może potrwać kilka minut. Po jego zakończeniu przez kilka sekund będzie widoczne powiadomienie. Możesz również wybrać ikonę dzwonka w górnej części strony, aby wyświetlić powiadomienie.

Następne kroki

W tym przewodniku Szybki start dodano powiązanie danych wyjściowych do istniejącej funkcji. Aby uzyskać więcej informacji na temat tworzenia powiązań z kolejką magazynu, zobacz Powiązania kolejki magazynu w usłudze Azure Functions.