Contrato de evento
Campos que espera la consulta
| Campo | Tipo | Por que existe |
|---|---|---|
| timestamp_utc | Timestamp | Cuándo se completó la actividad facturable en UTC. |
| meter_event_id | Utf8 | Clave de idempotencia para un registro de uso lógico. |
| account_id | Utf8 | Identificador de cuenta de facturación estable. |
| plan | Utf8 | Plan que poseía la cuota cuando se produjo el uso. |
| billable_units | Float64 | Unidades normalizadas agregadas por este evento. |
| included_units | Float64 | Cuota mensual incluida para la cuenta y el plan. |
Copiar la consulta
WITH deduplicated_usage AS (
SELECT
meter_event_id,
account_id,
plan,
MAX(billable_units) AS billable_units,
MAX(included_units) AS included_units
FROM usage_meter_events
WHERE timestamp_utc >= date_trunc('month', now())
GROUP BY meter_event_id, account_id, plan
)
SELECT
account_id,
plan,
COUNT(*) AS meter_events,
SUM(billable_units) AS used_units,
MAX(included_units) AS included_units,
100.0 * SUM(billable_units)
/ NULLIF(MAX(included_units), 0) AS quota_used_pct,
SUM(billable_units) - MAX(included_units) AS overage_units
FROM deduplicated_usage
GROUP BY account_id, plan
ORDER BY quota_used_pct DESC;Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.
Resultado de la consulta
Cuota mensual utilizada por cuenta
Harbour ha superado su cuota incluida, mientras que Lumen está lo suficientemente cerca como para necesitar un pronóstico o una notificación al cliente.
| account_id | plan | meter_events | used_units | included_units | quota_used_pct | overage_units |
|---|---|---|---|---|---|---|
| account_harbor | growth | 18.420 | 1.126.000 | 1.000.000 | 112,6 | 126.000 |
| account_lumen | growth | 12.880 | 842.000 | 1.000.000 | 84,2 | -158.000 |
| account_north | starter | 3610 | 168.000 | 250.000 | 67,2 | -82.000 |
Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.
Reproducir el ejemplo
Descargar el accesorio público
El paquete JSON incluye el contrato de evento escrito, illustrative filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.
Cómo funciona el SQL
- 1El primer CTE agrupa por ID de evento de medidor, por lo que una entrega de al menos una vez no puede facturar el mismo uso lógico dos veces.
- 2Las unidades facturables se suman independientemente del recuento de eventos porque una solicitud puede representar muchas unidades o fracciones.
- 3El porcentaje de cuota y el excedente preservan el denominador específico del plan necesario para la clasificación de la cuenta y la revisión de facturación.
Casos extremos para decidir
- Los cambios de plan necesitan una política de prorrateo explícita; un máximo mensual único es ilustrativo cuando las cuotas pueden cambiar a mitad del período.
- Las correcciones y el uso negativo requieren un contrato de ajuste de solo anexo en lugar de mutar silenciosamente eventos anteriores.
- Concilie el total con el proveedor de facturación antes de que la factura sea definitiva.
Panel recomendado
- Barras: quota_used_pct por cuenta
- Tabla: unidades usadas, incluidas y excedentes
- Tendencia: unidades facturables diarias para cuentas superiores al 75%
Guía de alerta
Notifique a los propietarios de cuentas en los umbrales de cuota documentados y avise solo cuando la entrega o conciliación del medidor falle.
Leer configuración de alertaPon la receta a trabajar
Instrumentación y guías relacionadas.
Definir los datos de origen
Esquemas de eventos para este análisis.
Continuar el análisis
Calcular la conversión de prueba a pago
Mida cuántas cuentas de prueba se convierten en clientes pagos dentro de una ventana de conversión fija.
Receta abiertaMedir la recuperación de fallos de pago
Calcule la frecuencia con la que las facturas fallidas se recuperan mediante un intento de pago exitoso posterior.
Receta abiertaCalcular el movimiento de ingresos recurrentes mensuales
Separe los MRR nuevos, de expansión, contracción, abandono y reactivación de los eventos del ciclo de vida de facturación.
Receta abiertaEjecútelo en eventos reales.
Crea una tabla, adapta los campos y guarda el resultado.
Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.