ORACLE SQL v2 konektor
Naposledy aktualizované
Konektor ORACLE SQL v2 slúži na pravidelnú synchronizáciu konfiguračných položiek (CI) jedného typu z databázy Oracle do CMDB v CDESK. Ide o druhú verziu konektora ORACLE SQL. Podobne ako prvá verzia načíta údaje SQL dotazom, podľa identifikátora z databázy existujúce CI aktualizuje a chýbajúce CI založí. Navyše dokáže prenášať stav a vlastníka CI a CI, ktoré v databáze Oracle prestali existovať, označí nastaveným stavom.
Plný názov konektora v ponuke typov je „Oracle SQL synchronizácia údajov do CMDB v2“.
Čo konektor umožňuje – konektor prenáša údaje jedným smerom, z databázy Oracle do CMDB v CDESK. Umožňuje:
- Zakladanie a aktualizáciu CI zvoleného typu – CI sa párujú podľa identifikátora z databázy, ktorý sa v CI uloží do poľa Sync. ID. Riadky s prázdnym identifikátorom sa preskočia.
- Priradenie spoločnosti, prevádzky a miesta – spoločnosť sa vyhľadá v Adresári podľa názvu, prevádzka a miesto podľa názvu príslušného CI.
- Prenos vlastníka CI – vlastník sa vyhľadá medzi používateľmi CDESK podľa osobného čísla.
- Prenos stavu CI – hodnoty stavu z databázy sa prevedú na stavy CI v CDESK podľa nastaveného mapovania.
- Označenie odstránených záznamov – CI, ktoré sa pri synchronizácii nenachádzajú vo výsledku dotazu, dostanú nastavený stav.
- Prenos hodnôt vlastností CI – textové, číselné a dátumové vlastnosti typu CI je možné naplniť hodnotami zo stĺpcov dotazu.
- Pripojenie k viacerým databázovým serverom – pri databáze, ktorá beží na viacerých serveroch, je možné nastaviť záložné pripojenie (FAILOVER) a rozloženie záťaže (LOAD_BALANCE).
- Viac konektorov – v CDESK je možné pridať viac konektorov tohto typu, napríklad pre rôzne typy CI.
Rozdiely oproti konektoru ORACLE SQL – obidve verzie sa nastavujú rovnako a majú rovnaké prístupové údaje k databáze. Líšia sa v tom, ktoré údaje CI dokážu prenášať a ako zaobchádzajú s CI, ktoré v databáze chýbajú:
- Stav CI – verzia 2 prenáša stav CI a má na to záložku Mapovanie stavov. Prvá verzia stav neprenáša.
- Vlastník CI – verzia 2 prenáša vlastníka podľa osobného čísla používateľa. Prvá verzia vlastníka neprenáša.
- Chýbajúce záznamy – verzia 2 označí CI, ktoré v databáze chýbajú, nastaveným stavom. Prvá verzia ich ponechá bez zmeny.
- Dátumové vlastnosti – verzia 2 ponúka na mapovanie aj vlastnosti typu dátum a dátum s časom.
- Archivácia, nákladové stredisko a oblasť – tieto údaje prenáša len prvá verzia. Verzia 2 ich v mapovaní neponúka.
- Načítanie údajov – verzia 2 zoraďuje výsledok dotazu podľa identifikátora, aby sa pri načítaní po častiach žiadny riadok nevynechal ani nezopakoval. Zároveň zabraňuje založeniu dvoch CI s rovnakým identifikátorom.
Predpoklady
Pred nastavením konektora je potrebné overiť tieto predpoklady:
- Konektor je dostupný na požiadanie. Ak sa v ponuke typov konektora nezobrazuje, je potrebné kontaktovať poskytovateľa systému CDESK.
- Server CDESK musí mať sieťový prístup k databázovému serveru Oracle a podporu pripojenia k databáze Oracle.
- V databáze Oracle je potrebný používateľský účet s prístupom na čítanie údajov, ktoré dotaz načítava.
- V CMDB musí existovať cieľový typ CI. Ak sa má prenášať stav, typ CI musí mať zapnuté stavy CI. Ak sa má prenášať vlastník, typ CI musí mať zapnutú väzbu na vlastníka.
- V Adresári musia existovať spoločnosti s rovnakými názvami, aké vracia databáza. Pri prenose vlastníka musia mať používatelia vyplnené pole Osobné číslo používateľa.
- Na pridanie a úpravu konektora je potrebné právo zápisu do Globálnych nastavení.
Príprava v externom systéme
Na strane databázy Oracle je potrebné pripraviť prístup pre CDESK a údaje v tvare, ktorý konektor dokáže spracovať. Príprava je rovnaká ako pri konektore ORACLE SQL a vykonáva ju správca databázy v týchto krokoch:
- Správca vytvorí v databáze Oracle účet s právom na čítanie tabuliek alebo pohľadov, z ktorých bude dotaz čítať.
- Správca overí, že databázový server je dostupný zo servera CDESK, napríklad či ho neblokuje firewall.
- Správca poskytne adresu servera, port, názov služby databázy (service name) a znakovú sadu databázy.
- Pripraví sa SQL dotaz alebo pohľad, ktorý vráti jeden riadok pre každé CI. Dotaz musí obsahovať stĺpec s jedinečným identifikátorom záznamu a stĺpec s názvom spoločnosti presne v tvare, v akom je spoločnosť zapísaná v Adresári CDESK. Ak sa majú prenášať stav a vlastník, dotaz obsahuje aj stĺpec s hodnotou stavu a stĺpec s osobným číslom vlastníka.
Dotaz nesmie obsahovať klauzuly OFFSET a FETCH NEXT. CDESK ich k dotazu dopĺňa automaticky, pretože údaje načítava po častiach.
Nastavenie konektora
Konektor sa nastavuje v Globálnych nastaveniach v dvoch fázach. Najprv sa zadajú prístupové údaje k databáze, overí sa pripojenie a konektor sa vytvorí. Potom sa v záložkách nastaví dotaz, typ CI, priradenie stĺpcov a mapovanie stavov.
Pridanie konektora
Konektor sa pridáva v sprievodcovi pridaním konektora. Pred začatím si pripravte údaje uvedené v rámčeku.
- Máte prístup do Globálnych nastavení s právom zápisu.
- Typ ORACLE SQL v2 je v ponuke typov konektora dostupný, teda ho pre vaše prostredie povolil poskytovateľ systému CDESK.
- Poznáte adresu a port databázového servera Oracle (prípadne všetkých serverov databázy), názov služby databázy a jej znakovú sadu.
- Máte prihlasovacie meno a heslo účtu Oracle s právom čítať údaje, ktoré načítava dotaz.
- Máte pripravený SQL dotaz a v CMDB existuje typ CI, do ktorého sa majú údaje synchronizovať. Ak sa má prenášať stav, poznáte hodnoty stavu, ktoré databáza vracia.
Konektor pridáte týmto postupom:
- Otvorte Globálne nastavenia → Konektory, API.
- Kliknite na tlačidlo Pridať konektor. Zobrazí sa sprievodca „Pridanie konektora“.
- V poli Typ konektora vyberte typ ORACLE SQL v2 a kliknite na tlačidlo Pokračovať.
- Vyplňte pole Názov a v časti „ORACLE DB“ zvoľte Spôsob pripojenia a vyplňte prístupové údaje k databáze.
- Kliknite na tlačidlo Test pripojenia. Ak je pripojenie úspešné, zobrazí sa hlásenie „Pripojenie na ORACLE DB prebehlo úspešne.“, prepínač vedľa tlačidla sa zapne a zobrazí sa záložka Databázový dotaz.
- V záložke Databázový dotaz zadajte SQL dotaz do poľa Query a overte ho kliknutím na tlačidlo Test query.
- Kliknite na tlačidlo Vytvoriť. Konektor sa uloží a formulár sa otvorí v režime úprav.
- V záložke Mapovanie stĺpcov a vlastností vyberte v poli CI Type cieľový typ CI a priraďte stĺpce dotazu k údajom CI.
- Ak typ CI používa stavy, nastavte v záložke Mapovanie stavov prevod hodnôt stavu a stav pre odstránené záznamy.
- Zapnite prepínač Zapnuté a kliknite na tlačidlo Uložiť.
Význam polí
Horná časť formulára je rovnaká ako pri konektore ORACLE SQL a obsahuje spoločné polia konektora, prístupové údaje k databáze a čas synchronizácie. Formulár obsahuje nasledujúce polia:
- Typ konektora – typ zvolený v sprievodcovi. Po pridaní konektora sa nedá zmeniť.
- Názov – názov konektora v zozname konektorov. Pri viacerých konektoroch je vhodné uviesť v názve synchronizovaný typ CI.
- Zapnuté – zapína a vypína synchronizáciu. Vypnutý konektor sa nesynchronizuje ani v nastavenom čase, ani po kliknutí na tlačidlo Manuálna synchronizácia.
- Spôsob pripojenia – určuje, či sa CDESK pripája k jednému databázovému serveru, alebo k niekoľkým serverom tej istej databázy.
- Jeden server – zobrazia sa polia Oracle DB Server a Port.
- Viac serverov (FAILOVER) – zobrazí sa zoznam najviac 10 serverov, v ktorom má každý server vlastnú adresu a port. Ďalší server sa pridá kliknutím na tlačidlo Pridať server.
- FAILOVER – pri spôsobe pripojenia Viac serverov (FAILOVER) zapína pokus o pripojenie k ďalšiemu serveru, ak predchádzajúci neodpovedá. Predvolene je zapnuté.
- LOAD_BALANCE – pri spôsobe pripojenia Viac serverov (FAILOVER) zapína náhodný výber servera na rozloženie záťaže. Predvolene je vypnuté.
- Používateľ a Heslo – prihlasovacie údaje účtu v databáze Oracle. Heslo sa pri úprave existujúceho konektora vyplňuje len pri jeho zmene.
- Databáza – názov služby databázy Oracle (service name). Pole je povinné.
- Charset – znaková sada pripojenia, napríklad AL32UTF8. Pole je povinné.
- NLS Date format – formát dátumu pre databázové spojenie, napríklad DD.MM.YYYY. Pole je nepovinné.
- Čas synchronizácie – čas, od ktorého sa každý deň spustí automatická synchronizácia. Predvolená hodnota je 03:00.
Podrobnejší popis týchto polí je dostupný v dokumentácii konektora ORACLE SQL.
Test pripojenia
Test pripojenia overí, či sa CDESK so zadanými údajmi pripojí k databáze Oracle. Tlačidlo Test pripojenia sa nachádza pod prístupovými údajmi a je aktívne, keď sú vyplnené server, používateľ a heslo. Po úspešnom teste sa zobrazí hlásenie „Pripojenie na ORACLE DB prebehlo úspešne.“ a zapne sa prepínač vedľa tlačidla. Až potom sa pod formulárom zobrazia záložky. Pri otvorení uloženého konektora sa test pripojenia aj test dotazu spustia automaticky.
Prehľad záložiek
Záložky v dolnej časti formulára slúžia na nastavenie dotazu, mapovania a na kontrolu chýb. Zobrazia sa až po úspešnom teste pripojenia. Oproti konektoru ORACLE SQL pribudla záložka Mapovanie stavov.
| Záložka | Na čo slúži | Kedy sa zobrazuje |
|---|---|---|
| Databázový dotaz | Zadanie a overenie SQL dotazu, ktorým sa načítajú údaje. | Po úspešnom teste pripojenia. |
| Mapovanie stĺpcov a vlastností | Výber typu CI, priradenie stĺpcov dotazu k údajom CI a manuálne spustenie synchronizácie. | Po úspešnom teste pripojenia, len pri uloženom konektore. |
| Mapovanie stavov | Prevod hodnôt stavu z databázy na stavy CI a stav pre odstránené záznamy. | Po úspešnom teste pripojenia, len pri uloženom konektore a vybranom type CI so zapnutými stavmi CI. |
| Chyby synchronizácie | Zoznam riadkov z databázy, ktoré sa nepodarilo spracovať. | Po úspešnom teste pripojenia, len pri uloženom konektore. |
Záložka Databázový dotaz
Záložka Databázový dotaz slúži na zadanie SQL dotazu, ktorý konektor pri synchronizácii spúšťa v databáze Oracle. Dotaz nesmie obsahovať klauzuly OFFSET a FETCH NEXT, CDESK ich dopĺňa automaticky. Výsledok sa pri synchronizácii zoraďuje podľa stĺpca priradeného k údaju Externé ID. Záložka obsahuje tieto polia a tlačidlá:
- Query – SQL dotaz, ktorý vráti jeden riadok pre každé CI. Pole je povinné.
- Vyplniť podľa šablóny – po výbere položky ORACLE vloží do poľa Query vzorový dotaz, ktorý je potrebné upraviť podľa vašej databázy. Pôvodný obsah poľa sa prepíše.
- Test query – spustí dotaz a zobrazí tabuľku „Výsledok SQL query“ s prvými piatimi riadkami. Stĺpce výsledku sa potom ponúknu na priradenie v záložke Mapovanie stĺpcov a vlastností.
Záložka Mapovanie stĺpcov a vlastností
Záložka Mapovanie stĺpcov a vlastností určuje typ CI a to, ktorý stĺpec dotazu naplní ktorý údaj CI. Tabuľka má stĺpce CI hodnota, Povinné a Oracle hodnota a jej riadky sa vytvoria podľa zvoleného typu CI. Záložka obsahuje pole CI Type a tieto údaje CI:
- CI Type – typ CI, do ktorého sa údaje synchronizujú. Pole je povinné. Po zmene typu sa tabuľka mapovania vytvorí nanovo.
- Externé ID – jedinečný identifikátor záznamu v databáze Oracle. Uloží sa do poľa Sync. ID v CI a podľa neho sa CI párujú. Údaj je vždy povinný.
- Spoločnosť – názov spoločnosti, ku ktorej CI patrí. Vyhľadá sa v Adresári podľa presnej zhody názvu. Údaj je vždy povinný.
- Názov – názov CI. Zobrazuje sa len pri typoch CI bez automaticky generovaného názvu a vtedy je povinný.
- Prevádzka a Miesto – názov CI prevádzky alebo miesta rovnakej spoločnosti. Zobrazujú sa, ak typ CI danú väzbu používa.
- Vlastník – osobné číslo používateľa, ktorý sa nastaví ako vlastník CI. Zobrazuje sa, ak typ CI používa väzbu na vlastníka. Ak sa používateľ s daným osobným číslom nenájde, vlastník CI sa nezmení.
- Stav – hodnota stavu z databázy, ktorá sa prevedie na stav CI podľa záložky Mapovanie stavov. Zobrazuje sa, ak typ CI používa stavy.
- Vlastnosti typu CI – ďalšie riadky zodpovedajú vlastnostiam typu CI s jednou hodnotou typu text, celé číslo, desatinné číslo, dátum alebo dátum s časom.
Priradenie stĺpca sa zachová, len ak sa stĺpec s rovnakým názvom nachádza aj vo výsledku posledného testu dotazu. Po premenovaní stĺpca v dotaze je potrebné mapovanie nastaviť znova.
V záložke sa nachádza aj tlačidlo Manuálna synchronizácia, ktoré je opísané v časti Manuálna synchronizácia.
Záložka Mapovanie stavov
Záložka Mapovanie stavov slúži na prevod hodnôt stavu z databázy Oracle na stavy CI v CDESK a na nastavenie stavu, ktorý dostanú CI chýbajúce vo výsledku dotazu. Ponuka stavov obsahuje stavy CI, ktoré používa zvolený typ CI. Záložka obsahuje tieto polia:
- Stav pre odstránené záznamy – stav CI, ktorý sa nastaví všetkým CI zvoleného typu s vyplneným poľom Sync. ID, ktoré sa pri synchronizácii nenachádzali vo výsledku dotazu. Ak pole nie je vyplnené, chýbajúce CI sa nemenia.
- Stav a Hodnoty oddelené bodkočiarkou – pre každý stav CI je možné zadať hodnoty z databázy, ktoré mu zodpovedajú. Viac hodnôt sa oddeľuje znakom bodkočiarka, napríklad hodnoty AKT a ACTIVE pre stav V prevádzke. Ak sa hodnota z databázy nezhoduje so žiadnym stavom, stav CI zostane prázdny.
Záložka Chyby synchronizácie
Záložka Chyby synchronizácie zobrazuje riadky z databázy, ktoré sa nepodarilo spracovať. Každý záznam obsahuje tieto stĺpce:
- Oracle ID – hodnota identifikátora riadka z databázy. Ak zlyhá celá synchronizácia, stĺpec obsahuje hodnotu „Synchronization“. Ak sa preskočilo označovanie odstránených záznamov, stĺpec obsahuje hodnotu „Deleted records“.
- Chyba – popis chyby.
- Dátum – čas, kedy chyba vznikla.
Záznam z prehľadu zmizne po úspešnom spracovaní pri niektorej ďalšej synchronizácii.
Tlačidlá formulára
V dolnej časti formulára konektora sú dostupné tieto tlačidlá:
- Vytvoriť (pri uloženom konektore Uložiť) – uloží nastavenie konektora.
- Zmazať – odstráni konektor. Tlačidlo sa zobrazuje len pri uloženom konektore.
- Späť – vráti sa do zoznamu konektorov bez uloženia zmien.
Používanie konektora
Konektor nemá vlastnú obrazovku na každodennú prácu. Zapnutý konektor synchronizuje CI automaticky raz denne a výsledok sa prejaví v zozname CI zvoleného typu v CMDB a v detaile jednotlivých CI. Táto časť opisuje priebeh automatickej synchronizácie vrátane označenia odstránených záznamov a manuálne spustenie synchronizácie.
Automatická synchronizácia
CDESK každú minútu kontroluje, či má niektorý zapnutý konektor ORACLE SQL v2 spustiť synchronizáciu. Synchronizácia sa spustí raz denne, keď je aktuálny čas rovnaký alebo neskorší ako hodnota v poli Čas synchronizácie a konektor sa v daný deň ešte nesynchronizoval.
Pri synchronizácii konektor načíta údaje z databázy po 500 riadkoch a spracuje ich týmto postupom:
- Preskočí riadky s prázdnou hodnotou Externé ID.
- Vyhľadá CI zvoleného typu s rovnakou hodnotou v poli Sync. ID. Ak také CI neexistuje, založí nové CI.
- Nastaví spoločnosť, názov, prevádzku, miesto, vlastníka, stav a hodnoty priradených vlastností. Ak spoločnosť alebo povinná väzba neexistuje, riadok sa nespracuje a zapíše sa do záložky Chyby synchronizácie.
- Po spracovaní všetkých riadkov nastaví CI, ktoré sa vo výsledku dotazu nenachádzali, do stavu z poľa Stav pre odstránené záznamy, ak je vyplnené.
Označovanie odstránených záznamov sa týka všetkých CI zvoleného typu s vyplneným poľom Sync. ID, aj tých, ktoré vznikli inak ako týmto konektorom. Ak dotaz nevráti žiadne riadky, označovanie sa preskočí a zapíše sa hlásenie do záložky Chyby synchronizácie.
Príklad z praxe – konektor synchronizuje typ CI Notebooky z evidencie majetku. Stĺpec so stavom majetku obsahuje hodnoty AKT a VYR. V záložke Mapovanie stavov je hodnota AKT priradená stavu V prevádzke a hodnota VYR stavu Vyradené. Ako stav pre odstránené záznamy je zvolený stav Vyradené, takže notebooky vymazané z evidencie sa v CDESK označia ako vyradené.
Manuálna synchronizácia
Manuálna synchronizácia sa využíva pri prvom nastavení konektora alebo po zmene mapovania, keď nie je vhodné čakať na nastavený čas. Manuálnu synchronizáciu spustíte týmto postupom:
- Otvorte konektor v Globálne nastavenia → Konektory, API.
- Prejdite na záložku Mapovanie stĺpcov a vlastností.
- Kliknite na tlačidlo Manuálna synchronizácia. Konektor sa uloží a zobrazí sa text „Synchronizácia sa spúšta“.
- Synchronizácia sa spustí do jednej minúty a počas jej behu sa zobrazuje text „Synchronizácia beží“.
- Kliknutím na tlačidlo Aktualizovať sa načíta aktuálny stav. Po skončení sa zobrazí „Výsledok poslednej manuálnej synchronizácie“ s textom „Manuálna sycnhronizácia prebehla úspešne“ alebo so zoznamom chýb.
- Skontrolujte záložku Chyby synchronizácie a odstráňte príčiny chýb v databáze Oracle alebo v CDESK.
Manuálna synchronizácia sa započíta ako synchronizácia daného dňa. Ak prebehne pred nastaveným časom, automatická synchronizácia sa v ten deň už nespustí. Ak manuálna synchronizácia beží dlhšie ako dve hodiny, CDESK ju označí ako neúspešnú.
Riešenie problémov
Hlásenia pri pripojení a ukladaní konektora sú rovnaké ako pri konektore ORACLE SQL. Nasledujúca tabuľka obsahuje najčastejšie hlásenia a hlásenia, ktoré sú špecifické pre verziu 2.
| Hlásenie | Čo znamená a ako postupovať |
|---|---|
| „Je potrebné nastaviť aspoň jedno mapovanie Oracle hodnoty na CDESK vlastnosť“ | V záložke Mapovanie stĺpcov a vlastností nie je priradený žiadny stĺpec. Otestujte dotaz a priraďte stĺpce. |
| „Chýbajúci údaj – CI Type“ | Pri uloženom konektore nie je vybraný typ CI. Vyberte ho v poli CI Type. |
| „company with name … was not found“ | Spoločnosť z databázy neexistuje v Adresári pod rovnakým názvom. Založte spoločnosť alebo zjednoťte názov. |
| „empty name not allowed for CI Type“ | Typ CI vyžaduje názov a stĺpec priradený k údaju Názov je v riadku prázdny. |
| „branch with name … was not found“, „place with name … was not found“ | Povinná prevádzka alebo miesto sa nenašli medzi CI danej spoločnosti. Skontrolujte názov a spoločnosť príslušného CI. |
| „Zdroj nevrátil žiadne riadky, označovanie odstránených záznamov bolo preskočené (…)“ | Dotaz nevrátil žiadne riadky, preto CDESK nezmenil stav žiadneho CI. Overte dotaz kliknutím na tlačidlo Test query a dostupnosť údajov v databáze. |
| „Manuálna synchronizácia neprebehla úspešne. Prekročila povolený časový limit 2 hodiny.“ | Synchronizácia sa nedokončila v časovom limite. Overte rýchlosť dotazu v databáze. |
Test pripojenia je neúspešný
Ak prepínač vedľa tlačidla Test pripojenia zostane po teste vypnutý, CDESK sa k databáze nepripojil a záložky sa nezobrazia. Príčinou môže byť:
- Nesprávne prístupové údaje – server, port, názov služby databázy, používateľ alebo heslo obsahuje chybnú hodnotu.
- Nedostupný server – databázový server nie je zo servera CDESK dostupný, napríklad pre nastavenie firewallu.
- Chýbajúca podpora Oracle na serveri CDESK – v hlásení sa zobrazí text „PDO OCI rozšírenie nie je nainštalované.“ a je potrebné kontaktovať poskytovateľa systému CDESK.
Bola táto stránka užitočná?
Ďakujeme za spätnú väzbu.