Redis

Visão Geral

O componente Redis realiza operações de leitura e escrita em uma base de dados Redis.

Configuração

Aqui estão os parâmetros gerais para a configuração do componente. Todos os parâmetros de campos de texto aceitam o uso de variáveis. Parâmetros que suportam expressões de template estão marcados com (Tmpl).

Informação adicional

O uso de variáveis em parâmetros de campos de texto é feito utilizando a expressão {{var.nome_da_variavel}}. Para saber mais sobre o uso de variáveis na criação de integrações, acesse a seção Canvas de integrações.

Alguns parâmetros suportam expressões de template para utilização de valores dinâmicos. Para saber mais sobre o funcionamento dessa linguagem e como utilizar expressões de template para referenciar dados para valores dinâmicos, acesse a seção Go Template de integrações.

Parâmetros

• ID do Componente: Obrigatório. Identificador do componente no fluxo de integração.

Informação adicional

Os IDs são únicos por fluxo. Não é possível ter mais de um componente com o mesmo ID.

O ID do Componente não pode conter espaços, deve iniciar com número e pode conter apenas letras sem acentos, números e o caractere _.

• Nome: Rótulo opcional para identificar o componente visualmente no canvas.
• Host: Obrigatório. IP ou hostname do Redis
• Porta: Obrigatório. Porta do Redis
• Secret senha: Secret do tipo "Senha" que será usada para conexão com Redis. Deve ser cadastrada no Dhuo, na seção "Secrets"
• Método: Obrigatório. Opções: HashExists, HashGet, HashGetAll, HashSet, HashDel. Método que será executado no Redis.
• Chave (Tmpl): Obrigatório. Chave única identificadora do registro no Redis
• Field (Tmpl): Obrigatório para HashGet, HashSet, HashExists, HashDel. Campo que será utilizado dentro da chave
• Converter retorno: Obrigatório para HashGet e HashGetAll. Quando selecionado "Sim", o Dhuo armazenará o body de retorno da API em um objeto que será acessível em outros componentes (Ex: ). Quado selecionado "Não", o Dhuo armazenará o body de retorno da API em formato String não acessível em outros componentes.
• Valor (Tmpl): Obrigatório para HashSet. Valor que será gravado no registro do Redis
• Tempo de expiração TTL (segundos): Opcional. Tempo de vida do registro no Redis

Saída

Após a execução do componente, uma estrutura chave-valor será gerada com os dados de saída. Os dados podem ser acessados pelo contexto de execução em outros componentes em etapas posteriores do fluxo a partir da sintaxe .id_do_componenteOut.atributo_da_estrutura, onde:

• id_do_componente: valor configurado do parâmetro ID do Componente
• Out: sufixo padrão obrigatório
• atributo_da_estrutura: atributo retornado na estrutura chave-valor de saída da execução do componente

Atenção!

Caso ocorra algum erro durante a execução do componente, a estrutura chave-valor de saída não é gerada.

Aqui estão os atributos gerais da estrutura de saída do componente:

• exists: Booleano indicando a existência do registro no Redis. Disponível para a operação HashExists.
• status: Mensagem indicado o resultado da execução do método. Tem valor fixo para cada cenário. Vide exemplos. Disponível para o métodos HashGet, HashSet, HashGetAll, HashDel.
• Para a operação HashGet, caso exista registro correspondente à chave, o registro será retornado diretamente na estrutura de saída.
• Para a operação HashGetAll, caso existam registros correspondentes à chave, uma lista (array) será retornada diretamente na estrutura de saída com todos os registros correspondentes.

Exemplo - método HashExists:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "exists": true
  }
}

Exemplo - métodos HashGet, HashGetAll, HashDel - registro não encontrado:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "notFound"
  }
}

Exemplo - método HashGet - registro encontrado:

// ID do Componente: redisStep
{
  "redisStepOut": "user"
}

Exemplo - método HashGetAll - registro encontrado:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "user": "John Doe",
    "email": "john.doe@dhuo.io"
  }
}

Exemplo - método HashSet - registro inserido sem TTL:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "inserted"
  }
}

Exemplo - método HashSet - registro inserido com TTL:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "inserted and expire setted"
  }
}

Exemplo - método HashSet - registro atualizado sem TTL:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "updated"
  }
}

Exemplo - método HashSet - registro atualizado com TTL:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "updated and expire setted"
  }
}

Exemplo - método HashDel - registro apagado:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "deleted"
  }
}

Exemplo - método HashDel - erro não identificado:

// ID do Componente: redisStep
{
  "redisStepOut": {
    "status": "error_code"
  }
}