Partilhar via

Visão geral das associações do Azure Data Explorer para o Azure Functions (visualização)

  • Artigo

Este conjunto de artigos explica como trabalhar com associações do Azure Data Explorer no Azure Functions. O Azure Functions dá suporte a associações de entrada e de saída para clusters do Azure Data Explorer.

Ação Type
Ler dados de uma base de dados Vinculação de entrada
Ingerir dados para um banco de dados Vinculaçã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 C# isolado. Para saber mais, consulte Guia para executar o C# Azure Functions em um processo de trabalho isolado.

Adicione a extensão ao seu projeto instalando este pacote 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 em seu arquivo de projeto host.json.

Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código em seu arquivo host.json :

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Tempo de execução das funções

Nota

O suporte da 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 tempo de execução do Functions. Talvez seja necessário atualizar sua instalação das Ferramentas Principais do Azure Functions 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 em seu arquivo de projeto host.json.

Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código em seu 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 em seu arquivo de projeto host.json.

Você pode adicionar o pacote de extensão de visualização adicionando ou substituindo o seguinte código em seu 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 Functions com uma atualização para o pom.xml arquivo em seu projeto 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 Kusto

As associações do Azure Data Explorer para o Azure Functions têm uma propriedade necessária para a cadeia de conexão em todas as associações. A cadeia de conexão está documentada em cadeias de conexão Kusto.

Considerações

  • A associação do Azure Data Explorer dá suporte à versão 4.x e posterior do tempo de execução do Functions.
  • O código-fonte para as associações do Azure Data Explorer está neste repositório do GitHub.
  • Para maior segurança, seu aplicativo de função deve usar identidades gerenciadas ao se conectar ao Azure Data Explorer em vez de usar cadeias de conexão que contêm chaves. Para obter mais informações, consulte Cadeias de conexão Kusto. Para conexões baseadas em identidade gerenciada, você deve definir a managedServiceIdentity propriedade na definição de associação.
  • Essa associação requer conectividade com o Azure Data Explorer. Para ligações de entrada, os usuários precisam de permissões de visualização . Para ligações de saída, os usuários precisam de permissões Ingestor . Para obter mais informações sobre permissões, consulte Controle de acesso baseado em função.

Próximos passos