Eine einzeilige Abfrage fragt höchstens eine Zeile von der Datenbank ab. In einer SELECT-Anweisung für eine einzeilige Abfrage befindet sich eine INTO-Klausel nach der Auswahlliste und vor der FROM-Klausel. Die INTO-Klausel enthält eine Liste der Hostvariablen, um den Wert der einzelnen Elemente der Auswahlliste zu empfangen. Die Anzahl der Hostvariablen muss mit der Anzahl der Auswahllisten-Elemente übereinstimmen. Die Hostvariablen können von Indikatorvariablen gefolgt sein, um NULL-Ergebnisse anzuzeigen.

Sobald die SELECT-Anweisung ausgeführt wird, ruft der Datenbankserver die Ergebnisse ab und schreibt sie in die Hostvariablen. Falls die Abfrageergebnisse mehr als eine Zeile enthalten, gibt der Datenbankserver einen Fehler zurück.

Wenn die Abfrage dazu führt, dass keine Zeilen ausgewählt werden, wird ein Fehler zurückgegeben, der darauf hinweist, dass keine Zeilen gefunden werden konnten (SQLCODE 100). Fehler und Warnungen werden in der SQLCA-Struktur zurückgegeben.

 Beispiel

EXEC SQL BEGIN DECLARE SECTION;
long      id;
char      name[41];
char      sex;
char      birthdate[15];
a_sql_len ind_birthdate;
EXEC SQL END DECLARE SECTION;
...
int find_employee( long employee_id )
{
  id = employee_id;
  EXEC SQL SELECT GivenName ||
    ' ' || Surname, Sex, BirthDate
    INTO :name, :sex,
      :birthdate:ind_birthdate
    FROM Employees
    WHERE EmployeeID = :id;
  if( SQLCODE == SQLE_NOTFOUND ) 
  {
    return( 0 ); /* employee not found */
  } 
  else if( SQLCODE < 0 ) 
  {
    return( -1 ); /* error */
  } 
  else 
  {
    return( 1 ); /* found */
  }
}

 Siehe auch