Centro de soporte de Workiva

Con el conector Snowflake® JDBC, puedes utilizar comandos en una cadena para realizar operaciones en lenguaje de consulta estructurado (SQL) en bases de datos Snowflake. Por ejemplo, con este conector, puedes:

• Ejecutar comandos SQL, incluida una sentencia CREATE o UPDATE o una consulta SELECT.
• Recuperar detalles sobre una tabla en Snowflake
• Inserta registros en una base de datos de Snowflake

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para habilitar la conexión con el Snowflake, un administrador de seguridad de la org debe primero habilitarla desde Configuración.

El propio conector utiliza la conectividad a bases de datos Java (JDBC), asegurada con autenticación básica o por pares de claves. Para configurar el conector, necesitarás:

• Un usuario de integración designado creado en Snowflake para el conector, además del nombre de usuario y la Contraseña del usuario de integración.
  

  Nota: La Autenticación básica dejará de admitirse a partir de noviembre de 2025. Recomendamos utilizar en su lugar la autenticación por par de claves. Obtén más información.

• (Opcional) Un archivo de clave privada para permitir la autenticación de pares de claves .
• La URL de la conexión JDBC, como jdbc:snowflake://[accountName].snowflakecomputing.com/?[options]
• Para conectarte a una base de datos Snowflake local, a GroundRunner para la conexión. (Para conectarte a una instancia de Snowflake en la nube, utiliza el CloudRunner predeterminado).

Establece el conector Snowflake

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. En Conector Conexión, selecciona Snowflake JDBC y el corredor para utilizar la conexión.
   
3. En Información básica, introduce un nombre único y una descripción para ayudar a identificar la conexión.
4. (Opcional) En Recursos, sube tu archivo de clave privada. Tendrás que introducir este nombre exacto de archivo en el campo "Archivo de clave privada" en el paso siguiente.
5. En Propiedades, introduce los datos del conector:
   
   

   Propiedad	Detalles
   Nombre de usuario	Introduce el nombre de usuario con el que te vas a autentificar. Si se proporciona un archivo de clave privada a continuación, se autenticará automáticamente con este nombre de usuario.
   Contraseña	Introduce la Contraseña para la propiedad Nombre de usuario. Si a continuación se proporciona un archivo de clave privada, introduce la contraseña aquí. Tecla: Dejar en blanco para los archivos clave no encriptados.
   URL de conexión	Introduce la URL de la conexión JDBC, como jdbc:snowflake://[accountName].snowflakecomputing.com/. Para incluir propiedades opcionales para la conexión, añádelas como cadena de consulta. Por ejemplo, para que se agote automáticamente el tiempo de espera de un inicio de sesión si no se conecta en un minuto, añade ?loginTimeout=60.
   Archivo privado de claves.	(Opcional) Se utiliza para la autenticación con la clave pública del servidor. El Nombre de usuario y la Contraseña deben introducirse en los Campos de arriba. Más información:: Autenticación y rotación de pares de claves Nota: El nombre del archivo debe coincidir con un archivo cargado como recurso de conexión.

   Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256. Por motivos de seguridad, evita incluir las credenciales de usuario como propiedades opcionales dentro de la propiedad URL de conexión.

6. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
7. Para probar la conexión, crea y ejecuta una cadena con el comando Obtener definición de tabla del conector, y comprueba que devuelve un resultado válido.

Solución de problemas

• Si falla la conexión con Snowflake:
  • Verifica las credenciales de autenticación.
  • Si utilizas la autenticación por par de claves, asegúrate de que el nombre de archivo subido a través de Recursos clave coincide con el nombre de archivo introducido en el campo Archivo de clave privada.
  • Comprueba la URL de la conexión JDBC, incluyendo su nombre de cuenta.
  • Si te conectas a una base de datos local, comprueba el GroundRunner seleccionado para el conector.
• Si la conexión no ejecuta un comando, verifica que sus entradas, como su sintaxis SQL o su tabla, son válidas.
• Si un comando de Snowflake falla con el mensaje de error La solicitud entrante con IP/Token XX.XX.XX.XX no tiene permiso para acceder a Snowflake, consulta este artículo de Snowflake para obtener orientación sobre cómo añadir la dirección IP requerida (ya sea CloudRunner o GroundRunner) a la lista de IP permitidas en tu instancia de Snowflake.