Referens för larmsystemtabeller

Denna sida innehåller information om larmsystemets tabeller, inklusive en översikt av varje tabells schema. Använd dessa tabeller för att fråga dina arbetsytsaviseringar och deras utvärderingshistorik direkt i SQL, så att du kan granska aviseringsdefinitioner, analysera utvärderingstrender och övervaka aviseringsarbetsbelastningar i stor skala.

Schemat system.alert innehåller två tabeller:

• system.alert.alerts: Konfigurationen av varje varning, inklusive dess definition, schema, utvärderingsgränser, abonnenter och livscykeltidsstämplar.
• system.alert.alert_evaluation_history: En rad per varningsutvärdering, som fångar det utvärderade tillståndet, resultatvärden, status för leverans av notifikationer och feldetaljer.

Requirements

Som standard har endast användare med både kontoadministratörs- och metastoreadministratörsroller tillgång till larmsystemtabellerna. För att dela en tabells data med en användare eller grupp rekommenderar Databricks att skapa en dynamisk vy för varje användare eller grupp. Se Skapa en dynamisk vy.

Alert konfigurationstabellschema schema

Bordet system.alert.alerts är en långsamt föränderlig dimensionstabell. Varje rad fångar konfigurationen av en varning vid en viss tidpunkt, så en enda varning har flera rader när dess konfiguration ändras.

Tabellsökväg: Den här systemtabellen finns på system.alert.alerts.

Tabellen system.alert.alerts använder följande schema:

Schema för larmutvärderingshistorik

Tabellen system.alert.alert_evaluation_history registrerar en rad för varje varningsutvärdering och fångar det utvärderade tillståndet och relaterade statistik.

Tabellsökväg: Den här systemtabellen finns på system.alert.alert_evaluation_history.

Tabellen system.alert.alert_evaluation_history använder följande schema:

Exempelfrågor

Följande exempelfrågor visar vanliga sätt att analysera varningskonfiguration och utvärderingshistorik. Varje fråga använder namngivna parametermarkörer för aviserings- och arbetsyts-ID:n, så du blir tillfrågad om värdena när du kör frågan.

Hitta den senaste utvärderingen för en varning

Denna fråga returnerar den senaste konfigurationen av en specifik varning tillsammans med dess senaste utvärdering.

SELECT
  c.alert_id,
  c.display_name,
  c.compute,
  c.schedule.quartz_cron_schedule AS schedule,
  c.evaluation_comparison_operator AS operator,
  c.evaluation_threshold.value.double_value AS threshold,
  c.change_time AS config_last_updated,
  e.evaluated_state,
  e.start_time AS evaluation_time,
  e.end_time,
  TIMESTAMPDIFF(SECOND, e.start_time, e.end_time) AS eval_duration_seconds
FROM (
  SELECT *
  FROM system.alert.alerts
  WHERE alert_id = :your_alert_id
    AND delete_time IS NULL
  ORDER BY change_time DESC
  LIMIT 1
) c
LEFT JOIN (
  SELECT *
  FROM system.alert.alert_evaluation_history
  WHERE alert_id = :your_alert_id
  ORDER BY start_time DESC
  LIMIT 1
) e ON TRUE;

Hitta vilka varningar som triggats mest under de senaste sju dagarna

Denna fråga räknar hur många gånger varje varning utlöstes i en arbetsyta under de senaste sju dagarna.

SELECT
  alert_id,
  COUNT(*) AS trigger_count_7d
FROM system.alert.alert_evaluation_history
WHERE workspace_id = :your_workspace_id
  AND start_time >= CURRENT_DATE() - INTERVAL 7 DAY
  AND evaluated_state = 'TRIGGERED'
GROUP BY alert_id
ORDER BY trigger_count_7d DESC;

Följ hur en varnings tillstånd förändrades över tid

Denna fråga sammanfattar den dagliga räkningen för varje utvärderad stat för en specifik varning under de senaste 30 dagarna. Använd den för att bygga en instrumentpanel som övervakar varningens tillförlitlighet.

SELECT
  DATE_TRUNC('day', start_time) AS eval_day,
  COUNT_IF(evaluated_state = 'OK') AS ok_count,
  COUNT_IF(evaluated_state = 'TRIGGERED') AS triggered_count,
  COUNT_IF(evaluated_state = 'ERROR') AS error_count
FROM system.alert.alert_evaluation_history
WHERE alert_id = :your_alert_id
  AND start_time >= CURRENT_DATE() - INTERVAL 30 DAY
GROUP BY 1
ORDER BY eval_day ASC;

Lista aktiva varningar i en arbetsyta

Denna fråga returnerar den senaste konfigurationen för varje varning som inte är borttagen och inte pausad i en arbetsyta.

WITH latest AS (
  SELECT
    *,
    ROW_NUMBER() OVER (PARTITION BY alert_id ORDER BY change_time DESC) AS rn
  FROM system.alert.alerts
  WHERE workspace_id = :your_workspace_id
    AND delete_time IS NULL
)
SELECT
  alert_id,
  display_name,
  compute,
  schedule.quartz_cron_schedule AS cron_schedule,
  schedule.pause_status
FROM latest
WHERE rn = 1
  AND schedule.pause_status != 'PAUSED';