Download PDF-Version - bei Bartels

Transcript
Bartels User Language
Programmierhandbuch
sqlcmd - SQL Kommando ausführen (STD)
Synopsis
int sqlcmd(
string;
string;
* int;
);
//
//
//
//
Status
Datenbankdateiname
SQL-Kommando
Datenrückgabefunktion
Beschreibung
Über die Funktion sqlcmd kann mit Hilfe einer Zugriffsprache der Datentransfer von und zu einer mit sqlinit
initialisierten relationalen Datenbank gesteuert werden. Der erste Parameter der Funktion sqlcmd gibt den
Namen der Datenbankdatei an, die für die Bearbeitung geöffnet werden soll. Im zweiten Parameter ist das
auszuführende SQL-Kommando für den Datenzugriff zu spezifizieren. Die selektierten Datenfelder werden dem
Aufrufer über die im dritten Parameter referenzierte Datenrückgabefunktion übergeben. Soll keine
Datenrückgabefunktion aktiviert werden, dann ist für den entsprechenden Funktionsparameter das Schlüsselwort
NULL einzutragen. Der Rückgabewert der Funktion sqlcmd ist ungleich Null bei fehlenden oder ungültigen
Parametern oder wenn ein SQL-Datenbankfehler aufgetreten ist; die genaue Fehlerursache lässt sich im Falle
eines SQL-Datenbankfehlers anschließend mit Hilfe der Funktion sqlerr bestimmen.
SQL-Kommandos
Die durch sqlcmd interpretierbare Datenbank-Zugriffssprache lehnt sich in ihrer Befehlssyntax an die Structured
Query Language (SQL) für relationale Datenbanken an. Es werden die folgenden Grundbefehle angeboten:
create table
drop table
insert into table values
quickinsert into table values
index table
select from table
delete from table
help
Zur Repräsentation von Daten stehen die folgenden Datentypen zur Verfügung:
Schlüsselwort Datentyp
integer
Ganze Zahlen im Bereich [-2147483648, 2147483647]
float
Fließpunktzahlen im Bereich [-10^308, 10^308] mit einer Genauigkeit von ca. 15
führenden Stellen
string
Zeichenketten (in einfachen Anführungszeichen)
boolean
Logical value (FALSE oder TRUE)
date
Datum; Eingabe dd/mm/yyyy, Ausgabe yyyymmdd
Systemfunktionen
Seite C-131