Conexión de Snowflake en Jitterbit Studio

Introducción

Una conexión de Snowflake, creada mediante el conector de Snowflake, establece acceso a Snowflake. Una vez que se configura una conexión, se pueden crear instancias de actividades de Snowflake asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Snowflake

Se crea una nueva conexión de Snowflake usando el conector de Snowflake desde una de estas ubicaciones:

• La pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Design component palette).
• La página Global Endpoints (consulta Create a global endpoint en Global Endpoints).

Se puede editar una conexión de Snowflake existente desde estas ubicaciones:

• La pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Design component palette).
• La pestaña Components del panel del proyecto (consulta Component actions menu en Project pane Components tab).
• La página Global Endpoints (consulta Edit a global endpoint en Global Endpoints).

Configurar una conexión de Snowflake

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Snowflake.

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

• Authentication: Selecciona el tipo de autenticación, uno de Key-Pair, OAuth u Password (Deprecated):

  • Key-Pair: Selecciona esta opción para usar un par de claves para la autenticación:

    • Host name: Ingresa el nombre de host de Snowflake. Este es el nombre de cuenta de Snowflake (como example-account123) y el nombre de dominio de Snowflake snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

    • User name: Ingresa el nombre de usuario de Snowflake.

    • Private key specification: Selecciona Unencrypted o Encrypted key para identificar el tipo de clave privada utilizada.

    • Private key: Ingresa la clave privada. Para obtener más información, consulta la documentación de Snowflake sobre Key-pair authentication and key-pair rotation.

    • Passphrase: Si se selecciona Encrypted key para Private key specification, ingresa la frase de contraseña asociada con la clave privada cifrada.

  • OAuth: Selecciona esta opción para usar OAuth 2.0 de tres pasos para la autenticación. Para notas importantes sobre el comportamiento del token de acceso y el token de actualización, consulta Important notes.

• Nombre de host: Ingresa el nombre de host de Snowflake. Este es el nombre de cuenta de Snowflake (como example-account123) y el nombre de dominio de Snowflake snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

  -   **Nombre de usuario:** Ingresa el nombre de usuario de Snowflake.
  
  -   **Aplicación OAuth:** Selecciona una aplicación de conector de Snowflake configurada en la página [Registros de aplicaciones](/es/management-console/customizations/customizations-app-registrations/) de la Consola de administración. Para obtener más información sobre cómo configurar una aplicación de conector de Snowflake en la página **Registros de aplicaciones**, consulta los [requisitos previos de OAuth de 3 etapas](/es/integration-studio/design/connectors/snowflake/prerequisites/) de Snowflake.
  
  -   **Iniciar sesión con Snowflake:** Haz clic para autenticarte a través de Snowflake en una pestaña del navegador separada y proporciona consentimiento para que Jitterbit acceda a la aplicación de Snowflake.
  

  • Contraseña (Obsoleta): Selecciona esta opción para usar una contraseña para la autenticación:

    • Nombre de host: Ingresa el nombre de host de Snowflake. Este es el nombre de cuenta de Snowflake (como example-account123) y el nombre de dominio de Snowflake snowflakecomputing.com concatenados, como example-account123.snowflakecomputing.com.

    • Nombre de usuario y Contraseña: Ingresa el nombre de usuario y la contraseña de Snowflake.

      Snowflake está descontinuando la autenticación de contraseña de un solo factor

      Snowflake está eliminando gradualmente la autenticación de contraseña de un solo factor para todos los usuarios, incluidas las cuentas de servicio de tipo LEGACY_SERVICE requeridas para este tipo de autenticación Contraseña (Obsoleta). El despliegue se aplica en fases:

      • Entre mayo y julio de 2026, no se podían crear nuevas cuentas LEGACY_SERVICE; las existentes aún no se veían afectadas.
      • Entre agosto y octubre de 2026, Snowflake migra todas las cuentas LEGACY_SERVICE restantes a TYPE=SERVICE de forma gradual por cuenta, notificando a cada cuenta su fecha de aplicación específica dentro de esta ventana. Una vez migrada, una cuenta TYPE=SERVICE ya no puede autenticarse con una contraseña.

      Si tu cuenta de Snowflake se ve afectada, las conexiones que usan este tipo de autenticación fallan. Actualiza la conexión para usar autenticación OAuth o Par de claves en su lugar, y configura la cuenta de usuario de Snowflake para que coincida.

• Cuenta: Ingresa el nombre de cuenta de Snowflake.

• Nombre de base de datos: Ingresa el nombre de la base de datos de Snowflake.

• Nombre de esquema: Ingresa el nombre del esquema de Snowflake.

• Configuración opcional: Haz clic para expandir la configuración opcional adicional:

  • Rol: Ingresa el rol de Snowflake. Los roles disponibles son GENERAL, PUBLIC y READONLY.

  • Nombre de almacén: Ingresa el nombre del almacén de Snowflake.

  • Escapar caracteres especiales: Cuando se selecciona, un carácter de comilla simple (') se escapa (\') cuando está presente en la carga útil de solicitud de una actividad Insertar o Invocar procedimiento almacenado.

    Cuando no se selecciona (predeterminado), y un carácter de comilla simple (') está presente en una carga útil de solicitud, se devuelve un error de sintaxis en tiempo de ejecución.

  • Propiedades personalizadas de conexión: Haz clic en el icono de agregar para agregar una fila a la tabla asociada e ingresa una Clave y un Valor para una propiedad personalizada correspondiente a un parámetro de conexión JDBC de Snowflake. De forma predeterminada, se define una fila para JDBC_QUERY_RESULT_FORMAT con un valor de JSON.

    Para guardar la fila, haz clic en el icono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, colócate sobre la columna más a la derecha y usa el icono de edición o el icono de eliminación .

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

• Usar comillas para identificadores de Snowflake: Selecciona esta opción para entrecomillar identificadores de Snowflake como nombres de tablas y columnas en el SQL que genera el conector. Las comillas preservan la capitalización de un identificador en lugar de convertirlo a mayúsculas, lo que puede causar un error, y permiten identificadores que contienen caracteres especiales como un guión, que Snowflake rechaza como sintaxis inválida cuando no están entrecomillados. Por defecto, esta opción está seleccionada.

• Probar: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes del grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector mediante la política de organización Desactivar actualización automática del conector.

• Guardar: 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 (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de crear una conexión de Snowflake, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones de menú de una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Get: Recupera un archivo CSV de datos de tabla o vista de Snowflake y está diseñado para usarse como origen en una operación.

• Query: Recupera un archivo CSV de datos de tabla o vista de Snowflake y está diseñado para usarse como origen en una operación.

• Query v2: Recupera un archivo CSV de datos de tabla o vista en múltiples esquemas de Snowflake y está diseñado para usarse como origen en una operación.

• Merge: Inserta o actualiza un archivo CSV de datos de tabla en Snowflake y está diseñado para usarse como destino en una operación.

• Invoke Stored Procedure: Invoca un procedimiento almacenado creado en Snowflake y está diseñado para usarse como destino en una operación.

• Update: Actualiza datos de tabla en Snowflake y está diseñado para usarse como destino en una operación.

• Delete: Elimina datos de tabla y vista de Snowflake y está diseñado para usarse como destino en una operación.

• Insert: Inserta datos de tabla (ya sea como archivo CSV o asignados directamente a columnas de una tabla) en Snowflake y está diseñado para usarse como destino en una operación.