結果セットの行数の取得

結果セットの行数を取得するには、$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 に追加した場合は、 $start_index と $count のどちらのパラメーターも使用できません。