Tulip Tablesへのクエリ実行方法や、Tulip Apps内で利用可能な集計機能の構築方法について学びましょう
この記事では、以下のことを学びます...
- テーブルクエリと集計機能の概要
- クエリと集計の構築方法
- アプリ内でのクエリと集計の使用方法
概要
テーブルクエリと集計機能を使用すると、テーブルと動的にやり取りし、データをフィルタリングや集計してアプリで活用することができます。
この記事では、10行からなる以下の「注文」テーブルを例として取り上げます:

右上に**「クエリ**」と「集計」のボタンが表示されています。「クエリ」をクリックして、新しいクエリを追加します。
次の例では、フィルタを使用して、まだ出荷されていないレコードのみを返すようにしています:

集計はクエリの上に追加され、クエリと同様にテーブルレベルで構築されます。「集計」をクリックして、新しい集計を作成します。
次の例では、テーブルのフィールド「Product Quantity」の合計を算出します:

クエリ
クエリを使用すると、テーブル内のデータをフィルタリングしたり並べ替えたりできます。クエリでは、静的な値またはアプリの入力に基づく動的な値のいずれかを使用できます。
フィルタ
特定の列、または複数の列を、静的値またはアプリ入力と比較してレコードをフィルタリングします。
比較オプションの例としては、次のようなものがあります:
- 等しい/等しくない
- NULLである/NULLでない
- 含む/含まない
- で始まる/で始まらない
- で終わる / で終わらない
- 含まれる
- 以上である/以下である
- より後または等しい/より前または等しい
「静的値」はクエリの構築時に静的に設定されますが、「アプリ入力」はアプリ内で設定されます。「アプリ入力」は以下のいずれかに設定できます:
- 変数
- 静的値
- アプリ情報
- Tulipテーブルレコード
テーブルクエリで「作成日時」および「**更新日時」**フィールドを使用できるようになりました。
並べ替え
「並べ替え」オプションを設定して、レコードの表示をカスタマイズできます。例としては、次のようなものがあります。
- A から Z / Z から A
- 0 から 9 / 9 から 0
制限
クエリによって返されるレコードの最大数。
- デフォルト:1,000
- 最大値: 1,000
:::(警告) (制限に達した場合の挙動)
クエリのフィルタ(フィルタを設定していない場合は全体)に一致するrecords がテーブル内に制限数より多い場合、クエリ結果に含まれるのは制限数で指定された数のみとなります。
クエリに並べ替えが含まれている場合、その並べ替え順に従って最初のrecords がクエリ結果に含まれます。
:::
テスト
「Filter」、「Sort」、「Limit」オプションを設定してクエリを構成した後、**「Test」**をクリックすることで、テーブル上で直接クエリをテストできます。これにより、アプリ内でそのクエリがどのような結果を返すかがシミュレートされます。
アプリでのクエリの使用
アプリにクエリを追加するには、まず「レコード」タブをクリックし、「+テーブルを追加」を選択して、テーブルをアプリに追加します**。**次に、「クエリ」をクリックします。
表示されるモーダルで、クエリに「クエリ名」を指定し、必要に応じてフィルターに関連付けられた「アプリ入力」を設定します。この例では、「未出荷の製品」というクエリをご覧ください**:**

アプリでクエリの設定が完了したら、インタラクティブテーブルを埋め込み、データソースとしてそのクエリを選択します。
埋め込まれたテーブルには、クエリの結果が表示されます。この例では、フィルター条件「Shipped」が「No」に等しいレコードが3件返されています**:**

集計
集計とは、クエリに基づいて実行される集計値のことで、特定の列について以下のいずれかの値を計算できます:
平均*:数値または整数の平均値を返します
Count*:レコード数を返します。フィールドは不要です
Max*:数値または整数の最大値を返します
Min*:数値または整数の最小値を返します
最頻値*:最も頻繁に現れる値を返します。* 注:2つの値の出現回数が同じ場合、常に小さい方の値が返されます。
Sum* 数値または整数の合計を返します
Unique Values* 指定されたクエリの個々のユニークな値の配列を、データ型を問わず返します
制限
集計では、最大 1,000 件のレコードを対象とすることができます。
集計は、設定されたクエリによって返されたレコードに対して実行されます。集計の親クエリに設定された制限は、その集計にも適用されます(1,000 レコード)。
テーブルに、指定されたフィルター条件に一致するレコードが制限数を超えて存在し、かつユーザーがクエリの制限を認識していない場合、集計の結果が予期しないものになる可能性があります。
アプリで使用するために1,000 件を超えるレコードを集計する必要がある場合は、コネクタ関数を介して、最大 100,000 件のレコードをサポートする Tulip API の runAggregation エンドポイントを使用してください。
1,000 レコードを超える集計を可視化するだけでよい場合は、Analytics を使用して「単一値」分析を構築してください。これにより、テーブル内のすべてのレコードにわたって集計を行うことができます。
アプリでの集計の使用
クエリをアプリに追加するのと同様に、「+集計の追加」をクリックして集計を追加し、集計名を指定します。
この例では、「出荷されていないレコード」のみを返すクエリに対して、「注文された製品の総数量」という集計が実行されています。このため、集計名は「出荷予定製品の数量」となっています**:**

集計をアプリに埋め込むには、変数をアプリにドロップし、データソースとして「Tulip テーブル集計」を選択します。次に、アプリに集計を追加する際に設定した集計名を選択します。
この例では、集計「Sum of Product Quantity」が、出荷が必要なレコードを返すクエリに対して実行されました。これにより、合計 17 が返されます:

アプリロジックでの集計の使用
集計機能を使用すると、集計値に基づいてアプリロジックを構築することができます。以下の例をご覧ください:

なお、単一数値のTulip Analyticsは現在、アプリ内からはアクセスできず、アプリロジックで直接活用することはできません。クエリに基づいて集計を実行することで、この値をターゲットに設定し、それに基づいてアプリロジックを構築できるようになります。
