Skip to main content

Snowflake

Requisitos de configuración del controlador

Para procesamiento en base de datos y para evitar errores al escribir datos con la herramienta Datos de salida , especifica un almacén (warehouse), un esquema (schema) y una base de datos (database) en el controlador.

Tipo de soporte

Lectura y escritura; en base de datos.

Se validó en

Versión de base de datos: 6.8.1

Versión de cliente de ODBC: 3.0.0.1001 64 bits

Herramientas de Alteryx utilizadas para establecer conexiones

Standard Workflow Processing

Output Data Tool Icon Herramienta Datos de salida

Procesamiento de flujos de trabajo en base de datos

Herramienta Datos de entrada

  1. Selecciona la herramienta Datos de entrada y dirígete al panel Datos de entrada (1) - Configuración > Abre el menú desplegable en Conectar un archivo o una base de datos .

  2. Ve a la ventana Conexiones de datos > Todas las fuentes de datos > Snowflake > ODBC .

  3. En la ventana emergente Conexión ODBC de Snowflake , ingresa tu nombre de usuario y contraseña .

  4. En la ventana Elegir tabla o especificar consulta , selecciona la pestaña Tablas > Selecciona una Tabla > Selecciona Aceptar .

Modo clásico

Si prefieres trabajar con el Modo clásico , ve a Opciones > Configuración del usuario > Editar la configuración del usuario > Selecciona la casilla de verificación Usar el modo clásico para el menú de opciones de las herramientas de Entrada/Salida .

  1. Para especificar una consulta, selecciona la pestaña Editor de SQL > Escribe la consulta en el espacio disponible > Selecciona el botón Consulta de prueba > Selecciona Aceptar .

  2. Selecciona la herramienta Datos de salida y ve al menú > Opciones .

  3. Selecciona Configuración del usuario > Editar la configuración del usuario > Selecciona la casilla de verificación Usar el modo clásico para el menú de opciones de las herramientas de Entrada/Salida .

  4. Ve al panel Datos de salida (1) - Configuración > En Escribir en archivo o base de datos > Selecciona el menú desplegable .

  5. Selecciona Otras bases de datos > Selecciona Carga masiva de Snowflake…

  6. También puedes utilizar la herramienta Datos de entrada (modo clásico) para seleccionar los archivos y las fuentes de datos.

Si quieres cambiar al Modo clásico , sustituye la herramienta Datos de salida por una nueva herramienta > Selecciona el lienzo o presiona F5 para actualizar.

Herramienta Datos de salida

Para admitir totalmente la lectura y escritura de tablas y columnas, establece la opción Estilo de SQL de tabla/nombre del campo de Alteryx Designer en Entre comillas . Con esta opción, se seleccionará específicamente la tabla en la base de datos y, si seleccionas Ninguno , se generarán resultados en mayúsculas.

Revisa los siguientes puntos antes de configurar una conexión masiva de Snowflake:

  • Solo puedes escribir datos con el cargador masivo de Snowflake.

  • Después de escribir los datos en la nueva salida, el cargador masivo de Snowflake elimina los datos escritos del depósito S3.

  • La longitud máxima permitida para los campos de texto es de 16 777 216 bytes.

Para obtener más información, ve a la documentación de Snowflake .

Nota

A partir de la versión 2023.2, Designer cancela todas las ejecuciones en base de datos no completadas al cancelar el flujo de trabajo localmente. Esto te permite desbloquear tus pipelines de datos. La característica mejora la interacción general de la base de datos.

Configurar una conexión ODBC

  1. En el Administrador de origen de datos ODBC , selecciona el controlador de Snowflake y selecciona Configurar .

  2. Ingresa tu configuración de conexión y las credenciales.

  3. Selecciona Aceptar para guardar la conexión.

Nota

Para admitir totalmente la lectura y escritura de tablas y columnas con camel case, se debe establecer la opción Estilo de SQL de tabla/nombre del campo de Alteryx Designer en Entre comillas .

JWT de Snowflake para la autenticación con par de claves

Con la versión 2024.1 es más fácil que nunca usar la autenticación de archivo de claves (JWT) para Snowflake en Alteryx Designer con DCM. Simplemente selecciona tu conexión de Snowflake y busca la autenticación de par de claves de la lista de fuentes de datos disponibles.

Para configurar un JWT de Snowflake a través del controlador ODBC:

  1. Crea el token según las instrucciones de Snowflake, sigue estos pasos: https://docs.snowflake.com/en/user-guide/key-pair-auth.html.

  2. Establece el Autenticador en el DSN de ODBC en SNOWFLAKE_JWT.

    Snowflake JWT

  3. En Alteryx, la cadena de conexión tiene que apuntar a la ubicación del archivo, por ejemplo: odbc:DSN=Simba_Snowflake_JWT;UID=user;PRIV_KEY_FILE=G:\AlteryxDataConnectorsTeam\OAuth project\PEMkey\rsa_key.p8;PRIV_KEY_FILE_PWD=__EncPwd1__;JWT_TIMEOUT=120

    Para obtener más instrucciones, consulta la documentación de Snowflake .

Para obtener más información sobre cómo configurar la autenticación de JWT de Snowflake para tu cuenta de Snowflake, consulta la documentación de Snowflake .

Configurar una conexión masiva de Snowflake para escribir datos

La carga masiva se admite para conexiones que utilizan DSN y conexiones sin DSN.

Para configurar el cargador masivo con una cadena de conexión sin DSN, construye la cadena de conexión de forma manual. La cadena tiene que contener los parámetros necesarios para escribir en Snowflake y los necesarios para el entorno de ensayo. Los parámetros necesarios para Snowflake se pueden encontrar en la documentación de Snowflake . Los parámetros necesarios para el entorno de ensayo se pueden encontrar a continuación.

  • Ejemplo de cadena de conexión: snowbl:Driver= {SnowflakeDSIIDriver};Server=customerinstance.snowflakecomputing.com;Database=TEST_DB; Warehouse=TEST_WAREHOUSE;schema=PUBLIC;UID=user;PWD=password;Bucket=S3Bucket; Access=IAMAccessKey;Secret=IAMSecretKey;URL=s3.amazonaws.com;Region=us-east-1

Para configurar el cargador masivo con un DSN, usa la interfaz de usuario y sigue los pasos a continuación:

  1. Selecciona la herramienta Datos de salida y ve al panel Datos de salida (1) - Configuración .

  2. En Escribir en archivo o base de datos , selecciona el menú desplegable > Ve a la ventana Conexiones de datos para seleccionar la pestaña Fuentes de datos > Todas las fuentes de datos > Snowflake > Selecciona Masivo .

  3. En la ventana Conexión masiva de Snowflake , selecciona la pestaña Local > Ingresa tus credenciales en los espacios Nombre de usuario (opcional) y Contraseña (opcional) > Selecciona Aceptar para ver la ventana emergente Tabla de salida .

  4. Escribe el nombre de la tabla (u hoja de trabajo) para el archivo de salida especificado, ya sea con el nombre de la tabla o con el formato  db.schema.tablename : Esta es tu tabla completamente calificada.

  5. Bajo Opciones en el panel Datos de salida (1) - Configuración , selecciona en el menú desplegable Estilo de SQL de tabla/nombre del campo Entre comillas o Ninguno .

  6. En Tomar nombre de archivo/tabla del campo , decide si quieres seleccionar la casilla de verificación para ver el menú desplegable Anexar sufijo al nombre del archivo o de la tabla . Si seleccionas la casilla de verificación, elige entre las siguientes opciones:

    1. Anexar sufijo al nombre del archivo o de la tabla.

    2. Anteponer el prefijo al nombre del archivo y/o de la tabla.

    3. Cambiar el nombre del archivo/tabla

    4. Cambiar toda la ruta del archivo.

  7. Si seleccionas la casilla de verificación Anexar sufijo al nombre del archivo o de la tabla , en Campo que contiene el nombre del archivo o parte del nombre del archivo , selecciona una de las siguientes opciones:

    1. SEQUENCE_CATALOG

    2. SEQUENCE_SCHEMA

    3. SEQUENCE_NAME

    4. SEQUENCE_OWNER

    5. DATA_TYPE

    6. NUMERIC_PRECISION

    7. NUMERIC_PRECISION_RADIX

    8. NUMERIC_SCALE

    9. START_VALUE

    10. MINIMUM_VALUE

    11. MAXIMUM_VALUE

    12. NEXT_VALUE

    13. INCREMENT

    14. CYCLE_OPTION

    15. CREATED

    16. LAST_ALTERED

    17. COMMENT

  8. Decide si quieres seleccionar la casilla de verificación Conservar campo en la salida para la opción que has seleccionado en el menú desplegable a fin de utilizarla con los datos de la tabla.

Métodos para organizar datos en etapas con una conexión masiva de Snowflake

Configura una conexión masiva de Snowflake para escribir en Amazon S3

  1. En la ventana Datos de salida - Configuración , selecciona Escribir en archivo o base de datos y selecciona Otras bases de datos > Carga masiva de Snowflake para mostrar la ventana Conexión masiva de Snowflake .

  2. Selecciona un Nombre de la fuente de datos o selecciona Administrador de ODBC para crear uno. Consulta Conexiones de base de datos ODBC y OLEDB .

  3. Ingresa un Nombre de usuario y una Contraseña , según corresponda.

  4. En Amazon S3 , ingresa tu clave de acceso de AWS y tu clave secreta de AWS .

  5. En Cifrado de clave secreta , selecciona una opción de cifrado:

    • Ocultar : oculta la contraseña mediante un cifrado mínimo.

    • Cifrar para la maquina : cualquier usuario del equipo tiene acceso completo a la conexión.

    • Cifrar para el usuario : el usuario que ha iniciado la sesión tiene acceso completo a la conexión en cualquier computadora.

  6. En Punto de conexión , selecciona una de las siguientes opciones:

    • Default (predeterminado) : Amazon determina el punto de conexión según el bucket seleccionado.

    • Punto de conexión específico : para especificar una región S3 en la que reside el depósito, especifica un punto de conexión personalizado o selecciona uno de los puntos de conexión ingresados anteriormente.

      • El depósito S3 debe estar en la región S3 especificada. De lo contrario, se muestra un error que explica que el bucket al que estás intentando acceder debe tener el punto de conexión especificado en la dirección. Envía todas las solicitudes futuras a este punto de conexión.

      • Selecciona Default (predeterminado) para cerrar la ventana de error.

  7. (Opcional) Selecciona Utilizar Signature V4 para la autenticación para aumentar el nivel de seguridad más allá de Signature Version 2 predeterminado. Esta opción se activa automáticamente para las regiones que requieren la versión Signature V4. Las regiones creadas después del 30 de enero de 2014 solo admiten Signature Version 4. Las siguientes regiones requieren autenticación de Signature Version 4:

    • Región del este de los EE. UU. (Ohio)

    • Región de Canadá (central)

    • Región de Asia Pacífico (Mumbai)

    • Región de Asia Pacífico (Seúl)

    • Región de la UE (Frankfurt)

    • Región de la UE (Londres)

    • Región de China (Beijing)

  8. Selecciona un método de Cifrado en el lado del servidor para subir a un depósito de Amazon S3 cifrado. Consulta la Guía para el desarrollador del servicio de almacenamiento simple de Amazon.

    • Ninguno (predeterminado) : no se utiliza ningún método de cifrado.

    • SSE-KMS : utiliza la encriptación del servidor con las claves administradas por AWS KMS. También puedes proporcionar un Id. de clave de KMS . Al seleccionar este método, la opción Usar la firma V4 para la autenticación está habilitada de forma predeterminada.

  9. Ingresa el Nombre del bucket del bucket de AWS en el que se almacenan los objetos de datos.

  10. Configura Opciones de formato de archivo adicionales en el panel Datos de salida (1) - Configuración . Consulta Opciones de formato de archivo .

Configurar una conexión masiva de Snowflake para escribir en el almacenamiento local

Ahora tienes tres opciones mejoradas para elegir cuando organizas en etapas los datos en tu unidad local.

Selecciona la herramienta Datos de salida y ve al panel Datos de salida (1) - Configuración > En Escribir en archivo o base de datos , ve a la ventana Conexiones de datos y selecciona la pestaña Fuentes de datos > Todas las fuentes de datos > Snowflake > Selecciona Masivo . En la ventana Conexión masiva de Snowflake > Selecciona la pestaña Local >

  1. Etapa de usuario : Etapa interna proporcionada por Snowflake, asociada con el usuario.

    1. Selecciona Usuario > Selecciona Aceptar . En la ventana emergente Tabla de salida , escribe el nombre de la tabla (u hoja de trabajo) para el formato de archivo de salida especificado con el nombre de la tabla o con el formato  db.schema.tablename : Esta es tu tabla completamente calificada. Selecciona Guardar . Bajo Opciones en el panel Datos de salida (1) - Configuración , selecciona en el menú desplegable de Estilo de SQL de nombre de tabla/campo Entre comillas o Ninguno .

  2. Etapa de tabla : Etapa interna proporcionada por Snowflake, asociada con la tabla.

    1. Selecciona Etapa de tabla > Selecciona Aceptar . En la ventana emergente Tabla de salida , escribe el nombre de la tabla (u hoja de trabajo) para el formato de archivo de salida especificado con el nombre de la tabla o con el formato  db.schema.tablename : Esta es tu tabla completamente calificada. Selecciona Guardar . Bajo Opciones en el panel Datos de salida (1) - Configuración , selecciona en el menú desplegable de Estilo de SQL de nombre de tabla/campo Entre comillas o Ninguno .

      1. Etapa interna nombrada : En la base de datos de Snowflake , crea y ejecuta un comando CREATE STAGE y proporciona el nombre de la etapa a la configuración de la herramienta.

        Nota

        El tamaño máximo del campo es 16 MB. Si se supera el umbral de tamaño del campo, se producirá un error y no se escribirán los datos.

  3. Tipo de compresión : Las opciones son “Sin compresión” o “Comprimir con GZip”.

    1. Sin compresión: Los archivos se almacenan y se cargan como CSV

    2. Comprimir con GZip: los archivos CSV se comprimen con GZIP

  4. Tamaño del trozo en MB (de 1 a 999) : Esta opción te permite seleccionar el tamaño de cada CSV que se organiza localmente.

    Nota

    El tamaño real del archivo puede variar con respecto al tamaño del trozo seleccionado debido al formato y la compresión subyacentes.

  5. Número de subprocesos (de 1 a 99) : esta opción especifica la cantidad de subprocesos que se utilizarán para cargar archivos a Snowflake. El rendimiento puede mejorar en archivos más grandes cuando se aumenta este valor. Si se ingresa 0, se utilizará el valor predeterminado por Snowflake (4).

Desde la etapa, cada copia en la tabla puede contener hasta 1000 archivos. Si hay más de 1000 archivos en la etapa, es posible que veas varias copias en instrucciones. Es un requisito de Snowflake para copiar en instrucciones usando archivos. Para obtener más información, consulta el portal de Snowflake .

Puedes encontrar más información sobre las opciones de Tipo de compresión, Tamaño de trozos en MB y Número de subprocesos en el portal de Snowflake .

En esta sección: