Pregled povezav z bazami podatkov¶

Vsebina¶

1. Kako delujejo povezave
2. Vodiči za tehnologije
3. Predpogoj: namestite gonilnik ODBC na gostitelja digna
4. Ustvarite povezavo z bazo podatkov
5. Lastnosti ODBC
6. Šifriranje vrednosti lastnosti
7. Testiranje povezave
8. Katero bazo podatkov vidi povezava
9. Način profiliranja in delovna shema
10. Uporaba DSN
11. Odpravljanje težav

Kako delujejo povezave¶

digna dostopa do vsake izvorne tehnologije prek ODBC. Povezava je seznam lastnosti ODBC, ki jih vnesete kot pare ključ/vrednost. Ko digna odpre povezavo, te pare združi v niz za povezavo — Key=Value, ločeno z ;, v vrstnem redu, v katerem ste jih navedli — in ga preda upravitelju gonilnikov ODBC na gostitelju digna.

Ker lastnosti vnesete sami, je nastavitev brez DSN (DSN-less): povezava vsebuje vse, kar gonilnik potrebuje, zato na gostitelju ni treba registrirati nobenega vira podatkov ODBC (DSN). To je priporočen način konfiguracije digna, saj definicija povezave v celoti živi v digna in se premika skupaj z njo.

Zakaj ODBC¶

Prejšnje različice so ponujale izbiro med gonilnikom za posamezno tehnologijo in ODBC, ki se je izbirala s stikalom Use ODBC. Od Release 2026.06 digna temelji izključno na ODBC. En sam standardni vmesnik vam ponuja več kot nabor namenskih gonilnikov:

• Avtentikacija — avtentikacija je del ODBC, zato lahko povezava uporablja karkoli, kar podpira njen gonilnik: gesla, žetone in PAT, Kerberos in Active Directory, MFA in enotno prijavo v brskalniku, oblačno identiteto, odjemalske certifikate in TLS. Nove metode pridejo s posodobitvijo gonilnika, namesto da bi čakali na izdajo digna.
• Gonilniki, ki jih vzdržujejo proizvajalci baz podatkov — proizvajalčev lastni gonilnik sledi novim različicam strežnika in varnostnim popravkom, posodobite pa ga lahko po lastnem urniku, neodvisno od digna.
• En način za konfiguracijo vsega — vsaka tehnologija je seznam lastnosti ključ/vrednost, z istim vmesnikom, istim šifriranjem občutljivih vrednosti in istim odpravljanjem težav, namesto različnega nabora polj za vsak vir.
• Prilagajanje in doseg — možnosti na ravni gonilnika, kot so časovne omejitve, nastavitve TLS, posredniški strežniki in velikosti pridobivanja (fetch size), so na voljo za vsak vir, povežete pa lahko katero koli tehnologijo z ustreznim gonilnikom ODBC, vključno s tistimi, za katere digna ne objavlja namenskega vodiča.

Vodiči za tehnologije¶

Imena lastnosti se razlikujejo glede na gonilnik, vsaka tehnologija pa ima eno ali dve podrobnosti, ki jih druge nimajo. Spodnji vodiči zajemajo ta del; ta stran zajema stran digna, ki je enaka za vse.

Predpogoj: namestite gonilnik ODBC na gostitelja digna¶

digna odpira povezave z viri s strežnika, na katerem teče zaledje digna, ne iz brskalnika. Gonilnik ODBC mora biti zato nameščen na tem računalniku, njegovo ime pa registrirano pri lokalnem upravitelju gonilnikov.

odbcinst -q -d

odbcinst -q -d

Namesto registriranega imena vsi običajni upravitelji gonilnikov sprejmejo tudi celotno pot do knjižnice gonilnika, na primer Driver=/opt/simba/spark/lib/64/libsparkodbc_sb64.so. To je uporabno, kadar je gonilnik nameščen, ni pa registriran.

Ustvarite povezavo z bazo podatkov¶

Odprite Admin Panel, pojdite na zavihek Database Connections in kliknite Add DB Connection. Zaslon zahteva pet podatkov:

Povezava se upravlja centralno in se nato dodeli enemu ali več projektom, tako da lahko ista povezava služi več projektom.

Lastnosti ODBC¶

Za vsako lastnost kliknite Add Property in izpolnite Key, Value ter za skrivnosti potrditveno polje Encrypted. Vsak vodič za tehnologijo navaja primer nabora za to tehnologijo, ki ga prilagodite svoji različici gonilnika in strežniku — glejte opombo zgoraj.

Ne glede na gonilnik nabor lastnosti zajema iste štiri stvari:

• Driver — registrirano ime gonilnika, kot je opisano zgoraj.
• Naslov strežnika — ključ se razlikuje glede na gonilnik: SERVER, HOST, DBCNAME, Server ali, pri Oracle, opisnik povezave DBQ.
• Poverilnice — običajno UID in PWD; Snowflake uporablja UID in token, Databricks pa dobesednega uporabnika token in osebni dostopni žeton v PWD.
• Baza podatkov ali katalog, v katerem se dela, kjer ga tehnologija ima — glejte Katero bazo podatkov vidi povezava.

Vse drugo, kar dokumentira gonilnik, lahko dodate na enak način — združevanje povezav (connection pooling), časovne omejitve vtičnic, nastavitve Kerberos, nastavitve posredniškega strežnika. digna lastnosti ne tolmači; samo posreduje jih naprej.

Šifriranje vrednosti lastnosti¶

Označite Encrypted za vsako lastnost, ki vsebuje skrivnost — PWD, token, skrivnost odjemalca. Vrednost se nato šifrira, preden se shrani v repozitorij digna, na zaslonu je zakrita, dešifrira pa se šele, ko se sestavi niz za povezavo.

Lastnosti, ki niso skrivne — ime gonilnika, gostitelj, vrata, baza podatkov — je najbolje pustiti nešifrirane, da ostanejo berljive za tistega, ki bo povezavo pozneje vzdrževal.

Testiranje povezave¶

V pogovornem oknu Add DB Connection kliknite Test, preden shranite. Test uporabi vrednosti, ki so trenutno v obrazcu, in izvede dejansko povezavo, zato poroča natanko to, na kar bi naletela inšpekcija — napačno ime gonilnika, zavrnjeno geslo, nedosegljivega gostitelja. Nič se ne shrani: testna povezava se razveljavi (rollback), ne glede na to, ali uspe ali ne.

Za povezavo, ki že obstaja, se na zavihku Database Connections z miško postavite nad njeno vrstico in kliknite ikono vtiča, da jo znova testirate. To je najhitrejši način, da preverite, ali je vir dosegljiv po menjavi gesla ali spremembi požarnega zidu.

Katero bazo podatkov vidi povezava¶

Ko dodate vir podatkov, digna ponudi kataloge, sheme in tabele, ki jih povezava doseže. Kako daleč to seže, je odvisno od tehnologije:

Način profiliranja in delovna shema¶

Način profiliranja določa, kako digna obdeluje podatke in izračunava metrike:

• Standard: Metrike se izračunajo neposredno na izvornih tabelah, brez kopiranja podatkov.
• Permanent: Podatki za pregledovani dan se kopirajo v trajno tabelo, metrike pa se izračunajo na kopiranih podatkih.
• Session: Podatki se kopirajo v sejno ali začasno tabelo, metrike pa se izračunajo na teh začasnih podatkih.

Način določa, kaj mora uporabnik povezave smeti početi:

Standard samo bere, zato je to način, ki ga izberete, kadar ima digna dostop samo za branje. Work Schema se bere samo pri Permanent, vendar jo je vseeno vredno izpolniti, da povezava deluje naprej, če se način pozneje spremeni.

Uporaba DSN¶

DSN še vedno deluje — DSN je le še ena lastnost:

Key: DSN        Value: my_registered_dsn
Key: UID        Value: <user>
Key: PWD        Value: <password>        [Encrypted]

DSN mora biti registriran na gostitelju digna, za isti uporabniški račun, pod katerim teče zaledje digna, in kot System DSN, kadar digna teče kot storitev. Vse, kar je konfigurirano v DSN, lahko preglasite tako, da to dodate tudi kot lastnost.

Brez DSN je dokumentirana privzeta možnost, ker se izogne temu stanju na strani gostitelja: povezava je v celoti opisana v digna, nov gostitelj digna pa potrebuje nameščen gonilnik, konfigurirati pa ni treba ničesar.

Odpravljanje težav¶

Data source name not found / no default driver specified¶

Simptomi: - Gumb Test sporoči napako, ki omenja data source name not found, čeprav je nastavitev brez DSN

Vzroki in rešitve: 1. Vrednost Driver se ne ujema z imenom registriranega gonilnika — primerjajte jo z zavihkom Drivers v ODBC Data Source Administrator (64-bit) ali z odbcinst -q -d 2. Gonilnik je nameščen na vaši delovni postaji, ne pa na gostitelju digna 3. Gonilnik je 32-bitni, digna pa je 64-bitna — namestite 64-bitni gonilnik 4. Lastnost Driver v celoti manjka, prav tako ni bil podan DSN 5. Na Linux in macOS je gonilnik nameščen, ni pa registriran — namesto tega navedite celotno pot do knjižnice gonilnika ali ga registrirajte v odbcinst.ini

Test povezave poteče¶

Simptomi: - Test obvisi in nato po približno pol minute ne uspe

Vzroki in rešitve: 1. Gostitelj ali vrata niso dosegljivi z gostitelja digna — preverite požarni zid in pri oblačnih virih seznam dovoljenih naslovov IP 2. Ime gostitelja je pravilno, vrata pa pripadajo drugi storitvi 3. Vir potrebuje več kot privzetih 30 sekund, da sprejme povezavo — povečajte DIGNA_SOURCE_LOGIN_TIMEOUT_SEC v razdelku [base] datoteke config.toml (0 čaka neomejeno) in znova zaženite zaledje 4. Serverless končna točka se prebuja iz mirovanja — poskusite znova, in če se to redno dogaja, povečajte časovno omejitev prijave, kot je opisano zgoraj

Avtentikacija ne uspe, čeprav so poverilnice pravilne¶

Simptomi: - Gonilnik sporoči neveljavne poverilnice, isti uporabnik pa deluje v drugem odjemalcu SQL

Vzroki in rešitve: 1. Geslo vsebuje ; — vrednost zavijte v zavite oklepaje: {p@ss;word} 2. V vrednost je bil skopiran presledek na koncu 3. Gonilnik pričakuje določen mehanizem avtentikacije — na primer AuthMech za gonilnika Hive in Databricks ali authenticator za Snowflake 4. Vrednost je bila shranjena šifrirano in nato urejena — šifriranih vrednosti ni mogoče znova prebrati, zato skrivnost znova vnesite v celoti 5. Žeton je potekel — osebni dostopni žetoni in programmatic access tokens se izdajajo z datumom poteka

Zaslon za vir podatkov ne ponudi pričakovane baze podatkov ali sheme¶

Simptomi: - Ko dodajate vir podatkov, manjkajo katalogi, sheme ali tabele

Vzroki in rešitve: 1. Povezava kaže na drugo bazo podatkov — glejte Katero bazo podatkov vidi povezava 2. Uporabnik povezave nima pravic za branje sheme ali podatkovnega slovarja 3. Technology se ne ujema z virom, zato digna poizveduje po napačnem podatkovnem slovarju 4. Pri Snowflake uporabniku ni dodeljeno privzeto skladišče (warehouse) in lastnost Warehouse ni bila podana, zato poizvedb po metapodatkih ni mogoče izvesti

Profiliranje ne uspe, čeprav test povezave uspe¶

Simptomi: - Test uspe, inšpekcija pa ne uspe pri ustvarjanju delovnih tabel

Vzroki in rešitve: 1. Izbrano je profiliranje Permanent, uporabnik povezave pa ne more ustvarjati tabel v Work Schema — dodelite pravice ali preklopite na Session ali Standard 2. Work Schema je prazna ali navaja shemo, ki ne obstaja, izbrano pa je profiliranje Permanent 3. Izbrano je profiliranje Session, uporabnik povezave pa ne sme ustvarjati začasnih tabel 4. Dolgotrajna poizvedba profiliranja doseže časovno omejitev poizvedbe — povečajte DIGNA_SOURCE_QUERY_TIMEOUT_SEC v razdelku [base] datoteke config.toml (privzeto 3600 sekund, 0 onemogoči časovno omejitev)

Priporočene prakse¶

NAREDITE:

• Namestite in registrirajte gonilnik na gostitelju digna, preden konfigurirate povezavo
• Označite Encrypted za vsako geslo in žeton
• Pred shranjevanjem kliknite Test in po menjavi gesla povezavo znova testirajte
• Povezave poimenujte po viru in okolju, na primer sales_dwh_prod
• digna dodelite namenskega uporabnika baze podatkov, samo za branje, kjer zadošča profiliranje Standard
• Za vsako izvorno bazo podatkov imejte eno povezavo in raje dodajte drugo, kot da bi prvo preklapljali

NE:

• Ne shranjujte skrivnosti nešifriranih in ne delite enega uporabnika baze podatkov med digna in drugimi orodji
• Ne uporabljajte 32-bitnega gonilnika s 64-bitno namestitvijo digna
• Ne zanašajte se na User DSN, kadar digna teče kot storitev — ne bo viden
• Ne vnašajte vrednosti, ki vsebuje ;, v lastnost brez zavitih oklepajev
• Ne usmerite Work Schema na shemo, ki vsebuje izvorne podatke

Podpora¶

Potrebujete pomoč pri povezavi z bazo podatkov?

• E-pošta: support@digna.ai
• Dokumentacija: https://docs.digna.ai
• Spletna stran: https://www.digna.ai

Izdaja: 2026.06
© 2026 digna GmbH — www.digna.ai