Conector copo de nieve

Consulta de información de Snowflake para utilizarla con las aplicaciones de Tulip

Audiencia

Ten en cuenta que la integración con Snowflake es técnica y puede requerir que tu soporte informático cree los objetos, roles y permisos adecuados.

Contacto de soporte

Este conector ha sido creado en colaboración con Spaulding Ridge. Para más información o preguntas, póngase en contacto con Spaulding Ridge en info@spauldingridge.com.

Propósito

El conector Snowflake agiliza la consulta de información de una nube de datos Snowflake. La documentación de la API REST SQL de Snowflake puede encontrarse aquí.

Notas sobre el conector

El conector Snowflake puede manipular registros individuales con relativa facilidad. Pueden ser necesarios widgets personalizados para consultar múltiples filas de datos o manipular salidas en Tulip (tabla intercativa, etc.).

Snowflake OAuth utiliza el servicio OAuth integrado de Snowflake y admite Tulip como cliente personalizado. La documentación de Snowflake OAuth se puede encontrar aquí. Los detalles de configuración del cliente personalizado se pueden encontrar aquí.

Configuración

Esta sección proporciona el procedimiento para configurar un token OAuth desde el servidor OAuth de Snowflake para establecer conectividad con Tulip como cliente, así como los pasos para configurar el conector Snowflake en Tulip.

Paso 1: Registrar Tulip como aplicación cliente en Snowflake

Inicie sesión en su instancia de Snowflake con un usuario que tenga el rol/privilegio para crear y gestionar Integraciones de Seguridad (ACCOUNTADMIN).

Cree una nueva hoja de cálculo SQL en el almacén COMPUTE_WH.

Ejecute el siguiente script para crear una Integración de Seguridad de tipo OAuth. No olvide actualizar los valores de INTEGRATION_NAME, TULIP_INSTANCE_NAME y TIME_IN_SECONDS.

CREATE OR REPLACE SECURITY INTEGRATION <NOMBRE_INTEGRACION> TYPE = OAUTH ENABLED = TRUE OAUTH_CLIENT = CUSTOM OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' OAUTH_REDIRECT_URI = 'https://<NOMBRE_INSTANCIA_TULIPANICA>.tulip.co/oauth-redirect-handler' OAUTH_ISSUE_REFRESH_TOKENS = TRUE OAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Nota: la validez del token de actualización puede ser de hasta 90 días (7776000 segundos).

Paso 2: Recopilar detalles para la configuración de OAuth en Tulip

Ejecuta los siguientes comandos para describir la integración de seguridad que acabas de crear y anota los siguientes detalles: OAUTH_CLIENT_ID OAUTH_REDIRECT_URI OAUTH_AUTHORIZATION_ENDPOINT OAUTH_TOKEN_ENDPOINT OAUTH_CLIENT_SECRET

DESCRIBE LA INTEGRACIÓN DE SEGURIDAD ; SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('');

Paso 3: Configure su conector Snowflake

Inicia sesión en Tulip y añade el conector Snowflake desde la biblioteca de Tulip (Web o Embedded).

Haz clic en el botón "Production & Testing & Development" para editar los detalles de la conexión como se indica a continuación. Puedes encontrar tu SNOWFLAKE_ACCOUNT_NAME en el OAUTH_AUTHORIZATION_ENDPOINT o OAUTH_TOKEN_ENDPOINT del Paso 2.

Haga clic en "Probar" y "Guardar". El conector se conectará.

Paso 4: Edite los detalles de autentificación de su conector Snowflake

Haga clic en el botón "Producción, pruebas y desarrollo" y en el botón "Editar encabezados".

Elija el tipo de autenticación como "OAuth 2 (Admin)" u "OAuth 2 (Operador)" en función de sus necesidades. Puedes encontrar más información sobre esto en la sección Autenticación del artículo Cómo configurar un conector.

Edita los campos de autenticación, usando los detalles del Paso 2: Authorization Code URL = OAUTH_AUTHORIZATION_ENDPOINT Access Token URL = OAUTH_TOKEN_ENDPOINT Client ID = OAUTH_CLIENT_ID Client Secret = OAUTH_CLIENT_SECRET

Haga clic en "Probar". Aparecerá la ventana de inicio de sesión de su cuenta Snowflake.

Debe iniciar sesión un usuario. Tenga en cuenta que su función predeterminada no debe ser ACCOUNTADMIN, SECURITYADMIN ni ORGADMIN. Puede alterar el rol por defecto de los usuarios para OAuth, como se detalla en este recurso de Snowflake: Gestión del consentimiento del usuario para OAuth.

Después de la autenticación con éxito, aparecerá un mensaje para el consentimiento. Por favor, léelo atentamente para entender la operación que se está realizando y haz clic en "Permitir". ¡Ya puedes conectarte de forma segura a Snowflake desde Tulip!

Utilización

Tienes dos opciones para empezar a utilizar el conector:

Comience personalizando las funciones de la plantilla del conector para adaptarlas a sus necesidades específicas.

Siga las instrucciones de la prueba de unidad de Snowflake para una demostración práctica de cómo utilizar el conector para tareas que incluyen: recuperar todos los registros de una tabla Snowflake en Tulip, crear un nuevo registro, actualizar un registro existente y eliminar un registro.

Funciones de plantilla

El conector de biblioteca incluye las siguientes funciones de plantilla: Plantilla: Consultar base de datos Descripción: Permite enviar una o varias sentencias SQL para su ejecución. Método: POST Punto final: /api/v2/statements Referencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements Plantilla: Comprobar estado de consulta Descripción: Le permite comprobar el estado de ejecución de una sentencia. Método: GET Punto final: /api/v2/statements/{statementHandle} Referencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandle Plantilla: Cancelar consulta Descripción: Permite cancelar la ejecución de una sentencia Método: POST Endpoint: /api/v2/statements/{statementHandle}/cancel Referencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Referencias adicionales

Esta guía de la comunidad de Snowflake también proporciona contexto adicional a la integración de Snowflake