Início Rápido: Usar o Cache do Azure para Redis no Python

  • Artigo

Neste artigo, você incorporará o Cache do Azure para Redis a um aplicativo Python para ter acesso a um cache seguro e dedicado que pode ser acessado de qualquer aplicativo no Azure.

Pular para o código no GitHub

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

Pré-requisitos

Criar uma instância de Cache do Azure para Redis

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

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

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

    Em Novo, os Bancos de Dados e o Cache do Azure para Redis estão realçados.

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

    Configuração Escolher um valor Descrição
    Assinatura Clique na lista suspensa e selecione sua assinatura. A assinatura na qual essa nova instância do Cache do Azure para Redis será criada.
    Grupo de recursos Clique na lista suspensa e selecione um grupo de recursos ou selecione Criar e insira um novo nome de grupo de recursos. Nome do grupo de recursos no qual o cache e outros recursos serão criados. Ao colocar todos os seus recursos de aplicativos em um só grupo de recursos, você pode gerenciá-los ou excluí-los juntos com facilidade.
    Nome DNS Insira um nome exclusivo. O nome do cache deve conter de 1 a 63 caracteres e incluir somente números, letras ou hifens. O nome precisa começar e terminar com um número ou uma letra e não pode conter hifens consecutivos. O nome do host da instância de cache será <nome DNS>.redis.cache.windows.net.
    Localidade Clique na lista suspensa e selecione uma localização. Selecione uma região perto de outros serviços que usam o seu cache.
    Tipo de cache Clique na lista suspensa e selecione uma camada. A camada determina o tamanho, o desempenho e os recursos disponíveis para o cache. Para obter mais informações, confira Visão geral do Cache do Azure para Redis.

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

  5. Na guia Rede, escolha o método de conectividade.

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

    Captura de tela mostrando a guia Avançado no painel de trabalho e a opção disponível para seleção.

    • Para caches Básico 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 Próximo: Marcas ou o botão Próximo: Marcas na parte inferior da página.

  8. Opcionalmente, na guia Marcas, insira o nome e o valor caso deseje categorizar o recurso.

  9. Selecione Examinar + criar. Você será levado para a guia Examinar + criar, na qual o Azure valida sua configuração.

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

A criação do cache demora um pouco. Monitore o progresso na página Visão Geral do Cache do Azure para Redis. Quando o Status for mostrado como Em execução, o cache estará pronto para uso.

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

Para conectar seu servidor do 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 se referir a esses itens por nomes um pouco diferentes. Você pode obter o nome do host, as portas e as chaves do portal do Azure.

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

    Chaves do Cache Redis do Azure

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

    Propriedades do Cache Redis do Azure

Instale o redis-py

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

O exemplo a seguir usa pip3 para Python 3 para instalar o redis-py no Windows 11 por meio de um prompt de comando do administrador.

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

Ler e gravar no cache

Execute o Python na 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. O nome do seu host é da forma <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

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

Criar um aplicativo de exemplo do Python

Crie um novo arquivo de texto, adicione o script a seguir 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. O nome do seu host é da forma <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 os do exemplo a seguir:

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

Limpar os recursos

Se você não pretende mais usar o grupo de recursos do Azure, ou os recursos criados neste início rápido, pode excluí-los para evitar encargos.

Importante

A exclusão de um grupo de recursos é irreversível, e o que significa que todos os recursos nesse grupo são permanentemente excluídos. 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 sua instância do Redis do Cache do Azure:

  1. No portal do Azure, procure 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 tela do portal do Azure mostrando como excluir o grupo de recursos para Cache do Azure para Redis.

Próximas etapas