Tutorial: função Python com o Armazenamento de Tabelas do Azure como saída

Neste tutorial, você aprenderá a configurar uma função do Python com a Tabela de Armazenamento como saída concluindo as tarefas a seguir.

Uma visão geral dos componentes do projeto de função neste tutorial:

Pré-requisitos

• Instale o Visual Studio Code em uma das plataformas compatíveis.
• A CLI do Azure. Você pode usá-la no Azure Cloud Shell ou instalá-la localmente.
• Uma conta de Armazenamento do Microsoft Azure e uma tabela de Armazenamento. Se você não possuir uma conta de armazenamento, crie uma.
• O guia pressupõe que você conhece os conceitos apresentados no guia do desenvolvedor do Functions e em Como se conectar aos serviços no Azure Functions.

Criar um aplicativo de funções do Python

Siga o tutorial para criar um projeto local do Azure Functions e forneça as seguintes informações nos prompts:

Você criou um projeto de função Python com um gatilho HTTP.

Adicionar uma associação de saída da tabela de armazenamento

Os atributos de associação são definidos no arquivo function.json para uma determinada função. Para criar uma associação, clique com o botão direito do mouse (Ctrl+clique no macOS) no arquivo function.json na pasta da função e escolha Adicionar associação.... Siga os prompts para definir as seguintes propriedades de associação para a nova associação:

Para verificar se a associação foi adicionada com êxito:

1. Abra o arquivo TableStorageOutputFunc/function.json, verifique se uma nova associação type: table direction: out foi adicionada a esse arquivo.
2. Abra o arquivo local.settings.json, verifique se um novo par chave-valor <your-storage-account-name>_STORAGE: <your-storage-account-connection-string> que contém a cadeia de conexão da conta de armazenamento foi adicionado a esse arquivo.

Depois que a associação for adicionada, atualize os códigos de função para consumir a associação substituindo TableStorageOutputFunc/__init__.py pelo arquivo Python aqui.

import logging
import uuid
import json
import azure.functions as func

def main(req: func.HttpRequest, outMessage: func.Out[str]) -> func.HttpResponse:

    rowKey = str(uuid.uuid4())
    data = {
        "Name": "Output binding message",
        "PartitionKey": "message",
        "RowKey": rowKey
    }

    outMessage.set(json.dumps(data))
    return func.HttpResponse(f"Message created with the rowKey: {rowKey}")

Executar a função localmente

Siga o tutorial para executar a função localmente e verificar a saída da tabela.

1. Selecione a Conta de Armazenamento que você escolheu ao criar o recurso de função do Azure se for necessário se conectar a uma conta de armazenamento. Esse valor é usado no runtime do Azure Functions. Não é necessariamente a mesma conta de armazenamento que você usa para a saída.
2. Para iniciar a função localmente, pressione <kbd>F5</kbd>ou selecione o íconeExecutar e Depurar na barra Atividade do lado esquerdo.
3. Para verificar se a função pode gravar na tabela, clique com o botão direito do mouse em Execute Function Now... na função na exibiçãoWORKSPACE do Visual Studio Code e verifique a resposta da função. A mensagem de resposta deve conter a rowKey que foi gravada na tabela.

Criar uma conexão usando o Service Connector

Na última etapa, você verificou o projeto de função localmente. Agora, você aprenderá a configurar a conexão entre a Função do Azure e a Tabela de Armazenamento do Microsoft Azure na nuvem, para que a função possa gravar no blob de armazenamento depois de ser implantada na nuvem.

1. Abra o arquivo function.json no projeto local, altere o valor da propriedade connection em bindings para AZURE_STORAGETABLE_CONNECTIONSTRING.
2. Execute o comando da CLI do Azure a seguir para criar uma conexão entre a função do Azure e o Armazenamento do Microsoft Azure.

az functionapp connection create storage-table --source-id "<your-function-resource-id>" --target-id "<your-storage-table-resource-id>" --secret

• Formato --source-id: /subscriptions/{subscription}/resourceG roups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
• Formato --target-id: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/tableServices/default

Você criou um recurso do Service Connector que configura uma variável AZURE_STORAGETABLE_CONNECTIONSTRING nas Configurações de Aplicativo da função. Essa configuração de aplicativo será consumida pela associação de função para se conectar ao armazenamento e permitir que a função grave na tabela de armazenamento. Você pode saber mais sobre como o Service Connector ajuda o Azure Functions a se conectar aos serviços.

Implantar sua função no Azure

Agora você pode implantar a função no Azure e verificar se a associação de saída da tabela de armazenamento funciona.

1. Siga este tutorial do Azure Functions para implantar a função no Azure.
2. Para verificar se a função pode gravar na tabela, clique com o botão direito do mouse em Execute Function Now... na função na exibiçãoRECURSOS do Visual Studio Code e verifique a resposta da função. A mensagem de resposta deve conter o rowKey que a função acabou de gravar na tabela.

Solucionar problemas

Se houver erros relacionados ao host de armazenamento, por exemplo, No such host is known (<acount-name>.table.core.windows.net:443), você precisará verificar se a cadeia de conexão usada para se conectar ao Armazenamento do Microsoft Azure contém o ponto de extremidade da tabela ou não. Caso contrário, vá para o portal do Armazenamento do Microsoft Azure, copie a cadeia de conexão da folha Access keys e substitua os valores.

Se esse erro acontecer quando você iniciar o projeto localmente, verifique o arquivo local.settings.json.

Se isso acontecer quando você implantar a função na nuvem (nesse caso, a implantação da função geralmente falhará em Syncing triggers), verifique as Configurações de Aplicativo da função.

Limpar os recursos

Se você não quiser continuar usando esse projeto, exclua o recurso Aplicativo de Funções criado anteriormente.

az functionapp delete --name <function-name> --resource-group <resource-group>

Próximas etapas

Leia os artigos abaixo para saber mais sobre os conceitos do Service Connector e como ele ajuda o Azure Functions a se conectar a outros serviços de nuvem.