Datasets (Conjuntos de Datos)

General

Cuando ejecutas una regla, se genera un conjunto de datos con el resultado de la ejecución. Este nuevo conjunto de datos puede ser un subconjunto (por ejemplo usando operaciones como limit o include/exclude) o conjuntos de datos completos.

Los conjuntos de datos pueden descargarse a una carpeta local (JSON o CSV) o pueden cargarse en uno de los sumideros disponibles.

Load

Para cargar un conjunto de datos en un sumidero, el sumidero debe agregarse al modelo. Puedes encontrar más información sobre cómo agregar un sumidero al modelo en la página de Sumideros.

Una vez ejecutado, se creará un trabajo donde podrás ver el progreso de la carga.

UI Options

La página de Conjuntos de Datos proporciona varias opciones de interacción para cada conjunto de datos en la tabla:

Acción	Descripción
Descargar	Descarga el conjunto de datos en formato JSON o CSV
Actualizar	Actualiza la información del conjunto de datos
Compartir	Crea un enlace compartible para el conjunto de datos
Eliminar	Elimina el conjunto de datos del sistema

Funcionalidad de Compartir

El botón Compartir te permite crear URL públicas para compartir tus conjuntos de datos. Cuando haces clic en el botón Compartir:

Si tienes solo una clave API en tu proyecto, crea automáticamente un endpoint compartible
Si tienes múltiples claves API, se te pedirá que selecciones cuál usar

Estructura de URL Compartida

Una vez compartidos, los conjuntos de datos son accesibles vía URL con la siguiente estructura:

[protocolo]//[nombrehost]/api/[organización]/[proyecto]/model/[modelo-seq]/dataset/[dataset-seq]

Por ejemplo:

https://tuserver/api/acme-corp/datos-ventas/model/1/dataset/42

Parámetros de URL

Puedes personalizar la URL compartida con parámetros adicionales:

Parámetro	Valores	Descripción
`format`	`json-zip`, `csv-zip`, `sql`	Especifica el formato de descarga para el conjunto de datos

URLs de ejemplo con parámetros:

https://tuserver/api/acme-corp/datos-ventas/model/1/dataset/42?format=json-zip
https://tuserver/api/acme-corp/datos-ventas/model/1/dataset/42?format=csv-zip
https://tuserver/api/acme-corp/datos-ventas/model/1/dataset/42?format=sql

Detalles de la UI de Compartir

Cuando haces clic en el botón Compartir, la fila se expande para mostrar:

Endpoint API: La URL completa para acceder a tu conjunto de datos
Selector de Formato: Dropdown para elegir el formato (JSON ZIP, CSV ZIP, SQL)
Botón Copiar: Copia la URL con formato seleccionado al portapapeles
Contador de Llamadas: Muestra cuántas veces se ha accedido al endpoint
Opción Eliminar: Elimina el endpoint API si ya no es necesario

Representación ASCII de la Tabla de Conjuntos de Datos

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Nombre Dataset     Regla    Última Actualización  Creado Por   Tamaño    Acciones                        │
├──────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ customers_2023     filter   hace 2 horas           John Doe     2.4 MB    Descargar Compartir Eliminar   │
│ products_filtered  select   hace 1 día             Jane Smith   15.7 MB   Descargar Compartir Eliminar   │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Cuando haces clic en el botón Compartir para un conjunto de datos, la fila se expande:

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Nombre Dataset     Regla    Última Actualización  Creado Por   Tamaño    Acciones                        │
├──────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ customers_2023     filter   hace 2 horas           John Doe     2.4 MB    Descargar Compartir Eliminar   │
├──────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ ┌──── GET ────┐ https://tuserver/api/org/proj/model/1/dataset/42           [Copiar]                      │
│ │  # llamadas │                                                           [Eliminar]                     │
│ └─────────────┘  ?format= [json-zip ▼]                                                                   │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Esta vista expandida muestra la URL compartible, te permite seleccionar diferentes formatos y proporciona opciones para copiar la URL o eliminar el endpoint.

Tabla de Contenidos