Início Rápido: Utilizar a Cache do Azure para Redis no Python

  • Artigo

Neste artigo, você incorpora o Cache Redis do Azure em um aplicativo Python para ter acesso a um cache dedicado e seguro acessível a partir de qualquer aplicativo no Azure.

Saltar para o código no GitHub

Se você quiser pular diretamente para o código, consulte o início rápido do Python no GitHub.

Pré-requisitos

Criar uma instância do Cache do Azure para Redis

  1. Para criar um cache, entre no portal do Azure e selecione Criar um recurso.

    Criar um recurso é realçado no painel de navegação esquerdo.

  2. Na página Novo, selecione Bancos de Dados e, em seguida, selecione Cache do Azure para Redis.

    Em Novo, Bancos de Dados é realçado e o Cache Redis do Azure é realçado.

  3. Na página Novo Cache Redis, defina as configurações para o novo cache.

    Definição Escolher um valor Description
    Subscrição Drop-down e selecione sua assinatura. A assinatura sob a qual criar essa nova instância do Cache do Azure para Redis.
    Grupo de recursos Drop-down e selecione um grupo de recursos, ou selecione Criar novo e insira um novo nome de grupo de recursos. Nome do grupo de recursos no qual criar o cache e outros recursos. Ao colocar todos os recursos do seu aplicativo em um grupo de recursos, você pode facilmente gerenciá-los ou excluí-los juntos.
    Nome DNS Introduza um nome exclusivo. O nome do cache deve ser uma cadeia de caracteres entre 1 e 63 caracteres que contenha apenas números, letras ou hífenes. O nome deve começar e terminar com um número ou letra e não pode conter hífenes consecutivos. O nome de host da instância de cache é <DNS name.redis.cache.windows.net>.
    Location Drop-down e selecione um local. Selecione uma região perto de outros serviços que usam seu cache.
    Tipo de cache Drop-down e selecione uma camada. A camada determina o tamanho, o desempenho e os recursos disponíveis para o cache. Para obter mais informações, consulte Visão geral do Cache do Azure para Redis.

  4. Selecione a guia Rede ou selecione o botão Rede na parte inferior da página.

  5. Na guia Rede, selecione seu método de conectividade.

  6. Selecione a guia Avançar: Avançado ou selecione o botão Avançar: Avançado na parte inferior da página para ver a guia Avançado .

    Captura de ecrã a mostrar o separador Avançadas no painel de trabalho e a opção disponível para selecionar.

    • Para caches Basic ou Standard, alterne a seleção para uma porta não-TLS. Você também pode selecionar se deseja habilitar a Autenticação do Microsoft Entra.
    • Para um cache Premium, defina as configurações para porta não-TLS, clustering, identidade gerenciada e persistência de dados. Você também pode selecionar se deseja habilitar a Autenticação do Microsoft Entra.

  7. Selecione a guia Next: Tags ou selecione o botão Next: Tags na parte inferior da página.

  8. Opcionalmente, na guia Marcas , insira o nome e o valor se desejar categorizar o recurso.

  9. Selecione Rever + criar. Você é levado para a guia Revisão + criação, onde o Azure valida sua configuração.

  10. Depois que a mensagem verde Validação passada for exibida, selecione Criar.

Demora um pouco para um cache ser criado. Você pode monitorar o progresso na página Visão geral do Cache do Azure para Redis. Quando Status é exibido como Em execução, o cache está pronto para uso.

Recuperar nome de host, portas e chaves de acesso do portal do Azure

Para conectar seu servidor Cache do Azure para Redis, o cliente de cache precisa do nome do host, das portas e de uma chave para o cache. Alguns clientes podem mencionar esses itens com nomes ligeiramente diferentes. Você pode obter o nome do host, as portas e as chaves no portal do Azure.

  • Para obter as chaves de acesso, selecione Autenticação no menu Recurso. Em seguida, selecione a guia Teclas de acesso.

    Cache do Azure para chaves Redis

  • Para obter o nome do host e as portas do cache, selecione Visão geral no menu Recurso. O nome do host é do formato <DNS name.redis.cache.windows.net>.

    Propriedades do Cache do Azure para Redis

Instalar redis-py

Redis-py é uma interface Python para o Cache do Azure para Redis. Use a ferramenta de pacotes Python, pip, para instalar o redis-py pacote a partir de um prompt de comando.

O exemplo a seguir usado pip3 para Python 3 para instalar redis-py no Windows 11 a partir de um prompt de comando do administrador.

Captura de tela de um terminal mostrando uma instalação da interface redis-py no Cache do Azure para Redis.

Ler e escrever na cache

Execute Python a partir da linha de comando e teste seu cache usando o código a seguir. Substitua <Your Host Name> e <Your Access Key> pelos valores da sua instância do Cache do Azure para Redis. Seu nome de host é do formato <DNS name>.redis.cache.windows.net.

>>> import redis
>>> r = redis.StrictRedis(host='<Your Host Name>',
        port=6380, db=0, password='<Your Access Key>', ssl=True)
>>> r.set('foo', 'bar')
True
>>> r.get('foo')
b'bar'

Importante

Para o Cache do Azure para Redis versão 3.0 ou superior, a verificação de certificado TLS/SSL é imposta. ssl_ca_certs deve ser definido explicitamente ao se conectar ao Cache do Azure para Redis. Para RedHat Linux, ssl_ca_certs estão no /etc/pki/tls/certs/ca-bundle.crt módulo de certificado.

Criar um aplicativo de exemplo Python

Crie um novo arquivo de texto, adicione o seguinte script e salve o arquivo como PythonApplication1.py. Substitua <Your Host Name> e <Your Access Key> pelos valores da sua instância do Cache do Azure para Redis. Seu nome de host é do formato <DNS name>.redis.cache.windows.net.

import redis

myHostname = "<Your Host Name>"
myPassword = "<Your Access Key>"

r = redis.StrictRedis(host=myHostname, port=6380,
                      password=myPassword, ssl=True)

result = r.ping()
print("Ping returned : " + str(result))

result = r.set("Message", "Hello!, The cache is working with Python!")
print("SET Message returned : " + str(result))

result = r.get("Message")
print("GET Message returned : " + result.decode("utf-8"))

result = r.client_list()
print("CLIENT LIST returned : ")
for c in result:
    print(f"id : {c['id']}, addr : {c['addr']}")

Execute PythonApplication1.py com Python. Você deve ver resultados como o exemplo a seguir:

Captura de tela de um terminal mostrando um script Python para testar o acesso ao cache.

Clean up resources (Limpar recursos)

Se você tiver terminado com o grupo de recursos do Azure e os recursos criados neste início rápido, poderá excluí-los para evitar cobranças.

Importante

A exclusão de um grupo de recursos é irreversível e o grupo de recursos e todos os recursos nele contidos são excluídos permanentemente. Se você criou sua instância do Cache do Azure para Redis em um grupo de recursos existente que deseja manter, poderá excluir apenas o cache selecionando Excluir na página Visão Geral do cache.

Para excluir o grupo de recursos e seu Cache Redis para instância do Azure:

  1. No portal do Azure, pesquise e selecione Grupos de recursos.

  2. Na caixa de texto Filtrar por nome, digite o nome do grupo de recursos que contém sua instância de cache e selecione-o nos resultados da pesquisa.

  3. Na página do grupo de recursos, selecione Excluir grupo de recursos.

  4. Digite o nome do grupo de recursos e selecione Excluir.

    Captura de ecrã do portal do Azure a mostrar como eliminar o grupo de recursos para a Cache do Azure para Redis.

Próximos passos