Amplitude QueryでカスタムSQLを作成する

この記事のテーマ：

• カスタムSQLを使用してSnowflakeデータベースを検索する

Amplitude Queryプロダクトアドオンを使用すると、Amplitudeが管理するSnowflakeデータベースを介して生データを検索できます。データは、30分ごとにSnowflakeに読み込まれます。Queryには、Amplitude SQLと呼ばれる新しい強力なチャートタイプも含まれています。この機能により、Amplitude Platform内でAmplitudeデータに対して直接カスタムSQLを作成することができます。

注：Queryプロダクトアドオンを購入したエンタープライズプランおよびグロースプランユーザーのみがご利用いただける機能です。

Queryを使ってみる

Amplitude SQLへは、他のチャートタイプと同様に、*[Create New]（新規作成） > [Chart]（チャート） > [All chart types]（すべてのチャートタイプ）*からアクセスできます。このチャートタイプの使用方法について詳しくは、以下のAmplitude SQLセクションを参照してください。

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

**注：**この機能は、Queryアドオンを購入したエンタープライズおよびグロースユーザーのみがご利用いただけます。

Queryスキーマの説明

テーブルの命名法

Queryパッケージは、SnowflakeとAmplitude SQL用の簡略化されたテーブルスキーマを使用します。Amplitude SQLは、特定プロジェクトの省略形$eventsを使用して参照できる単一のテーブルスキーマを使用します。他のテーブルにアクセスする場合は、Show Schema（スキーマを表示）をチェックすると表示されるフルネームを使用します。

$eventsテーブルは、統合されたユーザーのマッピングを自動的に処理しますが、統合されたユーザーテーブルのスキーマは、$eventsのスキーマの下でも利用可能になります。これは、1つに統合されたユーザー数を表示したい場合に役立ちます。

Queryの主な利点の1つは、テーブル列を無制限に作成できることです。カスタムユーザープロパティとイベントプロパティは、バリアントとして保存され、個々の列として検索できます。カスタムユーザープロパティは、接頭辞user_properties:が付きます。イベントプロパティは、すべてに接頭辞event_properties:が付きます。

注：ユーザーまたはイベントプロパティにピリオドまたはスペースが含まれている場合は、プロパティの名前を引用符で囲む必要があります（例：user_properties:"first name"）。

特定の値を検索する場合は、一重引用符でプロパティの値を囲む必要があります（例：user_properties:"plan type"='enterprise'）。

列スキーマ

$eventsテーブル

統合されたユーザーテーブル

Amplitudeによるユニークユーザーの追跡方法については、こちらの記事をご覧ください。

Amplitude SQLチャートタイプ

Amplitude SQL分析は、他のチャートと同様に、保存、共有、ダッシュボードに追加できます。このチャートタイプでは、独自のAmplitudeデータに対してカスタムSQLクエリを作成できます。

**注：**この機能は現在、Portfolio Viewsのデータのキューイングをサポートしていません。

チャート設定

デフォルトでは、日付、ユニークユーザー、過去30日間に実行された総イベント数を返すシンプルなSQLクエリが表示されます。SQL構文がハイライト表示され、SQLコマンドをクエリの他の部分と区別しやすくなっています。

さらに、Amplitude SQLは、テーブル内の列のオートコンプリートをサポートしています。入力中にクエリエディタが列を推奨するため、すばやく入力できます。

特殊フィールド

Amplitude SQLは、Amplitudeチャートエクスペリエンスに直接組み込まれているため、日付ピッカーのチャート保存など、多くの使い慣れたユーザーインターフェイスを活用できます。Amplitude SQLの特殊フィールドを強力なショートカットとして利用することで、これを行うことができます。

• **$date：**このショートカットを使用する場合、日付ピッカーによって選択された時間範囲が自動的に適用され、時間とともにクエリが更新されます。イベントのイベント時間を参照し、プロジェクトが設定されたタイムゾーンを適用します。それ以外の場合は、Amplitude SQLはUTCでデータを返します。
  • 注：**$events**と組み合わせて使用する必要があります。
• **$events：**現在のプロジェクトのテーブルを参照するために使用される省略形。このテーブルを使用する場合、統合されたユーザーは自動的に処理されます。
  • 注：**$date**と組み合わせて使用する必要があります。
• **$amplitude_id：**ユーザーの元のAmplitude ID。このフィールドを使用して、マージされたユーザーを自動的に処理します。

検索結果

検索を実行するには、*[Compute]*をクリックします。検索の実行が完了すると、下のデータテーブルに結果が表示されます。データテーブルとCSVエクスポートの結果は、1,000行までに制限されます。さらに、返されたデータを視覚化して、表の下のチャートに表示します。このときに表示できるのは、時系列のみです。

視覚化されたチャートをカスタマイズしたい場合は、クエリエディタの下のコントローラを使用できます。視覚化コントローラで調整できるオプションは、SQLのSELECT文で返すフィールドと同じです。例えば、上記のクエリでは、視覚化できる3つのフィールドは、「DATE」、「UNIQUES」、「TOTALS」です。

• **X軸列：**X軸にプロットするものを選択します。現在は、時系列のみがサポートされています。
• **指標列：**SQL SELECT文で返されるフィールドを選択すると、Y軸にプロットされます。

group-bysの適用

列でチャートをグループ化するには、[Label columns]（ラベル列）フィールドに列の名前を入力します。次に、*[Compute]*をクリックします。

クエリの共有と保存

他のAmplitudeチャートと同様に、*[More]（詳細） > [Export]（エクスポート）*に移動して、結果をPNG、PDF、またはCSVファイルとしてエクスポートできます。さらに、分析を保存してチームと共有したり、作成した視覚化資料をAmplitudeのダッシュボードに追加したりできます。

Snowflake ETL

Queryアドオンに加えて、有料ユーザーは、セルフサービスUIにアクセスして、AmplitudeデータをSnowflakeアカウントにエクスポートすることができます。この機能は、すべての有料Amplitudeプランに含まれ、すべての地域でサポートされています。この機能によって、Amplitudeエンジニアリングのサポートがなくても、データウェアハウスの所有権とプライバシーを維持し、メンテナンス、管理、カスタマイズ作業を自分で行うことができます。

Amplitudeの以前のデータ共有サービスであるSnowflake ETLは、まもなくサービスが終了になります。現在Snowflake ETLを使用している場合は、サクセスマネージャーに連絡して、セルフサービスエクスポートへの移行に関するガイダンスをお聞きください。

この表に、セルフサービスSnowflakeエクスポートの利点をまとめています。