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 patas 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 (Obsoleto): 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.

      La propiedad TYPE del usuario de Snowflake debe establecerse en LEGACY_SERVICE y futura deprecación de la autenticación de un solo factor

      Snowflake ha anunciado la próxima deprecación de la autenticación de un solo factor, que afecta a las integraciones que se conectan a Snowflake usando una contraseña. Todos los usuarios del conector de Snowflake que usan el tipo de autenticación Contraseña (Obsoleto) se ven afectados.

      Acción recomendada del usuario

      Se requiere acción del usuario en dos fases:

      1. Antes del 31 de marzo de 2025, la propiedad TYPE de la cuenta de usuario que usas para conectarte a Snowflake debe establecerse en LEGACY_SERVICE para continuar usando autenticación basada en contraseña (consulta Tipos de usuarios). Sin acción del usuario, se espera que las integraciones existentes que usan autenticación de contraseña de un solo factor de Snowflake comiencen a fallar en abril de 2025.

      2. Antes de noviembre de 2025, debes actualizar el tipo de autenticación usado para conectarte a Snowflake a OAuth 2.0 o autenticación de par de claves. En este momento, la autenticación basada en contraseña ya no será compatible.

• 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 del 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, coloca el cursor sobre la columna más a la derecha y utiliza 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 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 utilicen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones de 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 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.