Daten aus Datenbank lesen

Bitte beachten

Alle Beispiele bezieht sich auf MapEdit Version 23.2.142 und höher.

Fügen Sie zur Nutung der Datenbank Funktionen immer das using Statement

using Mum.Geo.DataAccess;

in den Kopf ihrere Klasse ein.

Warnung

Beachten Sie das wenn Sie Datenabfragen durchführen und das Ergebniss sehr viele Datensätze zurückliefert, das dies zu Speicherüberlauf (und damit Abstürzen) oder zum Stillstand von MapEdit führen kann da alle Datensätze bei diesem Methoden vom Server auf den Client geladen werden. Bedenken Sie also immer was sie tun und fragen sie nicht alle Datensätze einer Tabelle ab sondern nur die Datensätze die Sie wirklich benötigen.

Bitte beachten

Binden Sie keine Datenbank Provider DLLs wie npgsql.dll, Oracle.DataAccess.Client.dll, system.datasqlite.dll etc ein. Diese werden für MapEdit nicht benötigt. MapEdit ist eine Client - Server Software. Ihr Plugin Code läuft auf dem Client. Alle Datenbank Zugriffe geschehen über die MapEdit API welche dann die Daten vom Server abfrägt.

Feature Object

Die Klasse "Feature" sollte immer dann genutzt werden wenn sie einen Datensatz lesen und spätere auch wieder zurück in die Datenbank schreiben wollen.

Das Feature holt immer alle Spalteninformationen des Datensatzes von der Datenbank.

Einzelnen Datensatz/Feature abfragen

Wenn die FID bekannt ist können Sie ein Feature folgendermaßen von der Datenbank abfragen.

Connection cn = this.Connection;

//Der erste Parameter ist der Tabellenname
//Der zweite Parameter ist der Wert der  Primarschluessel Spalte
//Im normalfall die FID oder ID des Datensatzes.

Feature feature = cn.ReadFeature("BAUM", "177");

long fid = feature.GetInt64Ex("FID");
string name = feature.GetStringEx("NAME"); 
double area = feature.GetDoubleEx("AREA");
DateTime date = feature.GetDateEx("DATE_CREATED")

//Check if the Column has a value
if (!feature.IsDBNull("COLORNAME"))
{
  string color = feature.GetStringEx("COLORNAME"); 
}

Mehrere Datensätze/Features mittels Filter anfragen

Sie können mehrere Feature auch mittels eines Filters lesen. der Filter entspricht einer SQL "Where" Bedingung.

Connection cn = this.Connection;

//Der erste Parameter ist der Tabellenname
//Der zweite Parameter der Filter (die SQL Where Bedingung)

List<Feature> features = cn.ReadFeatures("BAUM", "area<1000");
foreach(Feature feature in features) 
{
    long fid = feature.GetInt64Ex("FID");
    string name = feature.GetStringEx("NAME"); 
    double area = feature.GetDoubleEx("AREA");
}

feature.Key liefert jeweils den Wert der Primärschlüsselspalte als Textwert zurück.
Im Normalfall ist das die Spalte FID, oder ID bei Kennungslisten.

string fidString = feature.Key;

feature.KeyID liefert jeweils den Wert der Primärschlüsselspalte als long Wert zurück.

long fid = feature.KeyID;

Abfrage via SQL

Im Gegensatz zur Klasse "Feature" kann hier explizit angegeben werden welche Spalten von der Datenbank abgerufen werden sollen.

Hier können beliebige SQLs angegeben werden, d.h. es können im Gegensatz zur Klasse "FEature" auch meherer Tabellen kombiniert werden.

Diese vorgehen ist in Fällen wo nur Daten gelesen werden das optimalere da bei iesem vorgehen die Menge an Daten kleiner ist. Dadurch ist die Abfrage schneller und es müssen weniger Daten vom Server an den Client übertragen werden.

Das folgende Beispiel liest den Spalten Wert eines einzelnen Datensatzes

Connection cn = this.Connection;
string name = cn.SqlQueryScalarString("select NAME from BAUM where FID=17");

Das folgende Beispiel liest Datensätze mittels eines SQLs.

Connection cn = this.Connection;

SqlQuery reader = new SqlQuery(cn);
reader.Query("select FID,NAME from BAUM where baumtyp=9");
while (reader.ReadNext())
{
    long fid = reader.GetInt64Ex("FID");
    string name = reader.GetStringEx("NAME");
}
reader.Close();

Mittels "reader.Succeeded" können Sie prüfen ob die Abfrage erfolgreich war und mittels "reader.ExceptionMessage" kann die Fehlermeldung gelesen werden.

SqlQuery reader = new SqlQuery(this.Connection);
reader.Query("select FID,NAME from BAUM where baumtyp=9");
if (!reader.Succeeded ) 
{
     string err = reader.ExceptionMessage;
}

Informationen zum lesen von Spaltenwerten

Die folgenden Informationen gelten für die Klassen Feature und SqlQuery gleichermassen.

Beachten Sie das Spaltenwerte leer (NULL) sein können.

Mit der Funktion feature.IsDBNull("spaltenname") kann geprüft werden ob der Spaltenwert NULL (leer) ist.

Beispiel:

string treeType = "";
if (!feature.IsDBNull("TREE_TYPE"))
{
    treeType = feature.GetString("TREE_TYPE");
}

Sie können auch einen Wert vorgeben der zurück gegeben werden soll wenn die Spalte NULL ist.

Der erste Parameter ist der Name der Spalte Der zweite Parameter ist der Wert der zurück geliefert werden soll wenn die Spalte NULL ist.

Das folgende Beispiel liest den wert der Spalte NAME. Enthält die Spalte NAME keinen Wert (NULL) dann wird als Wert "Eiche" zurück gegeben.

string name = feature.GetString("NAME", "Eiche");

Dies steht bei allen DatenTypen Funktionen zur verfügung. also auch bei GetInt32, GetBoolean usw.

Funktionen die mit "Ex" enden liefern wenn der Spaltenwert NULL ist jeweils einen fixen Vorgabewert zurück.

Hier eine Übersicht der Funktionen für verschiedenen Datentypen und was diese im Fall zurück wenn der Spaltenwert NULL ist.

Funktion	Rückgabewert wenn NULL
GetStringEx	"" (leerer String)
GetInt32Ex	0
GetInt64Ex	0
GetDoubleEx	0.0
GetDateEx	1/1/1900
GetDateTimeEx	1/1/1900
GetBooleanEx	false

Int32 entspricht dem Datentyp integer
Int64 entspricht dem Datentyp long

Diese Namensgebung wurde so von Microsoft übernommen.
Diese verwenden diese so in ihren Frameworks wie z.B. ADO.NET.
Der Datentyp int ist das gleiche wie Int32.
Der Datentyp long ist das gleiche wie Int64.

Spezial Fall "GetBooleanEx" (Ja/Nein Werte)

Die meisten Datenbanken unterstützen keinen Datentyp Boolean. Um dieses Problem zu umgehen speichert MapEdit Boolean werte in der Datenbank als NUMBER(1) ab.

Die Funktion GetBoolean/GetBooleanEx leist Datenbankwerte egal ob diese als Zahlenwerte oder Textwerte gespeichert sind und wandelt diese intern in den passenden Datentyp Boolean um.

Bei Zahlenwerten gilt das alle Werte die nicht 0 sind als true interpretiert werden. Bei Text werten werden alle Werte die nicht "NO" oder "FALSE" sind als true interpretiert/

Die Umwandlungstablle sieht so aus. Die Gross-kleinschreibung spielt dabei keine Rolle.

Spalten Wert	Rückgabewert
null	false
"FALSE"	false
"NO"	false
"0"	false
0	false
0.0	false
""	false
"TRUE"	true
"YES"	true
"1"	true
1	true
1.0	true
"-1"	true
-1	true
-1.0	true
alles andere	true

Das folgende Beispiel liest den Textwert der Spalte NAME. Enthält die Spalte NAME keinen Wert (NULL) dann wird als Wert "" zurück gegeben.

string name  = feature.GetStringEx("NAME");

Das folgende Beispiel liest den integer wert der Spalte ALTER. Enthält die Spalte ALTER keinen Wert (NULL) dann wird als Wert 0 zurück gegeben.

int alter  = feature.GetInt32Ex("ALTER");

Diese Variante liefert wenn der Spalten Wert Null ist wirklich ein NULL (NULl String) zurück

string name  = feature.GetString("NAME");

Grosse Datenmengen abfragen

Wenn Sie größere Datenmengen Abfragen müssen oder sie innerhalb der Datensätze vor und zurück navigieren müssen sollten Sie die Klasse SqlReader bzw. FeatureReader verwenden.

Diese Klasse ruft nicht alle Datensätze auf einmal ab sondern ruft diese erst bei Bedarf in Blöcken ab. Dadurch können große Datenmengen verarbeitet werden ohne das der Speicher überläuft.

Der erste Parameter von reader.Query ist der Name der Tabelle. Der zweite Parameter ist die Where bedigung. Alle weiteren Parameter die einzelnen Spalten die zureuck geliefert werden sollen.

Beispiel:

Connection cn = this.Repository.GetDbConnection("LASVEGAS");
SqlReader reader = new SqlReader(cn);
reader.Query("STREET","order by FID", "FID","STRNAME");
int c = reader.RecordCount;
while (reader.MoveNext())
{
 if (reader.IsRecordAvailable) //pruefen ob der Datensatz in Zwischenzeit gelöscht wurde.
 {
     long fid = reader.GetInt64("fid", 0);
     string streetName= reader.GetString("strname", "");
 }
}
reader.Close();