/
DB Meta Tanımları

DB Meta Tanımları

Owned by serdar ak
Last updated: Jun 14, 2024 by Arda Ülgü (Unlicensed)
6 min read

GEODI, varsayılan olarak bir veritabanındaki seçili veya tüm tabloları bazı varsayılan davranışlarla indeksler. DBMeta’lar, bu davranışı değiştirmek için isteğe bağlı tanımlamalardır.
Gömülü veya bağlantılı dosyaları indekslemek, SQL’I indekslenecek satırları değiştirmek için bir DBMeta tanımlamanız gerekir.
DBMeta dosyaları *.jsettings uzantılıdır ve “Settings\Reader\DBMeta" klasöründe olmalıdır.

Ayarların Etkisini Sınırlama

Ayarların etki alanını sınırlayabilirsiniz. Bu şekilde birden çok meta tanımın yapabilirsiniz. Her biri ayrı tablo/veritabanı için etkili olacaktır.

Key

Açıklama

Key

Açıklama

WorkspaceName

Ayarların geçerli olacağı WorkSpace(ler).

TableFilter

Ayarların geçerli olacağı Tablolar.

ColumnFilter

Verilen kolonları içeren tablolar. (- verilirse ilgili kolonları içermeyen tablolar dikkate alınır). Birden çok verilirse ilişki VE dir.

Columns

İndekslenecek veya dışarıda kalacak kolonlar

 

{ "Defines":[ { "__type":"Geodi.Database.Meta.DBView, Geodi.Database", "WorkspaceName":"0000-Promotional and Educational Videos", "TableFilter":"*", "ColumnFilter":"*", "Columns":"-FILEPATH,-SILINECEK,-Hazırlayan,-TARIH,-GEODIFILELINK" } ] }

 

Satırların adını belirleme

Her kayıt bir belgedir. GEODI için dosyalar neyse satırlar da o şekilde ele alınır. Varsayılanda ilk text kolon satırın adı olur. Satırın adı, doc:(…) sorgusunun kullandığı içeriktir.

DisplayNameMacro kullanarak her bir tablo için ayrı ayrı değiştirebilirsiniz. Makroda diğer kolonları da kullanabilirsiniz. Makro kuralları sayfa sonunda verilmiştir.

{ "Defines":[ { "__type":"Geodi.Database.Meta.DBRowDisplayName, Geodi.Database", "DisplayNameMacro":"[TEXT4]/[TEXT2]-[TEXT3]" } ] }

 

Tablolara Gömülü dosyaları Indexleme

 Geodi, Veritabanında dosya yolları bulunan ya da blob olarak veritabanına gömülmüş dosyaları tarayabilir. Bu dokümanda gerekli ayarların nasıl yapılacağı anlatılmıştır. 

  • File1 dosyaların isimlerinin olduğu sütun File2 Blob dosya içeren sütun. Oluşturulan veri tabanın da BLOB dosya kolonu “bytea” data tipi olarak seçilmiştir.

  • Access,Postgres,Mssql,Oracle,Sqlıte,MySql veri tabanlarında kullanabilirsiniz.

  • VT içerisinde FileMemoColumn verilen sütunda dosya uzantısı olması gerekmektedir.

    • Eğer kolon değerinde uzantı yok ve tüm dosyalar aynı tipte ise makro değerine uzantı eklenebilir.

Key

Açıklama

Key

Açıklama

IDColumnMacro

Tablonun birincil anahtarının olduğu kolon .

FileNameColumnMacro

Dosyanın aramalarda ve görüntüleyicilerde görünecek adı . Makrolar dokümanın sonunda yer almaktadır

FileMemoColumn

Dosya içeriğinin yer aldığı BLOB/MEMO alan. GEODI dosya içeriğini otomatik olarak belirleyecektir

{ "Defines":[ { "__type":"Geodi.Database.Meta.DBSubContent, Geodi.Database", "TableFilter":"TEST", "IDColumnMacro":"[OBJECTID]", "FileNameColumnMacro":"[FILE1]", "FileMemoColumn":"file2" } ] }

Bir Tabloda Birden Fazla Gömülü Dosya Indexleme

  • Aynı tablo içerisinde birden fazla sütunda gömülü dosya indexlemek için aşağıdaki metayı kullana bilirsiniz.

Bir Tabloda Dosya İsmi Olmadan Gömülü Dosya Indexleme

  • Tablodaki dosya adı veritabanında yoksa, FileNameColumnMacro değerini kullanarak bir dosya adı oluşturabilirsiniz. Aşağıda iki örnek bulunmaktadır. İlk örnek basit bir örnektir. İkinci örnek bazı satırlarda uzantı değeri olmadığını varsayar. FileMemoColumn, dosya akışıdır.

  • Örnekte, Extension sütununun dosya uzantısına sahip olduğu varsayılmaktadır. Bazı satırlarda boş değerler olabilir. Eğer uzantı yoksa dosyanın PDF olduğunu varsaydık. Makro, dosyaları atlamak için boş bir dize döndürebilir.

    •  

Dosya Yolu ile İndexleme

Bir kayıtta yer alan dosya linkleri ile belirtilen dosyaları da indexleyebilirsiniz. (*.csv dosyaları için desteklenmez.)

Key

Açıklama

Key

Açıklama

FileFullPathColumnMacro

Burada yazacağıız makro ile dosya yolları hesaplanır. Bu dosyalar ilgili satırın child içeriği olurlar.

FileFullPathColumnSplitter

Eğer dosya yolunda birden çok dosya varsa ayraç karakterini verebilirsiniz.

 

 

Birincil Anahtar Kolonu Belirleme

Değişenleri tara ve versiyonlama için her bir tablo için primary kolon gereklidir. GEODI ObjectID değerini varsayılan olarak belirler. Burada anlatılan tanım ile farklı bir kolonu belirleyebilirsiniz.

  • “KeyColumns” değeri özgün ID değeri olacaktır.  

  • Primary kolon isimi metada veritbanındaki ismi ile aynı yazılmalıdır.

Bir SQL ifadesinin sonucunu indexleme

SQL anahtarı ile ismi NewName olan yeni bir tablo oluşturursunuz. SQL deyimi ilgili VTYS ile uyumlu olmalıdır.

  • KeyColums değerini alternatif olarak SQL içerisinde kolona “as P_KEY” veya “as OBJECTID” yazılarak da belirtebilirsiniz.

  • Bu özellik *.xDeceConnection ve MDB gibi dosya bazlı olanlar için geçerlidir.

  • Standart SQL kullanılmalıdır.

  • Yazılan SQL ifadesinin sonucunda birden fazla tekrar eden aynı adlı kolon olmamasına dikkat edilmelidir.

Satır Bazlı Yetkilendirme

  • Tablo, SQL veya View satır bazlı yetkilendirebilirsiniz.

  • Yetkilendirme için “PermitMacro”&”DenyMacro” içinde kullanıcı ve/veya GEODI gruplarını kullanabilirsiniz.

    • Aynı zamanda kendi oluşturduğunuz kullanıcılar içinde [geodi:kullanıcıadı] şeklinde kullanabilirsiniz.

    • Birden fazla kullanıcı, grup yazmak isterseniz = ile başlatıp gelişmiş makro kullanmalısınız. Basit makro tanımı sadece tek grup/kullanıcı için tanımlama yapmakta kullanılabilir.

  • Kullanıcı adı veya gruplar tablo(veya SQL, veya View) da bir kolondan üretilebilir olmalı.

  • Tabloda satırlar yetkilenecek, dosyalarda da (child content) bu yetkileri kullanılır.

Oluşturulan grup ismi büyük/küçük harf ayrımı yapar.

Örnek 1 : SQL Sorgu Sonucu Yetkilendirme

Örnek 2 : Oluşturulan Grup Bazlı Yetkilendirme

Örnek 3 : Gelişmiş Makro Örnekleri

Örnek 4 :

Örnek 5 :

Örnek 6 :

Bir Kaydın Metin/Text Sonucunu Belirleme

Bu özellik GEODI arama indexini değiştirmekte kullanılır context içinde verilen isimlendirme GEODI üzerinden arandığı zaman tablodaki tüm içerikleri bulur. Content ile bir kaydın kolonun arama kelimesini seçebiliriz kolon ismi olmayan kelimeleri bu özellik ile arama kelimesi haline getirebiliriz. Content içine birden fazla [Kolondadı] yazıp isimlendirebilirsiniz. DBmetadaki Ignore durumunda yapılan ayarın kapatıp açılmasını sağlar.

  • “Ignore”:”False” ise Content içine yazılan ayarlar geçerlidir.

  • “Ignore”:”True” ise Content içine yazılan ayarlar geçerli değildir .

  • Bu özellik *.xDeceConnection ve MDB gibi dosya bazlı olanlar için geçerlidir.

Kayıtların Görünüm Şeklini Ayarlamak

“TemplateName” anahtarı ile vereceğiniz html şablon kriterlere uyan kayıtların görünümü belirleyecektir. Bu “.html” uzantılı şablon “DBMeta” dosyası altındaki Templates klasörünün altında olmalıdır ve oluşturulan meta “DBMeta” klasörü altında kaydedilmelidir.

TemplateName kullanımı size görsel olarak esneklik sağlar ama performans kaybı yaşatabilir.

 

FieldIndex Ayarları (Aramaları Kolon Adı ile sınırlamak)

Varsayılan arama tüm tablolar ve tüm kolonları kapsar. Arama sonucunu kolon bazlı sınırlamak için FieldIndex ayarını yapmalısınız. Ayar sonrası “kolonadı:<arama cümleniz>” ile kriterler ilgili kolon ile sınırlandırılacaktır.

  • Proje detay ayarlardan ContentReaderEnumerators → Veritabanınız → EnableAutoFieldIndex ayarını true yapıp projenizi yeniden taratmalısınız.  Yeniden tarama büyük veride zaman alabilir, bu nedenle baştan planlanmasında yarar vardır.  

Bu özellik aktif olduğunda. Veritabanındaki keşif sonuçlarında kolon adı yazacaktır.

Veritabanlarında Örneklemeli Veri Keşifi Yapmak

GEODI varsayılan ayarlarda veritabanı içeriklerinin tümünü keşfeder. İsteğe bağlı olarak veritabanı içeriklerinizden örnekleme keşif yapabilirsiniz bu sayede tarama süresinde ve depolama alanından kazanç sağlayabilirsiniz. GEODI her tablodan rastgele N örnek satır seçer.

Örnekleme ayarını Folder kaynakları için kullanırsanız dosya bazlı DB’ler de (excel,*.mdb,*.accdb gibi) etkili olur.

Kolon adlarını çok dilli yapmak ve alias(eş anlamlı) tanımlamak

İsterseniz aşağıdaki tanımları yapmalısınız.

  1. resx dosya isimleri içinde “fields” mutlaka geçmelidir. Bu dosyalar globalization dizininde yer almalıdır.

  2. kullanılan name değeri att{fieldname} şeklinde olmalıdır ve tabloda olan ile uyuşmalıdır. Farklı dillerde aynı anahtarı kullanmalısınız.

  3. value değeri alternatif kolon adlarını içerir(alias). Birden çok alternatifi“|” ile ayırabilirsiniz.

  4. Kullandığınız aliaslardan herhangi biri başka bir kolon adı ile aynı olursa dikkate alınmaz.

  5. Çok dilli gösterimlerde ilk alias dikkate alınır.

myfields.resx

 

myfields.en-us.resx


Makrolar

Doküman ID, Dosya yolu gibi değerler için makro yazabilirsiniz. Makrolar kolon değerlerin doğrudan yetersiz kaldığı durumları çözmenizi sağlar. Hangi değerler için makro kullanılabileceği ilgili bölümlerde belirtilmiştir.

Makro metni kolonların “[]” arasında verildiği bir metindir. Örnekte görüldüğü gibi aynı kolonu birden çok kez verebilirsiniz.

Makrolarda bazı karakter escape karakteri (“\”) ile birlikte kullanılmalıdır. Örneğin “\” , “\\” şeklinde verilmelidir.

"FileFullPathColumnMacro":"C:\TEST\KUR-1166 VT\files\[FILE1]"

"DisplayNameMacro":“[ADANO] Ada [PARSELNO] Parsel”

"DisplayNameMacro":“[TITLE]-[POSITION]”

Tipi makro olan ayarların değeri = ile başlarsa c# makro kullanımına geçiliyor. Bu sınırsız esneklik getiriyor.

Örnekler

"FileFullPathColumnMacro":'=Path.Combine(@"C:\\TEST\\KUR-1166 VT\\files\\",d["FILE1"])'

"DisplayNameMacro":'=string.Concat(d["ADANO"]," Ada ",d["PARSELNO"]," Parsel")'

"DisplayNameMacro":'=string.Concat(d["TITLE"],"-",d["POSITION"])'

"DisplayNameMacro":'=d.Get<int>("DEGER")>-1?"Pozitif":"Negatif"'

 

Detay Bilgiler