Tinybird
Envía eventos y consulta datos con Tinybird
Potencia tus pipelines de datos en tiempo real y análisis con Tinybird – la plataforma rápida y escalable para ingerir, consultar y construir APIs sobre grandes volúmenes de datos de eventos. Tinybird permite a desarrolladores e ingenieros de datos recopilar, transformar y exponer datos al instante, facilitando alimentar dashboards, aplicaciones y automatización con información actualizada.
Con la integración de Tinybird, puedes:
- Transmitir eventos a escala: Ingiere millones de eventos JSON por segundo de forma confiable, usando APIs basadas en HTTP con NDJSON o JSON.
- Consultar datos con baja latencia: Ejecuta análisis complejos basados en SQL y consultas de agregación en tiempo real, ideal para dashboards, alertas e informes.
- Exponer datos mediante APIs instantáneas: Construye y publica endpoints de API para tus consultas directamente desde la interfaz de Tinybird o mediante su API.
- Automatizar flujos de trabajo: Usa las APIs de Tinybird en tus automatizaciones para obtener, transformar y sincronizar datos en tu stack.
- Monitorear y depurar: Obtén información sobre el rendimiento del pipeline, latencias de consultas y salud de la ingesta con monitoreo en tiempo real.
- Acceso seguro: Aprovecha la autenticación granular y el alcance de recursos con tokens de API personales o de workspace.
Tinybird empodera a equipos de ingeniería, análisis y producto para entregar productos de datos ultrarrápidos y siempre actualizados con mínima sobrecarga operativa. Pasa de datos de eventos en bruto a endpoints listos para producción en minutos.
¡Conecta Tinybird a tus flujos de trabajo hoy para acelerar funcionalidades basadas en datos, automatización y análisis!
Instrucciones de uso
Interactúa con Tinybird usando la Events API para transmitir eventos JSON o NDJSON, o usa la Query API para ejecutar consultas SQL contra Pipes y Data Sources.
Herramientas
tinybird_events
Envía eventos a una fuente de datos de Tinybird usando la API de eventos. Admite formatos JSON y NDJSON con compresión gzip opcional.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
base_url | string | Sí | URL base de la API de Tinybird (ej., https://api.tinybird.co o https://api.us-east.tinybird.co\) |
datasource | string | Sí | Nombre de la fuente de datos de Tinybird a la que enviar eventos. Ejemplo: "events_raw", "user_analytics" |
data | string | Sí | Datos a enviar como NDJSON (JSON delimitado por líneas) o cadena JSON. Cada evento debe ser un objeto JSON válido. Ejemplo NDJSON: {"user_id": 1, "event": "click"}\n{"user_id": 2, "event": "view"} |
wait | boolean | No | Esperar confirmación de la base de datos antes de responder. Permite reintentos más seguros pero introduce latencia. Por defecto es false. |
format | string | No | Formato de los datos de eventos: "ndjson" (por defecto) o "json" |
compression | string | No | Formato de compresión: "none" (por defecto) o "gzip" |
token | string | Sí | Token de API de Tinybird con alcance DATASOURCE:APPEND o DATASOURCE:CREATE |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
successful_rows | number | Número de filas ingestadas exitosamente |
quarantined_rows | number | Número de filas en cuarentena (falló la validación) |
tinybird_query
Ejecuta consultas SQL contra pipes y fuentes de datos de Tinybird usando la API de consultas.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
base_url | string | Sí | URL base de la API de Tinybird (ej., https://api.tinybird.co\) |
query | string | Sí | Consulta SQL a ejecutar. Especifica el formato de salida deseado (ej., FORMAT JSON, FORMAT CSV, FORMAT TSV). El formato JSON proporciona datos estructurados, mientras que otros formatos devuelven texto sin formato. Ejemplo: "SELECT * FROM my_datasource LIMIT 100 FORMAT JSON" |
pipeline | string | No | Nombre de pipe opcional. Cuando se proporciona, habilita la sintaxis SELECT * FROM _. Ejemplo: "my_pipe", "analytics_pipe" |
token | string | Sí | Token de API de Tinybird con alcance PIPE:READ |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
data | json | Datos del resultado de la consulta. Para FORMAT JSON: array de objetos. Para otros formatos (CSV, TSV, etc.): cadena de texto sin procesar. |
rows | number | Número de filas devueltas (solo disponible con FORMAT JSON) |
statistics | json | Estadísticas de ejecución de la consulta - tiempo transcurrido, filas leídas, bytes leídos (solo disponible con FORMAT JSON) |