Compartilhar via

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çõ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.
  • Para maior segurança, seu aplicativo de funções 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, confira Cadeias de conexão do 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 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.

Próximas etapas