DataGrip で Spotify のデータ をクエリ

DataGrip は、SQL 開発者がデータベースへのクエリ、作成、管理を行えるデータベース IDE です。CData API Driver for JDBC と組み合わせることで、DataGrip からリアルタイムSpotify のデータを操作できます。この記事では、DataGrip で Spotify のデータ への接続を確立方法を説明します。

Spotify 用の新しいドライバー定義を作成

以下のステップでは、DataGrip で Spotify 用の新しいデータソースを作成する方法を説明します。

1. DataGrip で、File -> New -> Project をクリックしてプロジェクト名を入力します。
2. Database Explorer で、プラスアイコン（）をクリックして Driver を選択します。
3. Driver タブで以下を設定します。
   • Name をわかりやすい名前に設定します（例："CData Spotify Driver"）。
   • Driver Files を適切な JAR ファイルに設定します。ファイルを追加するには、プラス（）をクリックし、「Add Files」を選択して、ドライバーのインストールディレクトリ内の「lib」フォルダに移動し、JAR ファイル（例：cdata.jdbc.api.jar）を選択します。
   • Class を cdata.jdbc.api.API.jar に設定します。
   また、詳細タブでは、ドライバーのプロパティや、VM Options、VM environment、VM home path、DBMS などの設定を変更できます。
   • ほとんどの場合、Expert options で DBMS type を「Unknown」に変更して、ネイティブの SQL Server クエリ（Transact-SQL）を回避してください。これを行わないと、無効な関数エラーが発生する可能性があります。
4. 「Apply」をクリックし、「OK」をクリックして接続を保存します。

Spotify への接続を設定

1. 接続を保存したら、プラス（）をクリックし、「Data Source」→「CData Spotify Driver」を選択して、新しい Spotify データソースを作成します。
2. 新しいウィンドウで、JDBC URL を使用して Spotify への接続を設定します。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Spotify JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

         java -jar cdata.jdbc.api.jar
       

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   OAuth 認証の設定

   Spotify は認証に OAuth 2.0 を使用します。クライアント認証情報を取得するには、Spotify Developer Dashboard でアプリケーションを作成する必要があります。

   Spotify アプリケーションのセットアップ

   1. Spotify Developer Dashboard にアクセスします。
   2. Spotify アカウントでログインして Create app をクリックします。
   3. アプリ名、説明を入力し、Redirect URI を設定します（デスクトップアプリケーションの場合は

      http://localhost:33333

      など）。
   4. アプリ設定から Client ID と Client Secret をコピーします。

   接続プロパティ

   以下の接続プロパティを設定して接続を確立してください：

   • AuthScheme：OAuth に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
   • OAuthClientId：Spotify アプリケーションの Client ID に設定します。
   • OAuthClientSecret：Spotify アプリケーションの Client Secret に設定します。
   • Scope：必要な OAuth スコープ（スペース区切り）に設定します。デフォルトには、このプロファイルのテーブルに必要なすべての読み取りスコープが含まれます。
   • CallbackURL：Spotify アプリケーションで設定したリダイレクト URI に設定します（例：http://localhost:33333）。

   接続文字列の例

   Profile=C:\profiles\Spotify.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackURL=http://localhost:33333;
   

   利用可能な OAuth スコープ

   • user-read-private：ユーザーのサブスクリプション詳細と露骨なコンテンツ設定への読み取りアクセス。
   • user-read-email：ユーザーのメールアドレスへの読み取りアクセス。
   • user-library-read：ユーザーが保存したトラック、アルバム、エピソード、ショー、オーディオブックへの読み取りアクセス。
   • playlist-read-private：ユーザーの非公開プレイリストへの読み取りアクセス。
   • playlist-read-collaborative：ユーザーがフォローしているコラボレーティブプレイリストへの読み取りアクセス。
   • user-follow-read：現在のユーザーがフォローしているアーティストの一覧への読み取りアクセス。
   • user-read-playback-state：ユーザーのプレーヤー状態（デバイス、現在のトラック、再生位置）への読み取りアクセス。
   • user-read-currently-playing：ユーザーが現在再生中のコンテンツへの読み取りアクセス。
   • user-read-playback-history：ユーザーが最近再生したトラックへの読み取りアクセス。
   • user-top-read：ユーザーのトップアーティストとトラックへの読み取りアクセス。
   
3. URL を接続文字列に設定します。例：

   jdbc:api:Profile=C:\profiles\Spotify.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackURL=http://localhost:33333;

4. 「Apply」と「OK」をクリックして接続文字列を保存します。

これで、Data Explorer にデータソースが表示されます。

Spotify に対して SQL クエリを実行

JDBC Driver を介してアクセス可能な Spotify のエンティティ（テーブルとして利用可能）を参照するには、データソースを展開します。

クエリを実行するには、任意のテーブルを右クリックして「New」→「Query Console」を選択します。

Console で、実行したい SQL クエリを記述します。例：

SELECT ,  FROM Albums WHERE Id = '4aawyAB9vmqN3uQ7FjRGTy'

CData API Driver for JDBC の30日間の無料トライアルをダウンロードして、DataGrip でリアルタイムSpotify のデータを操作してみてください。ご不明な点があれば、サポートチームにお問い合わせください。