Prozkoumání typů vstupních a výstupních vazeb

10 min

Použití a zpracovávání dat jsou klíčové úlohy v mnoha softwarových řešeních. Zvažte některé z těchto scénářů:

Byli jste požádáni, abyste implementovali způsob, jak přesunout příchozí data ze služby Azure Blob Storage do služby Azure Cosmos DB.
Chcete umístit příchozí zprávy do fronty pro zpracování jinou komponentou ve vašem podniku.
Vaše služba potřebuje získat hráčské výsledky z fronty a aktualizovat online žebříčky.

Všechny tyto příklady jsou o přesunu dat. Zdroj dat a cíle se mezi scénáři liší, ale vzor je podobný. Připojíte se ke zdroji dat a zapisujete a čtete data. Služba Azure Functions vám pomáhá integrovat data a služby s použitím vazeb.

Co je vazba?

Vazby v Azure Functions poskytují deklarativní způsob připojení k datům z vašeho kódu. Zjednodušují konzistentní integraci s datovými proudy ve funkci. Můžete mít více vazeb, které budou poskytovat přístup k různým datovým prvkům. Tato integrace je výkonná, protože se můžete připojit ke zdrojům dat, aniž byste museli kódovat konkrétní logiku připojení (například připojení k databázi nebo rozhraní webového rozhraní API).

Typy vazeb

Existují dva druhy vazeb, které můžete u funkcí použít:

Vstupní vazba – Připojení ke zdroji dat. Naše funkce může číst data z těchto vstupních zdrojů.
Výstupní vazba – Připojení k cíli dat. Naše funkce může zapisovat data do těchto výstupních cílů.

Existují také triggery, což jsou speciální typy vstupních vazeb, které způsobují spuštění funkce. Jako aktivační událost můžete například nakonfigurovat oznámení služby Azure Event Grid. Když dojde k události, funkce se spustí.

Typy podporovaných vazeb

Typ vazby definuje, kde čteme nebo odesíláme data. Existuje vazba pro reakci na webové požadavky a velký výběr vazeb pro přímou interakci s různými službami Azure a službami třetích stran.

Typ vazby lze použít jako vstup, výstup nebo obojí. Funkce může například zapisovat do výstupní vazby Blob Storage, ale aktualizace služby Blob Storage může aktivovat jinou funkci.

Mezi běžné typy vazeb patří:

Blob Storage
Fronty služby Azure Service Bus
Azure Cosmos DB
Azure Event Hubs
Externí soubory
Externí tabulky
Koncové body HTTP

Tyto typy uvádíme jen pro představu. Je jich více a kromě toho mají funkce model rozšiřitelnosti, který umožňuje přidat další vazby.

Vlastnosti vazeb

Ve všech vazbách se vyžadují tři vlastnosti, ale možná budete muset zadat více vlastností na základě typu vazby a úložiště, které používáte.

Název – definuje parametr funkce, jehož prostřednictvím přistupujete k datům. Například ve vstupní vazbě fronty je tato vlastnost název parametru funkce, který přijímá obsah zprávy fronty.
Typ – identifikuje typ vazby. Například typ dat nebo služby, se kterými chcete pracovat.
Směr – označuje směr toku dat. Jedná se například o vstupní nebo výstupní vazbu?

Kromě toho většina typů vazeb potřebuje i čtvrtou vlastnost:

Připojení – jde o název klíče nastavení aplikace, který obsahuje připojovací řetězec. Vazby používají připojovací řetězce, které jsou uložené v nastavení aplikace, aby se tajné kódy uchovávaly mimo kód funkce. Připojení ionové řetězce usnadňují konfiguraci a zabezpečení kódu.

Vytvoření vazby

Vazby jsou definované v souboru JSON. Vazba je konfigurovaná v konfiguračním souboru vaší funkce, který má název function.json a nachází se ve stejné složce jako kód funkce.

Pojďme prozkoumat příklad vstupní vazby:

    ...
    {
      "name": "headshotBlob",
      "type": "blob",
      "path": "thumbnail-images/{filename}",
      "connection": "HeadshotStorageConnection",
      "direction": "in"
    },
    ...

Vytvoření této vazby

Vytvořte vazbu v našem souboru function.json.
Zadejte hodnotu proměnné name. V tomto příkladu proměnná obsahuje data objektu blob.
Zadejte vlastnost type pro úložiště. V předchozím příkladu používáme službu Blob Storage.
Zadejte vlastnost path, která určuje kontejner a název položky, která do ní patří. Vlastnost path je vyžadována při použití triggeru objektu blob a měla by být k dispozici ve stylu, který je zde uvedený, s složenými složenými závorkami kolem části názvu souboru cesty. Tato syntaxe vytvoří vazbový výraz , který umožňuje odkazovat na název objektu blob v jiných vazbách a v kódu vaší funkce. V tomto příkladu by byl parametr funkce s názvem filename vyplněný názvem souboru objektu blob, který funkci aktivuje.
Zadejte název nastavení řetězce connection definovaný v souboru nastavení aplikace. Používá se jako klíč k vyhledání připojovacího řetězce pro připojení k vašemu účtu úložiště.
Definujte direction jako in. Čte data z objektu blob.

Vazby se ve funkci používají k připojení k datům. V tomto příkladu jsme použili vstupní vazbu pro připojení uživatelských obrázků ke zpracování naší funkcí jako miniatur.

Pokračovat