クエリビルダーでのクエリの作成

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

前提条件

クエリビルダーを使用するには、ワークスペースレベルで次の権限が必要です。

クエリビルダーの使用

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

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

クエリ作成のヒントやサポートが必要な場合は、クエリテンプレートを選択し、作成済みのテンプレートを選択します。空のクエリから始めるには、SQLエディターを選択します。

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

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

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

• operatorを使用
• 自分で作成

注

この機能は現在、Brazeの統合AIアシスタントであるBrazeAI Operator™の一部です。以前はスタンドアロンのアシスタントとして利用可能だったAI機能は、現在すべてダッシュボードの作業場所からオペレーターを通じてアクセスできます。

クエリビルダーのサイドパネルでOperatorに質問を選択し、必要なデータを説明します。Operatorは利用可能なSnowflakeデータテーブルに対してSQLを作成します。レポートを実行する前に、SQLを確認して結果をプレビューできます。クエリビルダーでOperatorを使用するには、「ダッシュボードレポートを編集」権限が必要です。

生成されたSQLは、自分で作成するクエリと同じSQL作成ルールに従う必要があります。詳細については、Operatorでできることを参照してください。Operatorによるデータの取り扱いについては、Operatorのデータプライバシーとセキュリティを参照してください。

Snowflake構文を使用してSQLクエリを作成します。クエリで利用可能なテーブルと列の一覧については、テーブルリファレンスを参照してください。

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

1. クエリビルダーページでリファレンスパネルを開き、利用可能なデータテーブルを選択して、利用可能なデータテーブルとその名前を表示します。
2. 詳細を表示を選択すると、テーブルの説明や、データ型などのテーブル列に関する情報が表示されます。
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か月のメール送信数を取得します。

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_VARIATION_API_ID	キャンバスバリアント名
CAMPAIGN_ID	キャンペーン名

このクエリは、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:レポートを生成する

クエリの作成が完了したら、クエリを実行を選択します。エラーやレポートのタイムアウトがなければ、クエリからCSVファイルが生成されます。

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

重要

各レポートで結果を生成できるのは1日1回のみです。同じ暦日に同じレポートを複数回実行すると、各レポートに同じ結果が表示されます。

レポートのタイムアウト

実行に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クレジットの一部が使用されます。

注

Snowflakeクレジットは機能間で共有されません。たとえば、SQLセグメントエクステンションとクエリビルダーのクレジットは互いに独立しています。

クレジットの使用量は、SQLクエリの実行時間に関連しています。実行時間が長いほど、クエリで消費されるSnowflakeクレジットの割合が高くなります。実行時間は、クエリの複雑さやサイズによって時間とともに変化することがあります。複雑なクエリを頻繁に実行するほど、リソースの割り当てが大きくなり、実行時間が短くなります。

Braze SQLエディター内でレポートを作成、編集、または保存する際には、クレジットは使用されません。クレジットは毎月1日の午前0時 (UTC) に5にリセットされます。月間のクレジット使用量は、クエリビルダーページの上部で確認できます。

クレジットキャップに達すると、クエリを実行できなくなりますが、SQLレポートの作成、編集、保存は引き続き可能です。クエリビルダーのクレジットを追加購入したい場合は、アカウントマネージャーにお問い合わせください。