Saltar al contenido

Conexión a Snowflake

Introducción

Una conexión a Snowflake, creada utilizando 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 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).

Nota

Este conector soporta la Política de organización de Habilitar reautenticación en cambio organization policy. Si está habilitada, un cambio en el Nombre del host, Nombre de usuario, Cuenta o Nombre de la base de datos en esta conexión requiere que los usuarios vuelvan a ingresar la Contraseña para la conexión.

Crear o editar una conexión a Snowflake

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

Una conexión a Snowflake existente se puede editar desde estas ubicaciones:

Configurar una conexión a Snowflake

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

Configuración de conexión de Snowflake

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 la conexión: Ingrese 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 utiliza para identificar el punto final de Snowflake, que se refiere tanto a una conexión específica como a sus actividades.

  • Autenticación: Seleccione el tipo de autenticación, uno de Clave-Pareja, OAuth o Contraseña (Obsoleta):

    • Clave-Pareja: Seleccione esta opción para usar una clave-pareja para la autenticación:

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

      • Nombre de usuario: Ingrese el nombre de usuario de Snowflake.

      • Especificación de clave privada: Seleccione Sin cifrar o Clave cifrada para identificar el tipo de clave privada utilizada.

      • Clave privada: Ingrese la clave privada. Para más información, consulte la documentación de Snowflake sobre Autenticación de clave-pareja y rotación de clave-pareja.

      • Frase de paso: Si se selecciona Clave cifrada para Especificación de clave privada, ingrese la frase de paso asociada con la clave privada cifrada.

    • OAuth: Seleccione esta opción para usar OAuth 2.0 de 3 patas para la autenticación:

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

      • Nombre de usuario: Ingrese el nombre de usuario de Snowflake.

      • Aplicación OAuth: Seleccione una aplicación de conector de Snowflake configurada en la página de Registros de aplicaciones del 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 de Registros de aplicaciones, consulte los requisitos previos de OAuth de 3 patas de Snowflake.

      • Iniciar sesión con Snowflake: Haga clic para autenticarse a través de Snowflake en una pestaña del navegador separada y otorgue consentimiento para que Jitterbit acceda a la aplicación de Snowflake.

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

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

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

        La propiedad TYPE del usuario de Snowflake debe estar configurada como LEGACY_SERVICE y la futura obsolescencia de la autenticación de un solo factor

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

        Acción recomendada del usuario

        Se requiere acción del usuario en dos fases:

        1. Para el 31 de marzo de 2025, la propiedad TYPE de la cuenta de usuario que utiliza para conectarse a Snowflake debe estar configurada como LEGACY_SERVICE para continuar utilizando la autenticación basada en contraseña (consulte Tipos de usuarios). Sin acción del usuario, se espera que las integraciones existentes que utilizan la autenticación de contraseña de un solo factor de Snowflake comiencen a fallar en abril de 2025.

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

  • Cuenta: Ingresa el nombre de la cuenta de Snowflake.

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

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

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

    • Rol: Ingresa el rol de Snowflake. Los roles disponibles son GENERAL, PÚBLICO y SOLO LECTURA.

    • 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 una carga útil de solicitud de Insertar o actividad de Invocar Procedimiento Almacenado.

      Cuando no se selecciona (por defecto), 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.

  • Usar comillas para identificadores de Snowflake: Selecciona esta opción para usar comillas alrededor de los identificadores de Snowflake, como los nombres de las tablas, para preservar su caso en lugar de convertir su caso a mayúsculas, lo que puede causar un error. Por defecto, esta opción está seleccionada.

  • Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. 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 organización Deshabilitar Actualización Automática del Conector.

  • 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, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Siguientes pasos

Después de que se ha creado una conexión de Snowflake, se coloca 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, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Obtener: Recupera un archivo CSV de datos de tabla o vista de Snowflake y está destinado a ser utilizado como fuente en una operación.

  • Consulta: Recupera un archivo CSV de datos de tabla o vista de Snowflake y está destinado a ser utilizado como fuente en una operación.

  • Fusionar: Inserta o actualiza un archivo CSV de datos de tabla en Snowflake y está destinado a ser utilizado como destino en una operación.

  • Invocar procedimiento almacenado: Invoca un procedimiento almacenado creado en Snowflake y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza datos de tabla en Snowflake y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina datos de tabla y datos de vista de Snowflake y está destinado a ser utilizado como destino en una operación.

  • Insertar: Inserta datos de tabla (ya sea como un archivo CSV o directamente mapeados a columnas de una tabla) en Snowflake y está destinado a ser utilizado como destino en una operación.