DataGrip で Snapchat Ads のデータ をクエリ
DataGrip は、SQL 開発者がデータベースへのクエリ、作成、管理を行えるデータベース IDE です。CData JDBC Driver for Snapchat Ads と組み合わせることで、DataGrip からリアルタイムSnapchat Ads のデータを操作できます。この記事では、DataGrip で Snapchat Ads のデータ への接続を確立し、テーブルエディタを使用して Snapchat Ads のデータ を読み込む方法を説明します。
Snapchat Ads 用の新しいドライバー定義を作成
以下のステップでは、DataGrip で Snapchat Ads 用の新しいデータソースを作成する方法を説明します。
- DataGrip で、File -> New -> Project をクリックしてプロジェクト名を入力します。
- Database Explorer で、プラスアイコン()をクリックして Driver を選択します。
- Driver タブで以下を設定します。
- Name をわかりやすい名前に設定します(例:"CData Snapchat Ads Driver")。
- Driver Files を適切な JAR ファイルに設定します。ファイルを追加するには、プラス()をクリックし、「Add Files」を選択して、ドライバーのインストールディレクトリ内の「lib」フォルダに移動し、JAR ファイル(例:cdata.jdbc.snapchatads.jar)を選択します。
- Class を cdata.jdbc.snapchatads.SnapchatAds.jar に設定します。
また、詳細タブでは、ドライバーのプロパティや、VM Options、VM environment、VM home path、DBMS などの設定を変更できます。 - ほとんどの場合、Expert options で DBMS type を「Unknown」に変更して、ネイティブの SQL Server クエリ(Transact-SQL)を回避してください。これを行わないと、無効な関数エラーが発生する可能性があります。
- 「Apply」をクリックし、「OK」をクリックして接続を保存します。
Snapchat Ads への接続を設定
- 接続を保存したら、プラス()をクリックし、「Data Source」→「CData Snapchat Ads Driver」を選択して、新しい Snapchat Ads データソースを作成します。
- 新しいウィンドウで、JDBC URL を使用して Snapchat Ads への接続を設定します。
組み込みの接続文字列デザイナー
JDBC URL の構築には、Snapchat Ads JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
java -jar cdata.jdbc.snapchatads.jar接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Snapchat Ads 接続プロパティの取得・設定方法
Snapchat Ads はOAuth 認証のみサポートします。この認証を有効にするには、すべてのOAuth フローでAuthScheme をOAuth に設定し、カスタムOAuth アプリケーションを作成する必要があります。
定型のクエリを簡略化するために、AccountId にデフォルトのAccountId を指定するように設定することもできます。 これにより、WHERE 句の一部として手動で指定する必要がなくなります。(AccountId が指定されず、WHERE 句にアカウントID が明示的に与えられない場合、CData 製品はAccounts ビューに返されるリストから最初のアカウントを取得しようとします。)
ヘルプドキュメントでは、以下の3つの一般的な認証フローでのSnapchat Ads への認証について詳しく説明しています。
- デスクトップ:ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。
- Web:共有ウェブサイト経由でデータにアクセスします。
- ヘッドレスサーバー:他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。
カスタムOAuth アプリケーションの作成については、ヘルプドキュメント の「カスタムOAuth アプリケーションの作成」セクションを参照してください。
- URL を接続文字列に設定します。例:
jdbc:snapchatads:
- 「Apply」と「OK」をクリックして接続文字列を保存します。
これで、Data Explorer にデータソースが表示されます。
Snapchat Ads に対して SQL クエリを実行
JDBC Driver を介してアクセス可能な Snapchat Ads のエンティティ(テーブルとして利用可能)を参照するには、データソースを展開します。
クエリを実行するには、任意のテーブルを右クリックして「New」→「Query Console」を選択します。
Console で、実行したい SQL クエリを記述します。例:
SELECT AccountId, Name FROM Campaigns WHERE Id = '123'
CData JDBC Driver for Snapchat Ads の30日間の無料トライアルをダウンロードして、DataGrip でリアルタイムSnapchat Ads のデータを操作してみてください。ご不明な点があれば、サポートチームにお問い合わせください。