Veritabanı Bağlantılarına Genel Bakış¶

İçindekiler¶

1. Bağlantılar Nasıl Çalışır
2. Teknoloji Kılavuzları
3. Ön Koşul: ODBC Sürücüsünü digna Ana Makinesine Kurun
4. Veritabanı Bağlantısı Oluşturma
5. ODBC Özellikleri
6. Özellik Değerlerini Şifreleme
7. Bir Bağlantıyı Test Etme
8. Bağlantının Gördüğü Veritabanı
9. Profil Oluşturma Modu ve Çalışma Şeması
10. Bunun Yerine DSN Kullanma
11. Sorun Giderme

Bağlantılar Nasıl Çalışır¶

digna her kaynak teknolojiye ODBC üzerinden erişir. Bir bağlantı, anahtar/değer çiftleri olarak girdiğiniz ODBC özelliklerinin bir listesidir. digna bağlantıyı açtığında bu çiftleri bir bağlantı dizesinde birleştirir (Key=Value, ; ile ayrılmış, listelediğiniz sırayla) ve bunu digna ana makinesindeki ODBC sürücü yöneticisine iletir.

Özellikleri kendiniz girmeniz kurulumu DSN'siz kılar: bağlantı, sürücünün ihtiyaç duyduğu her şeyi taşır, bu nedenle ana makinede herhangi bir ODBC veri kaynağının (DSN) kaydedilmesi gerekmez. Bağlantı tanımı tamamen digna içinde bulunduğu ve onunla birlikte taşındığı için digna'yı yapılandırmanın önerilen yolu budur.

Neden ODBC¶

Önceki sürümler, Use ODBC anahtarıyla seçilen, teknolojiye özel bir sürücü ile ODBC arasında seçim sunuyordu. Release 2026.06 itibarıyla digna yalnızca ODBC üzerine kuruludur. Tek ve standart bir arayüz, bir dizi özel sürücünün sunabileceğinden fazlasını sağlar:

• Kimlik doğrulama: kimlik doğrulama ODBC'nin bir parçasıdır, bu nedenle bir bağlantı sürücüsünün desteklediği her yöntemi kullanabilir: parolalar, token'lar ve PAT'ler, Kerberos ve Active Directory, MFA ve tarayıcı tabanlı çoklu oturum açma, bulut kimliği, istemci sertifikaları ve TLS. Yeni yöntemler bir digna sürümünü beklemeden sürücü güncellemesiyle gelir.
• Veritabanı üreticileri tarafından bakımı yapılan sürücüler: üreticinin kendi sürücüsü yeni sunucu sürümlerini ve güvenlik düzeltmelerini takip eder; siz de onu digna'dan bağımsız olarak kendi takviminize göre güncelleyebilirsiniz.
• Her şeyi yapılandırmanın tek yolu: her kaynak için farklı bir alan kümesi yerine, her teknoloji aynı arayüze, hassas değerlerin aynı şekilde şifrelenmesine ve aynı sorun giderme yöntemine sahip bir anahtar/değer özellikleri listesidir.
• İnce ayar ve kapsam: zaman aşımları, TLS ayarları, proxy'ler ve getirme boyutları gibi sürücü düzeyindeki seçenekler her kaynak için kullanılabilir ve uyumlu bir ODBC sürücüsüne sahip her teknoloji bağlanabilir; digna'nın özel bir kılavuz yayımlamadığı teknolojiler de buna dahildir.

Teknoloji Kılavuzları¶

Özellik adları sürücüye göre farklılık gösterir ve her teknolojinin diğerlerinde bulunmayan bir veya iki ayrıntısı vardır. Aşağıdaki kılavuzlar bu kısmı kapsar; bu sayfa ise hepsi için aynı olan digna tarafını ele alır.

Ön Koşul: ODBC Sürücüsünü digna Ana Makinesine Kurun¶

digna kaynak bağlantılarını tarayıcıdan değil, digna arka ucunu çalıştıran sunucudan açar. Bu nedenle ODBC sürücüsünün o makineye kurulması ve adının yerel sürücü yöneticisine kaydedilmesi gerekir.

odbcinst -q -d

odbcinst -q -d

Kayıtlı bir ad yerine, yaygın sürücü yöneticilerinin tümü sürücü kitaplığının tam yolunu da kabul eder; örneğin Driver=/opt/simba/spark/lib/64/libsparkodbc_sb64.so. Bu, sürücü kurulu olduğu halde kayıtlı olmadığında kullanışlıdır.

Veritabanı Bağlantısı Oluşturma¶

Admin Panel'i açın, Database Connections sekmesine gidin ve Add DB Connection'a tıklayın. Ekran beş bilgi ister:

Bir bağlantı merkezi olarak yönetilir ve ardından bir veya daha fazla projeye atanır; böylece aynı bağlantı birden çok projeye hizmet edebilir.

ODBC Özellikleri¶

Her özellik için Add Property'ye tıklayın ve Key, Value alanlarını ve gizli değerler için Encrypted onay kutusunu doldurun. Her teknoloji kılavuzu, o teknoloji için sürücü sürümünüze ve sunucunuza uyarlayacağınız bir örnek küme listeler; bkz. yukarıdaki not.

Sürücü ne olursa olsun, bir özellik kümesi aynı dört şeyi kapsar:

• Driver: yukarıda açıklandığı şekilde kayıtlı sürücü adı.
• Sunucunun adresi: anahtar sürücüye göre değişir: SERVER, HOST, DBCNAME, Server veya Oracle için DBQ bağlantı tanımlayıcısı.
• Kimlik bilgileri: genellikle UID ve PWD; Snowflake UID ile birlikte bir token kullanır, Databricks ise token değişmez kullanıcı adını ve PWD içinde kişisel erişim token'ını kullanır.
• Üzerinde çalışılacak veritabanı veya katalog (teknolojide varsa); bkz. Bağlantının Gördüğü Veritabanı.

Sürücünün belgelediği diğer her şey de aynı şekilde eklenebilir: bağlantı havuzu, soket zaman aşımları, Kerberos ayarları, proxy ayarları. digna özellikleri yorumlamaz; yalnızca iletir.

Özellik Değerlerini Şifreleme¶

Gizli bir değer tutan her özellik için Encrypted seçeneğini işaretleyin: PWD, token, bir istemci gizli anahtarı. Değer bu durumda digna deposunda saklanmadan önce şifrelenir, ekranda maskelenir ve yalnızca bağlantı dizesi oluşturulurken şifresi çözülür.

Gizli olmayan özellikleri (sürücü adı, ana makine, port, veritabanı) şifrelemeden bırakmak en iyisidir; böylece bağlantının bakımını daha sonra yapacak kişi için okunabilir kalırlar.

Bir Bağlantıyı Test Etme¶

Kaydetmeden önce Add DB Connection iletişim kutusunda Test'e tıklayın. Test, o anda formda bulunan değerleri kullanır ve gerçek bir bağlantı kurar; bu nedenle bir incelemenin karşılaşacağı sorunu tam olarak bildirir: yanlış bir sürücü adı, reddedilen bir parola, erişilemeyen bir ana makine. Hiçbir şey saklanmaz: test bağlantısı başarılı da olsa başarısız da olsa geri alınır.

Zaten var olan bir bağlantıyı yeniden test etmek için Database Connections sekmesinde satırının üzerine gelin ve fiş simgesine tıklayın. Bu, bir parola değişikliğinden veya güvenlik duvarı değişikliğinden sonra bir kaynağa erişilip erişilemediğini kontrol etmenin en hızlı yoludur.

Bağlantının Gördüğü Veritabanı¶

Bir veri kaynağı eklediğinizde digna, bağlantının erişebildiği katalogları, şemaları ve tabloları sunar. Bu erişimin ne kadar geniş olduğu teknolojiye bağlıdır:

Profil Oluşturma Modu ve Çalışma Şeması¶

Profil oluşturma modu, digna'nın verileri nasıl işlediğini ve metrikleri nasıl hesapladığını belirler:

• Standard: Metrikler, veriler kopyalanmadan doğrudan kaynak tablolar üzerinde hesaplanır.
• Permanent: İncelenen güne ait veriler kalıcı bir tabloya kopyalanır ve metrikler kopyalanan veriler üzerinde hesaplanır.
• Session: Veriler bir oturum tablosuna veya geçici tabloya kopyalanır ve metrikler bu geçici veriler üzerinde hesaplanır.

Mod, bağlantı kullanıcısının neleri yapabilmesi gerektiğini belirler:

Standard yalnızca okuma yapar; bu da onu digna'ya salt okunur erişim verildiğinde seçilecek mod yapar. Work Schema yalnızca Permanent için okunur, ancak mod daha sonra değiştirilirse bağlantının çalışmaya devam etmesi için yine de doldurulmaya değer.

Bunun Yerine DSN Kullanma¶

Bir DSN hâlâ çalışır; DSN yalnızca başka bir özelliktir:

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

DSN, digna ana makinesinde, digna arka ucunu çalıştıran kullanıcı hesabı için ve digna bir hizmet olarak çalıştığında System DSN olarak kaydedilmelidir. DSN'de yapılandırılan her şey, ayrıca bir özellik olarak eklenerek geçersiz kılınabilir.

DSN'siz yöntem, ana makine tarafındaki bu durumdan kaçındığı için belgelenen varsayılandır: bağlantı tamamen digna içinde tanımlanır ve yeni bir digna ana makinesinde sürücünün kurulu olması yeterlidir, başka bir şeyin yapılandırılması gerekmez.

Sorun Giderme¶

Veri kaynağı adı bulunamadı / varsayılan sürücü belirtilmedi¶

Belirtiler: - Test düğmesi, kurulum DSN'siz olmasına rağmen data source name not found ifadesini içeren bir hata bildiriyor

Nedenler ve Çözümler: 1. Driver değeri kayıtlı bir sürücü adıyla eşleşmiyor; bunu ODBC Data Source Administrator (64-bit) uygulamasının Drivers sekmesiyle veya odbcinst -q -d çıktısıyla karşılaştırın 2. Sürücü iş istasyonunuzda kurulu, ancak digna ana makinesinde kurulu değil 3. digna 64 bit iken sürücü 32 bit; 64 bit sürücüyü kurun 4. Driver özelliği tamamen eksik ve bir DSN de verilmemiş 5. Linux ve macOS'ta sürücü kurulu ancak kayıtlı değil; bunun yerine sürücü kitaplığının tam yolunu verin veya sürücüyü odbcinst.ini içinde kaydedin

Bağlantı testi zaman aşımına uğruyor¶

Belirtiler: - Test takılıyor ve yaklaşık yarım dakika sonra başarısız oluyor

Nedenler ve Çözümler: 1. Ana makineye veya porta digna ana makinesinden erişilemiyor; güvenlik duvarını ve bulut kaynakları için IP izin listesini kontrol edin 2. Ana makine adı doğru, ancak port başka bir hizmete ait 3. Kaynağın bir bağlantıyı kabul etmesi varsayılan 30 saniyeden uzun sürüyor; config.toml dosyasının [base] bölümündeki DIGNA_SOURCE_LOGIN_TIMEOUT_SEC değerini artırın (0 süresiz bekler) ve arka ucu yeniden başlatın 4. Sunucusuz bir uç nokta boşta kalma durumundan devam ediyor; yeniden deneyin ve bu düzenli olarak oluyorsa oturum açma zaman aşımını yukarıdaki gibi artırın

Kimlik bilgileri doğru olmasına rağmen kimlik doğrulama başarısız oluyor¶

Belirtiler: - Sürücü geçersiz kimlik bilgileri bildiriyor, ancak aynı kullanıcı başka bir SQL istemcisinde çalışıyor

Nedenler ve Çözümler: 1. Parola ; içeriyor; değeri süslü parantez içine alın: {p@ss;word} 2. Değere sondaki bir boşluk kopyalanmış 3. Sürücü belirli bir kimlik doğrulama mekanizması bekliyor; örneğin Hive ve Databricks sürücüleri için AuthMech veya Snowflake için authenticator 4. Değer şifrelenmiş olarak saklanmış ve ardından düzenlenmiş; şifrelenmiş değerler geri okunamaz, bu nedenle gizli değeri eksiksiz olarak yeniden girin 5. Bir token'ın süresi dolmuş; kişisel erişim token'ları ve programatik erişim token'ları bir son kullanma tarihiyle verilir

Veri kaynağı ekranı beklenen veritabanını veya şemayı sunmuyor¶

Belirtiler: - Bir veri kaynağı eklenirken kataloglar, şemalar veya tablolar eksik

Nedenler ve Çözümler: 1. Bağlantı farklı bir veritabanını gösteriyor; bkz. Bağlantının Gördüğü Veritabanı 2. Bağlantı kullanıcısının şema veya veri sözlüğü üzerinde okuma hakları yok 3. Technology kaynakla eşleşmiyor, bu nedenle digna yanlış veri sözlüğünü sorguluyor 4. Snowflake için kullanıcıya varsayılan bir warehouse atanmamış ve Warehouse özelliği de verilmemiş, bu nedenle meta veri sorguları çalışamıyor

Bağlantı testi başarılı olurken profil oluşturma başarısız oluyor¶

Belirtiler: - Test başarılı oluyor, ancak çalışma tabloları oluşturulurken bir inceleme başarısız oluyor

Nedenler ve Çözümler: 1. Permanent profil oluşturma seçili ve bağlantı kullanıcısı Work Schema içinde tablo oluşturamıyor; hakları verin veya Session ya da Standard moduna geçin 2. Permanent profil oluşturma seçiliyken Work Schema boş veya var olmayan bir şemayı adlandırıyor 3. Session profil oluşturma seçili ve bağlantı kullanıcısı geçici tablo oluşturamıyor 4. Uzun süren bir profil oluşturma sorgusu sorgu zaman aşımına takılıyor; config.toml dosyasının [base] bölümündeki DIGNA_SOURCE_QUERY_TIMEOUT_SEC değerini artırın (varsayılan 3600 saniye, 0 zaman aşımını devre dışı bırakır)

En İyi Uygulamalar¶

YAPIN:

• Bağlantıyı yapılandırmadan önce sürücüyü digna ana makinesine kurun ve kaydedin
• Her parola ve token için Encrypted seçeneğini işaretleyin
• Kaydetmeden önce Test'e tıklayın ve bir parola değişikliğinden sonra yeniden test edin
• Bağlantıları kaynağa ve ortama göre adlandırın, örneğin sales_dwh_prod
• digna'ya özel bir veritabanı kullanıcısı verin; Standard profil oluşturmanın yeterli olduğu yerlerde salt okunur olsun
• Kaynak veritabanı başına bir bağlantı tutun ve ilkini değiştirmek yerine ikinci bir bağlantı ekleyin

YAPMAYIN:

• Gizli bilgileri şifrelenmemiş olarak saklamayın veya bir veritabanı kullanıcısını digna ile diğer araçlar arasında paylaşmayın
• 64 bit bir digna kurulumuyla 32 bit bir sürücü kullanmayın
• digna bir hizmet olarak çalıştığında bir User DSN'e güvenmeyin; görünür olmayacaktır
• ; içeren bir değeri süslü parantez olmadan bir özelliğe koymayın
• Work Schema'yı kaynak verileri barındıran bir şemaya yönlendirmeyin

Destek¶

Bir veritabanı bağlantısı konusunda yardıma mı ihtiyacınız var?

• E-posta: support@digna.ai
• Dokümantasyon: https://docs.digna.ai
• Web sitesi: https://www.digna.ai

Sürüm: 2026.06
© 2026 digna GmbH — www.digna.ai