ローを返さないか、1 つだけ返す SELECT 文

「シングルロークエリ」がデータベースから取り出すローの数は多くても 1 つだけです。シングルロークエリの SELECT 文では、INTO 句が SELECT リストの後、FROM 句の前にきます。INTO 句には、SELECT リストの各項目の値を受け取るホスト変数のリストを指定します。SELECT リスト項目と同数のホスト変数を指定してください。ホスト変数と一緒に、結果が NULL であることを示すインジケーター変数も指定できます。

SELECT 文が実行されると、データベースサーバーは結果を取り出して、ホスト変数に格納します。クエリの結果、複数のローが取り出されると、データベースサーバーはエラーを返します。

クエリの結果、選択されたローが存在しない場合、ローが見つからないことを示すエラー (SQLCODE 100) が返されます。エラーと警告は、SQLCA 構造体で返されます。

例

次のコードは Employees テーブルから正しくローをフェッチできた場合は 1 を、ローが存在しない場合は 0 を、エラーが発生した場合は -1 を返します。

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 */
  }
}

参照

DocCommentXchange で意見交換できます