式の編集

最終更新日： 2025年4月11日

式を編集する場合は、条件を手動で入力してルールを作成します。このモードでは、日付、文字列、数値フィールド、並べ替えなど、特定のクエリの実行に使用する値を操作できる高度な関数を使用できます。

IMPORTANT
以下の節では、式エディターを操作してルールを作成する方法について説明します。ルールの作成に使用される構文は、パーソナライゼーションの追加に使用される構文とは異なることに注意してください。

式エディターの操作

式エディターは、クエリモデラーの「式を編集」ボタンから実行できます。このボタンは、カスタム条件を設定する際に「属性」フィールドと「値」フィールドで使用できます。

「属性」フィールドからのアクセス「値」フィールドからのアクセス
属性フィールドの式エディター 値フィールドの式エディター

式エディターには、次の内容があります。

  • 式が定義されている 入力フィールド （1）。
  • 式で使用でき、クエリのターゲティングディメンションに対応する使用可能な フィールド （2） のリスト。
  • カテゴリ別に並べ替えられる​ ヘルパー関数（3）。

式を編集するには、入力フィールドに式を直接入力します。フィールドまたはヘルパー関数を追加するには、式内の追加する場所にカーソルを置き、「+」ボタンをクリックします。

式エディターインターフェイス

式の準備が整ったら、「確認」ボタンをクリックします。式は、選択したフィールドに表示されます。編集するには、式エディターを開き、目的の変更を行います。

次の例は、「値」フィールドに設定された式を示しています。編集するには、「式を編集 ボタンを使用して式エディターを開きます。

値フィールドの式の編集例

ヘルパー関数

クエリ編集ツールを使用すると、高度な関数を使用して、目的の結果や操作対象のデータのタイプに応じて複雑なフィルタリングを実行できます。次の関数を使用できます。

集計

集計関数は、一連の値に対して計算を実行します。

名前説明構文
Avg数値タイプの列の平均を返しますAvg(<値>)
カウント列の null でない値をカウントしますCount(<値>)
CountAll返される値をカウントします（すべてのフィールド）CountAll()
Countdistinct列の null でないユニーク値をカウントしますCountdistinct(<値>)
Max数値、文字列または日付タイプの列の最大値を返しますMax(<値>)
Min数値、文字列、または日付タイプの列の最小値を返しますMin(<値>)
StdDev数値、文字列、または日付列の標準偏差を返しますStdDev(<値>)
StringG文字列タイプの列の値を,、2 番目の引数の文字で区切って連結した結果を返しますStringAgg(<Value>, <String>)
Sum数値、文字列または日付タイプの列の値の合計を返しますSum(<値>)

日付

日付関数は、日付または時刻の値を操作します。

名前説明構文
AddDays日付に日数を追加しますAddDays(<日付>, <数値>)
AddHours日付に時間数を追加しますAddHours(<日付>, <数値>)
AddMinutes日付に分数を追加しますAddMinutes(<日付>, <数値>)
AddMonths日付に月数を追加しますAddMonths(<日付>, <数値>)
AddSeconds日付に秒数を追加しますAddSeconds(<日付>, <数値>)
AddYears日付に年数を追加しますAddYears(<日付>, <数値>)
ConvertNTZ定義済みセッション TZ を適用して、タイムスタンプ NTZ （timestamp without timezone）を TZ （timestamp with timezone）に変換するConvertNTZ （<date+time>）
DateCmp2 つの日付を比較DateCmp （<date>, <date>）
DateOnly日付のみを返します（時刻は 0:00）DateOnly(<日付>)
日日付の日を表す数を返しますDay(<日付>)
DayOfYear日付の年の日数を返しますDayOfYear(<日付>)
DaysAgo現在の日付 - n 日に対応する日付を返しますDaysAgo(<数値>)
DaysAgoInt現在の日付 - n 日に対応する日付（整数 yyyymmdd）を返しますDaysAgoInt(<数値>)
DaysDiff2 つの日付間の日数を返しますDaysDiff(<終了日>, <開始日>)
DaysOld年齢（日数）を返しますDaysOld(<日付>)
GetDateサーバーの現在のシステム日付を返しますGetDate()
時間日付の時間を返しますHour(<日付>)
HoursDiff2 つの日付の間の時間数を返しますHoursDiff(<終了日>, <開始日>)
分日付の分を返しますMinute(<日付>)
MinutesDiff2 つの日付の間の分数を返しますMinutesDiff(<終了日>, <開始日>)
月日付の月を表す数を返しますMonth(<日付>)
MonthsAgo現在の日付 - n ヶ月に対応する日付を返しますMonthsAgo(<数値>)
MonthsDiff2 つの日付の間の月数を返しますMonthsDiff(<終了日>, <開始日>)
MonthsOld年齢（月数）を返しますMonthsOld(<日付>)
古い範囲内の最も古い日付を返しますOldest （<date, date>）
Second日付の秒を返しますSecond(<日付>)
SecondsDiff2 つの日付の間の秒数を返しますSecondsDiff(<終了日>, <開始日>)
SubDays日付から日数を引きますSubDays(<日付>, <数値>)
SubHours日付から時間数を引きますSubHours(<日付>, <数値>)
SubMinutes日付から分数を引きますSubMinutes(<日付>, <数値>)
SubMonths日付から月数を引きますSubMonths(<日付>, <数値>)
SubSeconds日付から秒数を引きますSubSeconds(<日付>, <数値>)
SubYears日付から年数を引きますSubYears(<日付>, <数値>)
ToDate日付 + 時間を日付に変換しますToDate(<日付 + 時刻>)
ToDateTime文字列を日付 + 時刻に変換しますToDateTime(<文字列>)
ToStamp文字列をタイムスタンプに変換しますToTimestamp （<string>）
ToTimezone日付+時刻をタイムゾーンに変換しますToTimeZone （<date>, <time zone>）
TruncDate日付+時刻を最も近い秒に丸めますTruncDate(@lastModified, <秒数>)
TruncDateTZ日付と時刻を指定された精度（秒）に丸めますTruncDateTZ(<日付>, <秒数>, <タイムゾーン>)
TruncQuarter日付を四半期に丸めますTruncQuarter(<日付>)
TruncTime時刻部分を最も近い秒に丸めますTruncTime(<日付>, <秒数>)
TruncWeek日付を週に丸めますTruncWeek(<日付>)
TruncYear日付 + 時刻をその年の 1 月 1 日に丸めますTruncYear(<日付>)
平日曜日を表す数値を返します (0=月曜日、6=日曜日)WeekDay(<日付>)
年日付の年を表す数を返しますYear(<日付>)
YearAndMonth日付の年と月を表す数を返しますYearAndMonth(<日付>)
年前指定された日付から現在の日付までの年数を返しますYearsAgo （<date>）
YearsDiff2 つの日付間の年数を返しますYearsDiff(<終了日>, <開始日>)
YearsOld満年齢を返しますYearsOld(<日付>)
NOTE
DateOnly 関数は、オペレーターのタイムゾーンではなく、サーバーのタイムゾーンを考慮することに注意してください。

ジオマーケティング

ジオマーケティング関数は、地理に関する値を操作する場合に使用します。

名前説明構文
Distance経度と緯度で定義された 2 つのポイントの距離を返します。Distance(<経度 A>, <緯度 A>, <経度 B>, <緯度 B>)

数値

数値関数は、テキストを数値に変換する場合に使用します。

名前説明構文
Abs数値の絶対値を返しますAbs(<数値>)
Ceilある特定の数値以上の最小の整数を返しますCeil(<数値>)
Floorある特定の数値以上の最大の整数を返しますFloor(<数値>)
Greatest2 つの数のうち大きい方を返しますGreatest(<数値 1>, <数値 2>)
Least2 つの数のうち小さい方を返しますLeast(<数値 1>, <数値 2>)
Mod整数の割り算 n1 ÷ n2 の余りを返しますMod(<数値 1>, <数値 2>)
Percent割合で表される 2 つの数の比率を返しますPercent(<数値 1>, <数値 2>)
Randomランダムな値を返しますRandom()
Round数値を n 桁に丸めますRound(<数値>, <小数点以下の桁数>)
Sign数値の符号を返しますSign(<数値>)
ToDouble整数を浮動小数に変換しますToDouble(<数値>)
ToInt64浮動小数を 64 ビットの整数に変換しますToInt64(<数値>)
ToInteger浮動小数を整数に変換しますToInteger(<数値>)
Truncn1 を n2 の桁数に切り捨てますTrunc(<n1>, <n2>)

その他

以下の表には、上記以外の使用可能な関数が記載されています。

名前説明構文
AESEncrypt引数で指定された文字列を暗号化AESEncrypt(<value>)
Case条件が true の場合は値 1 を返します。そうでない場合は値 2 を返します(When(<条件>, <値 1>), Else(<値 2>))
ClearBit値のフラグを削除しますClearBit(<識別子>, <フラグ>)
Coalesce値 1 がゼロまたは null の場合は値 2 を返し、それ以外の場合は値 1 を返しますCoalesce(<値 1>, <値 2>)
Decode値 1 = 値 2 の場合は値 3 を返します。そうでない場合は値 4 を返しますDecode(<値 1>, <値 2>, <値 3>, <値 4>)
Else値 1 を返します（case 関数のパラメーターとしてのみ使用できます）Else(<値 1>, <値 2>)
GetEmailDomainメールアドレスからドメインを抽出しますGetEmailDomain(<値>)
GetMirrorURLミラーページサーバーの URL を取得しますGetMirrorURL(<値>)
Iif式が true の場合は値 1 を返します。そうでない場合は値 2 を返しますIif(<条件>, <値 1>, <値 2>)
IsBitSet値にフラグが含まれているかどうかを示しますIsBitSet(<識別子>, <フラグ>)
IsEmptyString文字列 1 が空の場合は値 2 を返し、それ以外の場合は値 3 を返しますIsEmptyString(<値 1>, <値 2>, <値 3>)
NewUUID一意の ID を返しますNewUUID()
NoNull引数が NULL の場合は、空の文字列を返しますNoNull(<値>)
RowIdライン番号を返しますRowId
SetBit値に強制的にフラグを指定しますSetBit(<識別子>, <フラグ>)
ToBoolean数値をブール値に変換しますToBoolean(<数値>)
When式が true の場合は値 1 を返します。そうでない場合は値 2 を返します（case 関数のパラメーターとしてのみ使用できます）When(<条件>, <値 1>)