DSEDataSourceExplorer
DSE 1.0.1

Manual de usuario

Esta guía explica el flujo operativo completo de Data Source Explorer (DSE).

Úsela cuando necesite una referencia detallada que cubra:

1. Para qué está diseñada la aplicación

DSE es una aplicación de escritorio orientada al operador para descubrir fuentes de datos, inspeccionar su estructura, preparar definiciones de extracción o mapeo y generar artefactos de salida reutilizables.

En la práctica, el flujo habitual es:

  1. elegir un destino y ejecutar Discover
  2. inspeccionar el árbol de fuentes descubiertas
  3. revisar o editar la información de conexión
  4. probar la conectividad
  5. cargar tablas / colecciones / buckets / otros objetos
  6. revisar la estructura del objeto y la vista previa de datos
  7. construir un catálogo de esquema / catálogo de datos con lo relevante
  8. componer objetivos de salida cuando se necesiten objetos de destino mapeados
  9. generar desplegables para uno o varios destinos de ejecución
  10. revisar los archivos generados y, si es necesario, generar el esquema gráfico

2. Distribución de la ventana principal

La ventana principal está dividida en varias zonas de trabajo.

Área superior de comandos

Use esta zona para:

Árbol de navegación izquierdo

El lado izquierdo muestra el entorno descubierto. Según el ambiente, puede ver:

Área de trabajo derecha

El lado derecho muestra:

3. Iniciar una sesión

  1. Abra la aplicación.
  2. Seleccione el idioma de la interfaz si hace falta.
  3. En el cuadro de destino, escriba la máquina, host, entorno o ruta de descubrimiento que desea inspeccionar.
  4. Elija el tipo de descubrimiento si la aplicación ofrece varios modos.
  5. Pulse Discover.

Buena práctica

4. Descubrir y explorar fuentes

Después del descubrimiento, revise con cuidado el árbol de la izquierda.

Qué debe observar:

Flujo recomendado

  1. expanda el árbol por niveles
  2. seleccione una fuente de interés
  3. revise la tarjeta/resumen de la derecha
  4. decida si abrir detalles, editar la conexión, quitar el alcance o continuar con la carga de objetos

5. Revisar detalles y editar la conexión

Para la fuente seleccionada, DSE puede mostrar acciones como:

Open details

Úselo para ver un resumen técnico en modo lectura de la conexión o nodo seleccionado.

Edit connection

Úselo cuando:

Secuencia recomendada:

  1. edite solo los campos necesarios
  2. guarde los cambios de conexión
  3. ejecute inmediatamente Test connection
  4. solo después continúe con la carga de objetos o la generación de desplegables

6. Probar la conexión

Use Test connection antes de cualquier operación importante.

Una buena prueba confirma que:

Si la prueba falla:

7. Cargar objetos e inspeccionar la estructura

Después de una conexión exitosa, pulse Load tables o el comando equivalente.

Según el tipo de fuente, puede cargar:

Cómo inspeccionar objetos

  1. seleccione un objeto en la lista
  2. revise Table info o la pestaña equivalente
  3. abra Preview para ver filas o documentos de ejemplo
  4. use Row details para inspeccionar un registro concreto
  5. revise Catalog Schema y Data Catalog para convertir la estructura en una definición reutilizable

8. Construir el Schema Catalog y el Data Catalog

Schema Catalog

Use esta zona para definir la vista estructural de los objetos fuente relevantes para la extracción o el despliegue posterior.

Data Catalog

Use esta zona para enriquecer o revisar los campos y objetos seleccionados desde una perspectiva más reutilizable para el usuario.

Buena práctica

9. Generar Output Data directamente

Use Output Data cuando quiera producir artefactos de datos a partir del catálogo seleccionado.

Es útil para:

Tipos de salida habituales:

Antes de una ejecución grande:

10. Componer objetivos de salida

Use Compose targets cuando necesite mapeos orientados al destino en lugar de solo navegación de la fuente.

En el compositor normalmente trabaja con tres capas:

  1. filas/campos fuente disponibles a la izquierda
  2. uno o más objetivos destino en el centro
  3. objetos destino y mapeos de campos a la derecha

Flujo típico

  1. cree un target destino
  2. elija el preset o tipo de sistema destino
  3. cree uno o más objetos destino
  4. seleccione filas/campos fuente
  5. agréguelos al objeto destino seleccionado
  6. revise la cuadrícula de mapeos
  7. resuelva advertencias de validación
  8. guarde la definición del target

Sugerencias de validación

Corrija antes de guardar:

11. Generar desplegables

Use Generate deployables para producir un runner portable o artefactos relacionados a partir del catálogo y/o de targets guardados.

Modos de entrada

DSE admite dos patrones comunes:

Con targets guardados habilitados, puede agregar targets desde el desplegable, crear un conjunto multi-target, cambiar entre chips y quitar targets del trabajo actual.

Sección Destination instance

Aquí configura cómo el desplegable se conectará al destino o interpretará la definición del target.

Revise campos como:

Plataformas y runtimes

Elija una o varias plataformas y después uno o varios runtime identifiers compatibles.

Output options

Elija qué archivos emitirá el runner, por ejemplo:

Revise además:

Panel de readiness

Antes de generar, lea la sección de preparación/preflight.

Debe indicar si todavía faltan:

Generar

Cuando todo esté listo:

  1. verifique los targets y chips seleccionados
  2. verifique los valores de destino
  3. verifique plataformas/runtimes/formatos/carpeta
  4. pulse Generate

12. Persistencia de la configuración del trabajo

Al salir de Generate deployables, la aplicación puede preguntarle si desea conservar la configuración del trabajo.

Si elige conservarla

La próxima vez se restauran:

Si elige no conservarla

La configuración temporal se elimina.

13. Revisar los desplegables generados

Después de generar, DSE muestra un área resumen.

Úsela para:

14. Revisar resultados de ejecución

La ventana de resultados es la superficie de validación posterior a la ejecución.

Suele ofrecer:

Flujo recomendado

  1. abra la ventana de resultados
  2. seleccione cada archivo al menos una vez
  3. inspeccione pestañas o texto
  4. verifique conteos de filas y nombres de columnas
  5. abra el archivo físico cuando necesite validación externa

15. Generar el esquema gráfico

En la ventana de resultados, use Generate schema para construir un grafo visual de la ejecución.

El grafo puede conectar:

Es útil para:

Mientras se construye, el indicador de progreso debe mostrar actividad.

Save graph

Use Save graph para exportar el esquema en formatos compatibles, como:

16. Workspaces

Use el menú Workspace para gestionar sesiones reutilizables.

Acciones habituales:

Recomendación

17. Plugins, Logs y Help

Plugins

Abra Plugins para revisar proveedores/extensiones disponibles. Si falta un tipo de fuente o se comporta distinto de lo esperado, revise primero el estado del plugin.

Logs

Abra Logs siempre que necesite detalle técnico sobre descubrimiento, conexión, generación o problemas de ejecución.

Help

Abra Help para documentación con búsqueda. Pulse F1 para ayuda contextual.

18. Secuencia recomendada para una ejecución limpia

  1. abra o cree un workspace
  2. descubra el alcance deseado
  3. seleccione una fuente y revise sus detalles
  4. edite la conexión si hace falta
  5. pruebe la conexión
  6. cargue objetos
  7. inspeccione vista previa y estructura
  8. construya el catálogo
  9. componga targets si la ejecución requiere mapeo explícito
  10. abra generate deployables
  11. elija targets guardados o entrada por catálogo
  12. revise ajustes de destino, plataformas, runtimes, formatos y carpeta
  13. genere el desplegable
  14. abra el resumen y luego los resultados
  15. revise archivos y vistas previas
  16. genere y guarde el esquema gráfico si necesita documentación
  17. guarde el workspace

19. Lista de verificación para problemas

Discovery devuelve demasiado o muy poco

Test connection falla

Los objetos no aparecen tras cargar

La generación se bloquea

Los resultados parecen incompletos

20. Recomendaciones finales

Para una experiencia más confiable:

← AnteriorSiguiente →