Gerenciar extensões de idioma em seu cluster do Azure Data Explorer

O recurso de extensões de idioma permite que você use plug-ins de extensão de idioma para integrar outros idiomas em suas consultas KQL do Azure Data Explorer. O tempo de execução do plug-in é hospedado em um sandbox, um ambiente isolado e seguro, executado nos nós do cluster. Neste artigo, você gerencia o plug-in de extensões de idioma em seu cluster do Azure Data Explorer no portal do Azure.

Pré-requisitos

• Uma assinatura do Azure. Crie uma conta do Azure gratuita.
• Um cluster e um banco de dados do Azure Data Explorer. Crie um cluster e um banco de dados.
• Analise as limitações. Observe que as extensões de idioma só podem ser habilitadas em SKUs que oferecem suporte à virtualização aninhada.
• Cluster AllDatabasesAdmin permissões. Gerencie as permissões de cluster do Azure Data Explorer.

Habilitar extensões de idioma no cluster

Execute as seguintes etapas para habilitar uma extensão de idioma no cluster:

1. No portal do Azure, vá para o cluster do Azure Data Explorer.

2. Selecione Configurações.

3. Em Configurações, localize a extensão de idioma que deseja usar e selecione Ativado.

   

4. Para Python, selecione a imagem desejada na lista. A imagem pode ser gerenciada ou uma imagem personalizada.

5. Selecione Guardar.

Observação

Ativar a extensão de idioma pode levar até 60 minutos. O processo não afeta a disponibilidade do cluster.

Alterar a imagem das extensões de linguagem Python no cluster

Siga as seguintes etapas para editar a imagem da extensão de linguagem Python no seu cluster.

1. No portal do Azure, vá para o cluster do Azure Data Explorer.
2. Selecione Configurações.
3. Em Configurações, selecione a imagem Python desejada na lista.
4. Selecione Guardar.

Observação

A atualização do processo de imagem pode levar até 60 minutos. O processo não afeta a disponibilidade do cluster.

Criar uma imagem personalizada

1. No portal do Azure, vá para o cluster do Azure Data Explorer.

2. Selecione Configurações.

3. Em Configurações, selecione + Adicionar imagem personalizada (visualização)

4. No painel que se abre, forneça as seguintes informações:

   • Nome da imagem personalizada: o nome da imagem personalizada.
   • Partir de: Escolha o mecanismo Python ou a imagem existente.
     • Motor Python:
       1. Insira um número de versão Python válido.
       2. Adicione um arquivo de requisitos.
     • Imagem existente:
       1. Selecione uma imagem existente na lista suspensa.
       2. Adicione um arquivo de requisitos.

5. Selecione OK.

   

Observação

Enquanto o cluster está atualizando a nova imagem, outras alterações no cluster não podem ser feitas.

Depois que a imagem é criada, você pode editá-la ou excluí-la.

Ficheiro de requisitos

Os arquivos de requisitos suportados estão no formato de pip requirements.txt e podem incluir qualquer pacote Python. Cada linha contém o nome de um pacote, opcionalmente seguido pelo número do pacote. Por exemplo:

annotated-types==0.6.0
anytree
arrow==1.3.0
attrs==23.2.0

Desativar extensões de idioma no cluster

Observação

A desativação do processo de imagem pode levar até 30 minutos. O processo não afeta a disponibilidade do cluster.

Execute as seguintes etapas para desabilitar as extensões de idioma no cluster:

1. No portal do Azure, vá para o cluster do Azure Data Explorer.
2. Em Configurações, selecione Configurações.
3. No painel Configurações , selecione Desativado para desativar uma extensão de idioma.
4. Selecione Guardar.

Limitações

• A sandbox de execução das extensões de linguagem aloca espaço em disco mesmo que nenhuma consulta seja executada no âmbito da linguagem relevante. Para obter limitações mais detalhadas, consulte sandboxes.

Conteúdo relacionado

• Saiba como executar consultas KQL integradas ao Python
• Saiba como executar consultas KQL integradas ao R