ReadODBC (FPScript)
Liest über ODBC ein oder mehrere Spalten aus einer Tabelle einer Datenquelle.
Syntax
ReadODBC(Connection, Query, [ UTC = FALSE ] [ , Result = ODBC_RESULT_DATASERIES ])
Die Syntax der ReadODBC-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||
---|---|---|---|---|---|---|---|
Connection |
Folgende Angaben sind hier möglich:
Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||
Query |
SQL-Anweisung, die verwendet wird um die Datenspalte in der angegebenen Datenquelle zu adressieren. Die vom Datenverknüpfungsobjekt ODBC-Daten generierten Abfragen haben die Form SELECT <Spalte> FROM <Tabelle> wobei <Spalte> und <Tabelle> stellvertretend für die im Import-Dialog gewählte Tabelle und Spalte stehen. Sie können die Abfrage z. B. auch um einen Sortierbefehl ergänzen. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||
UTC |
Dieses Argument wird nur berücksichtigt, wenn die Datenspalte Kalenderzeiten (Datum und Uhrzeit) enhält. Der Wert TRUE gibt an, dass die in der Datenbank abgelegten Daten als in Koordinierter Weltzeit (UTC) vorliegend betrachtet werden sollen. Ansonsten werden die Daten als in Lokalzeit vorliegend interpretiert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
||||||
Result |
Legt fest, wie das Ergebnis zurückgegeben werden soll. Das Argument Result kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert ODBC_RESULT_DATASERIES gesetzt. |
Anmerkungen
Wenn Sie ODBC_RESULT_DATASERIES wählen, so liefert die Funktion als Ergebnis immer nur die erste Spalte einer Abfrage, selbst wenn Sie die Abfrage so formulieren, dass sie grundsätzlich mehrere Spalten als Ergebnis liefert. Binäre SQL-Datentypen werden nicht unterstützt. In diesem Fall werden ungültige Werte zurückgeliefert.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
ReadODBC("ODBC;DRIVER={Microsoft Access Driver (*.mdb)};DSN='';DBQ=c:\\examples\\database.mdb", "SELECT ExampleColumn FROM ExampleTable")
Import die Spalte 'ExampleColumn' aus der Tabelle 'ExampleTable', die sich in der Microsoft Access-Projektdatenbank 'database.mdb' befindet.