Lernprogramm: Python-Funktion mit Azure Queue Storage als Trigger

In diesem Tutorial erfahren Sie, wie Sie eine Python-Funktion mit einer Speicherwarteschlange als Trigger konfigurieren, indem Sie die folgenden Aufgaben ausführen.

Hier eine Übersicht über die Komponenten des Funktionsprojekts dieses Tutorials:

Voraussetzungen

• Installieren Sie Visual Studio Code auf einer der unterstützten Plattformen.
• Die Azure-Befehlszeilenschnittstelle Sie können sie in Azure Cloud Shell verwenden oder lokal installieren.
• Ein Azure Storage-Konto und eine Speicherwarteschlange. Wenn Sie über keine Azure Storage verfügen, müssen Sie eine erstellen.
• In diesem Leitfaden wird davon ausgegangen, dass Sie die grundlegenden Konzepte kennen, die im Entwicklerhandbuch Azure Functions sowie im Artikel Herstellen einer Verbindung mit Diensten in Functions vorgestellt werden.

Erstellen eines Python-Funktionsprojekts

Folgen Sie dem Lernprogramm, um ein lokales Azure Functions-Projekt zu erstellen, und geben Sie die folgenden Informationen bei den Eingabeaufforderungen an:

Sie haben ein Python-Funktionsprojekt mit Azure Storage-Warteschlange als Trigger erstellt. Das lokale Projekt verbindet sich mit Azure Storage unter Verwendung der in der local.settings.json-Datei gespeicherten Verbindungszeichenfolge. Schließlich kann die main-Funktion in __init__.py-Datei der Funktion die Verbindungszeichenfolge mit Hilfe der in der function.json-Datei definierten Funktionsbindung nutzen.

Lokales Ausführen der Funktion

Folgen Sie dem Tutorial, um die Funktion lokal auszuführen und den Trigger zu überprüfen.

1. Wählen Sie das Speicherkonto aus, das Sie beim Erstellen der Azure-Funktionsressource verwendet haben, wenn Sie aufgefordert werden, eine Verbindung mit einem Storage herzustellen. Dieser Wert wird für die Laufzeit der Azure-Funktion verwendet und ist nicht unbedingt mit dem Speicherkonto identisch, das Sie für den Trigger verwenden.
2. Um die Funktion lokal zu starten, drücken Sie <kbd>F5</kbd>, oder wählen Sie auf der Aktivitätsleiste auf der linken Seite das Symbol Ausführen und debuggen aus.
3. Um zu überprüfen, ob der Trigger ordnungsgemäß funktioniert, führen Sie die Funktion lokal aus und öffnen den Bereich „Speicherwarteschlange“ im Azure-Portal. Wählen Sie anschließend Nachricht hinzufügen aus, und geben Sie eine Testnachricht ein. Sie sollten sehen, dass die Funktion getriggert und als Warteschlangenelement in Ihrem Visual Studio Code Terminal verarbeitet wird.

Herstellen einer Verbindung mithilfe des Dienstconnectors

Im vorherigen Schritt haben Sie das Funktionsprojekt lokal überprüft. Jetzt erfahren Sie, wie Sie die Verbindung zwischen der Azure-Funktion und der Azure Storage-Warteschlange in der Cloud konfigurieren, damit Ihre Funktion nach der Bereitstellung in der Cloud von der Speicherwarteschlange getriggert werden kann.

1. Öffnen Sie die Datei function.json in Ihrem lokalen Projekt, und ändern Sie den Wert der connection-Eigenschaft von bindings zu AZURE_STORAGEQUEUE_CONNECTIONSTRING.
2. Führen Sie den folgenden Azure CLI-Befehl aus, um eine Verbindung zwischen Ihrer Azure-Funktion und Ihrem Azure Storage-Konto zu erstellen.

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

• --source-id-Format: /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
• --target-id-Format: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/queueServices/default

Dieser Schritt hat eine Dienstconnectorressource erstellt, die eine AZURE_STORAGEQUEUE_CONNECTIONSTRING-Variable in den App-Einstellungen der Funktion konfiguriert. Die Funktionsbindungslaufzeit verwendet sie zum Herstellen einer Verbindung mit dem Speicher, sodass die Funktion Trigger aus der Speicherwarteschlange akzeptieren kann. Weiter Informationen finden Sie unter wie der Dienstconnector Azure Functions bei der Verbindung mit Diensten unterstützt.

Bereitstellen Ihrer Funktion in Azure

Sie können jetzt Ihre Funktion in Azure bereitstellen und überprüfen, ob der Warteschlangentrigger funktioniert.

1. Dieses Azure Functions-Tutorial unterstützt Sie dabei, Ihre Funktion in Azure bereitzustellen.
2. Öffnen Sie den Bereich „Speicherwarteschlange“ im Azure-Portal, wählen Sie Nachricht hinzufügen aus, und geben Sie eine Testnachricht an. Sie sollten sehen, dass die Funktion getriggert und als Warteschlangenelement in Ihren Funktionsprotokollen verarbeitet wird.

Problembehandlung

Wenn irgendwelche Fehler wie No such host is known (<account-name>.queue.core.windows.net:443) im Zusammenhang mit dem Speicherhost auftreten, prüfen Sie, ob die Verbindungszeichenfolge, die Sie für die Verbindung mit Azure Storage verwenden, den Warteschlangenendpunkt enthält. Andernfalls wechseln Sie im Azure-Portal zu Azure Storage, kopieren die Verbindungszeichenfolge im Bereich Access keys und ersetzen die Werte.

Wenn dieser Fehler beim lokalen Starten des Projekts auftritt, überprüfen Sie die Datei local.settings.json.

Wenn dieser Fehler beim Bereitstellen Ihrer Funktion in der Cloud auftritt (in diesem Fall schlägt die Funktionsbereitstellung in der Regel bei Syncing triggers fehl), überprüfen Sie die App-Einstellungen Ihrer Funktion.

Bereinigen von Ressourcen

Wenn Sie dieses Projekt nicht weiterverwenden möchten, löschen Sie die zuvor erstellte Funktions-App-Ressource.

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

Nächste Schritte

Lesen Sie die folgenden Artikel, um mehr über Dienstconnectorkonzepte und wie Azure Functions Sie bei der Verbindung mit Diensten unterstützt zu erfahren.