Conexão Redis v2 (Beta)

Introdução

Uma conexão Redis v2 (Beta), criada usando o conector Redis v2 (Beta), estabelece acesso ao Redis. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades Redis v2 (Beta) associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão Redis v2 (Beta)

Uma nova conexão Redis v2 (Beta) é criada usando o conector Redis v2 (Beta) a partir de uma destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).

Uma conexão Redis v2 (Beta) existente pode ser editada a partir destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba de Componentes do Painel do Projeto).
• A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).

Configurar uma conexão Redis v2 (Beta)

Cada elemento da interface do usuário da tela de configuração da conexão Redis v2 (Beta) é descrito abaixo.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Redis v2 (Beta) e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Redis v2 (Beta), que se refere tanto a uma conexão específica quanto às suas atividades.

• Provedor: Selecione o provedor da instância Redis, um dos REDIS (CLOUD/ON-PREMISE) (padrão), AZURE CACHE FOR REDIS ou AMAZON ELASTICACHE.

• Conectar usando: Escolha como deseja inserir suas informações de conexão:

  • String de conexão: Para esta opção, a conexão é autenticada usando uma string de credenciais combinadas no formato do protocolo Redis.
  • Formulário: Para esta opção, a conexão é autenticada usando campos de credenciais distintos.

  Para ambas as opções, as mesmas configurações adicionais aparecem após seus campos de interface específicos.

Configurações da string de conexão

Quando String de conexão é selecionada para a configuração Conectar usando, estes campos são exibidos:

• URL de conexão: Insira a string de conexão completa no formato do protocolo Redis, incluindo as credenciais necessárias para fazer login. Por exemplo redis://username:password@host:port ou rediss://username:password@host:port se o SSL estiver habilitado.

• Tipo de implantação: Selecione o tipo de implantação, um dos NÃO CLUSTERIZADO (padrão), CLUSTERIZADO e SENTINEL.

  • NÃO CLUSTERIZADO: Selecione ao conectar-se a uma instância Redis não clusterizada e não de alta disponibilidade.

  • CLUSTERIZADO: Selecione ao conectar-se a uma instância de Cluster Redis. Quando selecionado, uma tabela adicional é exibida:

    • Insira a string de conexão dos nós do Cluster: Clique no ícone de adicionar para adicionar uma linha à tabela abaixo e insira uma String de Conexão no formato de protocolo Redis.

      Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

      Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

      Para excluir todas as linhas, clique em Limpar Tudo.

  • SENTINEL: Selecione ao conectar-se a uma instância de Redis Sentinel. Quando selecionado, uma tabela adicional é exibida:

    • Insira a string de conexão dos nós Sentinel: Clique no ícone de adicionar para adicionar uma linha à tabela abaixo e insira uma URL do Nó Sentinel no formato de protocolo Redis e ID do Master.

      Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

      Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

      Para excluir todas as linhas, clique em Limpar Tudo.

Configurações do formulário

Quando Formulário é selecionado para a configuração Conectar usando, esses campos são exibidos:

• Nome de usuário: Insira o nome de usuário para conectar-se à instância Redis. Certifique-se de que o usuário associado tenha permissões suficientes para conectar-se e interagir com a instância Redis.

• Senha: Insira a senha associada ao Nome de usuário fornecido.

• Tipo de implantação: Selecione o tipo de implantação, um dos NÃO CLUSTERIZADO, CLUSTERIZADO e SENTINEL.

  • NÃO CLUSTERIZADO: Selecione ao conectar-se a uma instância Redis não clusterizada e não de alta disponibilidade. Quando selecionado, os seguintes campos são exibidos:

    • Host: Insira o nome do host da instância Redis.

    • Porta: Insira a porta da instância do Redis. A porta padrão do Redis é 6379.

  • CLUSTERIZADO: Selecione ao conectar-se a uma instância de Cluster Redis. Quando selecionado, uma tabela adicional é exibida:

    • Insira hosts e portas dos nós do Cluster: Clique no ícone de adicionar para adicionar uma linha à tabela abaixo e insira um Host e Porta.

      Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

      Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

      Para excluir todas as linhas, clique em Limpar Tudo.

  • SENTINEL: Selecione ao conectar-se a uma instância de Redis Sentinel. Quando selecionado, uma tabela adicional é exibida:

    • Insira hosts e portas dos nós Sentinel: Clique no ícone de adicionar para adicionar uma linha à tabela abaixo e insira um SentinelHost, SentinelPort e Master ID.

      Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

      Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

      Para excluir todas as linhas, clique em Limpar Tudo.

Configurações adicionais

Independentemente da opção selecionada para a configuração Conectar usando, esses campos são exibidos:

• Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  • Habilitar Configuração do Cliente: Selecione para mostrar as configurações de configuração do cliente Redis:

    

    • Tempo Limite (Segundos): Insira o valor de tempo limite para a conexão do cliente.
    • Banco de Dados: Insira o índice do banco de dados padrão a ser usado para a conexão do cliente. O padrão do Redis é 0.
    • ClientName: Insira um nome de cliente para identificar a conexão do cliente dentro do Redis.
    • SSL: Selecione para habilitar a criptografia SSL para a conexão do cliente.

  • Habilitar Configuração de Pool: Selecione para mostrar as configurações do pool de conexão do Redis:

    

    • Total Máximo: Insira o número máximo total de conexões no pool. Insira -1 para conexões ilimitadas.
    • Ativas Máximas: Insira o número máximo de conexões ativas no pool.
    • Inativas Máximas: Insira o número máximo de conexões inativas no pool.
    • Inativas Mínimas: Insira o número mínimo de conexões inativas no pool.
    • Habilitar LIFO: Selecione para habilitar o modo last-in first-out (LIFO) para o empréstimo de conexões. Por padrão, o modo first-in first-out (FIFO) é utilizado.
    • Máximo de Espera (Milissegundos): Insira o tempo máximo de espera antes que uma conexão esteja disponível.
    • Tempo Mínimo Inativo Evitável (Milissegundos): Insira o tempo mínimo inativo antes que as conexões sejam sinalizadas para evacuação.
    • Número de Testes por Execução de Evacuação: Insira o número de conexões a serem testadas para cada tentativa de evacuação.
    • Tempo Entre Execuções de Evacuação (Milissegundos): Insira o tempo entre as execuções de evacuação.
    • Testar ao Emprestar: Selecione para testar as conexões antes que sejam emprestadas do pool. Habilitar esta configuração pode impactar negativamente o desempenho.
    • Testar Enquanto Inativo: Selecione para testar as conexões enquanto estão inativas. Tempo Entre Execuções de Evacuação (Milissegundos) deve ser maior que 0 para que esta configuração funcione como esperado.

• Testar: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política de organização Desabilitar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede que você confirme que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede que você confirme que deseja excluir a conexão.

Próximos passos

Após uma conexão Redis v2 (Beta) ter sido criada, você coloca um tipo de atividade no canvas de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para detalhes, veja Menus de ações em Conceitos Básicos do Conector.

Estes tipos de atividade estão disponíveis:

• Definir: Define chaves no Redis e é destinado a ser usado como um alvo em uma operação.

• Obter: Obtém chaves do Redis e é destinado a ser usado como uma fonte em uma operação.

• Existe: Verifica se as chaves existem no Redis e é destinado a ser usado como um alvo em uma operação.