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

目的

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

制限

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

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

集計オプション

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

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

アプリでのクエリーと集計の使用

アプリへのクエリの追加

アプリにクエリを追加するには、まず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は現在アプリからアクセスできないため、アプリロジックで直接利用することはできません。クエリから集計を実行することで**、**この値をターゲットにすることができ、その値を中心にアプリロジックを構築することができます。