Visão geral das associações do Azure Data Explorer para o Azure Functions (versão prévia)

  • Artigo

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ção.

As funções são executadas em um processo de trabalho isolado do C#. 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 ligações do Azure Data Explorer está disponível a partir da v4.6.0 ou posterior do tempo de execução 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 para as associações do Azure Data Explorer está neste repositório do GitHub.
  • Essa associação requer conectividade com o Azure Data Explorer. Para ligações de entrada, os usuários exigem permissões de Visualizador . Para ligações de saída, os usuários exigem permissões do Ingestor . Para obter mais informações sobre permissões, confira Controle de acesso baseado em função.

Próximas etapas