Snowflake Obtener actividad

Introducción

Una actividad Get de Snowflake, que utiliza su conexión Snowflake, recupera un archivo CSV de datos de una tabla o vista de Snowflake y está destinado a ser utilizado como fuente para proporcionar datos en una operación.

Crear un Snowflake Obtener actividad

Se crea una instancia de una actividad Get de Snowflake a partir de una conexión Snowflake utilizando su tipo de actividad Obtener.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad Obtener de Snowflake existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad de obtención de Snowflake

Siga estos pasos para configurar una actividad Obtener de Snowflake:

• Paso 1: Ingrese un nombre y seleccione un objeto
  Proporcione un nombre para la actividad y seleccione un objeto, ya sea una tabla o una vista.

• Paso 2: Revise los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo.

Paso 1: Ingrese un nombre y seleccione un objeto

En este paso, proporcione un nombre para la actividad y seleccione una tabla o vista (consulte Descripción general de las vistas de Snowflake). A continuación se describe cada elemento de la interfaz de usuario de este paso.

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad Get de Snowflake y no debe contener barras diagonales. /o dos puntos :.

• Seleccionar un objeto: Esta sección muestra los objetos disponibles en el extremo de Snowflake. Al volver a abrir una configuración de actividad existente, solo se muestra el objeto seleccionado en lugar de volver a cargar la lista completa de objetos.

  • Objeto de Snowflake seleccionado: Después de seleccionar un objeto, este aparece aquí.

  • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si ya se muestran objetos en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para volver a cargar objetos desde el extremo durante la búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

  • Actualizar: Haga clic en el icono de actualización o la palabra Refresh para recargar objetos desde el extremo de Snowflake. Esto puede resultar útil si se han agregado objetos a Snowflake. Esta acción actualiza todos los metadatos utilizados para crear la tabla de objetos que se muestran en la configuración.

  • Selección de un objeto: Dentro de la tabla, haga clic en cualquier parte de una fila para seleccionar un objeto. Solo se puede seleccionar un objeto. La información disponible para cada objeto se obtiene desde el extremo de Snowflake:

    • Nombre: El nombre de un objeto, ya sea una tabla o una vista.

    • Tipo: El tipo de objeto, ya sea una tabla o una vista.

  Consejo

  Si la tabla no se llena con los objetos disponibles, la conexión Snowflake puede no tener éxito. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

• NullIf: El valor que se devolverá si se obtiene un resultado NULL.

• Campo opcionalmente encerrado por: El carácter opcional utilizado para encerrar el campo NullIf.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

  El conector Snowflake utiliza versión 3.19.0 del controlador JDBC de Snowflake, y los comandos SQL de Snowflake. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

  Los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

  • Solicitud

    Campo/nodo del esquema de solicitud	Notas
    stageName	Nombre de la etapa interna del Snowflake se utiliza al obtener datos de la tabla. Nota El stageName es el nombre de un área de preparación interna de Snowflake, que debe existir previamente antes de ejecutar una operación con esta actividad. El archivo se copia primero en el área de preparación antes de que esté disponible para el conector.
    fileName	Nombre del archivo en la etapa interna de Snowflake que se utilizará al obtener datos de la tabla.
    compressData	Indicador booleano que indica si se deben comprimir los datos antes de cargarlos en la etapa interna de Snowflake.
    fileFormat	Nodo del formato de archivo.
    nullIf	Mostrar valor para NULLIF.
    FIELD_OPTIONALLY_ENCLOSED_BY	Delimitador utilizado para encerrar el NULLIF entrada.

  • Respuesta

    Campo/nodo del esquema de respuesta	Notas
    fileName	Nombre del archivo en la etapa interna de Snowflake se utiliza al obtener datos de la tabla (idéntico a la solicitud).
    content	Contenido de la tabla Snowflake en formato CSV.

• Actualizar: Haga clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Snowflake. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad Get de Snowflake, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades Get de Snowflake se pueden utilizar como fuente con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente)
• Patrón de archivo HTTP de dos destinos (solo como primera fuente)
• Patrón de dos transformaciones (como primera o segunda fuente)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.