COUNT

行が返されない

行が選択されていない場合、COUNT はクエリに従って、0 か NULL のどちらかを返します。

• 選択リストに、FROM 節テーブル内のフィールド (集約関数に提供されているフィールド以外) への参照が含まれていない場合、COUNT は 0 を返します。COUNT 集約関数のみが 0 を返し、その他の集約関数は NULL を返します。クエリは %ROWCOUNT 1 を返します。以下に例を示します。

    SET myquery = 3
    SET myquery(1) = "SELECT COUNT(*) AS Recs,COUNT(Name) AS People,"
    SET myquery(2) = "AVG(Age) AS AvgAge,MAX(Age) AS MaxAge,CURRENT_TIMESTAMP AS Now"
    SET myquery(3) = " FROM Sample.Employee WHERE Name %STARTSWITH 'ZZZ'"
    SET tStatement = ##class(%SQL.Statement).%New()
    SET qStatus = tStatement.%Prepare(.myquery)
      IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
    SET rset = tStatement.%Execute()
    DO rset.%Display()
    WRITE !,"Rowcount:",rset.%ROWCOUNT

  

• 選択リストに、FROM 節テーブル内のフィールドへの直接参照が含まれている場合、または TOP 0 が指定されている場合、COUNT は NULL を返します。クエリは %ROWCOUNT 0 を返します。以下の例では、%ROWCOUNT の値が 0 のため、COUNT の値は返されません。

    SET myquery = 2
    SET myquery(1) = "SELECT COUNT(*) AS Recs,COUNT(Name) AS People,$LENGTH(Name) AS NameLen"
    SET myquery(2) = " FROM Sample.Employee WHERE Name %STARTSWITH 'ZZZ'"
    SET tStatement = ##class(%SQL.Statement).%New()
    SET qStatus = tStatement.%Prepare(.myquery)
      IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
    SET rset = tStatement.%Execute()
    DO rset.%Display()
    WRITE !,"Rowcount:",rset.%ROWCOUNT
  

  

• テーブルが指定されていない場合、COUNT(*) は 1 を返します。クエリは %ROWCOUNT 1 を返します。以下に例を示します。

    SET myquery = "SELECT COUNT(*) AS Recs"
    SET tStatement = ##class(%SQL.Statement).%New()
    SET qStatus = tStatement.%Prepare(myquery)
      IF qStatus'=1 {WRITE "%Prepare failed:" DO $System.Status.DisplayError(qStatus) QUIT}
    SET rset = tStatement.%Execute()
    DO rset.%Display()
    WRITE !,"Rowcount:",rset.%ROWCOUNT
  

  

ストリーム・フィールド

COUNT(expression) は、ストリーム・フィールド値のカウントに使用できますが、多少の制約があります。COUNT(streamfield) では、すべての非 NULL 値がカウントされます。値に重複があるかどうかはチェックされません。

expression がストリーム・フィールドである場合は、COUNT 関数の DISTINCT キーワードを指定できません。ストリーム・フィールドで DISTINCT キーワードを使用しようとすると、SQLCODE -37 エラーが返されます。

また、%FOREACH col-list でストリーム・フィールドを指定することはできません。これを実行しようとすると、SQLCODE -37 エラーが返されます。

以下の例は、COUNT 関数の有効な使用法を示しています。Title は文字列フィールド、Notes および Picture はストリーム・フィールドです。

SELECT DISTINCT Title,COUNT(Notes),COUNT(Picture %FOREACH(Title))
FROM Sample.Employee

Title が文字列フィールドで、Notes および Picture がストリーム・フィールドの場合、以下の例は有効ではありません。

-- Invalid: DISTINCT keyword with stream field
SELECT Title,COUNT(DISTINCT Notes) FROM Sample.Employee

-- Invalid: %FOREACH col-list contains stream field
SELECT Title,COUNT(Notes %FOREACH(Picture))
FROM Sample.Employee

特権

COUNT(*) を使用するには、指定したテーブルに対するテーブルレベルの SELECT 特権が必要です。COUNT(column-name) を使用するには、指定した列に対する列レベルの SELECT 特権、または指定したテーブルに対するテーブルレベルの SELECT 特権が必要です。%CHECKPRIV コマンドを呼び出すことにより、現在のユーザが SELECT 特権を持っているかどうかを確認できます。$SYSTEM.SQL.CheckPriv()Opens in a new tab メソッドを呼び出すことにより、指定のユーザがテーブルレベルの SELECT 特権を持っているかどうかを確認できます。特権の割り当てについては、"GRANT" コマンドを参照してください。

パフォーマンス

COUNT のパフォーマンスを最適化するには、以下のようにインデックスを定義してください。

• COUNT(*) で、必要に応じてビットマップ・エクステント・インデックスを定義する。このインデックスは、テーブルが作成されたときに自動的に定義されている場合もあります。

• COUNT(fieldname) で、指定されたフィールドのビットスライス・インデックスを定義する。

コミットされていないトラクザクションによる変更

すべての集約関数と同様、COUNT は常にデータの現在の状態を返します。現在のトランザクションの分離レベルを問わず、以下のようにコミット前の変更も現在の状態として扱われます。

• COUNT は、挿入されたレコードや更新されたレコードを、その変更がコミットされておらず、ロールバックされる可能性がある場合でもカウントします。

• COUNT は、削除されたレコードを、その削除がコミットされておらず、ロールバックされる可能性がある場合でもカウントしません。

詳細は、"SET TRANSACTION" および "START TRANSACTION" を参照してください。