メインコンテンツまでスキップ

仮想プロパティと参照テーブルのプロパティ

最終更新 2026/10/03

業務データを分析する際、レポーティングされたプロパティやクロスソースで生成されたプロパティをそのまま使うだけでなく、特殊なプロパティに二次加工を施したり、参照テーブルのマッピングデータと組み合わせて変換したりしたい場合があります。このような場合は、「仮想プロパティ」と「参照テーブル」機能で処理できます。

1. 仮想プロパティの作成​

次のような場合は、ユーザープロパティまたはイベントプロパティ画面で仮想プロパティを作成できます:

  • プロパティやタグを二次計算して新しいプロパティを生成したいとき(複数プロパティの数値演算、複数プロパティの連結、論理式など)
  • プロパティやタグのデータタイプを変換したいとき(テキストを配列やオブジェクトに分割する、数値をテキストに変換するなど)
  • その他のシナリオは仮想プロパティ作成のベストプラクティスを参照してください

SQL 関数テンプレートを使った仮想プロパティの設定

AE 4.0では、ユーザーがより手軽に仮想プロパティを作成できるよう、常用関数テンプレートをリリースしました。

  • 関数名にマウスカーソルを合わせると、その関数の名前、使い方の概要、使用例が表示されます。
  • 「挿入」ボタンをクリックすると、例が編集ボックスに挿入され、そのまま二次編集できます。
  • 他のイベントプロパティ、ユーザープロパティ、タグを自由にコピーして取り込み、関数と組み合わせて使うことで、より柔軟に仮想プロパティを作成できます。

仮想プロパティのルールを設定する際(下図参照):

  • 既存の仮想プロパティを使って、さらに仮想プロパティを作成することはできません
  • 仮想プロパティにデータテーブルを関連付けて生成した参照テーブルのプロパティは使用できません
  • 分析主体が仮想プロパティであるタグは使用できません
  • row_number()、lead()など、行をまたいで計算する関数は使用できません
  • ( select xxx )などのサブクエリは使用できません

設定したルールは、デバッグが通ってから保存できます。デバッグ時には、ルールの演算結果に基づいてシステムがプロパティのデータタイプを推定します。ルールのデータタイプを強制的に変換したい場合は手動で調整できますが、調整後は再度デバッグする必要があります。

カスタム仮想イベントプロパティとイベントの関連付けでは、自動マッチを選択できます。この場合、システムが仮想プロパティのルールに基づいて関連付け可能なイベントを推定します。もちろん、ユーザーがイベントを指定して関連付けを作成することもできます。

2. 参照テーブルのプロパティの作成​

次のような場合は、ユーザープロパティまたはイベントプロパティ画面で参照テーブルのプロパティを作成できます:

  • レポーティングされたキー型のプロパティ(アイテムIDなど)に、アイテム名のような読みやすい表示名を追加したいとき
  • レポーティングされたキー型のプロパティに、アイテムの分類や価格など、より多くの業務情報を補足したいとき

作成済みのデータテーブルをプロパティの参照テーブルとして追加することも、新しくデータテーブルを作成してプロパティの参照テーブルにすることもできます。参照テーブルとして追加すると、そのテーブルの主キー以外のフィールドに基づいて参照テーブルのプロパティが自動生成されます。参照テーブルのプロパティは、イベントプロパティやユーザープロパティとして分析に使用できます。

次のプロパティには、そのプロパティ自体に参照テーブルを追加できません:

  • 作成ルールに参照テーブルのプロパティを含む仮想プロパティとそのサブプロパティには、参照テーブルを追加できません
  • 仮想イベントプロパティの作成ルールにユーザープロパティまたはタグが含まれる場合、参照テーブルを追加できません

プロパティのデータタイプによって、参照テーブルの要件は次のように異なります:

プロパティのデータタイプ参照テーブル追加の説明
文字列、数値、ブール値参照テーブルを追加できます。テーブルのプライマリキーのデータタイプは、プロパティと同じである必要があります。
時間参照テーブルを追加できます。テーブルの主キーのデータタイプはテキストで、時間フォーマットの指定が必要です。
リスト参照テーブルを追加できます。テーブルのプライマリキーのデータタイプは文字列である必要があります。
オブジェクト、オブジェクトグループ参照テーブルのプロパティは追加できません。サブプロパティには参照テーブルを追加できます。

通常、システムは参照テーブル内のフィールド(主キーを除く)に対して参照テーブルのプロパティを自動作成します。ただし、リストタイプのプロパティの参照テーブルでは、テーブル内のテキストタイプのフィールドに対してのみ、対応する参照テーブルのプロパティが作成されます。

プロジェクトで有料機能「クロスソースアセット構成」を有効にし、「データテーブル」を設定している場合、画面上の「参照テーブル」の編集は「データテーブル」と表示され、参照テーブルの更新/ダウンロード/削除機能は提供されません。

このページは役に立ちましたか?