結果セットの行数の取得¶
結果セットの行数を取得するには、$count セグメントを URL に追加します。
例
customer ビューの行数の取得: http://acme:9090/denodo-restfulws/administration_guide/views/customer/$count
customer ビューで条件 Country = 'Mexico' を満たす行の数の取得: http://acme:9090/denodo-restfulws/administration_guide/views/customer/$count?Country=Mexico
customer ビューで条件 Country <> 'France' を満たす行の数の取得: http://acme:9090/denodo-restfulws/administration_guide/views/customer/$count?$filter=%22Country%22%3C%3E%27France%27
リクエストした表現 (HTML、XML、または JSON) によって結果は異なります。
上記の URL をブラウザで開くと、結果セットの行数を値とする「count」列が 1 つ存在するテーブルの HTML 表現が RESTful Web サービスから返されます。
XML 表現または JSON 表現をリクエストした場合 ($format パラメータを追加するか、HTTP ヘッダー Accept を使用します)、RESTful Web サービスからは行数のみが、XML ドキュメントでも JSON ドキュメントでもないプレーンテキストで返されます。
JSON 表現をリクエストした場合、$jsoncallback パラメータを追加すると、コールバック関数の内部に行数を取得できます。
たとえば、URL として http://acme:9090/denodo-restfulws/administration_guide/views/customer/$count?$format=json&$jsoncallback=function1 を指定します。
この URL によって以下の関数が返されます。
function1(39)
39 は customer ビューにある行の総数です。
$count
セグメントを URL に追加した場合は (例: 「.../customer/$count」)、 $start_index
と $count
のどちらのパラメータも使用できません。