Spotify JDBC Driver を使用した OBIEE でのレポート作成

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Spotify JDBC Driver を OBIEE にデプロイして、エンタープライズ全体でリアルタイムレポートを実現します。

CData JDBC Driver for Spotify は、標準的なデータベースドライバーとして、Java ベースのレポーティングサーバーにSpotify のデータへのリアルタイムアクセスを統合できます。この記事では、Oracle Business Intelligence Enterprise Edition（OBIEE）にドライバーをデプロイし、変更がリアルタイムに反映されるSpotify のデータのレポートを作成する方法を説明します。

JDBC Driver のデプロイ

以下の手順で、JDBC Driver を WebLogic のクラスパスに追加します。

WebLogic 12.2.1 の場合、ドライバーの JAR ファイルと .lic ファイルを DOMAIN_HOME\lib に配置するだけで完了です（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）。これらのファイルは起動時にサーバーのクラスパスに追加されます。

手動でクラスパスにドライバーを追加することもできます（以前のバージョンでは必須）。setDomainEnv.cmd（Windows）または setDomainEnv.sh（Unix）の PRE_CLASSPATH の先頭に以下を追加します。このスクリプトは、そのドメインのフォルダ内の bin サブフォルダにあります（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\bin）。 

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.api.jar;%PRE_CLASSPATH%

すべてのサーバーを再起動します（例：DOMAIN_HOME\bitools\bin の stop コマンドと start コマンドを実行）。

Spotify 用 JDBC データソースの作成

JDBC Driver をデプロイしたら、BI Publisher から JDBC データソースを作成できます。

  1. BI Publisher にログインします（URL は例えば http://localhost:9502/analytics）。Administration -> Manage BI Publisher をクリックします。
  2. JDBC Connection -> Add Data Source をクリックします。
  3. 以下の情報を入力します：
    • Data Source Name：ユーザーがレポートで接続を作成する際に使用する名前を入力します。
    • Driver Type：Other を選択します。
    • Database DriverClass：ドライバークラス cdata.jdbc.api.APIDriver を入力します。
    • Connection String：JDBC URL を入力します。

      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：ユーザーのトップアーティストとトラックへの読み取りアクセス。

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

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

      java -jar cdata.jdbc.api.jar

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

      JDBC URL を構成する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に特に役立ちます。

      一般的な JDBC URL は以下のとおりです：

      jdbc:api:Profile=C:\profiles\Spotify.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackURL=http://localhost:33333;
    • Username：ユーザー名を入力します。
    • Password：パスワードを入力します。
  4. Security セクションで、許可するユーザーロールを選択します。

リアルタイム Spotify レポートの作成

これで、リアルタイムSpotify のデータに基づいたレポートや分析を作成できます。以下の手順で、標準のレポートウィザードを使用して、Spotify のデータの変更がリアルタイムに反映されるインタラクティブなレポートを作成します。

  1. グローバルヘッダーで、New -> Data Model をクリックします。
  2. Diagram タブで、メニューから SQL query を選択します。
  3. クエリの名前を入力し、Data Source メニューで作成した Spotify JDBC データソースを選択します。
  4. standard SQL を選択し、以下のようなクエリを入力します： 
    SELECT ,  FROM Albums WHERE Id = '4aawyAB9vmqN3uQ7FjRGTy'
  5. View Data をクリックして、レポート作成に使用するサンプルデータを生成します。
  6. サンプルデータに含める行数を選択し、View をクリックしてから、Save As Sample Data をクリックします。
  7. Create Report -> Use Data Model をクリックします。
  8. Guide Me を選択し、Select Layout ページで含めるレポートオブジェクトを選択します。この例では Chart と Table を選択します。
  9. のような数値カラムを Y 軸の Drop Value Here ボックスにドロップします。 のようなディメンションカラムを X 軸の Drop Label Here ボックスにドロップします。
  10. Refresh をクリックすると、Spotify のデータの変更が反映されます。

はじめる準備はできましたか？

API Driver で Spotify のライブデータに接続

Spotify に接続

この記事の内容

関連記事