これまでの New to NetSuite | SuiteQL Overview および New to NetSuite | Understanding SuiteQL Syntax の記事では、SuiteQLの基本的な概念、機能、および構造について説明しました。
高度なクエリ向けの SuiteQL 構文では、単純な選択や結合にとどまらず、データベース内で堅牢かつ柔軟な分析クエリを実行できます。SuiteQL の機能は標準 SQL と類似しています(一部、NetSuite 固有の制約があります)。こうした高度な機能の1つがWIDTH_BUCKETです。
WIDTH_BUCKETは、範囲をバケットと呼ばれる等間隔の区間に分割し、各値が属するバケットの番号を返します。これにより、顧客の与信限度額などの値を分析用にグループ化できます。
構文
WIDTH_BUCKET(expression, min_value, max_value, num_buckets)
- expression: 評価する値または列。
- min_value: 開始境界値。
- max_value: 終了境界値。
- num_buckets: 等間隔のバケットの数。正の整数である必要があります。
昇順の範囲では、各バケットは下限値を含み、上限値を含みません。
SuiteQLのサンプル
このクエリは、顧客の与信限度額を、それぞれ2,000幅の5つの等しい範囲にグループ化します。
SELECT
id, -- Customer's internal ID
companyname, -- Customer's company name
creditlimit, -- Customer's assigned credit limit
-- Divide the range from 0 to 10,000 into 5 equal-sized buckets.
-- Bucket width = (10,000 - 0) / 5 = 2,000.
-- Each bucket includes its lower boundary and excludes its upper boundary.
-- Bucket 1: 0 <= creditlimit < 2,000
-- Bucket 2: 2,000 <= creditlimit < 4,000
-- Bucket 3: 4,000 <= creditlimit < 6,000
-- Bucket 4: 6,000 <= creditlimit < 8,000
-- Bucket 5: 8,000 <= creditlimit < 10,000
-- Values below 0 return bucket 0.
-- Values of 10,000 or higher return bucket 6.