Irakurri ingelesez

Partekatu honen bidez:


Enlaces de Azure Tables para Azure Functions

Selección de un lenguaje de programación

Azure Functions se integra con Azure Tables mediante desencadenadores y enlaces. La integración con Azure Tables permite crear funciones que leen y escriben datos con Azure Cosmos DB for Table y Azure Table Storage.

Acción Tipo
Lectura de datos de tabla en una función Enlace de entrada
Permitir que una función escriba datos de tabla Enlace de salida

Instalación de la extensión

El paquete NuGet de la extensión que instale depende del modo de C# que esté usando en la aplicación de funciones:

Garrantzitsua

El soporte técnico del modelo en proceso finalizará el 10 de noviembre de 2026. Se recomienda encarecidamente migrar las aplicaciones al modelo de trabajo aislado para obtener soporte técnico completo.

Las funciones se ejecutan en el mismo proceso que el host de Functions. Para más información, consulte Desarrollo de funciones de la biblioteca de clases de C# con Azure Functions.

En una variación de este modelo, Functions se puede ejecutar mediante el scripting de C#, que se admite principalmente para la edición del portal de C#. Para actualizar las extensiones de enlace existentes de las aplicaciones del script de C# que se ejecutan en el portal sin tener que volver a publicar la aplicación de funciones, consulte Actualización de las extensiones.

El proceso para instalar la extensión varía en función de la versión de la extensión:

En esta sección se describe el uso de una biblioteca de clases. En el caso del scripting de C#, tendría que instalar en su lugar la agrupación de extensiones, versión 4.x.

Esta versión presenta la posibilidad de conectarse con una identidad en lugar de un secreto. Para obtener un tutorial sobre cómo configurar las aplicaciones de funciones con identidades administradas, consulte el tutorial Creación de una aplicación de funciones con conexiones basadas en identidades.

Esta versión permite enlazar con tipos de Azure.Data.Tables. También presenta la capacidad de usar Azure Cosmos DB for Table.

Esta extensión está disponible mediante la instalación del paquete de NuGet Microsoft.Azure.WebJobs.Extensions.Tables en un proyecto con la versión 5.x o posterior de la extensión para blobs y colas.

Mediante la CLI de .NET:

# 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

Oharra

Azure Blobs, Azure Queues y Azure Tables ahora usan extensiones diferentes y se les hace referencia por separado. Por ejemplo, para usar los desencadenadores y enlaces para los tres servicios de la aplicación en proceso de .NET, debe agregar los siguientes paquetes al proyecto:

Anteriormente, las extensiones se enviaban juntas como Microsoft.Azure.WebJobs.Extensions.Storage, versión 4.x. Este mismo paquete también tiene una versión 5.x que hace referencia solo a los paquetes divididos para blobs y colas. Al actualizar las referencias del paquete desde versiones anteriores, es posible que tenga que hacer referencia además al nuevo paquete de NuGet Microsoft.Azure.WebJobs.Extensions.Tables. Además, al hacer referencia a estos paquetes divididos más recientes, asegúrese de que no hace referencia a una versión anterior del paquete de almacenamiento combinado, ya que esto provocaría conflictos por las dos definiciones de los mismos enlaces.

Instalación del conjunto

Los enlaces de Azure Tables forman parte de un conjunto de extensiones, que se especifica en el archivo de proyecto host.json. Es posible que tenga que modificar este conjunto para cambiar la versión de los enlaces o en caso de que los conjuntos aún no estén instalados. Para obtener más información, consulte Conjuntos de extensiones.

Esta versión presenta la posibilidad de conectarse con una identidad en lugar de un secreto. Para obtener un tutorial sobre cómo configurar las aplicaciones de funciones con identidades administradas, consulte el tutorial Creación de una aplicación de funciones con conexiones basadas en identidades.

Para agregar esta versión de la extensión desde el conjunto de extensiones v3, puede agregar o reemplazar el código siguiente en el archivo host.json:

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

Tipos de enlaces

Los tipos de enlace admitidos para .NET dependen de la versión de extensión y del modo de ejecución de C#, que puede ser uno de los siguientes:

Un biblioteca de clases en proceso es una función de C# compilada que se ejecuta en el mismo proceso que Functions Runtime.

Seleccione una versión para ver los detalles del tipo de enlace para el modo y la versión.

La extensión Azure Tables admite tipos de parámetros según la tabla siguiente.

Escenario de enlace Tipos de parámetro
Entrada de tabla (entidad única) Un tipo derivado de ITableEntity
Entrada de tabla (varias entidades de la consulta) IEnumerable<T> donde T deriva de ITableEntity
TableClient
Salida de tabla (entidad única) Un tipo derivado de ITableEntity
Salida de tabla (varias entidades) TableClient
ICollector<T> o IAsyncCollector<T> donde T implementa ITableEntity

Pasos siguientes