Toto je staršia verzia dokumentu!
Aktuálna verzia je 1.27 z 5.8.2014
Obslužné funkcie a procedúry sú určené napr. pre prihlásenie a podobne.
FUNCTION FS_VERSION()
RETURNS VARCHAR(30)
Táto funkcia vráti aktualnu verziu FS databázy.
SELECT FS_VERSION();
PROCEDURE FS_RESULT()
Táto procedúra generuje jednoriadkovú tabuľku podľa aktuálneho stavu poslednej chyby.
Ak nenastala žiadna chyba, potom stĺpec `status`
bude obsahovať hodnotu 1
a stĺpec `info`
bude obsahovať text ok
.
Ak nastala nejaká chyba, potom stĺpec `status`
bude obsahovať hodnotu 0
, stĺpec `info`
bude obsahovať text err
a stĺpec `error`
bude obsahovať text chyby.
Stĺpec `data`
je určený ako dodatkový parameter pre niektoré procedúry, napr. procedúra fs_changelog_status()
do tohoto stĺpca ukladá informáciu o tom, že či je nutné robiť aplikáciu synchronizačného logu alebo nie.
Ak je pri nejakej nižšie popísanej procedúre napísané, že výsledok procedúry je
SELECT FS_RESULT
, potom môžete na výstupe očakávať práve takúto jednoriadkovú tabuľku, z ktorej sa dozviete, či bola procedúra úspešne ukončená a ak nebola, potom sa dozviete aj chybovú hlášku.
Príklad: pokúsime sa prihlásiť pomocou chybného `hash_idf`
, ktoré nepatrí momentáne žiadnemu zariadeniu.
mysql> call fs_select_device("ddf24"); +--------+-------+----------------------------------------------------+-------+ | status | info | error | data | +--------+-------+----------------------------------------------------+-------+ | 0 | error | Zadany hash nepatri ziadnemu aktivnemu zariadeniu! | NULL | +--------+-------+----------------------------------------------------+-------+
Príklad: teraz sa pokúsime sa prihlásiť pomocou funkčného `hash_idf`
.
mysql> call fs_select_device("kwef7dv"); +--------+------+-------+-------+ | status | info | error | data | +--------+------+-------+-------+ | 1 | ok | NULL | NULL | +--------+------+-------+-------+
FUNCTION FS_ERROR()
RETURNS SMALLINT
Táto funkcia vráti iba hodnotu 1
, ak nastala nejaká chyba, alebo 0
, ak žiadna chyba nenastala.
Text chyby sa dá vytiahnuť pomocou funkcie fs_last_error()
.
SELECT FS_ERROR();
FUNCTION FS_LAST_ERROR()
RETURNS VARCHAR(255)
Táto funkcia vráti text poslednej chyby.
SELECT FS_LAST_ERROR();
FUNCTION FS_GET_DEVICE_LAST_ACCESS()
IN `_DEVICE_ALIAS`
VARCHAR(50)
RETURNS DATETIME
Funkcia pre zistenie času posledného prístupu zariadenia podľa jeho aliasu `_DEVICE_ALIAS`
.
SELECT FS_GET_DEVICE_LAST_ACCESS("system24");
PROCEDURE FS_SELECT_DEVICE()
IN `_DEVICE_HASH`
VARCHAR(50)
SELECT FS_RESULT
Procedúra, pomocou ktorej sa treba prihlásiť, ak chcete vykonávať synchronizáciu alebo aplikovať synchronizačný log (changelog). Ako vstup sa používa parameter _DEVICE_HASH, ktorý je pridelený vašemu zariadeniu. Výsledok procedúry je select fs_result.
CALL FS_DELECT_DEVICE("d86dkh213");
PROCEDURE FS_SELECT_DEVICE_QUICK()
IN `_DEVICE_HASH`
VARCHAR(50)
SELECT FS_RESULT
Skoro rovnaká procedúra ako FS_SELECT_DEVICE(), ale nerobí zmeny v tabuľke zariadení, takže by nemala čakať na uzamknutie inou transakciou.
Je vhodné ju používať pre rýchlu prácu so zámkom.
PROCEDURE FS_FREE()
SELECT FS_RESULT
Procedúra určená pre ukončenie spojenia. Táto procedúra vyčistí všetky dočasné premenné a tabuľky a pripraví databázu pre nové spojenie.
Túto procedúru použite po skončení činnosti, napr. po pridaní záznamov do logu alebo po aplikácii synchronizačného logu.
CALL FS_FREE();
Manipulačné funkcie sú určené pre manipuláciu s dátami, napr. pridávanie, zmeny a podobne.