Amplitude SQL：クエリの使用を開始する

Amplitude Queryプロダクトを使用すると、Amplitudeが管理するSnowflakeデータベースを通じて生データをクエリできます。クエリにはAmplitude SQLと呼ばれるチャートタイプも含まれています。このチャートタイプを使用すると、Amplitudeプラットフォーム内で直接Amplitudeデータに対してカスタムSQLを記述できます。

Amplitudeは30分ごとにデータをSnowflakeにロードします。

はじめに

_作成 > チャート > 追加のチャートタイプを表示_からAmplitude SQLを見つけることができます。他のチャートと同様に、保存、共有、ダッシュボードへの追加が可能です。

また、ターミナルやSQL WorkbenchやPython用Snowflakeコネクターなどのサードパーティ製アプリケーションを介してSnowflakeデータベースに直接接続することもできます。Snowflakeの資格情報については、Amplitude サポートまたは担当のサクセスマネージャーにお問い合わせください。

設定と構文

Queryパッケージは、SnowflakeとAmplitude SQL用に簡略化されたテーブルスキーマを使用しています。スキーマには単一のテーブルが含まれており、省略形の$eventsを使用して参照できます。

他のテーブルにアクセスするには、フルネームを使用してください。フルネームは、_「スキーマを表示」_の下にあります。

クエリテーブルは、データフィールドを無制限にサポートします。クエリはカスタムユーザープロパティとイベントプロパティをバリアントとして保存します。これらは個々の列としてクエリできます。カスタムユーザープロパティにはuser_properties:という接頭辞、イベントプロパティにはevent_properties:という接頭辞がそれぞれ付いています。

特定の値を検索する場合は、プロパティ値を単一引用符で囲みます：user_properties:"plan type"='enterprise'。

デフォルトでは、Amplitude SQLはユーザーが過去30日間に実行したイベントに対する単純なSQLクエリを表示します。SQL構文には次のフィールドが含まれます。

• $dateを_Date_として（イベントの発生日）。
• COUNT(DISTINCT $amplitude_id)、エイリアスは_Uniques_（ユニークユーザー数）。
• COUNT($amplitude_id)を_Totals_として（ユーザーの合計数）。

SQL構文の強調表示は、SQLコマンドを他のクエリと区別するためのものです。

Amplitude SQLは、テーブル内のカラムのオートコンプリートもサポートしています。

クエリ結果

SQLクエリの構築が完了したら、_計算_をクリックして実行します。クエリの実行が完了したら：

• クエリ結果はデータ テーブルに表示されます。
• 結果の時系列チャートが表の下に表示されます。

クエリエディタの下にあるコントロールを使用して、時系列の視覚化をカスタマイズできます。 オプションには、SQLのSELECT文で返すすべてのフィールドが含まれます。たとえば、上記のクエリでは、DATE、UNIQUES、および_TOTALS_が該当します。

• **X軸列：**X軸に使用するものを選択します。これは時系列である必要があります。
• **メトリック列：**SQLのSELECT文によって返されるフィールドを選択して、Y軸上に表示します。

グループ化基準の適用

チャートを列ごとにグループ化するには、_ラベル列_フィールドに列名を入力し、_計算_をクリックします。

クエリの共有と保存

結果をPNG、PDF、またはCSVファイルとしてエクスポートするには、_詳細 > エクスポート_に移動します。また、分析結果を保存してチームと共有したり、作成したビジュアライゼーションをAmplitudeのダッシュボードに追加したりすることもできます。

次に、Snowflakeデータをより迅速にクエリするための特別なフィールドショートカットについて説明します。