Auf Englisch lesen

Teilen über

Azure Tables-Bindungen für Azure Functions

  • Artikel
Auswählen einer Programmiersprache

Azure Functions ist in Azure Tables über Trigger und Bindungen integriert. Durch die Integration in Azure Tables können Sie Funktionen erstellen, die Daten mithilfe von Azure Cosmos DB for Table und Azure Table Storage lesen und schreiben.

Aktion type
Liest Tabellendaten in einer Funktion Eingabebindung
Gestattet einer Funktion das Schreiben von Tabellendaten Ausgabebindung

Installieren der Erweiterung

Das NuGet-Erweiterungspaket, das Sie installieren, hängt vom C#-Modus ab, den Sie in Ihrer Funktions-App verwenden:

Wichtig

Die Unterstützung für das In-Process-Modell endet am 10. November 2026. Es wird dringend empfohlen, Ihre Apps zum isolierten Workermodell zu migrieren, um den vollständigen Support zu ermöglichen.

Funktionen werden im gleichen Prozess wie der Functions-Host ausgeführt. Weitere Informationen finden Sie unter Entwickeln von C#-Klassenbibliotheksfunktionen mithilfe von Azure Functions.

In einer Variante dieses Modells kann Functions mithilfe von C#-Skripts ausgeführt werden. Dies wird hauptsächlich für die Bearbeitung im C#-Portal unterstützt. Um vorhandene Bindungserweiterungen für C#-Skriptanwendungen zu aktualisieren, die im Portal ausgeführt werden, ohne Ihre Funktions-App erneut veröffentlichen zu müssen, lesen Sie Aktualisieren von Erweiterungen.

Der Prozess zum Installieren der Erweiterung ist abhängig von der Erweiterungsversion unterschiedlich:

In diesem Abschnitt wird die Verwendung einer Klassenbibliothek beschrieben. Für C#-Skripterstellung müssen Sie stattdessen das Erweiterungspaket (Version 4.x) installieren.

Diese Version bietet die Möglichkeit, eine Verbindung mithilfe einer Identität anstelle eines Geheimnisses herzustellen. Ein Tutorial zum Konfigurieren Ihrer Funktions-Apps mit verwalteten Identitäten finden Sie im Tutorial zum Erstellen einer Funktions-App mit identitätsbasierten Verbindungen.

Mit dieser Version können Sie Bindungen an Typen aus Azure.Data.Tables erstellen. Außerdem wird die Möglichkeit eingeführt, Azure Cosmos DB for Table zu verwenden.

Diese Erweiterung ist nutzbar, indem Sie das Paket Microsoft.Azure.WebJobs.Extensions.Tables NuGet mit Version 5.x oder höher der Erweiterungen für Blobs und Warteschlangen in einem Projekt installieren.

Verwenden der .NET-CLI:

.NET CLI 
# Install the Azure Tables extension
dotnet add package Microsoft.Azure.WebJobs.Extensions.Tables

# Update the combined Azure Storage extension (to a version which no longer includes Azure Tables)
dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage

Hinweis

Azure Blobs, Azure Queues und Azure Tables verwenden jetzt separate Erweiterungen und werden einzeln referenziert. Wenn Sie beispielsweise die Trigger und Bindungen für alle drei Dienste in Ihrer .NET-In-Process-App verwenden möchten, sollten Sie ihrem Projekt die folgenden Pakete hinzufügen:

Zuvor wurden die Erweiterungen zusammen als Microsoft.Azure.WebJobs.Extensions.Storage Version 4.x ausgeliefert. Dieses Paket verfügt auch über eine 5.x-Version, die nur auf die geteilten Pakete für Blobs und Warteschlangen verweist. Wenn Sie Ihre Paketverweise älterer Versionen aktualisieren, müssen Sie möglicherweise zusätzlich auf das neue NuGet-Paket Microsoft.Azure.WebJobs.Extensions.Tables verweisen. Stellen Sie beim Verweisen auf diese neueren geteilten Pakete außerdem sicher, dass Sie nicht auf eine ältere Version des kombinierten Speicherpakets verweisen, da dies zu Konflikten durch jeweils zwei Definitionen derselben Bindungen führt.

Installieren des Pakets

Die Azure Tables-Bindungen sind Teil eines Erweiterungspakets, das in Ihrer Projektdatei „host.json“ angegeben wird. Möglicherweise müssen Sie dieses Paket ändern, um die Version der Bindungen zu ändern, oder wenn Pakete noch nicht installiert sind. Weitere Informationen finden Sie unter Erweiterungspakete.

Diese Version bietet die Möglichkeit, eine Verbindung mithilfe einer Identität anstelle eines Geheimnisses herzustellen. Ein Tutorial zum Konfigurieren Ihrer Funktions-Apps mit verwalteten Identitäten finden Sie im Tutorial zum Erstellen einer Funktions-App mit identitätsbasierten Verbindungen.

Sie können diese Version der Erweiterung aus dem Erweiterungspaket v3 hinzufügen, indem Sie den folgenden Code in Ihrer Datei host.json hinzufügen oder ersetzen:

JSON 
{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[3.3.0, 4.0.0)"
    }
}

Bindungstypen

Die für .NET unterstützten Bindungstypen hängen sowohl von der Erweiterungsversion als auch von dem C#-Ausführungsmodus ab, der einer der folgenden sein kann:

Eine In-Process-Klassenbibliothek ist eine kompilierte C#-Funktion, die im gleichen Prozess wie die Functions-Runtime ausgeführt wird.

Wählen Sie eine Version aus, um für den Modus und die Version Details zum Bindungstyp anzuzeigen.

Die Azure Tables-Erweiterung unterstützt Parametertypen gemäß der folgenden Tabelle.

Bindungsszenario Parametertypen
Tabelleneingabe (einzelne Entität) Ein von ITableEntity abgeleiteter Typ.
Tabelleneingabe (mehrere Entitäten aus Abfrage) IEnumerable<T>, wobei T von ITableEntity abgeleitet ist.
TableClient
Tabellenausgabe (einzelne Entität) Ein von ITableEntity abgeleiteter Typ.
Tabellenausgabe (mehrere Entitäten) TableClient
ICollector<T> oder IAsyncCollector<T>, wobei TITableEntity implementiert.

Nächste Schritte