実装ガイド › 実装 › 成果物の作成（契約マネージャ） › レポートの作成方法 › 自由形式レポート › 汎用のヒストグラム自由形式レポート

汎用のヒストグラム自由形式レポート

以下で述べるクエリを、下のグラフに示したようにテーブル内の値の分布をパーセンテージで示すために、自由形式レポート内で使用することができます。

前に示したグラフでは、各値のどの割合（パーセンテージで）が 11.5 未満（0%）、804.74 未満（~50%）、および 1435.53 未満（100%）であるかを確認できます。

SLA が目標を「値の x% が y 未満であるべき」と指定した場合、この自由形式の結果は SLA への適合を保証する x 値と y 値を見つけることに役立ちます。

以下のパラメータがクエリ内で使用されます。

• @Query - 次の形式のクエリの select ステートメント： select some_value val from some_table。 エイリアス（別名）の val は必須です。 このクエリにより、分布が分析される各値が提供されます。
• @Buckets - x 軸上の値の数。 ソース値はこれらの数に丸められます。 たとえば、@Buckets = 100 を指定すると、ソース データの値は 100 のグループに分割されます。また、クエリによりどれだけの値が各グループの範囲内に入るかが計算されます。 @Buckets の値を大きくすると結果はより正確になりますが、グラフの視覚的な訴求力は低下します。
• @Relation - 累積の方向。 可能な値は、「<」（目標が「次の値以上」の場合）または「>=」（目標がそれ以外の場合）です。

クエリは、最適な結果を得るために、データ ソースまたは T_SLALOM_OUTPUTS に対して実行できます。

以下のクエリによって、前に示したグラフが生成されます。

select val,100*records/(select count(*) from (@Query))
from
(
  select x.bucket_val val,
    sum(y.records) records
  from
  (
    select round(val/bucket_size,0)*bucket_size bucket_val,
      count(*) records
    from
    (
      select (max(val)-min(val))/@Buckets bucket_size
      from
      (
        @Query
      )
    ) params,
    (
            @Query
       ) source
    group by round(val/bucket_size,0)*bucket_size
    order by round(val/bucket_size,0)*bucket_size
  ) x,
  (
    select round(val/bucket_size,0)*bucket_size bucket_val,
      count(*) records
    from
    (
      select (max(val)-min(val))/@Buckets bucket_size
      from	
      (
        @Query
         )
    ) params,
    (
            @Query
       ) source
    group by round(val/bucket_size,0)*bucket_size
    order by round(val/bucket_size,0)*bucket_size
  ) y
  where y.bucket_val @Relation x.bucket_val
  group by x.bucket_val
  order by x.bucket_val
)

使用可能なサンプルのパラメータ リスト（XML 形式）を以下に示します。

<custom>
     <connection>
          <params/>
     </connection>
     <query>
          <params>
               <param name="@Query" disp_name="Data Type" type="LIST">
                    <value>PDP Context Activation Success</value>
                    <list>
                         <item>
                              <value>select success_rate as val from PDP_Context_Activation_Success.CSV</value>
                              <text>PDP Context Activation Success</text>
                         </item>
                         <item>
                              <value>select throughput as val from [gprs throughput volume by apn.csv]</value>
                              <text>Throughput of a Single APN</text>
                         </item>
                         <item>
                              <value>select throughput as val from [Generic GPRS Throughput.CSV]</value>
                              <text>Generic Throughput</text>
                         </item>
                    </list>
               </param>
               <param name="@Buckets" disp_name="X Axis Values" type="LIST">
                    <value>100</value>
                    <list>
                         <item>
                              <value>25</value>
                              <text>25</text>
                         </item>
                         <item>
                              <value>50</value>
                              <text>50</text>
                         </item>
                         <item>
                              <value>100</value>
                              <text>100</text>
                         </item>
                         <item>
                              <value>250</value>
                              <text>250</text>
                         </item>
                         <item>
                              <value>500</value>
                              <text>500</text>
                         </item>
                         <item>
                              <value>1000</value>
                              <text>1000</text>
                         </item>
                    </list>
               </param>
               <param name="@Relation" disp_name="Violation of threshold means" type="LIST">
                    <value>providing too little</value>
                    <list>
                         <item>
                              <value>&gt;=</value>
                              <text>providing too little</text>
                         </item>
                         <item>
                              <value>&lt;=</value>
                              <text>providing too much</text>
                         </item>
                    </list>
               </param>
          </params>
     </query>
</custom>

コメント

• このクエリは、Oracle と SQL Server 向けに最適化されています。 他の ODBC データ ソースについては、列別名の前に「as」を追加し、また他の変更を適用することが必要になる場合があります。
• 結果を Excel にエクスポートする場合は、ユーザで XY（散布図）レポートを生成してそれを表すことをお勧めします。 グラフを点で描ける場合は、値の散乱を示すことも可能です。