ドキュメントの検索
karat

+

K

APIリファレンス ↗

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

トランスフォームテーブルを使ってデータを一括変換する

概要

トランスフォームテーブルは、オブジェクトやオブジェクトから派生した表形式のデータのバッチ解析を行うためのコンテナです。トランスフォームテーブルを使うと、入力オブジェクト(時系列を含む)のプロパティに基づいて行を導出したり、オブジェクトデータの結合やグループ化機能を提供します。

これらの操作の計算負荷が高いため、トランスフォームテーブルでは最大50,000行まで許可されています

トランスフォームテーブルの例

トランスフォームテーブルを使って以下のことができます。

  • オブジェクトを結合および集約する
  • オブジェクトプロパティから新しい行を導出する
  • データを作成または編集してデータを豊富にする
  • 時系列の行を一括で変換する
  • 操作の出力をさまざまな方法でプロットする

変換を追加する

トランスフォームテーブル検索ウィンドウは、変換を追加ボタンをクリックすることでトランスフォームテーブル内でアクセスできます。すべての利用可能な変換がトランスフォームアクションタイプ(列の編集、フィルター処理、時系列操作、null/エラー処理など)でグループ化されて表示されます。ほとんどの変換は、それぞれのタイプの新しい行を追加しますが、一部の変換はテーブルの形状を変更します(たとえば、他のオブジェクトタイプと結合したり、カテゴリーごとにテーブルをグループ化して行を集約する場合など)。

トランスフォームテーブル検索ウィンドウ

トランスフォームテーブル変換は、次のアクションメニューからも直接追加することができます。変換カテゴリーと変換を選択すると、選択した変換がテーブルに適用されたトランスフォームテーブルカードが解析に追加されます。

トランスフォームカテゴリー検索ウィンドウ

変換は、トランスフォームテーブルの外側のサポートされる入力の1つに対しても適用できます。これは、テーブル内のバッチ操作としてではなく、その値に対して1回だけ操作を行う場合です。

変換カードを解析に追加するには、上部のメニューバーで利用可能な検索ウィンドウを使って検索するだけです。

トランスフォームテーブルの入力

トランスフォームテーブルは、5つのカテゴリーの入力を受け取ることができます。オブジェクトセット、カテゴリカルチャート、時系列チャート、時系列プロット、テーブル(ピボットテーブルや他のトランスフォームテーブル)です。

時系列チャートと時系列プロットの違いについては、こちらを参照してください。

解析にトランスフォームテーブルを追加するには、上部のテーブルメニューでトランスフォームテーブルを選択します。これにより、エディタパネルが開き、解析に適した既存の入力を選択できます。

トランスフォームテーブルエディタパネル

入力: オブジェクトセット

オブジェクトセットは、トランスフォームテーブルの入力として最も一般的です。

解析内の任意のオブジェクトセットからトランスフォームテーブルを作成できます。次のアクションメニューで変換 > トランスフォームテーブルを選択します。

オブジェクトセットの次のアクションからトランスフォームテーブルを追加

トランスフォームテーブルごとに最大50,000行の制限があるため(開始から結合まで)、50,000行以下のオブジェクトでトランスフォームテーブルを作成することができます。

オブジェクトセットからトランスフォームテーブルが作成されると、セット内のオブジェクトごとに1行、各オブジェクトの一意のIDを表すプライマリキー列、オブジェクトの目立つプロパティ(オントロジーで定義されているもの)ごとに行が作成されます。また、目立つプロパティがない場合は、オブジェクトの最初のプロパティ(最大20個)が行として作成されます。

テーブルの右下隅にあるプロパティボタンをクリックして、プロパティ列を追加または削除し、オブジェクトセットにリンクされた測定値も追加します。列をドラッグしてテーブル内で並べ替えます。

トランスフォームテーブルの各変換ステップに対して異なる列構成を設定できます。以下のセクションで、トランスフォームテーブルの書式設定について詳しく学びましょう。

トランスフォームテーブル: 新しい列の追加

入力: カテゴリカルチャート

棒グラフ、折れ線グラフ、散布図はすべて、トランスフォームテーブルの入力になります。これらの入力を使用すると、チャートのカテゴリと値が表示され、基本データは取り込まれません。基本データを取り込むには、チャートを作成したオブジェクトセットを使用してください。カテゴリカルチャートからトランスフォームテーブルを作成するには、チャートを選択し、次のアクションメニューをクリックして、テーブル > トランスフォームテーブルを選択します。

入力: 時系列プロット

時系列プロットは、テーブルの入力になります。これにより、時系列データが表形式に変換され、操作、編集、または豊富にされます。

時系列プロットからトランスフォームテーブルを作成するには、チャートから特定の時系列プロットを選択してください。次に、時系列チャートの下部にある次のアクションメニューでテーブル > トランスフォームテーブルを選択します。

時系列からのトランスフォームテーブル

次に、トランスフォームエディタパネルで利用可能な範囲オプションを選択してください。

  • 入力時系列の全期間を使用する(デフォルト)
  • インポートする期間を指定する。これは、開始と終了のタイムスタンプを手動で入力するか、範囲パラメータを参照することで行えます。

パフォーマンス上の理由から、トランスフォームテーブルは50,000行に制限されています。トランスフォームテーブルは、データをバックエンドサービスにプッシュするのではなく、フロントエンドで操作するため、時系列データはサンプリング(バケット分け)して適合させる必要があります。

データオプションで、時系列データをどのように表形式に変換するかを選択できます。

  • 「サンプリング」設定では、各バケットに対して、境界タイムスタンプと値(最も早いものと最も遅いもの、最小値と最大値)、平均値、点数が表示されます。サンプリングバケットの数を調整できます。
  • 「非サンプリング」設定では、テーブルには生の非サンプリングデータ(「ティックデータ」)が表示され、プライマリキー、タイムスタンプ、値の3つの列が表示されます。
時系列プロットからのトランスフォームテーブル

タイムスタンプのシリーズデータは、デフォルトでUTCで表示されます。トランスフォームテーブルエディタの列設定で、タイムスタンプのタイムゾーンをユーザーのタイムゾーンまたは別の静的タイムゾーンに変更できます。

トランスフォームテーブル列タイムゾーン設定

入力: 時系列チャート

時系列チャートは、テーブルの入力になります。これにより、チャート内の各時系列プロットがテーブルの1行として開かれます。

時系列チャートからトランスフォームテーブルを作成するには、特定の時系列プロットではなく、時系列チャートを選択します。次に、時系列チャートの下部にある次のアクションメニューでテーブル > チャートの時系列からテーブルを選択します。

時系列チャートからのトランスフォームテーブル

入力: テーブル

ピボットされたデータは、トランスフォームテーブルの入力になります。これにより、ピボットテーブルの列でフォーミュラを使用して操作を行うことができます。チャートと同様に、ピボットテーブルからトランスフォームテーブルを作成すると、入力データではなく、ピボットされたデータが取り込まれます。 トランスフォームテーブルは、トランスフォームテーブルの入力にもなります。これは、変換ロジックを「ブロック」のロジックステップに分割したり、データ変換とデータ書式設定を分離したりする場合に便利です。 テーブルカードの下部にある次のアクションメニューでテーブルを選択することで、他のテーブルからトランスフォームテーブルを作成できます。 ピボットされたデータは、テーブルの入力になります。これにより、ピボットテーブルの列でフォーミュラを使用して操作を行うことができます。チャートと同様に、ピボットテーブルからトランスフォームテーブルを作成すると、入力データではなく、ピボットされたデータが取り込まれます。ピボットテーブルからトランスフォームテーブルを作成するには、テーブルを選択し、次のアクションメニューをクリックして、テーブル > トランスフォームテーブルを選択します。

変換テーブルの出力

変換テーブルからの出力には、主に4つのカテゴリーがあります。時系列、チャート、テーブル、値です。 変換テーブルの出力は、テーブルの下部にある次のアクションメニューから追加できます。

変換テーブル:出力インターフェース

出力:時系列

変換テーブルから時系列データを出力する方法はいくつかあります。

  • 時系列テーブルのセルにカーソルを合わせると、「ポップアウト」ボタンが現れます。これをクリックすると、新しい時系列チャートに時系列がプロットされます。
変換テーブル:セルのポップアウト
  • テーブルの下部にある次のアクションメニューで、時系列 > グループ化された時系列プロットを選択することで、時系列列を1つの時系列チャートにプロットできます。テーブルから入力列を選択し、重ねて表示する時系列の数を設定します。
変換テーブル:次のアクション グループ化された時系列プロット 変換テーブル:グループ化された時系列プロット
  • タブラ形式の時系列データ(タイムスタンプと値)を時系列プロットに変換して、Quiverで利用できる時系列可視化と変換のすべての範囲を使用できます。テーブルの下部にある次のアクションメニューで、時系列 > タブラ形式の時系列を選択します。変換テーブルからタイムスタンプ(日付/時刻)列と値(数値)列を選択し、必要に応じて単位を設定します。タブラ形式のデータにタイムスタンプごとに複数の値が含まれている場合、そのタイムスタンプの最初のポイントのみがプロットされます。
変換テーブル:タブラ形式の時系列 次のアクション 変換テーブル:タブラ形式の時系列設定

出力:チャート

変換テーブルのデータから、折れ線グラフ、カテゴリー別散布図、棒グラフ、Vegaプロットを作成できます。これらのチャートは、カテゴリー別の数式プロットやオーバーレイチャートなど、チャートを入力として受け取るQuiverの任意の機能で使用できます。

出力:テーブル

既存の変換テーブルから新しい変換テーブルを開始することで、基本データとは別にフォーマットや整理ができるビューを提供できます。

出力:値

変換テーブルの列を集約して、メトリックカード上に数値や配列として出力できます。これらのメトリックは、数値や配列を入力として受け取るQuiverの任意の機能で使用できます。

新しい列の計算

計算列を追加するには、変換の追加を選択し、作成するデータのタイプに対応するタブを選択します。数値、日付/時刻、文字列、ブール、配列、時系列です。

新しい列の追加アニメーション

列を作成するための利用可能な変換の完全なリストについては、変換テーブルの変換インデックスを参照してください。

結合

リンクされたオブジェクトへの結合

変換テーブルにオブジェクトが入力として設定されている場合、オントロジーを使用してリンクされたオブジェクトをテーブルに結合できます。この変換はリンクされたオブジェクトへの結合と呼ばれ、変換メニューのテーブルタブにあります。

リンクされたオブジェクトへの結合

オブジェクトセットを他のリンクされたオブジェクトに結合する場合、開始オブジェクトと入力オブジェクトの間の接続であるリンクタイプを選択するよう求められます。結果として得られるテーブルには、新しい結合された主キーがあります。これは、開始セットの主キーと入力セットの主キーの組み合わせです。新しい結合された主キーは、入力オブジェクトのプロパティを既存の各行に追加し、列の数を増やします。

リンクタイプの選択

開始オブジェクトが1つの入力オブジェクトにのみ接続されている場合(つまり、「1 対 1」または「多対 1」のリンクタイプ)、行の数は増えません。開始オブジェクトごとに複数の入力オブジェクトがある場合(つまり、「1 対 多」のリンクタイプ)、テーブルの行数が増えます。

以下の例では、会社のオブジェクトセットから変換テーブルを開始します。最初のテーブルには505行(オブジェクトごとに1行)があります。次に、リンクされた株式イベントオブジェクトを追加するために、リンクされたオブジェクトへの結合変換を追加します。これで、テーブルには11,149行があり、主キーは両方のオブジェクトの主キーの組み合わせであり、株式イベントオブジェクトからの列が追加されています。

リンクされたオブジェクトへの結合の例

結合

結合変換は、変換メニューのテーブルタブにあります。SQLの結合操作に似ており、2つの変換テーブルを結合する際に、一致条件(下の画像の緑のボックスで示されています)を指定できます。

結合を実行するには:

  1. 結合するテーブルを選択します。
  2. 結合タイプ(左、内部、または完全)を設定します。
  3. 一致条件を設定します。一致スタイル(すべて、いずれか)と、入力テーブルと結合テーブルの列の1つ以上のペアを比較します。
  4. 入力テーブルから保持する列を選択します。
  5. 結合されたテーブルから、入力テーブルに追加する列を選択します。入力テーブルにすでに追加される列と同じ名前の列が含まれている場合、結合された列のプレフィックスが追加されます。

変換テーブルの結合

クロス結合

クロス結合変換を使用すると、カルテシアン結合を実行して2つの変換テーブルを結合できます。クロス結合は、最初のテーブルの行と2番目のテーブルの行のペアのすべての組み合わせに対して行を生成します。特定の列に基づいて結合するわけではありません

グループ化

グループ化とは、事前に定義されたウィンドウやバケットで値のコレクションを集約することです。変換テーブルでこれを行う方法は2つあります。

グループ化

グループ化では、グループ化列のプロパティごとに1つのカテゴリーを作成します。各カテゴリーに対して、関連する時間ベースの数値列と時系列列が値の配列(グループとも呼ばれます)になります。これらの配列(グループ)に対して、配列変換や集約を実行できます。

例えば、下の変換テーブルでは、標高値が異なる世界中の気象ステーションのセットが表示されています。これらのステーションを所在国別にグループ化して、国ごとの標高値の配列を作成できます。

グループ化の例

これらの標高値に対して集約を行いたい場合、例えば各国の平均標高を計算する場合、数値グループ集約変換を使用できます。これにより、選択した入力列(ここでは elevation_array)の平均を返す列がテーブルに追加されます。

数値グループ集約

Joined Group By

Joined Group Byは、ウィンドウ化された集約量(例えば、カテゴリーごとの平均屋根高さなど)を計算したいが、テーブル内の行数を同じに保ちつつ、集約メトリックの新しい行を追加したい場合に便利です。

Joined Group By変換を実行すると、オブジェクトが所属するグループバイカテゴリーの一部でない各プロパティに対する値の配列行が追加されます(下の画像の緑のボックスで示されています)。その後、これらの配列に対して値を計算するために集約変換を追加する必要があります(下の画像の赤のボックスで示されています)。

Joined Group By

時系列

変換テーブルは、時系列のバッチ分析を可能にするために設計されています。これにより、フィルター処理、微分、累積集計などの変換が一度に複数の時系列に適用できるようになりました。

含まれている個々の時系列変換についての詳細情報は、変換テーブル変換の索引を参照してください。

変換テーブルに時系列行を追加する方法は3つあり、変換するデータのカテゴリーによって異なります。これらの方法は次のとおりです。

時間系列オブジェクトのセットから時系列ラインプロット(スパークライン)を表示する

デフォルトでは(そしてパフォーマンスの理由から)、時系列データのスパークラインは、明示的に追加しない限り表示されません。時間系列やセンサーオブジェクトを含む変換テーブルを作成した場合、Time Series Object変換を追加して、時間系列オブジェクトの主キーを選択することでそれらを含めることができます。

親オブジェクトからMeasure/Channelを追加する

親オブジェクトとしてマークされ、オントロジーで時間系列オブジェクトがそれに接続されているオブジェクトは、Measure行を追加するだけで関連シリーズを表示できます。これを行うには、Time Series Measureを選択し、親オブジェクトの主キーを選択します。

タイムスタンプと値のグループから時系列を作成する

変換テーブルを使用すると、日付や時間のグループを時系列に変換することができます。これは、変換テーブルの外部でオブジェクトの棒グラフや線グラフを時系列に変換するのと同じです。これを行うには、Group to Time Seriesを選択し、input dateとして日付/時間グループを、input valueとして数値/値グループを選択します。

変換テーブルのフォーマット

変換テーブルの行は、カスタマイズ可能な幅と高さでフォーマットできます。また、個々の値自体もフォーマットできます。すべてのフォーマットは、Transform TableのDisplayタブで行われます。

行のフォーマット

すべての行、数値であろうとそうでなかろうと、行の幅と最小高さを静的に設定するためのフォーマットオプションを含みます。

Column formatting Column formatting (continued)

行は、変換メニューからRename columns変換を追加することで名前を変更できます。

Rename columns

値の条件付きフォーマット

さらに、数値行には値と条件付きフォーマットのオプションがあり、以下のコントロールがあります。

  1. D3/視覚的なフォーマット: これらの数値フォーマットオプションは、Quiverのメトリックカードや他の数値データをフォーマットするために使用されるものと似ています。 D3フォーマットについて詳しく学ぶ。
  2. 配置: これらのオプションは、セル内の数字の配置を制御します。左寄せ、中央寄せ、右寄せの設定が利用可能です。
  3. 条件付き色付け: これらのオプションは、しきい値に基づいて値の条件付き色付けを可能にします。しきい値は静的に設定することも、Quiverの分析にある任意の他の数値を取り込むように設定することもできます。セルのテキストや背景の色を変更することができます。
Conditional formatting options Conditional coloring

FAQ

変換テーブルを使用して、グループバイ時系列を作成することはできますか?

はい。グループバイ時系列(バー図から時系列を作成し、それを複数の時系列に分割する能力)は変換テーブルで利用可能です。日付や時間のグループ、値のグループを使用して、Group to Time Series機能を使用してグループバイ時系列を作成できます。

変換テーブルの時系列で詳細情報をご覧ください。

変換テーブルをフォーマットできますか?

はい、パラメーターや手動で値を入力して、テーブルのセルをユーザー定義のロジックルールに従ってフォーマットすることができます。

変換テーブルのフォーマットに関するドキュメンテーションを参照してください。

変換テーブルのスケール限界は何ですか?

変換テーブルは、パフォーマンスの観点から、50,000行を限界としています。なぜなら、変換テーブルはデータをフロントエンドに引き寄せて操作するため、バックエンドサービスにデータをプッシュするのではないからです。

変換テーブルの値をプロットすることはできますか?

はい。変換テーブルからは4つの出力があります:時系列、テーブル、チャート、値(メトリックカード)。 変換テーブルの出力に関するドキュメンテーションを参照してください。

オブジェクトセットは変換テーブルへの入力として許可されている唯一のものですか?

いいえ。変換テーブルでオブジェクトを使用することは一般的ですが、時系列データ、チャートデータ、またはピボットテーブルや他の変換テーブルなどのテーブルに対して変換テーブルを使用することもできます。 チャートデータやピボットテーブルを操作すると、行は基礎となるオブジェクトとの接続を失い、集約データに対して操作を行うことができますが、基礎となるデータにリンクすることはできません。これにより、ピボットテーブルに対する列方向の操作を行う能力が開放され、さらに、プロットデータを表形式で作成し、操作する能力が開放されます。

変換テーブルの入力に関するドキュメンテーションを参照してください。