Funkce _sqp

_sqp_trace

function _sqp_trace(IN situation INTEGER, IN username CHAR(31), IN objectname CHAR(63), IN logname CHAR(31), IN kontext_extent INTEGER) RETURNS BOOLEAN;

Parametry

situation	Φφslo situace, jejφ₧ logovßnφ se mß ovlivnit
username	jmΘno u₧ivatele, jeho₧ akce se majφ logovat, je-li prßzdnΘ, mφnφ se vÜichni u₧ivatele
objectname	jmΘno tabulky, k nφ₧ se vztahuje po₧adavek na logovßnφ
logname	jmΘno logu, do n∞ho₧ se loguje, je-li prßzdnΘ, mφnφ se standardnφ log
kontext_extent	urΦuje rozsah informacφ v logu, p°φpadn∞ vypφnß logovßnφ

Od verze

7.0

Popis

Funkce za°adφ nov² po₧adavek na logovßnφ urΦitΘ situace nebo zm∞nφ Φi zruÜφ platn² po₧adavek na logovßnφ.

╚φsla situacφ v parametru situation jsou oznaΦena konstantami popsan²mi zde.

Pro situace vztahujφcφ se k manipulaci s daty v tabulkßch uvßdφ parametr objectname jmΘno tabulky, kterΘ se logovßnφ t²kß. JmΘno lze prefixovat jmΘnem schΘmatu (aplikace), pokud prefix nenφ uveden, mφnφ se prßv∞ vybranΘ schΘma. Tabulka musφ existovat ji₧ b∞hem volßnφ tΘto funkce.

Pokud je jmΘno logu logname neprßzdnΘ, pak musφ oznaΦovat ji₧ existujφcφ log, nap°φklad vytvo°en² d°φv∞jÜφm volßnφm funkce _sqp_define_log.

Parametr username musφ oznaΦovat existujφcφ u₧ivatelskΘ jmΘno. Nelze v n∞m pou₧φt jmΘno u₧ivatele, kter² bude teprve zalo₧en.

Hodnoty parametru kontext_extent urΦujφ mφru vypisovan²ch informacφ o kontextu, v n∞m₧ situace nastala. Existujφ t°i stupn∞ kontextu:

0 - logovßnφ se neprovßdφ - tato hodnota ruÜφ d°φve zadan² po₧adavek na logovßnφ;
1 - zprßva bez kontextu;
2 - zprßva obsahujφcφ nejbli₧Üφ kontextem situace;
3 - zprßva obsahujφcφ ·daje o vÜech rekurzivn∞ zano°en²ch kontextech, v nich₧ situace nastala.

Kontext v∞tÜφ ne₧ 1 mß smysl zejmΘna p°i logovßnφ u₧ivatelsk²ch chyb, SQL p°φkaz∙ a manipulacφ s tabulkou. Nastavenφm kontextu 0 se logovßnφ vypφnß.

Hodnota funkce

Funkce vracφ TRUE, pokud ·sp∞Ün∞ za°adila nebo zruÜila zadan² po₧adavek na logovßnφ. Vracφ FALSE p°i chyb∞, kterß m∙₧e b²t zp∙sobena zadßnφm jmΘna neexistujφcφho u₧ivatele nebo objektu.

Viz

Logovßnφ a trasovßnφ

P°φklad:

V procedu°e _ON_SERVER_START m∙₧ete pro v²voj aplikacφ zapnout trasovßnφ bez replikacφ nap°. takto:

PROCEDURE _ON_SERVER_START();
BEGIN
//  CALL Log_write("server spuÜt∞n");
  CALL _sqp_trace(TRACE_SERVER_FAILURE, '', '', '', 3);
  CALL _sqp_trace(TRACE_START_STOP,     '', '', '', 3);
  CALL _sqp_trace(TRACE_LOGIN,          '', '', '', 3);
  CALL _sqp_trace(TRACE_SERVER_INFO,    '', '', '', 3);
  CALL _sqp_trace(TRACE_USER_ERROR,     '', '', '', 3);
  CALL _sqp_trace(TRACE_SQL,            '', '', '', 3);
  CALL _sqp_trace(TRACE_CURSOR,         '', '', '', 3);
  CALL _sqp_trace(TRACE_LOG_WRITE,      '', '', '', 3);

  CALL _sqp_trace(TRACE_REPLICATION,   '', '', '', 0);
  CALL _sqp_trace(TRACE_DIRECT_IP,     '', '', '', 0);
  CALL _sqp_trace(TRACE_REPLIC_MAIL,   '', '', '', 0);
  CALL _sqp_trace(TRACE_REPLIC_COPY,   '', '', '', 0);
  CALL _sqp_trace(TRACE_REPL_CONFLICT, '', '', '', 0);
END