Skip to content

クエリビルダー

クエリビルダーの使用方法について説明します。Snowflakeで Braze データを使用してレポートを生成できます。クエリビルダーには、すぐに使える SQL クエリテンプレートが付属しているので、すぐに始めることができます。また、独自のカスタム SQL クエリを作成して、より多くのインサイトを得ることもできます。

前提条件

クエリビルダーを使用するには、「View PII」権限が必要です。これにより、一部の顧客データに直接アクセスできるようになります。

クエリビルダーの使用

ステップ 1: SQL クエリの作成

新しいクエリを作成するには、分析 > クエリビルダーに移動し、Create SQL Query を選択します。

「Create SQL Query」ドロップダウン内にある「Query Template」および「SQL Editor」オプション。

インスピレーションが必要な場合やクエリの作成にヘルプが必要な場合は、Query Template を選択し、事前作成テンプレートを選択します。空のクエリで開始するには、SQL Editor を選択します。

レポートには、現在の日時からなる名前が自動的に付けられます。名前の上にカーソルを合わせ、を選択して、SQL クエリにわかりやすい名前を付けます。

レポート名の例「Channel engagement for May 2025」。

ステップ 2: クエリを作成する

クエリを作成する際に、AI のサポートを受けるか、自分で作成するかを選択できます。

AI クエリビルダーは OpenAI を搭載した GPT を活用して、クエリのSQLを提案します。AI クエリビルダーでSQLを生成するには、次の手順に従います。

  1. クエリビルダーでレポートを作成したら、AI Query Builder タブを選択します。
  2. プロンプトを入力するか、サンプルプロンプトを選択し、生成を選択してプロンプトをSQLに変換します。
  3. 生成されたSQLが正しいかどうかを確認し、Insert into Editor を選択します。

SQL AI クエリビルダー。

ヒント

  • 利用可能な Snowflake データテーブルをよく理解してください。これらのテーブルに存在しないデータを要求すると、ChatGPTが架空のテーブルを作成する可能性があります。
  • この機能の SQL 記述ルールをよく理解してください。このルールに従わないと、エラーが発生します。
  • AI クエリビルダーでは、1分あたり最大20個のプロンプトを送信できます。

私のデータはどのように使用され、OpenAIに送られますか？

OpenAIを活用するBrazeAI機能を通じてAI出力（以下「出力」）を生成するために、Brazeは特定の情報（以下「入力」）をOpenAIに送信します。入力はお客様のプロンプトで構成され、該当する場合にはダッシュボードに表示されるコンテンツやお客様のクエリに関連するその他のワークスペースデータが含まれることがあります。OpenAIのAPIプラットフォームのコミットメントに基づき、Braze経由でOpenAIのAPIに送信されたデータは、OpenAIモデルのトレーニングや改善には使用されません。OpenAIは不正利用の監視を目的として最大30日間データを保持し、その後削除します。お客様とBrazeの間において、出力はお客様の知的財産です。Brazeは、かかる出力に対する著作権の所有権を主張しません。Brazeは、出力を含め、AIが生成したコンテンツに関していかなる種類の保証も行いません。

Snowflake 構文を使用してSQLクエリを記述します。クエリ可能なテーブルとカラムの全リストについては、テーブルリファレンスを参照してください。

クエリビルダー内でテーブルの詳細を表示するには、次の手順に従います。

  1. クエリビルダーページから参照パネルを開き、Available Data Tables を選択すると、利用できるデータテーブルとその名前が表示されます。
  2. See Details を選択して、テーブルの説明やデータタイプなどのテーブル列に関する情報を表示します。
  3. テーブル名をSQLに挿入するには、を選択します。

クエリを特定期間に限定すると、結果をより迅速に生成できます。以下に、過去1時間の購入数と収益を取得するクエリの例を示します。

1
2
3

SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

次のクエリは、先月のメール送信数を取得します。

1
2
3

SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

CANVAS_ID、CANVAS_VARIATION_API_ID、CAMPAIGN_IDに対するクエリを実行すると、それらに関連付けられている名前列が自動的に結果テーブルに含まれます。SELECTクエリ自体にこれらを含める必要はありません。

ID名 関連する名前列
CANVAS_ID Canvas名
CANVAS_VARIATION_API_ID Canvasバリアント名
CAMPAIGN_ID Campaign名

このクエリは、3つのすべてのIDと、それらに関連付けられている名前の列を取得します。行数の上限は100行です。

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

トラブルシューティング

クエリは次のいずれかの理由で失敗する可能性があります。

  • SQLクエリの構文エラー
  • 処理タイムアウト（6分後）
    • レポートの実行が6分を超えると、タイムアウトします。
    • レポートがタイムアウトした場合は、クエリするデータの時間範囲を限定するか、より具体的なデータセットをクエリしてみてください。

ステップ 3: レポートの生成

クエリの構築が完了したら、Run Query を選択します。エラーやレポートタイムアウトがない場合、クエリからCSVファイルが生成されます。

CSVレポートをダウンロードするには、エクスポートを選択します。

テンプレートクエリ「Channel engagement and revenue for the last 30 days」の結果を表示するクエリビルダー。

レポートのタイムアウト

実行に6分以上かかるレポートはタイムアウトになります。これがしばらくぶりに実行する最初のクエリである場合、処理に時間がかかるため、タイムアウトする可能性が高くなります。タイムアウトした場合は、レポートをもう一度実行してみてください。

複数回試行してもレポートのタイムアウトが続く場合は、サポートにお問い合わせください。

中止理由のクエリ

任意の USERS_MESSAGES_*_ABORT_SHARED テーブルの ABORT_TYPE 列をクエリして、メッセージが送信されなかった理由を分析できます。ABORT_TYPE フィールドには中止の具体的な理由を示す文字列値が含まれ、関連する ABORT_LOG フィールドには追加の詳細（トリガーされたフリークエンシーキャップルールなど）が含まれます。

たとえば、過去30日間のメール中止をタイプ別にカウントするには、次のようにします。

1
2
3
4
5

SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

ABORT_TYPE の値とその説明の全リストについては、中止タイプを参照してください。

データと結果

すべてのクエリは過去60日間のデータを表示します。結果をエクスポートすると、最大1,000行のみが含まれます。大量のデータを必要とするレポートの場合は、CurrentsやエクスポートAPIエンドポイントなどのツールを使用できます。

Snowflakeクレジット

各会社は、すべてのワークスペースで共有される月5つのSnowflakeクレジットを使用できます。Snowflakeクレジットのごく一部が、クエリを実行したりテーブルをプレビューしたりするたびに使用されます。

クレジット使用量はSQLクエリの実行時間と相関しています。実行時間が長いほど、クエリで消費されるSnowflakeクレジットの量が多くなります。実行時間は、時間の経過に伴うクエリの複雑さとサイズによって異なります。実行するクエリが複雑で頻繁になるほど、リソースの割り当てが大きくなり、実行時間が短縮されます。

BrazeのSQLエディターでレポートの作成、編集、保存を行う場合、クレジットは使用されません。クレジットは、毎月1日午前12時（UTC）にリセットされ5に戻ります。クエリビルダーページの上部で、月次クレジット使用量を監視できます。

今月のクレジット使用量を表示するクエリビルダー。

クレジット上限に達すると、クエリの実行はできませんが、SQLレポートの作成、編集、および保存はできます。クエリビルダーのクレジットをさらに購入する場合は、アカウントマネージャーにお問い合わせください。
New Stuff!