Conector copo de nieve

Consulta información de Snowflake para utilizarla con aplicaciones Tulip

El conector Snowflake agiliza la consulta de información desde Snowflake Data Cloud. La documentación de la API REST SQL de Snowflake se puede encontrar aquí.

Contacto de soporte

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

Notas sobre el conector

El conector Snowflake puede manipular registros individuales con relativa facilidad. Pueden ser necesarios widgets personalizados para consultar varias filas de datos o manipular salidas en Tulip (tabla interactiva, 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.

Registrar Tulip como aplicación cliente en Snowflake

1. Inicie sesión en su instancia de Snowflake con un usuario que tenga el rol/privilegio de crear y gestionar Integraciones de Seguridad (ACCOUNTADMIN).
2. Cree una nueva hoja de cálculo SQL en el almacén COMPUTE_WH.
3. 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 = OAUTHENABLED = TRUEOAUTH_CLIENT = CUSTOMOAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDIRECT_URI = 'https://<NOMBRE_INSTANCIA_TULIPANICA>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Nota: La validez del token de actualización puede ser de hasta 1 día (86400 segundos).

Recopilar detalles para la configuración de OAuth en Tulip

1. Ejecuta los siguientes comandos para describir la Integración de Seguridad que acabas de crear yDESCRIBE SECURITY INTEGRATION ;
2. Escribe los siguientes detalles:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Ejecutar:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>');

debe ser completamente capitilisede.g no tulip_intergation pero TULIP_INTEGRATION

1. Escriba:OAUTH_CLIENT_SECRET

Configura tu conector Snowflake

1. Entra en Tulip y añade el Snowflake Connector desde la librería de Tulip (Web o Embedded).
2. Haz clic en el entorno de producción
3. Configura los siguientes parámetros:

Running On: Cloud Connector HostServer address: La url del servidor de tu cuenta Snowflake en formato .snowflakecomputing.comRuta base: api/v2AuthenticationSeleccione OAuthAuthorization code URL - OAUTH_AUTHORIZATION_ENDPOINT del paso 2Access token URL - OAUTH_TOKEN_ENDPOINT del paso 2Client ID - OAUTH_CLIENT_ID del paso 2Client Secret - OAUTH_CLIENT_SECRET del paso 2Seleccione las casillas de verificación paraSend authentication headerEncode client ID during authentication.

1. 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.

1. Después de la autenticación con éxito, aparecerá un mensaje para el consentimiento. Léalo atentamente para comprender la operación que se está realizando y, a continuación, haga 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 obtener una demostración práctica de cómo utilizar el conector para tareas como: 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 datosDescripción: Permite enviar una o varias sentencias SQL para su ejecución.Método: POSPunto final: /api/v2/statementsReferencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Comprobar estado de consultaDescripción: Permite comprobar el estado de ejecución de una sentencia.Método: GETEndpoint: /api/v2/statements/{statementHandle}Referencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancelar ConsultaDescripción: Permite cancelar la ejecución de una sentencia.Método: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReferencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Referencias adicionales

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