Kurz: Funkce Pythonu se službou Azure Table Storage jako výstupem

V tomto kurzu se dozvíte, jak nakonfigurovat funkci Pythonu s tabulkou služby Storage jako výstup provedením následujících úloh.

Přehled součástí projektu funkcí v tomto kurzu:

Požadavky

• Nainstalujte Visual Studio Code na jedné z podporovaných platforem.
• Rozhraní příkazového řádku Azure. Můžete ho použít v Azure Cloud Shellu nebo ho nainstalovat místně.
• Účet služby Azure Storage a tabulka úložiště. Pokud účet úložiště nemáte, vytvořte si ho.
• Průvodce předpokládá, že znáte koncepty uvedené v příručce pro vývojáře functions a jak se připojit ke službám ve službě Azure Functions.

Vytvoření projektu funkce Pythonu

Podle kurzu vytvořte místní projekt Azure Functions a na příkazovém řádku zadejte následující informace:

Vytvořili jste projekt funkce Pythonu s triggerem HTTP.

Přidání výstupní vazby tabulky úložiště

Atributy vazby jsou definovány v souboru function.json pro danou funkci. Pokud chcete vytvořit vazbu, klikněte pravým tlačítkem myši (Ctrl+klikněte na macOS) function.json soubor ve složce funkce a zvolte Přidat vazbu... . Podle pokynů definujte následující vlastnosti vazby pro novou vazbu:

Chcete-li zkontrolovat úspěšné přidání vazby:

1. TableStorageOutputFunc/function.json Otevřete soubor, zkontrolujte, zda byla do tohoto souboru přidána nová vazba type: table direction: out.
2. local.settings.json Otevřete soubor a zkontrolujte, jestli do tohoto souboru byla přidána nová dvojice <your-storage-account-name>_STORAGE: <your-storage-account-connection-string> klíč-hodnota, která obsahuje váš účet úložiště, připojovací řetězec.

Po přidání vazby aktualizujte kódy funkcí tak, aby tuto vazbu spotřebovávají nahrazením TableStorageOutputFunc/__init__.py souboru Pythonu.

import logging
import uuid
import json
import azure.functions as func

def main(req: func.HttpRequest, outMessage: func.Out[str]) -> func.HttpResponse:

    rowKey = str(uuid.uuid4())
    data = {
        "Name": "Output binding message",
        "PartitionKey": "message",
        "RowKey": rowKey
    }

    outMessage.set(json.dumps(data))
    return func.HttpResponse(f"Message created with the rowKey: {rowKey}")

Místní spuštění funkce

Podle kurzu spusťte funkci místně a ověřte výstup tabulky.

1. Vyberte účet úložiště, který jste zvolili při vytváření prostředku funkce Azure, pokud se zobrazí výzva k připojení k účtu úložiště. Tato hodnota se používá pro modul runtime funkce Azure Functions. Nemusí to být nutně stejný účet úložiště, který používáte pro výstup.
2. Pokud chcete funkci spustit místně, stiskněte klávesu <kbd>F5 </kbd> nebo vyberte ikonu Spustit a Ladit na panelu aktivit na levé straně.
3. Pokud chcete ověřit, že funkce může zapisovat do tabulky, klikněte pravým tlačítkem myši Execute Function Now... na funkci v zobrazení pracovního prostoru editoru Visual Studio Code a zkontrolujte odpověď funkce. Zpráva odpovědi by měla obsahovat rowKey zprávu, která byla zapsána do tabulky.

Vytvoření připojení pomocí konektoru Service Connector

V posledním kroku jste místně ověřili projekt funkce. Teď se dozvíte, jak nakonfigurovat připojení mezi funkcí Azure Functions a tabulkou Azure Storage v cloudu, aby vaše funkce po nasazení do cloudu mohl zapisovat do objektu blob úložiště.

1. function.json Otevřete soubor v místním projektu, změňte hodnotu connection vlastnosti bindings tak, aby byla AZURE_STORAGETABLE_CONNECTIONSTRING.
2. Spuštěním následujícího příkazu Azure CLI vytvořte připojení mezi vaší funkcí Azure a službou Azure Storage.

az functionapp connection create storage-table --source-id "<your-function-resource-id>" --target-id "<your-storage-table-resource-id>" --secret

• --source-id formát: /subscriptions/{subscription}/resourceG roups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
• --target-id formát: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/tableServices/default

Vytvořili jste prostředek konektoru služby, který konfiguruje proměnnou AZURE_STORAGETABLE_CONNECTIONSTRING v nastavení aplikace funkce. Toto nastavení aplikace pak bude využívat vazba funkce pro připojení k úložišti, aby funkce mohl zapisovat do tabulky úložiště. Další informace o tom, jak Service Connector pomáhá službě Azure Functions připojovat se ke službám.

Nasazení funkce do Azure

Teď můžete funkci nasadit do Azure a ověřit, že výstupní vazba tabulky úložiště funguje.

1. Postupujte podle tohoto kurzu azure Functions a nasaďte funkci do Azure.
2. Pokud chcete ověřit, že funkce může zapisovat do tabulky, klikněte pravým tlačítkem myši Execute Function Now... na funkci v zobrazení Visual Studio Code RESOURCES a zkontrolujte odpověď funkce. Zpráva odpovědi by měla obsahovat rowKey funkci, kterou jste právě napsali do tabulky.

Odstraňování potíží

Pokud dojde k nějakým chybám souvisejícím s hostitelem úložiště, například No such host is known (<acount-name>.table.core.windows.net:443)potřebujete zkontrolovat, jestli připojovací řetězec, které používáte pro připojení ke službě Azure Storage, obsahuje koncový bod tabulky, nebo ne. Pokud ne, přejděte na portál Azure Storage, zkopírujte připojovací řetězec z Access keys okna a nahraďte hodnoty.

Pokud k této chybě dojde při místním spuštění projektu, zkontrolujte local.settings.json soubor.

Pokud k tomu dojde, když funkci nasadíte do cloudu (v tomto případě se nasazení funkce obvykle nezdaří Syncing triggers ), zkontrolujte nastavení aplikace vaší funkce.

Vyčištění prostředků

Pokud tento projekt nebudete dál používat, odstraňte prostředek aplikace Funkcí, který jste vytvořili dříve.

az functionapp delete --name <function-name> --resource-group <resource-group>

Další kroky

Další informace o konceptech konektoru služeb a o tom, jak azure Functions pomáhá připojit se k dalším cloudovým službám, najdete v následujících článcích.