Starcounter SQL follows the established standard SQL92 (ANSI INCITS 135-1992, R1998) to support easy data exchange with other databases and external tools.
There are two to use Starcounter SQL:
In programming code with
Db.SQL as described in Querying using SQL.
In the interactive SQL browser of the Starcounter Administrator.
The SQL in the Administrator and in code are not identical. For performance reasons, literals can't be used in the programming code with
Db.SQL while it's available in the Administrator. Because of this, when using the examples in this documentation, remember to replace literals with variables in programming code.
Starcounter SQL contains some extensions to the SQL92 standard to better deal with objects, since the standard SQL only supports relational databases. For these extensions we follow the Object Data Standard ODMG 3.0 (ISBN 1-55860-647-4). The object extensions in Starcounter SQL are:
In traditional SQL you can only refer to tables, columns, rows and fields of values. The concept of an "object" is represented by a row in a table. You refer to an "object" by values on its primary key which are some specified columns.
In Starcounter SQL you can refer to an object itself. For example, in query below the identifier
e is an object reference.
SELECT e FROM Employee e
In a traditional SQL database, to get data from more than one type of object (table/class) you have to do a "join" of a number of tables. For example, query below gives you the names of the employees and the names of the departments where they work.
SELECT e.FirstName, d.Name FROM Employee e JOIN Department d ON e.DepartmentId = d.Id
In Starcounter SQL there is a more convenient way to get the same result by instead using a path expression as in query below. In that way, you can from one type of object (
Employee) reach another type of object (
Department) by object reference.
SELECT e.FirstName, e.Department.Name FROM Employee e
In object oriented programming the extent of a class is all object instances of that class. An extent of object instances corresponds to a table of rows in a relational database. Thus,
Employee in the example queries above can either be regarded as the extent of the class
Employee or as the table