Extraer datos de la tarea Snowflake

Acerca de la tarea Extraer datos de Snowflake

Snowflake es un software en la nube de datos de terceros que se utiliza para almacenar, mantener y compartir datos. Puede importar datos de Snowflake para utilizarlos en un flujo de trabajo de Qualtrics.

Integración con Snowflake

Para utilizar esta tarea, debe crear una nueva integración en Snowflake y conectarla a Qualtrics.

Configuración en Snowflake

1. Inicie sesión en Snowflake.
2. En la ficha Hojas de cálculo, haga clic en el signo más ( + ) y seleccione Hoja de cálculo SQL.
3. Pegue el siguiente código en la hoja de cálculo:
   

   
   CREATE SECURITY 
   
   INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect'
   
    ENABLED = TRUE
   
    OAUTH_ISSUE_RE76O76T_URI =''ENABLED = TRUE OAUTH_ISSUE_RE76O76FRESH_VAL_REKABLED = TRUE
   
    OAUTH_ISSUE_RE76O76FRESH_TOFRESH_VAL_REKENUE

4. Sustituya la línea en negrita QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 por un nombre para la integración. Utilice solo letras, números y guiones bajos para el nombre de integración.
   
   Consejo Q: Copie su nombre de integración, ya que lo necesitará más tarde para completar la configuración. Snowflake pondrá todas las letras en mayúsculas automáticamente en su nombre de integración. Por ejemplo, si nombre mi integración como “Qualtrics_Integration”, se guardará como “QUALTRICS_INTEGRATION” en Snowflake. Este es el nombre que debería guardar para más adelante.
5. Reemplace el publicapist3 en negrita con información sobre su marca. Esta información será diferente en función de si desea configurar una conexión individual dentro del propio flujo de trabajo o una conexión de toda la cuenta en la ficha Administración.
   • Si crea una conexión individual, reemplácela con su brandID.
     Ejemplo: Si mi brandID es “dsx”, mi valor actualizado es https://dsx.qualtrics.com/oauth-client-service/redirect’
   • Si crea una conexión de toda la cuenta, sustitúyala por su datacenterID.
     Ejemplo: Si mi datacenterID es “iad1”, mi valor actualizado es https://iad1.qualtrics.com/oauth-client-service/redirect’
6. Haga clic en Ejecutar.
7. Recibirá el mensaje “Se ha creado correctamente la integración ‘Nombre de la integración’”.
   
   Consejo Q: Si recibe un error “privilegios insuficientes”, se deben actualizar sus permisos de Snowflake. Consulte esta página de soporte técnico de Snowflake para obtener más información sobre qué autorizaciones son necesarias.
8. En la misma hoja de trabajo, introduzca el siguiente código:

   ​​​​DESCRIBIR INTEGRACIÓN DE SEGURIDAD NAME_OF_SECURITY_INTEGRATION

9. Sustituya la INTEGRACIÓN NAME_OF_SECURITY_INTEGRATION en negrita por su nombre de integración en mayúscula del paso 4.
10. Haga clic en Ejecutar.
11. Se le presentarán varios datos sobre la integración. Copie los valores para los siguientes campos:
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. En la misma hoja de trabajo, introduzca el siguiente código:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS(‘NAME_OF_SECURITY_INTEGRATION’)

13. Sustituya el NAME_OF_SECURITY_INTEGRATION en negrita por su nombre de integración en mayúscula del paso 4.
14. Haga clic en Ejecutar.
15. Copie uno de los valores de secreto de cliente.

Configuración en Qualtrics

1. Si crea una conexión de toda la organización (es decir, una cuenta de Snowflake disponible para todos los usuarios de su licencia de Qualtrics), vaya a la Extensiones de la sección Administrador y busque Extraer datos de la integración de Snowflake.
2. Si crea una conexión individual (es decir, una cuenta de Snowflake solo disponible para usted), vaya a Flujos de trabajo y crear un nuevo flujo de trabajo ETL. Al seleccionar su tarea de extractor, seleccione la tarea Extraer datos de Snowflake.
3. Haga clic en Añadir cuenta si está en la pestaña Administración o en Añadir una cuenta de usuario si está en la tarea de flujo de trabajo. Los pasos restantes son los mismos independientemente de dónde esté configurando su cuenta.
   
4. Asigne un nombre a su cuenta para poder identificarla más adelante.
   
5. Seleccione Código de autorización para la clase de subvención.
6. Introduzca sus detalles de autorización:
   • ID de cliente: El OAUTH_CLIENT_ID que ha copiado en el paso 10 de Configuración en Snowflake.
   • Secreto de cliente: El CLIENT_SECRET que ha copiado en el paso 14 de Configuración en Snowflake.
   • Punto de acceso de token: El OAUTH_TOKEN_ENDPOINT que ha copiado en el paso 10 de Configuración en Snowflake.
   • Punto de acceso de autorización: El OAUTH_AUTHORIZATION_ENDPOINT que ha copiado en el paso 10 de Configuración en Snowflake.
   • Alcances (opcional): puede utilizar alcances para limitar el nivel de acceso. Para la mayoría de los casos de uso, puede dejarlo en blanco.
7. Haga clic en Conectar cuenta.
8. Se abrirá una ventana para que inicie sesión en Snowflake. Introduzca su nombre de usuario y contraseña de Snowflake.
9. Haga clic en Iniciar sesión.

Configuración de una tarea Extraer datos de Snowflake

1. Siga las instrucciones enlazadas para crear un nuevo flujo de trabajo ETL.
2. Para su tarea de workflow, seleccione la tarea Extraer datos de Snowflake.
3. Elija la cuenta de Snowflake que conectó anteriormente.
   
4. Haga clic en Siguiente.
5. Introduzca la siguiente información sobre los datos que desea importar desde Snowflake:
   
   • Patrón de nombre de archivo: una cadena de texto utilizada para identificar los archivos que se van a importar.
     Consejo Q: Recomendamos incluir “Qualtrics” al principio de todos los archivos que desee importar. A continuación, puede introducir “Qualtrics” en este campo para importar todos los archivos relevantes.
   • Directorio de recogida: el directorio Snowflake que contiene los archivos.
     Consejo Q: Si el archivo se encuentra en la etapa base, puede dejar este campo en blanco.
   • Identificador de cuenta: El identificador de cuenta de Snowflake de la base de datos que contiene los archivos que se van a importar.
   • Identificador de base de datos: El identificador de base de datos Snowflake de la base de datos que contiene los archivos que se van a importar.
   • Identificador de esquema: el identificador de esquema Snowflake del esquema que contiene el archivo que se va a importar.
   • Nombre de etapa: El nombre de la etapa Snowflake que contiene los archivos que se van a importar.
6. Si lo desea, active Omitir archivos incorrectos. Cuando está activado, los archivos dañados y los archivos que no coinciden con sus cabeceras se ignoran.
7. Debe cargar un archivo de muestra que contenga el formato general de los datos que desea importar a Qualtrics. Haga clic en Seleccionar archivo y seleccione el archivo en su ordenador.
   Consejo Q: Si es necesario, puede descargar uno de los archivos de muestra enumerados en la ventana de tareas.
8. Haga clic en Cargar.
9. Revise su archivo de muestra para asegurarse de que todo parece correcto.
   Consejo Q: Si necesita cambiar su archivo, haga clic en Atrás en la esquina superior izquierda.
10. Haga clic en Guardar.
11. Seleccione su tarea de cargador, que determina dónde se guardan los datos. Consulte Tareas del cargador disponibles para obtener más información sobre las opciones disponibles.