Conecta-seEntrar na plataforma

Redis

Ler, gravar e administrar chaves e estruturas de dados no Redis.

Integrações e ferramentasBancos de dadosConexão: Credencial protegida

O que faz

Conecte-se a qualquer instância do Redis para fazer operações de chave-valor, hash, lista e utilitários por conexão direta.

Quando usar: Use quando o seu fluxo precisar ler, gravar e administrar chaves e estruturas de dados no Redis.

Exemplo de situação: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Redis ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Ler (GET)Lê (GET) com o bloco Redis.
Gravar (SET)Grava (SET) com o bloco Redis.
Excluir (DEL)Exclui (DEL) com o bloco Redis.
Listar chavesLista chaves com o bloco Redis.
HSETExecuta a operação “HSET” com o bloco Redis.
HGETExecuta a operação “HGET” com o bloco Redis.
HGETALLExecuta a operação “HGETALL” com o bloco Redis.
HDELExecuta a operação “HDEL” com o bloco Redis.
INCRExecuta a operação “INCR” com o bloco Redis.
INCRBYExecuta a operação “INCRBY” com o bloco Redis.
EXISTSExecuta a operação “EXISTS” com o bloco Redis.
SETNXExecuta a operação “SETNX” com o bloco Redis.
LPUSHExecuta a operação “LPUSH” com o bloco Redis.
RPUSHExecuta a operação “RPUSH” com o bloco Redis.
LPOPExecuta a operação “LPOP” com o bloco Redis.
RPOPExecuta a operação “RPOP” com o bloco Redis.
LLENExecuta a operação “LLEN” com o bloco Redis.
LRANGEExecuta a operação “LRANGE” com o bloco Redis.
EXPIREExecuta a operação “EXPIRE” com o bloco Redis.
PERSISTExecuta a operação “PERSIST” com o bloco Redis.
TTLExecuta a operação “TTL” com o bloco Redis.
Comando livreExecuta a operação “Comando livre” com o bloco Redis.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Ler (GET) · Gravar (SET) · Excluir (DEL) · Listar chaves · HSET · HGET · HGETALL · HDEL · INCR · INCRBY · EXISTS · SETNX · LPUSH · RPUSH · LPOP · RPOP · LLEN · LRANGE · EXPIRE · PERSIST · TTL · Comando livre
    Padrão:
    Ler (GET)

  • Conexão

    Obrigatório

    Escolha uma conexão do workspace.

    Exemplo:
    (escolha na lista do campo)

  • Endereço de conexão Redis

    ObrigatórioEm campos adicionaisDado protegido

    Informa o endereço HTTPS do serviço ou recurso que será acessado.

    Padrão:
    Segredo protegido

  • Chave

    Obrigatório conforme a operação

    Chave do Redis em que a operação atua, ou seja, o nome do valor, hash ou lista guardado (ex.: carrinho:cliente-123).

    Aparece em:
    Ler (GET), Gravar (SET), Excluir (DEL), HSET, HGET, HGETALL, HDEL, INCR, INCRBY, EXISTS, SETNX, LPUSH, RPUSH, LPOP, RPOP, LLEN, LRANGE, EXPIRE, PERSIST, TTL
    Exemplo:
    minha-chave

  • Valor

    Obrigatório conforme a operação

    Valor a guardar.

    Aparece em:
    Gravar (SET), SETNX, HSET, LPUSH, RPUSH
    Exemplo:
    150.00

  • Expiração (segundos)

    Em campos adicionais

    TTL opcional em segundos.

    Aparece em:
    Gravar (SET)
    Exemplo:
    TTL opcional em segundos

  • Campo

    Obrigatório conforme a operação

    Nome do campo do hash.

    Aparece em:
    HSET, HGET, HDEL
    Exemplo:
    Nome do campo do hash

  • Padrão

    Em campos adicionais

    Padrão de nomes das chaves a listar, em que * vale qualquer texto (ex.: * para todas ou pedido:* para as que começam com pedido:).

    Aparece em:
    Listar chaves
    Exemplo:
    * (todas as chaves) ou usuario:* (prefixo)

  • Segundos

    Obrigatório conforme a operação

    Tempo em segundos.

    Aparece em:
    EXPIRE
    Exemplo:
    Tempo em segundos

  • Incremento

    Obrigatório conforme a operação

    Quanto incrementar (negativo para decrementar).

    Aparece em:
    INCRBY
    Exemplo:
    Quanto incrementar (negativo para decrementar)

  • Índice inicial

    Obrigatório conforme a operaçãoEm campos adicionais

    Posição do primeiro item da lista a retornar no LRANGE; 0 é o primeiro item e números negativos contam a partir do fim (-1 é o último).

    Aparece em:
    LRANGE
    Exemplo:
    0

  • Índice final

    Obrigatório conforme a operaçãoEm campos adicionais

    Posição do último item da lista a retornar no LRANGE, incluído no resultado; -1 vai até o fim da lista (ex.: 9 para os dez primeiros itens).

    Aparece em:
    LRANGE
    Exemplo:
    -1 (todos os elementos)

  • Comando

    Obrigatório conforme a operação

    Informa dados estruturados ou código no formato exigido pelo campo.

    Aparece em:
    Comando livre
    Exemplo:
    { "chave": "valor" }

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <redis.value>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<redis.value>jsonValor lido (GET, HGET, LPOP, RPOP: texto ou null) ou novo valor depois do incremento (INCR, INCRBY: número).
<redis.result>jsonResultado da operação (operações SET, HSET, EXPIRE, PERSIST e Comando livre).
<redis.deletedCount>numberNúmero de chaves excluídas (operação Excluir).
<redis.deleted>numberNúmero de campos excluídos (operação HDEL).
<redis.keys>arrayLista de chaves que correspondem ao padrão (operação Listar chaves).
<redis.count>numberNúmero de itens encontrados (operações Listar chaves e LRANGE).
<redis.key>stringChave usada na operação.
<redis.fields>jsonPares campo-valor do hash, indexados pelo nome do campo (operação HGETALL).
<redis.fieldCount>numberNúmero de campos do hash (operação HGETALL).
<redis.field>stringNome do campo do hash (operações HSET, HGET e HDEL).
<redis.ttl>numberTTL restante em segundos. Inteiro positivo se houver TTL definido, -1 se não expira, -2 se a chave não existe.
<redis.length>numberTamanho da lista (operações LPUSH, RPUSH e LLEN).
<redis.values>arrayElementos da lista no intervalo informado (operação LRANGE).
<redis.command>stringComando executado (operação Comando livre).
<redis.pattern>stringPadrão usado para encontrar as chaves (operação Listar chaves).
<redis.exists>booleanIndica se a chave existe (true) ou não (false) (operação EXISTS).
<redis.wasSet>booleanIndica se a chave foi gravada (true) ou se já existia (false) (operação SETNX).

Exemplo de uso

Objetivo: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

InícioRedispróxima etapa
Operação
Ler (GET)
Conexão
(escolha na lista do campo)
Chave
minha-chave

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <redis.value>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
Não foi possível conectar ao banco
Confira endereço, porta, nome do banco e usuário da conexão, e se o banco aceita conexões vindas da plataforma (firewall e lista de IPs liberados).
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados