Ler dados com associações de entrada

  • 5 minutos

Para conectar-se a uma fonte de dados, você precisa configurar uma associação de entrada. Uma associação de entrada permitirá que você escreva o mínimo de código para criar uma mensagem. Você não precisa escrever código para tarefas como abrir uma conexão de armazenamento; o runtime do Azure Functions e a associação cuidam dessas tarefas para você.

Tipos de associação de entrada

As funções de cadeia do Azure podem ter vários tipos de entrada. No entanto, nem todos os tipos dão suporte a entrada e saída. Use uma função de entrada sempre que quiser ingerir dados desse tipo. Aqui, analisamos os tipos de função de entrada que dão suporte a associações de entrada e quando usá-las.

  • Armazenamento de Blobs do Azure – as associações do Armazenamento de Blobs permitem a leitura de um blob.

  • Azure Cosmos DB – As associações de entrada do Azure Cosmos DB usam a API do SQL para recuperar um ou mais documentos do Azure Cosmos DB e os transmitir ao parâmetro de entrada da função. A ID do documento ou os parâmetros de consulta podem ser determinados com base no gatilho que invoca a função.

  • Aplicativos Móveis – Uma associação de entrada de Aplicativos Móveis carrega um registro de um ponto de extremidade de tabela móvel e passa-o para a função.

  • Armazenamento de Tabelas do Azure – você pode ler os dados e trabalhar com o Armazenamento de Tabelas do Azure.

Uma lista completa das associações com suporte está disponível aqui

Para criar uma associação como uma entrada, é necessário definir direction como in. Os parâmetros para cada tipo de associação podem variar.

O que é uma expressão de associação?

Uma expressão de associação é um texto especializado no function.json, parâmetros de função ou um código que é avaliado quando a função é invocada para produzir um valor. Por exemplo, se houver uma associação de Fila do Barramento de Serviço, você poderá usar uma expressão de associação para obter o nome da fila em Configurações de Aplicativo.

Tipos de expressões de associação

Há vários tipos de expressões de associação, incluindo:

  • Configurações de aplicativo
  • Nome do arquivo do gatilho
  • Metadados do gatilho
  • Conteúdos JSON
  • Novo GUID
  • Data e hora atuais

A maioria das expressões de associação são identificadas pela disposição entre chaves. No entanto, as expressões de associação da configuração do aplicativo são dispostas entre sinais de porcentagem em vez de chaves. Por exemplo, se o caminho da associação de saída do blob for %Environment%/newblob.txt e o valor da configuração de aplicativo do Ambiente for Desenvolvimento, será criado um blob no contêiner de Desenvolvimento.

Resumo

As associações de entrada permitem que você conecte sua função a uma fonte de dados. Você pode se conectar a vários tipos de fontes de dados, e os parâmetros de cada tipo variam. Para resolver valores de fontes de entrada, use expressões de associação no arquivo function.json, nos parâmetros da função ou no código.