Visão geral das associações do Azure Data Explorer para o Azure Functions (versão prévia)
Este conjunto de artigos explica como trabalhar com as associações do Azure Data Explorer no Azure Functions. O Azure Functions dá suporte às associações de entrada e saída para os clusters do Azure Data Explorer.
| Ação | Tipo |
|---|---|
| Ler dados de um banco de dados | Associação de entrada |
| Consumir dados em um banco de dados | Associação de saída |
Instalar a extensão
O pacote NuGet de extensão que você instala depende do modo C# que você está usando em seu aplicativo de funções.
As funções são executadas em um processo de trabalho C# isolado. Para saber mais, confira o Guia para executar C# do Azure Functions em um processo de trabalho isolado.
Adicione a extensão ao seu projeto instalando este pacote do NuGet.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Kusto --prerelease
Instalar o pacote
A extensão de associações do Azure Data Explorer faz parte de um pacote de extensão de visualização, que é especificado no arquivo de projeto host.json.
Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código no arquivo host.json :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
runtime do Functions
Observação
O suporte à linguagem Python para a extensão de associações do Azure Data Explorer está disponível a partir da v4.6.0 ou posterior do runtime do Functions. Talvez seja necessário atualizar a instalação do Azure Functions Core Tools para desenvolvimento local.
Instalar o pacote
A extensão de associações do Azure Data Explorer faz parte de um pacote de extensão de visualização, que é especificado no arquivo de projeto host.json.
Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código no arquivo host.json :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Instalar o pacote
A extensão de associações do Azure Data Explorer faz parte de um pacote de extensão de visualização, que é especificado no arquivo de projeto host.json.
Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código no arquivo host.json :
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
Atualizar pacotes
Adicione a biblioteca Java para associações do Azure Data Explorer ao seu projeto do Functions com uma atualização para o pom.xml arquivo em seu projeto do Python Azure Functions, da seguinte maneira:
<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-kusto</artifactId>
<version>1.0.4-Preview</version>
</dependency>
Cadeia de conexão do Kusto
As associações do Azure Data Explorer para o Azure Functions têm uma propriedade obrigatória para a cadeia de conexão em todas as associações. A cadeia de conexão está documentada nas cadeias de conexão do Kusto.
Considerações
- A associação do Azure Data Explorer dá suporte à versão 4.x e posterior do runtime do Functions.
- O código-fonte das associações do Azure Data Explorer está neste repositório do GitHub.
- Essa associação requer conectividade com o Azure Data Explorer. Para associações de entrada, os usuários precisam de permissões de Visualizador . Para associações de saída, os usuários precisam de permissões Ingestor . Para obter mais informações sobre permissões, confira Controle de acesso baseado em função.