Tell príkazy - D2000 Archív

BACKUP [path]

Záloha archívnej databázy. Ak parameter path nie je uvedený, záloha sa vykoná do adresára špecifiikovaného konfiguračným parametrom BackupPath.
Poznámka: Tento príkaz je podporovaný iba pre databázu Sybase SQL Anywhere. Na zálohovanie databáz Oracle/PostgreSQL/MsSql použite ich príslušné utility.

Vykonanie prepočtov starých hodnôt, ktoré boli presmerované na pomocný prepočtový task (viď parameter archívu RecalcImmediateDepth) a následne miesto prepočtu uložené do súboru (viď parameter archívu DropOldRequests). Pokiaľ názov súbor nie zadaný, spracuje sa pre proces meno.ARC súbor meno_ARCHIV_DROPPED_CALCS.DAT, ktorý bude následne premenovaný na meno_ARCHIV_DROPPED_CALCS.DONE (ak taký súbor už existuje, bude zmazaný).
Poznámka: Príkaz skončí neúspešne, ak parameter archívu DropOldRequests má hodnotu 1, keďže v takom prípade by boli prepočty po načítaní zo súboru opätovne do súboru uložené.

Príkaz, ktorý je nutné spustiť po zmene parametra DataTableSlices z hodnoty 1 na hodnotu 2 (t.j. po zmene módu časových rezov na časové rezy iba pre štruktúrované objekty).
Archív vykoná presun hodnôt z časových rezov jednoduchých archívnych objektov do pôvodných dátových tabuliek a časové rezy vymaže.
Pozn: od štartu archívu až do presunu hodnôt do pôvodných dátových tabuliek bude archív pre jednoduché archívne objekty poskytovať iba dáta, ktoré sa nachádzajú v pôvodných dátových tabuľkách. Preto je vykonávanie tejto konverzie odporúčaná iba pre systémy s redundantnými archívmi, pričom archív vykonávajúci konverziu by mal byť nastavený ako pasívny.

Príkaz vykoná kompresiu časových rezov pri aktívnej TimescaleDB. Bude sa komprimovať chunk časového rezu konkrétneho objektu (HOBJ) alebo objektov so zadanou maskou, ktoré zodpovedajú zadanému času (formát je 'dd-mm-yyyy hh:mi'). Ak je špecifikovaný parameter FORCE, vykoná sa rekompresia už skomprimovaných časových rezov. Bez parametra FORCE sa komprimujú iba neskomprimované chunky.
Príklad: COMPRESS_TSDB H.Sec* "02-02-2026 00:00"

CRC path\filename mask from to [step] [PO]

Používa sa na kontrolu zhodnosti dát v inštančných archívoch. Vytvorenie súboru s CRC (kontrolná suma) pre archívne objekty vyhovujúce zadanej maske pre zadaný časový úsek.
Nepovinným parametrom step (v hodinách) je možné rozdeliť výpočet pre časový úsek na intervaly.
Parameter PO - výpočet bude realizovaný len pre primárne archívne dáta.

CRC_TREE path\filename name row col from to [step]

Používa sa na kontrolu zhodnosti dát v inštančných archívoch. Vytvorenie súboru s CRC (kontrolná suma) pre archívne objekty pre zadaný časový úsek. Výpočet bude realizovaný pre objekt zadaný parametrami "meno row col" a pre všetky objekty, ktoré ovplyvňujú jeho hodnotu.
Nepovinným parametrom step (v hodinách) je možné rozdeliť výpočet pre časový úsek na intervaly.
Viď poznámku k príkazu CRC.

DEL maska [row [col]][before]

Fyzické zmazanie dát z archívnej databázy objektov špecifikovaných maskou a voliteľne aj číslom riadku/stĺpca nasledovne:

• Ak parameter before nie je definovaný - pre jednotlivé archívne objekty sa zmažú všetky dáta staršie, ako je definovaná hĺbka archivácie (parameter Čas archivácie) v konfigurácii týchto objektov

• Ak parameter before je definovaný - zmažú sa všetky dáta s časovou značkou staršou ako, je definovaná parametrom before.

Formát pre zadávanie času je "dd-mm-rrrr hh:mi:ss.mss".

Príklady:
DEL H.Sec "01-01-2010 00:00:00.000" 
DEL H.MyStructCol 3 "01-01-2010 00:00:00.000"
DEL H.MyStruct 3 2 "01-01-2010 00:00:00.000"

Fyzické zmazanie dát z archívnej databázy bez vyvolania prepočtu závislých štatistík (obdoba akcie DELETEARCHDATA).
Formát pre zadávanie času je "dd-mm-rrrr hh:mi:ss.mss".
Príklady:
DELETE_DATA H.Sec "01-01-2010 00:00:00.000" "01-01-2010 00:00:01.000"
DELETE_DATA H.MyStructCol 3 "01-01-2010 00:00:00.000" "01-01-2010 00:00:01.000"
DELETE_DATA H.MyStruct 3 2 "01-01-2010 00:00:00.000" "01-01-2010 00:00:01.000"

DI ON/OFF [maska [row [col]]]

Debug Info - zapnutie, resp. vypnutie zobrazovania vnútorných ladiacich informácií procesu D2000 Archiv (v okne procesu a v procese D2000 Sysconsole).

Debug Info pre hodnoty - zapnutie / vypnutie zobrazovanie hodnôt archívnych objektov s uvedeným HOBJ, resp. s menom vyhovujúcim udanej maske. Pre štruktúrované archívy je možné špecifikovať aj konkrétnu položku štruktúry, resp. konkrétny stĺpec (ak ROW=0) alebo riadok (ak COL=0).

Príklady:
DP ON H.Test1 3 4 - zapnutie debugu na položke štruktúry H.Test1 v 3. riadku a 4. stĺpci
DP ON H.Test2 - zapnutie debugu na archívny objekt H.Test2 (pokiaľ ide o štruktúrovaný archív, tak na všetky položky štruktúry)
DP OFF 1234 0 4 - vypnutie debugu na celý 4. stĺpec štruktúrovaného archívu s HOBJ=1234

Štandardne sa zobrazujú iba čas a hodnota archívneho objektu. Pomocou zapnutia debug kategórie DBG.ARCHIV.DATA (v procese D2000 System Console alebo pomocou štartovacieho parametra /E+DBG.ARCHIV.DATA pri štartovaní procesu D2000 Archiv) je možné zobraziť kompletné ukladané údaje, ktoré slúžia pre vývojárov systému D2000:
Time (čas archivovanej hodnoty)
Value (vlastná hodnota)
Status (pole True/False hodnôt Valid, ProcAlarm, NoAckPAlarm, PrAlSilent, Weak, NoAckValue, Transient, Default, Manual, AlCrit, Unknown)
Limits (jedna z hodnôt InLimit, VL_Limit, L_Limit, H_Limit, VH_Limit, LimitsProblem)
ArchFlags (pole True/False hodnôt Start, Stop, Block, UnBlock, Deleted, UserModify, OldVal, ProcesModify, LoadData, MONO_TIME, K, L, M, N, O, Ver1)

DI ONREC/OFFREC HOBJ/maska [ROW [COL]]

Debug Info pre hodnoty - rekurzívne. Príkaz rozširuje funkcionalitu predchádzajúceho príkazu o zapnutie/vypnutie debugu pre archívne objekty, ktoré závisia na udaných archívnych objektoch (napr. minútové priemery).

Platforma Sybase: Parameter path+trezor_name určuje cestu a meno trezorovej databázy, ktorá sa má odmontovať. V mene trezorovej databázy je povolené používať znaky * a ? pre definovanie masky. Ak zadanej maske zodpovedá viac súborov, budú odmontované všetky vyhovujúce.

Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

Platforma Oracle: Parameter Id alebo trezor_name určuje číslo (meno) trezora, ktorý sa má odmontovať.
Meno trezora je názov tablespace (napr. MYAPP_TS_TREZOR15 alebo MYAPP_TS_TREZOR15_02) alebo názov dátového súboru (napr. MYAPP_TS_TREZOR0015_S02_20040801.ORA).
Je možné odmontovať všetky trezory (okrem aktuálne plnených) zadaním parametra all. Parametre IdFrom a IdTo umožňujú odmontovať celý interval trezorov.
Parameter SEGMENT seg, kde seg je číslo trezorového segmentu, umožňuje odmontovať jeden konkrétny trezorový segment. Seg je číslo medzi 0 a TrezorCountSegments. Pokiaľ sa príkaz DISMOUNT_TREZOR použije v konfigurácii so zapnutými trezorovými segmentmi bez parametra SEGMENT seg, pokúša sa odmontovať všetky segmenty vybraného trezora/trezorov.

Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

Platforma PostgreSQL: Parameter Id určuje číslo trezora, ktorý sa má odmontovať.
Je možné odmontovať všetky trezory (okrem aktuálne plnených) zadaním parametra all. Parametre IdFrom a IdTo umožňujú odmontovať celý interval trezorov.
Parameter SEGMENT seg, kde seg je číslo trezorového segmentu, umožňuje odmontovať jeden konkrétny trezorový segment. Seg je číslo medzi 0 a TrezorCountSegments. Pokiaľ sa príkaz DISMOUNT použije v konfigurácii so zapnutými trezorovými segmentmi bez parametra SEGMENT seg, pokúša sa odmontovať všetky segmenty vybraného trezora/trezorov.
Parameter WRITE spôsobí, že trezory budú namontované na zápis. Do takto namontovaného trezoru je možné vkladať dáta pomocou arcsynchro.

Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

DP ON/OFF

Debug Pipe - zapnutie / vypnutie zobrazovania komunikácie s procesom D2000 Server (len ak je okno procesu zobrazené na pracovnej ploche).

Príkaz vytvorí súbor (podľa parametra path+filename) obsahujúci SQL príkazy na zmazanie tabuliek, ktoré aktuálna konfigurácia archívu nepoužíva. Ak sú zapnuté časové rezy, v súbore budú aj príkazy na zmazanie príslušných riadkov z tabuľky ARC_SLICE, ktoré obsahujú informácie o jednotlivých časových rezoch zodpovedajúcich mazaným tabuľkám.

Ručné naplnenie archívnej cache (iba ak pracuje v móde izochrónnej cache) načítaním hodnôt z archívnej databázy.
Naplnenie archívnej cache môže byť aj automatické po štarte - viac informácií viď popis parametra IsoCacheAutoFill.

Na zvolenom objekte/objektoch sa nastaví čas ClearTime na hodnotu niekoľko hodín v minulosti, čo znamená, že v krátkom čase (do minúty) sa vykoná periodické mazanie dát tohto objektu (pokiaľ nie je z nejakého dôvodu vypnuté, napr. pri zapnutých časových rezoch v závislosti od parametrov DeleteInSlice0 a DeleteInSlices).

Príkaz FREEZE spôsobí, že zapisovacie aj výpočtové tasky archívu prestanú spracúvať požiadavky po dobu freeze_seconds. Počas tejto doby bude ďalší task (mazací) vypisovať počty požiadaviek (primárnych a vypočítaných) vo frontoch. Po uplynutí doby freeze_seconds sa spracovanie hodnôt obnoví. Pokiaľ bol zadaný parameter report_seconds, tak mazací task bude pokračovať vo výpise počtov požiadaviek vo frontoch ešte túto dobu.
Príkaz FREEZE je primárne určený k výkonnostným testom (otestovanie maximálnej rýchlosti spracovania požiadaviek pod záťažou) a pred použitím je potrebné si uvedomiť, že síce neovplyvňuje čítanie z archívu, ale počas jeho trvania sa po dobu freeze_seconds do archívu nič nezapisuje (takže pri čítaní nie sú k dispozícii najnovšie hodnoty) a ani neprebiehajú výpočty. V redundantných systémoch s 2 a viac archívmi odporúčame vykonávanie FREEZE príkazu na pasívnej inštancii, aby sa neovplyvňovala funkčnosť archívneho subsystému.
Pokiaľ je nutné prerušiť neaktivitu spôsobenú FREEZE príkazom, je to možné príkazom UNFREEZE (bez parametrov).

Príkaz vypíše zoznam trezorových databáz, s ktorými proces D2000 Archiv pracuje. Obsah zoznamu sa líši v závislosti od použitej platformy - Sybase, Oracle alebo PostgreSQL.
Parameter id:

• pre Sybase - názov trezorovej databázy

• pre Oracle - číslo trezorového tabuľkového priestoru (tablespace)

• pre PostgreSQL - číslo trezorovej databázy

LOAD_TREZOR path+filename [mask] [from] [to]

On-line import trezorovej databázy.

Platforma Sybase: Parameter path+trezor_name určuje cestu a meno trezorovej databázy, ktorá sa má namontovať. V mene trezorovej databázy je povolené používať znaky * a ? pre definovanie masky. Ak zadanej maske zodpovedá viac súborov, budú namontované všetky vyhovujúce.

Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

Platforma Oracle: Parameter Id (trezor_name) určuje číslo (meno) trezora, ktorý sa má namontovať. Parametre IdFrom a IdTo umožňujú namontovať celý interval trezorov.
Meno trezora je názov tablespace (napr. MYAPP_TS_TREZOR15 alebo MYAPP_TS_TREZOR15_02) alebo názov dátového súboru (napr. MYAPP_TS_TREZOR0015_S02_20040801.ORA).
Parameter SEGMENT seg, kde seg je číslo trezorového segmentu, umožňuje namontovať jeden konkrétny trezorový segment. Seg je číslo medzi 0 a TrezorCountSegments. Pokiaľ sa príkaz MOUNT použije v konfigurácii so zapnutými trezorovými segmentmi bez parametra SEGMENT seg, pokúša sa namontovať všetky segmenty vybraného trezora/trezorov.
Parameter WRITE umožňuje namontovať trezor/trezory na zápis (kvôli synchronizácii trezorov nástrojom Arcsynchro)
Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

Platforma PostgreSQL: Parameter Id určuje číslo trezora, ktorý sa má namontovať. Parametre IdFrom a IdTo umožňujú namontovať celý interval trezorov.
Parameter SEGMENT seg, kde seg je číslo trezorového segmentu, umožňuje namontovať jeden konkrétny trezorový segment. Seg je číslo medzi 0 a TrezorCountSegments. Pokiaľ sa príkaz MOUNT použije v konfigurácii so zapnutými trezorovými segmentmi bez parametra SEGMENT seg, pokúša sa namontovať všetky segmenty vybraného trezora/trezorov.
Parameter WRITE umožňuje namontovať trezor/trezory na zápis (kvôli synchronizácii trezorov nástrojom Arcsynchro)
Pre viac informácií pozri kapitolu On-line sprístupnenie údajov z trezorových databáz.

OPTIMIZE_QUEUE

Redukcia požiadaviek na prepočet vo fronte archívu. Pokiaľ z nejakého dôvodu narástol počet požiadaviek vo fronte archívu (napr. v dôsledku príchodu starých hodnôt z komunikácie), je možné týmto tell príkazom zredukovať duplicitné požiadavky.

Vytvorenie súboru obsahujúceho popisy nevybavených požiadaviek.

Prepočet hodnôt v štatistických a vypočítaných archívoch.
Maska - určuje zoznam objektov, ktoré sa majú prepočítať. V prípade potreby prepočtu konkrétneho riadku a/alebo stĺpca štruktúrovaného archívu je možné zadať parametre Row a Col (ak nie sú zadané, nadobúdajú hodnotu 0 znamenajúcu "celý riadok/stĺpec").

Parametre <From, To> určujú časový interval, ktorý bude prepočítaný. Ak nie je zadaný koncový čas, nahradí sa aktuálnym časom. Formát pre zadávanie času je dd-mm-rrrr [hh[:mi[:ss[.mss]]]].
Voliteľný parameter BACKGROUND spôsobí, že prepočet prebehne na pomocnom prepočtovom tasku (viď parameter archívu RecalcImmediateDepth). Parameter je vhodné použiť, pokiaľ sa robia väčšie prepočty hodnôt v minulosti, ktoré sa majú vykonávať na pozadí, pričom archív pokračuje v bežnom archivovaní dát v reálnom čase.

Ďalšie voliteľné parametre špecifikujú režim prepočtu:

• Parameter NODEPEND spôsobí, že sa nebudú prepočítavať závislé štatistické a vypočítané archívne objekty. Štandardne sú závislé objekty prepočítané (kvôli udržovaniu konzistencie dát).

• Parameter FORCE spôsobí, že sa budú vždy prepočítavať závislé štatistické a vypočítané archívne objekty, aj keď výpočet ich zdrojových archívov skončí s tým, že neboli žiadne zmenené dáta (viď parameter archívu RecalcOptimize). Tento parameter slúži na skonsolidovanie archívnej databázy, ktorá obsahuje nekonzistentné dáta.

• Parameter FORCEONDEMAND spôsobí, že sa budú prepočítavať závislé štatistické a vypočítané archívne objekty, ktoré majú nastavené výpočet na požiadanie, aj keď výpočet ich zdrojových archívov skončí s tým, že neboli žiadne zmenené dáta (viď parameter archívu RecalcOptimize).

• Pokiaľ nie je špecifikovaný žiaden z týchto parametrov, vykoná sa prepočet aj závislých štatistických a vypočítaných archívnych objektov, pričom v závislosti od parametrov archívu RecalcOptimize a IsochronousCache sa uplatňujú optimalizácie výpočtov.

Parameter VERBOSE zapína pomocné ladiace výpisy o jednotlivých prepočtoch.

Poznámka: Pokiaľ má parameter RecalcTimeIntervalLimit nenulovú hodnotu a časový interval <From, To> je väčší ako RecalcTimeIntervalLimit hodín, je nutné zadať voliteľný parameter BACKGROUND, aby prepočet prebehol na pomocnom prepočtovom tasku. Toto chovanie je implementované ako ochrana voči zahlteniu hlavného tasku prepočtami.

Predčasné odpojenie aktuálnej trezorovej databázy.

Príkaz slúži na vynútenie načítania posledných hodnôt zadaných objektov z archívnej databázy. Objekty je možné špecifikovať podľa mena/masky a podľa typu:

• SCRIPT - skriptom

• PRIMARY - primárne archívne objekty

• STATISTIC - štatistické archívne objekty

• EVAL - vypočítané archívne objekty

• ALL - všetky typy archívnych objektov

Pokiaľ napr. v testovacom prostredí nie je funčné vkladanie skriptom plnených archívov, ale tieto sú do archívnej databázy vkladané utilitou arcsynchro, je možné po skončení vkladania vykonať tell príkaz (napr. RELOAD_VALUES * STATISTIC). Následne sa vykoná čítanie (napr. všetkých skriptom plnených archívnych objektov) a môže sa iniciovať vykonanie prepočtov archívnych objektov, ktoré na načítaných objektoch závisia.

Ak sú zapnuté časové rezy, príkaz spôsobí, že archív prejde všetky časové rezy jednoduchých archívnych objektov podľa zadaného HOBJ alebo masky a zruší tie časové rezy, ktoré neobsahujú žiadne dáta.
Príkaz slúži na čistenie archívnej databázy od prázdnych časových rezov, ktoré vznikali v dôsledku chyby archívu. Táto chyba bola odstránená v podporovaných verziách 8. júna 2015.

On-line reorganizácia archívnej databázy. Príkaz skomprimuje všetky archívne tabuľky (Oracle príkaz ALTER TABLE MOVE, resp. Sybase príkaz REORGANIZE TABLE INDEX resp. PostgreSQL príkaz VACUUM - viď popis parametra archívu PG_ReorganizeSlice).

Poznámka: Len pre platformy Oracle, PostgreSQL a Sybase 8.0 a vyššie.

On-line reorganizácia tabuľky archívnej databázy s uvedeným HOBJ alebo s názvom archívneho objektu zodpovedajúcim zadanej maske. V prípade, že je definovaný aj parameter tablespace, daná tabuľka bude presunutá do nového tablespace-u. Ak sú zapnuté časové rezy, všetky časové rezy archívneho objektu so zadaným HOBJ budú reorganizované/presunuté, pokiaľ nie je špecifikované číslo časového rezu slice.

Poznámka 1: Parameter tablespace je použiteľný len pre platformy Oracle a PostgreSQL.
Poznámka 2: Číslo časového rezu okrem bežných hodnôt podporuje aj špeciálne hodnoty:

• hodnota -1 znamená "všetky časové rezy"

• hodnota -2 znamená "časový rez pre aktuálny čas"

• hodnota -3 znamená "predchádzajúci časový rez"

• hodnota -4 znamená "všetky časové rezy staršie ako aktuálny časový rez"

• hodnota -5 znamená "iba tie archívne objekty, ktoré nemajú časové rezy" (ak sú časové rezy nakonfigurované iba pre štruktúrované archívy, tak sa zreorganizujú iba jednoduché)

REORGANIZE ON

Povolenie reorganizácie archívnej databázy (ekvivalent k spusteniu procesu D2000 Archiv s parametrom /DBCY).

REORGANIZE OFF

Zakázanie reorganizácie archívnej databázy (ekvivalent k spusteniu procesu D2000 Archiv bez parametra /DBCY).

REORGANIZE ACTIVE

Povolenie reorganizácie archívnej databázy iba v aktívnom móde (ekvivalent k spusteniu procesu D2000 Archiv s parametrom /DBCA).

REORGANIZE PASSIVE

Povolenie reorganizácie archívnej databázy iba v pasívnom móde (ekvivalent k spusteniu procesu D2000 Archiv s parametrom/DBCP).

REORGANIZE SHRINK

Povolenie alternatívneho spôsobu reorganizácie archívnej databázy - iba pre Oracle 10g a vyšší (ekvivalent k spusteniu procesu D2000 Archiv s parametrom/DBCS).
Poznámka: Zapnutie pôvodného spôsobu je tell príkazom REORGANIZE MOVE.

REORGANIZE TABLEROWLIMIT rowlimit

On-line zmena parametra ReorganizeTableRowLimit pre automatickú reorganizáciu archívnej databázy.

REORGANIZE TABLETIMELIMIT timelimit

On-line zmena parametra ReorganizeTableTimeLimit pre automatickú reorganizáciu archívnej databázy.

Príkaz umožňuje zmeniť veľkosť dynamickej cache na zrýchlenie výpočtov štatistických archívnych objektov počas behu procesu D2000 Archiv.

Poznámka 1: Veľkosť cache pri štarte procesu D2000 Archiv je určená parametrom MaxCacheSize v procese D2000 Management Console.
Poznámka 2: Príkaz SET_CACHE zároveň zmení aj parameter MaxCacheSize v registri.

Tell príkazom SET_OPTION sa dajú meniť nasledovné "štartovacie" a konfiguračné parametre procesu archív: