Ler dados com enlaces de entrada
Para se conectar a uma fonte de dados, você precisa configurar uma associação de entrada. Uma ligação de entrada torna possível escrever código mínimo para criar uma mensagem. Você não precisa escrever código para tarefas, como abrir uma conexão de armazenamento; o tempo de execução e a vinculação do Azure Functions cuidam dessas tarefas para você.
Tipos de enlace de entrada
As funções de cadeia do Azure podem ter vários tipos de entrada. No entanto, nem todos os tipos suportam tanto entrada quanto saída. Use uma função de entrada sempre que quiser ingerir dados desse tipo. Aqui, examinamos os tipos de função de entrada que suportam ligações de entrada e quando usá-las.
Armazenamento de Blobs do Azure - As associações de Armazenamento de Blob permitem que você leia a partir de um blob.
Azure Cosmos DB - As associações de entrada do Azure Cosmos DB usam a API SQL para recuperar um ou mais documentos do Azure Cosmos DB e passá-los para o parâmetro de entrada da função. O ID do documento, ou parâmetros de consulta, pode ser determinado com base no gatilho que invoca a função.
Aplicativos Móveis - Uma ligação de entrada de Aplicativos Móveis carrega um registro de um ponto de extremidade de tabela móvel e o passa para sua função.
Armazenamento de tabela do Azure - Você pode ler dados e trabalhar com o armazenamento de tabela do Azure.
Uma lista completa das ligações suportadas está disponível aqui
Para criar uma associação como entrada, você deve definir direction como in. Os parâmetros para cada tipo de ligação podem variar.
O que é uma expressão de enlace?
Uma expressão de vinculação é um texto especializado em function.json, parâmetros de função ou código que é avaliado quando a função é invocada, para produzir um valor. Por exemplo, se você tiver uma associação de fila do Service Bus, poderá usar uma expressão de associação para obter o nome da fila nas Configurações do aplicativo.
Tipos de expressões de enlace
Existem vários tipos de expressões de ligação, incluindo:
- Definições da aplicação
- Nome do arquivo do gatilho
- Metadados do acionador
- Payloads JSON
- Novo GUID
- Data e hora atuais
A maioria das expressões de ligação são identificadas por serem embrulhadas em chaves encaracoladas. No entanto, as expressões de vinculação de configuração do aplicativo são encapsuladas em sinais de porcentagem, em vez de chaves encaracoladas. Por exemplo, se o caminho de vinculação de saída do blob for %Environment%/newblob.txt, e o valor da configuração do aplicativo Ambiente for Desenvolvimento, um blob será criado no contêiner Desenvolvimento.
Resumo
Enlaces de entrada lhe permitem ligar a função a uma origem de dados. Pode ligar a vários tipos de origens de dados, e os parâmetros para cada opção variam. Para resolver valores de fontes de entrada, use expressões de vinculação no arquivo function.json , em parâmetros de função ou em código.