Lectura de datos con enlaces de entrada
Para conectarse a un origen de datos, tiene que configurar un enlace de entrada. Un enlace de entrada permite escribir un código mínimo para crear un mensaje. No es necesario escribir código para tareas como abrir una conexión de almacenamiento. El sistema en tiempo de ejecución de Azure Functions y el enlace se encargan automáticamente de esas tareas.
Tipos de enlace de entrada
Las funciones de cadena de Azure pueden tener varios tipos de entrada. Pero no todos los tipos admiten tanto entradas como salidas. Use una función de entrada cuando quiera ingerir datos de ese tipo. Aquí, se examinan los tipos de funciones de entrada que admiten enlaces de entrada y cuándo usarlos.
Azure Blob Storage: los enlaces de Blob Storage le permiten leer un blob.
Azure Cosmos DB: los enlaces de entrada de Azure Cosmos DB usan la API de SQL para recuperar uno o varios documentos de Azure Cosmos DB y los pasan al parámetro de entrada de la función. Se puede determinar el identificador de documento o los parámetros de consulta según el desencadenador que invoca la función.
Mobile Apps: un enlace de entrada de Mobile Apps carga un registro desde un punto de conexión de tabla móvil y lo pasa a la función.
Azure Table Storage: puede leer los datos y trabajar con Azure Table Storage.
Hay disponible una lista completa de los enlaces admitidos aquí
Para crear un enlace como entrada, debe definir direction como in. Los parámetros para cada tipo de enlace pueden variar.
¿Qué es una expresión de enlace?
Una expresión de enlace es texto especializado en function.json, parámetros de función o código que se evalúa cuando se invoca la función para producir un valor. Por ejemplo, si tiene un enlace de cola de Service Bus, podría usar una expresión de enlace para obtener el nombre de la cola a partir de la configuración de la aplicación.
Tipos de expresiones de enlace
Hay varios tipos de expresiones de enlace, entre los que se incluyen los siguientes:
- Configuración de la aplicación
- Nombre de archivo del desencadenador
- Metadatos de desencadenador
- Cargas JSON
- GUID nuevos
- Fecha y hora actual
La mayoría de las expresiones de enlace se identifican encerrándolas entre llaves. Aun así, las expresiones de enlace de configuración de aplicaciones se incluyen entre signos de porcentaje, en lugar de entre llaves. Por ejemplo, si la ruta de acceso del enlace de salida de blob es %Environment%/newblob.txt y el valor de la configuración de aplicación Environment es Development, se crea un blob en el contenedor Development.
Resumen
Los enlaces de entrada el permiten conectar su función a un origen de datos. Puede conectarse a varios tipos de orígenes de datos, y los parámetros para cada uno de ellos varían. Para resolver valores de orígenes de entrada, use expresiones de enlace en el archivo function.json, en los parámetros de función o en el código.