チューリップ・テーブルのクエリと集約

目的

Tulipテーブルをクエリし、Tulip Appsからアクセス可能な集計を作成する方法を学びます。

この記事では、次のことを学びます。

• テーブルクエリの機能
• クエリと集計の作成方法
• アプリでのクエリと集計の使用方法

テーブルクエリとテーブル集計の概要

Table QueriesとTable Aggregationsを使用すると、App内でTulip Tablesにクエリを発行し、動的にフィルタリングすることができます。

この記事では、10行の注文を持つ以下のテーブルを参照します：

右上にQueriesと Aggregationsのボタンがあります。右上に「Queries」と「Aggregations」のボタンがあります。

次の例では、出荷されていないレコードのみを返すフィルタを使用しています：

集計はクエリの上に追加され、クエリのようにテーブルレベルで作成されます。新しい集計を作成するには、**[Aggregations]**をクリックします。

次の例では、テーブルフィールド「商品数量」を集計します：

クエリオプション

フィルタ

特定の列、または複数の列を静的値またはアプリ入力と比較して、レコードをフィルタリングします。

比較オプションの例を以下に示します：

• 等しい / 等しくない
• NULL / NULLでない
• 含む / 含まない
• で始まる / で始まらない
• で終わる / で終わらない
• である
• 以上である / 以下である
• が後またはatである / が前またはatである

Static Valueはクエリ構築時に静的に設定されるが、App Inputはアプリ自体で設定される。App Inputは以下のように設定できる：

• 変数
• 静的値
• アプリ情報
• チューリップ・テーブル・レコード

テーブル・クエリでCreated AtフィールドとUpdated Atフィールドを使用できるようになりました。

ソート

Sortオプションを設定することで、レコードの表示をカスタマイズできます。例を以下に示します：

• AからZ / ZからA
• 0から9 / 9から0

制限

制限を設定することで、クエリによって返されるレコードの量に制限を設けることができます。

制限の最大値は1,000レコードです。

テスト

Filter、Sort、Limitオプションを設定してクエリを設定した後、Testをクリックするとテーブル上でクエリをテストできます。これにより、クエリがアプリで返す結果をシミュレートできます。

集計

集計は、クエリ上で実行されるサマリー値であり、特定のカラムに対して以下の値のいずれかを計算することができます：

• 平均
• カウント
• 最大値
• 最小
• モード
• 合計
• 一意な値

:::(Info) (集約と制限) 集約はテーブルクエリの上に構成されるため、集約の親テーブルクエリに設定された制限は集約にも適用されます。つまり、Aggregation は最大 1,000 レコードまで考慮することができます：

アプリでクエリと集約を使用する

アプリへのクエリの追加

アプリにクエリを追加するには、まず、[Records]タブをクリックし、**[+Add Table]**をクリックして、テーブルをアプリに追加します。次に、[Query]をクリックします。

表示されるモーダルで、クエリに「Query Name（クエリ名）」を指定し、該当する場合はフィルタに関連する「App Input（アプリ入力）」を構成します。この例では、クエリ「Products Not Shipped」を参照してください：

クエリがアプリで構成されたので、インタラクティブテーブルを埋め込み、クエリとなるデータソースを選択します。

埋め込みテーブルには、クエリの結果が表示されます。この例では、**'Shipped' equals 'No'**というフィルタを満たすレコードが3件返されています：

アプリへの集計の追加

クエリをAppに追加する方法と同様に、+Add Aggregationをクリックして集計を追加し、Aggregation Nameを割り当てます。

この例では、未出荷のレコードのみを返すクエリに対して、Total Qty Products Orderedという集計を実行しています。このため、集計名はQuantity of Products to be Shippedとなっています：

アプリに集約を埋め込むには、変数（Variable）をアプリにドロップし、データソース（Datasource）-チューリップ・テーブル集約（Tulip Table Aggregation）を選択します。次に、アプリに集約を追加するときに構成された集約名を選択します。

この例では、出荷が必要なレコードを返すQueryの上で、Sum of ProductQuantityという集計が実行されています。これは合計17を返します：

アプリのロジックで集計を使用する

集約を使用すると、集約の値を中心にアプリロジックを構築することができます。以下の例を参照してください：

Single NumberTulip Analyticsは現在アプリからアクセスできないため、アプリロジックで直接利用することはできません。クエリから集計を実行することで**、**この値をターゲットにすることができ、その値を中心にアプリロジックを構築することができます。