Lesen von Daten mit Eingabebindungen

  • 5 Minuten

Um eine Verbindung mit einer Datenquelle herzustellen, müssen Sie eine Eingabebindung konfigurieren. Ein Eingabebindung ermöglicht es, mit minimalem Programmieraufwand eine Nachricht zu erstellen. Sie müssen keinen Code für Aufgaben schreiben, z. B. das Öffnen einer Speicherverbindung. Die Azure Functions-Runtime und die Bindung übernehmen diese Aufgaben für Sie.

Eingabebindungstypen

Azure-Kettenfunktionen können über mehrere Eingabetypen verfügen. Allerdings unterstützen nicht alle Typen sowohl Ein- als auch Ausgaben. Verwenden Sie immer dann eine Eingabefunktion, wenn Sie Daten dieses Typs erfassen möchten. Hier untersuchen wir die Eingabefunktionstypen, die Eingabebindungen unterstützen, und klären die Frage, wann sie verwendet werden.

  • Azure Blob Storage: Blob Storage-Bindungen ermöglichen es Ihnen, aus einem Blob zu lesen.

  • Azure Cosmos DB: Azure Cosmos DB-Eingabebindungen verwenden die SQL-API, um mindestens ein Azure Cosmos DB-Dokument abzurufen und an den Eingabeparameter der Funktion zu übergeben. Die Dokument-ID oder die Abfrageparameter können basierend auf dem Trigger, der die Funktion aufruft, ermittelt werden.

  • Mobile Apps: Eine Mobile Apps-Eingabebindung lädt einen Datensatz aus einem mobilen Tabellenendpunkt und übergibt ihn an die Funktion.

  • Azure Table Storage: Sie können Daten lesen und mit Azure Table Storage arbeiten.

Eine vollständige Liste der unterstützten Bindungen finden Sie hier.

Um eine Bindung als Eingabe zu erstellen, müssen Sie direction als in definieren. Die Parameter für die unterschiedlichen Bindungstypen können variieren.

Was ist ein Bindungsausdruck?

Ein Bindungsausdruck stellt spezialisierten Text in einer function.json-Datei, Funktionsparametern oder Code dar, der beim Aufrufen der Funktion ausgewertet wird, um einen Wert zu erhalten. Wenn Sie z. B. über eine Service Bus-Warteschlangenbindung verfügen, können Sie einen Bindungsausdruck verwenden, um den Namen der Warteschlange aus den App-Einstellungen abzurufen.

Arten von Bindungsausdrücken

Es gibt eine Reihe von Bindungsausdruckstypen, einschließlich:

  • App-Einstellungen
  • Triggerdateiname
  • Metadaten für Trigger
  • JSON-Nutzlasten
  • Neue GUID
  • Aktuelles Datum und aktuelle Uhrzeit

Die meisten Bindungsausdrücke werden identifiziert, indem sie in geschweifte Klammern eingeschlossen werden. Allerdings werden Bindungsausdrücke der App-Einstellungen eher in Prozentzeichen anstatt in geschweifte Klammern eingeschlossen. Wenn der Pfad der Blobausgabebindung z. B. %Environment%/newblob.txt ist und die App-Einstellung „Environment“ den Wert Development aufweist, wird ein Blob im Container „Development“ erstellt.

Zusammenfassung

Über Eingabebindungen können wir unsere Funktion mit einer Datenquelle verbinden. Es können Verbindungen zu verschiedenen Datenquellentypen hergestellt werden, und die Parameter für jeden einzelnen Typ sind unterschiedlich. Um Werte aus Eingabequellen aufzulösen, können Sie Bindungsausdrücke in der Datei function.json, in Funktionsparametern oder im Code verwenden.