For AI agents: the complete documentation index is available at https://docs.dataplatform.ovh.net/ja/llms.txt, the full documentation bundle is available at https://docs.dataplatform.ovh.net/ja/llms-full.txt, and this page is available as Markdown at https://docs.dataplatform.ovh.net/ja/analytics-manager-queries-visual-builder.md.
  • 🇯🇵 日本語
  • ビジュアルビルダーを使用する

    ビジュアルビルダーは、オープンソースのクエリエンジンの上に構築された特定のプロプライエタリフレームワークを使用して、保存された情報をクエリするための汎用的な方法を提供します

    目的

    ビジュアルビルダーは、保存された情報をクエリするための汎用的な方法を提供します。これは、オープンソースのクエリエンジンの上に構築された特定のプロプライエタリフレームワークを使用しています。

    クエリは、Lakehouse Managerからの属性を使用して、以下の4つのフィールドを埋めることで作成されます。

    • データ:集計したい指標
    • スケール:データをグループ化したい次元
    • フィルター:クエリ結果をフィルタリングするためのもの
    • 順序:クエリ結果をソートするためのもの

    さらに、Runボタンの横にあるウィジェットを使用して、インターフェースが返す行数に制限を設定できます。この制限は、ダウンストリームプロセス(APIおよびアプリ)のクエリには保存されません。

    ビジュアル概要

    クエリの設定方法を学ぶ

    仕組み

    例えば、ビジュアル化ダッシュボードの開発を担当する人が、日付(属性:date)ごとの売上曲線(属性:income)を表示したいとします。

    仕組み — Usecase1
    1. ビジュアルビルダーインターフェースを使用して、表示するデータ(データ: income)と、このデータをグループ化するためのメトリクス(スケール: date)を指定できます。
    2. この時点で、ビルダーは自動的にクエリに最も適したテーブルを決定します - 必要なすべての属性を含む最小のテーブルです。この例では、「agr_shop_date」という、日付ごとに売上データが集計されたテーブルが選択され、クエリされます。
    Info

    ビジュアルビルダーでは、テーブルを指定する必要はありません。これにより、データの保存システムが変化する(性質、保存情報量、データウェアハウススキーマなど)に伴い、プロジェクトが時間をかけて簡単にスケールアップできます。

    1. 最後に、結果はユーザーに軽量でDBMS非依存のJSONオブジェクトとして返されます。
    仕組み — Usecase2

    フィールドデータの設定

    フィールドデータに、表示したい属性を入力します。簡単な集計関数を使用して、表示するデータを集計できます。

    フィールドデータの設定 — ビジュアルデータ1

    同じテーブルに存在する限り、属性をいくつでも追加できます。そうでない場合はエラーが返されます。インターフェースの利用可能な属性のリストは、他の利用可能な属性のみを表示するように自動的にフィルタリングされます。

    テーブルを指定する必要はありません。画面左側のウィジェットを使用して、クエリしたいテーブルと属性についてのメタデータを取得できます。

    フィールドデータの設定 — ビジュアルテーブル詳細

    集計関数

    • SELECTSELECT関数は、選択した属性の値を単に表示します。複数の値が返される場合は、リストの最初の値を選択します。
    • SUMSUM関数は、属性の値の合計を計算するために使用されます。
    • COUNTCOUNT関数は、クエリによって返される発生回数をカウントするために使用されます。
    • COUNT DISTINCTCOUNT DISTINCT関数は、属性のユニークな異なる値をカウントするために使用されます。
    • MIN & MAXMIN & MAX関数は、属性の最小値と最大値を表示するために使用されます。
    • SELECT DISTINCTSELECT DISTINCT関数は、属性のユニークな異なる値を表示するために使用されます。
    • AVGAVG関数は、属性の算術平均を計算するために使用されます。

    テーブルの選択

    ビジュアルビルダーでは、テーブルを指定する必要はありません。デフォルトでは、プラットフォームはクエリに最も適したテーブルを決定します。これは、データ、スケール、フィルター、順序フィールドのすべての属性を含む行数が最も少ないテーブルです。

    特定のテーブルでクエリを強制的に実行したい場合は、常にシステム自動選択テーブルをオーバーライドして、自分のテーブルを選択することができます。これは、データの横のテーブルアイコンをクリックして行います。

    テーブルの選択 — ビジュアル強制テーブル
    Info

    特定の属性名(例:「date」)が多くのテーブルに共通している場合、クエリ対象のテーブルを強制するのは便利です。しかし、これは良い方法ではありません。Analytics Managerは、実行時間を短縮するために最適なパスを使用してデータを取得するように設計されています。

    フィールドスケールの設定

    フィールドスケールに、データ属性(通常は指標)をグループ化したい属性(通常は次元)を入力します。

    フィールドスケールの設定 — ビジュアルスケール1
    Info

    ユースケースの例として、クエリが月ごとの収益額または店舗ごとの収益額を返す必要がある場合があります。

    同じテーブルに存在する限り、属性をいくつでも追加できます。そうでない場合はエラーが返されます。インターフェースの利用可能な属性のリストは、他の利用可能な属性のみを表示するように自動的にフィルタリングされます。

    フィールドフィルターの設定

    このパラメータは、クエリが返す値にフィルターを適用するために使用されます。

    Info

    フィルターは、null値やラベルのない値が表示されないようにするのに特に役立ちます。

    フィールドフィルターの設定 — ビジュアルフィルター1

    文字列データ型のフィルターの参照値は、文字列の周囲の_" "_なしでそのまま入力します。数値データ型のフィルターの参照値もそのまま入力します。

    Info

    画面左側のウィジェットパネル_"テーブル詳細を表示"_を使用して、フィルターとして使用する属性の種類を確認できます。

    以下は、利用可能なすべてのフィルターオプションのリストです。

    • 等しい - 値が参照と等しい。
    • 等しくない - 値が参照と等しくない。
    • In - 値が参照リストに含まれている(値をリストに追加するにはEnterを押す)。
    • Not In - 値が参照リストに含まれていない(値をリストに追加するにはEnterを押す)。
    • より大きい(>) - 値が参照より大きい。
    • より大きいまたは等しい(>=) - 値が参照値より大きいまたは等しい。
    • より小さい(<) - 値が参照値より小さい。
    • より小さいまたは等しい(<=) - 値が参照値より小さいまたは等しい。
    • - 値が2つの値の間にある。
    • 間でない - 値が2つの値の間にない。
    • Null - 値がnullである。
    • Not null - 値がnullでない。
    • Like - 値の部分文字列が参照値に含まれている(SQL LIKE構文を使用して書式設定)。
    • Not like - 値の部分文字列が別の参照値に含まれていない(SQL LIKE構文を使用して書式設定)。

    フィールド順序の設定

    このパラメータは、1つ以上のフィールドの値の順序に基づいて、クエリによって返される結果を昇順または降順で並べ替えるために使用されます。

    フィールド順序の設定 — ビジュアル順序1
    Info

    スケールフィールドの属性は、実行時間を最適化するために、デフォルトで順序フィールドに追加されません。

    レスポンス形式を確認する

    クエリをビジュアルモードで実行すると、結果は以下の形式で返されます。

    [
        {
          "scales": {
            "company": "Snapchat"
          },
          "data": {
            "sales": {
              "avg": [
                {
                  "company": "Snapchat",
                  "value": 494.96303030302937
                }
              ]
            }
          }
        },
        {
          "scales": {
            "company": "Pied Piper"
          },
          "data": {
            "sales": {
              "avg": [
                {
                  "company": "Pied Piper",
                  "value": 492.7505523255817
                }
              ]
            }
          }
        },
        {
          "scales": {
            "company": "Google"
          },
          "data": {
            "sales": {
              "avg": [
                {
                  "company": "Google",
                  "value": 501.16340892465297
                }
              ]
            }
          }
        },
        {
          "scales": {
            "company": "Facebook"
          },
          "data": {
            "sales": {
              "avg": [
                {
                  "company": "Facebook",
                  "value": 512.5209205642168
                }
              ]
            }
          }
        }
    ]

    クエリを実行した際にAnalytics Managerから送信される生のレスポンスを確認するには、結果をテーブルとして表示します。その後、歯車アイコンをクリックし、生のレスポンスを表示を有効にします。

    レスポンス形式を確認する — ビジュアル生レスポンス

    最後に、クエリ結果をさまざまな形式(.csvなど、タブ区切り値をコピーするなど)でエクスポートすることができます。これは、ダウンロードボタンを実行ボタンの横にクリックすることで行います。

    レスポンス形式を確認する — エクスポート

    さらに詳しく

    当社のソリューションを実装するためのトレーニングや技術サポートが必要な場合は、営業担当者にお問い合わせください、またはこのリンクをクリックして見積もりを依頼し、当社のプロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。

    Data Platformを構築するチームと直接質問したり、フィードバックを送信したり、交流したりするには、専用のDiscordチャネルにアクセスしてください。

    OVHcloudサービスについてサポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

    ユーザーコミュニティに参加してください。