Saltar al contenido

Conexión Redis v2

Introducción

Una conexión Redis v2, creada utilizando el conector Redis v2, establece acceso a Redis. Una vez que se configura una conexión, se pueden crear instancias de actividades Redis v2 asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión Redis v2

Una nueva conexión Redis v2 se crea utilizando el conector Redis v2 desde una de estas ubicaciones:

Una conexión Redis v2 existente se puede editar desde estas ubicaciones:

Configurar una conexión Redis v2

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión Redis v2 se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto, y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes de las que elegir.

  • Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Redis v2 y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Redis v2, que se refiere tanto a una conexión específica como a sus actividades.

  • Proveedor: Selecciona el proveedor de la instancia de Redis, uno de REDIS (CLOUD/ON-PREMISE) (predeterminado), AZURE CACHE FOR REDIS o AMAZON ELASTICACHE.

  • Conectar usando: Elige cómo deseas ingresar tu información de conexión:

    • Cadena de conexión: Para esta opción, la conexión se autentica utilizando una cadena de credenciales combinada en formato de protocolo Redis.
    • Formulario: Para esta opción, la conexión se autentica utilizando campos de credenciales distintos.

    Para ambas opciones, los mismos ajustes adicionales aparecen después de sus campos de interfaz de usuario específicos.

Configuración de cadena de conexión

Cuando se selecciona Cadena de conexión para la configuración de Conectar usando, se muestran estos campos:

  • URL de conexión: Ingresa la cadena de conexión completa en formato de protocolo Redis, incluyendo las credenciales necesarias para iniciar sesión. Por ejemplo redis://username:password@host:port o rediss://username:password@host:port si SSL está habilitado.

  • Tipo de implementación: Selecciona el tipo de implementación, uno de NO CLUSTERIZADO (predeterminado), CLUSTERIZADO y SENTINEL.

    • NO CLUSTERIZADO: Selecciona al conectar a una instancia de Redis no clusterizada y no de alta disponibilidad.

    • CLUSTERIZADO: Selecciona al conectar a una instancia de Cluster de Redis. Cuando se selecciona, se muestra una tabla adicional:

      • Ingresa la cadena de conexión de los nodos del Cluster: Haz clic en el ícono de agregar para añadir una fila a la tabla de abajo e ingresa una Cadena de Conexión en formato de protocolo Redis.

        Para guardar la fila, haz clic en el ícono de enviar en la columna más a la derecha.

        Para editar o eliminar una fila única, pasa el cursor sobre la columna más a la derecha y utiliza el ícono de editar o el ícono de eliminar .

        Para eliminar todas las filas, haz clic en Limpiar todo.

    • SENTINEL: Selecciona al conectar a una instancia de Redis Sentinel. Cuando se selecciona, se muestra una tabla adicional:

      • Ingresa la cadena de conexión de los nodos Sentinel: Haz clic en el ícono de agregar para añadir una fila a la tabla de abajo e ingresa una URL de nodo Sentinel en formato de protocolo Redis y ID de Maestro.

        Para guardar la fila, haz clic en el ícono de enviar en la columna más a la derecha.

        Para editar o eliminar una fila única, pasa el cursor sobre la columna más a la derecha y utiliza el ícono de editar o el ícono de eliminar .

        Para eliminar todas las filas, haz clic en Limpiar todo.

Configuración del formulario

Cuando se selecciona Formulario para la configuración de Conectar usando, se muestran estos campos:

  • Nombre de usuario: Ingresa el nombre de usuario para conectarte a la instancia de Redis. Asegúrate de que el usuario asociado tenga permisos suficientes para conectarse e interactuar con la instancia de Redis.

  • Contraseña: Ingresa la contraseña asociada con el Nombre de usuario proporcionado.

  • Tipo de implementación: Selecciona el tipo de implementación, uno de NO CLUSTERIZADO, CLUSTERIZADO y SENTINEL.

    • NO CLUSTERIZADO: Selecciona al conectarte a una instancia de Redis no clusterizada y no de alta disponibilidad. Cuando se selecciona, se muestran los siguientes campos:

      • Host: Ingresa el nombre del host de la instancia de Redis.

      • Puerto: Ingresa el puerto de la instancia de Redis. El puerto predeterminado de Redis es 6379.

    • CLUSTERIZADO: Selecciona al conectarte a una instancia de Redis Cluster. Cuando se selecciona, se muestra una tabla adicional:

      • Ingresa los hosts y puertos de los nodos del Cluster: Haz clic en el ícono de agregar para añadir una fila a la tabla de abajo e ingresa un Host y Puerto.

        Para guardar la fila, haz clic en el ícono de enviar en la columna más a la derecha.

        Para editar o eliminar una sola fila, pasa el cursor sobre la columna más a la derecha y utiliza el ícono de editar o el ícono de eliminar .

        Para eliminar todas las filas, haz clic en Limpiar Todo.

    • SENTINEL: Selecciona al conectar a una instancia de Redis Sentinel. Cuando se selecciona, se muestra una tabla adicional:

      • Ingresa hosts y puertos de los nodos Sentinel: Haz clic en el ícono de agregar para añadir una fila a la tabla de abajo e ingresa un SentinelHost, SentinelPort y Master ID.

        Para guardar la fila, haz clic en el ícono de enviar en la columna más a la derecha.

        Para editar o eliminar una sola fila, pasa el cursor sobre la columna más a la derecha y utiliza el ícono de editar o el ícono de eliminar .

        Para eliminar todas las filas, haz clic en Limpiar Todo.

Configuraciones adicionales

Independientemente de la opción seleccionada para la configuración de Conectar usando, se muestran estos campos:

  • Configuraciones opcionales: Haz clic para expandir configuraciones opcionales adicionales:

    • Habilitar configuración del cliente: Selecciona para mostrar configuraciones de la configuración del cliente de Redis:

      • Tiempo de espera (segundos): Ingresa el valor de tiempo de espera para la conexión del cliente.
      • Base de datos: Ingresa el índice de la base de datos predeterminada a utilizar para la conexión del cliente. El valor predeterminado de Redis es 0.
      • ClientName: Ingresa un nombre de cliente para identificar la conexión del cliente dentro de Redis.
      • SSL: Selecciona para habilitar la encriptación SSL para la conexión del cliente.

    • Habilitar configuración del pool: Selecciona para mostrar configuraciones de la pool de conexiones de Redis:

      • Máximo total: Ingresa el número máximo total de conexiones en el pool. Ingresa -1 para conexiones ilimitadas.
      • Máximo activo: Ingresa el número máximo de conexiones activas en el pool.
      • Máximo inactivo: Ingresa el número máximo de conexiones inactivas en el pool.
      • Mínimo inactivo: Ingresa el número mínimo de conexiones inactivas en el pool.
      • Habilitar LIFO: Selecciona para habilitar el modo de último en entrar, primero en salir (LIFO) para el préstamo de conexiones. Por defecto, se utiliza el modo de primero en entrar, primero en salir (FIFO).
      • Máximo tiempo de espera (milisegundos): Ingresa el tiempo máximo de espera antes de que una conexión esté disponible.
      • Tiempo mínimo inactivo evictable (milisegundos): Ingresa el tiempo mínimo inactivo antes de que las conexiones sean marcadas para desalojo.
      • Número de pruebas por intento de desalojo: Ingresa el número de conexiones a probar para cada intento de desalojo.
      • Tiempo entre intentos de desalojo (milisegundos): Ingresa el tiempo entre intentos de desalojo.
      • Probar al pedir prestado: Selecciona para probar las conexiones antes de que sean tomadas del pool. Habilitar esta configuración puede afectar negativamente el rendimiento.
      • Probar mientras está inactivo: Selecciona para probar las conexiones mientras están inactivas. Tiempo entre intentos de desalojo (milisegundos) debe ser mayor que 0 para que esta configuración funcione como se espera.

  • Prueba: Haz clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Política de Desactivación de Actualización Automática del Conector política de organización.

  • Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión Redis v2, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Establecer: Establece claves en Redis y está destinado a ser utilizado como un destino en una operación.

  • Obtener: Obtiene claves de Redis y está destinado a ser utilizado como una fuente en una operación.

  • Existe: Verifica si las claves existen en Redis y está destinado a ser utilizado como un destino en una operación.

  • Eliminar: Elimina claves de Redis y está destinado a ser utilizado como un objetivo en una operación.

  • Obtener TTL: Obtiene los valores de tiempo de vida (TTL) de las claves de Redis y está destinado a ser utilizado como una fuente en una operación.