Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect a una fonte di dati SAP HANA

SAP HANA è un database in memoria ad alte prestazioni che velocizza le decisioni e le azioni basate sui dati e in tempo reale. È sviluppato e commercializzato da SAP. Il plug-in di origine dati SAP HANA ti aiuta a connettere la tua istanza SAP HANA con Grafana.

Con il plug-in SAP HANA Grafana Enterprise, puoi visualizzare i tuoi dati SAP HANA insieme a tutte le altre fonti di dati in Grafana, nonché i dati di log e metrici nel contesto. Questo plugin include un editor di query integrato, supporta le annotazioni e consente di impostare soglie di avviso, controllare l'accesso, impostare le autorizzazioni e altro ancora.

Funzionalità

Aggiungere la fonte di dati

Accesso e autorizzazioni

Per connettere Grafana a SAP HANA, utilizza credenziali dedicate. Fornisci solo le autorizzazioni necessarie all'utente. Innanzitutto, crea un utente con restrizioni con nome utente e password. La seguente query è un esempio di creazione di un utente con restrizioni. Questa query disabilita anche la modifica forzata della password.

CREATE RESTRICTED USER <USER> PASSWORD <PASSWORD> NO FORCE_FIRST_PASSWORD_CHANGE;

Quindi, consenti all'utente di connettere il sistema tramite client come Grafana con quanto segue:

ALTER USER <USER> ENABLE CLIENT CONNECT;

Infine, consenti all'utente di accedere alle viste, alle tabelle e agli schemi necessari.

ALTER USER <USER> GRANT ROLE PUBLIC;
GRANT SELECT ON SCHEMA <SCHEMA> TO <USER>;

Autorizzazioni a livello utente

Limita l'accesso a SAP HANA facendo clic sulla scheda Autorizzazioni nella pagina di configurazione dell'origine dati per abilitare le autorizzazioni dell'origine dati. Nella pagina delle autorizzazioni, gli amministratori possono abilitare le autorizzazioni e limitare le autorizzazioni per le query a utenti e team specifici.

Editor della query

Il plugin SAP HANA Grafana è dotato di un editor di query SQL in cui è possibile inserire qualsiasi query HANA. Se la tua query restituisce dati di serie temporali, puoi formattarla come serie temporali per visualizzarli in un pannello grafico. L'editor di query fornisce il completamento automatico per le macro Grafana supportate e l'evidenziazione della sintassi della query SQL.

Annotazioni

È possibile utilizzare le query SAP HANA come fonti delle annotazioni Grafana. La tua query di annotazione dovrebbe restituire almeno una colonna temporale e una colonna di testo. Per ulteriori informazioni sulle annotazioni, vedere. Annotazioni

Modelli e variabili

Per aggiungere una nuova variabile di query SAP HANA, vedere. Aggiungere una variabile di query Usa la tua fonte di dati SAP HANA come fonte di dati.

La seguente query di esempio restituisce l'elenco distinto di username dalla users tabella.

select distinct("username") from "users"

Modelli e variabili

È possibile utilizzare qualsiasi variabile Grafana nella query. Gli esempi seguenti mostrano come utilizzare la variabile singola/multipla nella query.

-- For example, following query
select * from "users" where "city" = ${city}
-- will be translated into
select * from "users" where "city" = 'london'
--- where you can see ${city} variable translated into actual value in the variable

Analogamente al testo, le variabili funzionano anche per i campi numerici. Nell'esempio seguente, ${age} è una variabile di una casella di testo in cui accetta numeri e quindi viene confrontata con il campo numerico della tabella.

select * from "users" where "age" > ${age}
--- wil be translated into
select * from "users" where "age" > '36'

Se la variabile restituisce più valori, puoi utilizzarla nelle condizioni della query SAP HANA come di in seguito. Nota le parentesi che circondano la variabile per rendere la where in condizione valida in SAP HANA.

select * from "users" where "city" in (${cities})
--- will be translated into
select * from "users" where "city" in ('london','perth','delhi')
--- where you can see ${cities} turned into a list of grafana variables selected.
--- You can also write the same query using shorthand notation as shown below
select * from "users" where "city" in ($cities)

Macro

Macro $__timeFilter () <time_column>

L'esempio seguente spiega la macro: $__timeFilter(<time_column>)

- In the following example, the query
select ts, temperature from weather where $__timeFilter(ts)
--- will be translated into
select ts, temperature from weather where ts > '2021-02-24T12:52:48Z' AND ts < '2021-03-24T12:52:48Z'
--- where you can see the grafana dashboard's time range is applied to the column ts in the query.

macro $__timeFilter (,) <time_column><format>

In alcuni casi, le colonne temporali nel database sono memorizzate in formati personalizzati. L'esempio seguente spiega la $__timeFilter(<time_column>, <format>) macro, che aiuta a filtrare i timestamp personalizzati in base al selettore orario di grafana:

SELECT TO_TIMESTAMP("TS",'YYYYMMDDHH24MISS') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYYMMDDHH24MISS") -- TS is in 20210421162012 format
SELECT TO_TIMESTAMP("TS",'YYYY-MON-DD') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYY-MON-DD") -- TS is in 2021-JAN-15 format

Nella macro, il formato può essere uno dei formati HANA validi corrispondenti alla colonna del timestamp. Ad esempio, YYYYMMDDHH24MISS è un formato valido quando i dati sono archiviati nel formato. 20210421162012

Macro $__TimeFilter (, «epoch») <time_column><format>

In alcuni casi, i timestamp vengono memorizzati come timestamp epoch nel database. L'esempio seguente spiega la $__timeFilter(<time_column>, "epoch" <format>) macro che aiuta a filtrare i timestamp delle epoche in base al selettore temporale di grafana. Nella macro, il formato può essere uno tra ms, s o ns. Se non viene specificato, s verrà considerato come formato predefinito.

SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","s") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms") -- Example : TIMESTAMP field stored in epoch_ms format 1257894000000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000000000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ns") -- Example : TIMESTAMP field stored in epoch_nanoseconds format 1257894000000000000

Invece di usare il terzo argomento per $__timeFilter, puoi usare uno tra epoch_s, epoch_ms o epoch_ns come secondo argomento..

SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms")
-- is same as
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch_ms")

macro toTimeFilter $__ () e $__ () fromTimeFilter

La $__fromTimeFilter() macro si espande in una condizione su un campo temporale basato sul time picker Grafana.

Questo accetta tre parametri. Il primo parametro è il nome del campo temporale. Puoi passare comparison_predicate o il formato della colonna time come secondo argomento. Se vuoi passare entrambi, allora format è il secondo parametro e usa comparison_predicate come terzo parametro.

<format>Se il formato non è specificato, il plugin presumerà che la colonna dell'ora sia di tipo timestamp/date. Se la colonna dell'ora è memorizzata in un formato diverso da timestamp/date, passa il formato come secondo argomento. <format>può essere uno tra epoch_s, epoch_ms, epoch_ns o qualsiasi altro formato personalizzato come YYYY-MM-DD.

<comparison_predicate>parametro opzionale. Se non viene passato, il plugin utilizzerà > come predicato di confronto. <comparison_predicate>può essere uno tra =,! =, <>, <, <=, >, >=

$__toTimeFilter()funziona come fromTimeFilter $__ (). Invece di usare Grafana's from time, utilizzerà to time. Inoltre, il predicato di confronto predefinito sarà <.

$__timeGroup (,) <time_column><interval>

Ad esempio, la macro $__TimeGroup (timecol,1h) viene estesa a SERIES_ROUND («timecol», 'INTERVAL 1 HOUR') nella query.

L'esempio seguente spiega il $__timeGroup(<time_column>, <interval>) macro.

SELECT $__timeGroup(timestamp,1h),  "user", sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp,1h), "user"
ORDER BY $__timeGroup(timestamp,1h) ASC

Questo viene tradotto nella seguente query dove $__timeGroup(timestamp,1h) viene espanso inSERIES_ROUND("timestamp", 'INTERVAL 1 HOUR').

SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR') as "timestamp",  "user", sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2020-01-01T00:00:00Z' AND "timestamp" < '2020-01-01T23:00:00Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR'), "user"
ORDER BY "timestamp" ASC

Se non vuoi codificare l'intervallo nella funzione $__timeGroup (), puoi lasciarlo a Grafana specificando $__interval come intervallo. Grafana calcolerà tale intervallo dall'intervallo di tempo della dashboard. Query di esempio:

SELECT $__timeGroup(timestamp, $__interval), sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp, $__interval)
ORDER BY $__timeGroup(timestamp, $__interval) ASC

Tale query viene tradotta nella seguente query in base all'intervallo di tempo del dashboard.

SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE'), sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2019-12-31T23:09:14Z' AND "timestamp" < '2020-01-01T23:17:54Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE')
ORDER BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE') ASC

Avviso

Avvisi relativi a dati non relativi a serie temporali

Per inviare avvisi sui dati non relativi alle serie temporali, utilizzate la TO_TIMESTAMP('${__to:date}') macro per trasformare le metriche non relative alle serie temporali in serie temporali. Questo convertirà la metrica in una query di serie temporali a punto singolo. Il formato della query è riportato di seguito

SELECT TO_TIMESTAMP('${__to:date}'),  <METRIC> FROM <TABLE≶ WHERE <YOUR CONDITIONS>

Nell'esempio seguente, una tabella contiene quattro campi denominati nome utente, età, città e ruolo. Questa tabella non ha alcun campo temporale. Desideriamo avvisare quando il numero di utenti con ruolo di sviluppo è inferiore a tre.

SELECT  TO_TIMESTAMP('${__to:date}'), count(*) as "count" FROM (
   SELECT 'John' AS "username", 32 AS "age", 'Chennai' as "city", 'dev' as "role" FROM dummy
   UNION ALL SELECT 'Jacob' AS "username", 32 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
   UNION ALL SELECT 'Ali' AS "username", 42 AS "age", 'Delhi' as "city", 'admin' as "role" FROM dummy
   UNION ALL SELECT 'Raja' AS "username", 12 AS "age", 'New York' as "city", 'ceo' as "role" FROM dummy
   UNION ALL SELECT 'Sara' AS "username", 35 AS "age", 'Cape Town' as "city", 'dev' as "role" FROM dummy
   UNION ALL SELECT 'Ricky' AS "username", 25 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
   UNION ALL SELECT 'Angelina' AS "username", 31 AS "age", 'London' as "city", 'cxo' as "role" FROM dummy
) WHERE "role" = 'dev'