フィールドの SQL 集約関数を設定または戻します。集約関数を設定する場合、選択する関数がフィールド タイプにとって意味のあるものでなければなりません。
例えば、DB_AGGR_COUNT を使用して、そのフィールドに何らかの値のあるレコードのカウントを戻します。一般的にはすべてのレコードのカウントを意図するので、カウントするフィールドとして通常は DBID を選択します。他の関数は、フィールドの最小値、最大値、平均値、合計のいずれかを戻します。合計および平均は、数値フィールドの場合のみ動作します。
例えば、「select count(dbid) from defect」では、データベース内の障害の合計数が戻されます。
また group-by フィールドを指定して、他のいくつかのフィールドによって破壊された統計情報を取得することもできます。例えば、「select count(dbid), owner from defect group by owner」では、所有者あたりの障害数が戻され、各所有者について、カウントと所有者が表示されます。
選択文節内でこれらの集約関数を他のフィールドと混在することは、それらが group-by 文節でも指定されていない限り、通常は無効です。ただし、複数の集約を指定できます。例えば、「select count(dbid), max(severity), min(due_date), owner group by owner」です。
VBScript
queryfielddef.AggregateFunction queryfielddef.AggregateFunction NewValue
Perl
$queryfielddef->GetAggregateFunction $queryfielddef->SetAggregateFunction(NewValue);
Perl
use CQPerlExt; #Start a Rational ClearQuest session #$AdminSession= CQAdminSession::Build(); $SessionObj = CQSession::Build(); $dbsetname = "CQMS.SAMPL.HOME"; #Refresh list of accessible databases $databases = $SessionObj->GetAccessibleDatabases("MASTR", "", $dbsetname); #Log into a database $SessionObj->UserLogon("admin","","SAMPL",$dbsetname); $querydef = $SessionObj->BuildQuery("defect") ; $querydef->BuildField("id") ; $querydef->BuildField("owner.login_name") ; $queryfielddefs = $querydef->GetQueryFieldDefs(); $idfield = $queryfielddefs->ItemByName("id"); $idfield->SetAggregateFunction($CQPerlExt::CQ_DB_AGGR_COUNT); $ownerfield = $queryfielddefs->ItemByName("owner.login_name"); $ownerfield->SetIsGroupBy(1); $resultset = $SessionObj->BuildResultSet($querydef); $ct = $resultset->ExecuteAndCountRecords(); for ($i = 0; $i < $ct; $i++) { $resultset->MoveNext(); print $resultset->GetColumnValue(1); print " "; print $resultset->GetColumnValue(2); print "¥n"; } CQAdminSession::Unbuild($AdminSession); CQSession::Unbuild($SessionObj);