製品をチェック

IBM Cloud Object Storage Driver の30日間無償トライアルをダウンロード

 ダウンロードはこちら

製品の詳細

IBM Cloud Object Storage アイコン IBM Cloud Object Storage JDBC Driver 相談したい

IBM Cloud Object Storage データに連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

JReport Designer でIBM Cloud Object Storage データを連携

JReport Designer でIBM Cloud Object Storage に連携するチャートとレポートを作成します。

加藤龍彦
ウェブデベロッパー

最終更新日:2022-10-10
ibmcloudobjectstorage ロゴ

CData

jdbc ロゴ画像
JReport Designer ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for IBMCloudObjectStorage を使用すると、IBM Cloud Object Storage がリレーショナルデータベースであるかのようにダッシュボードやレポートからリアルタイムデータにアクセスでき、使い慣れたSQL クエリを使用してIBM Cloud Object Storage] をクエリできます。ここでは、JDBC データソースとしてIBM Cloud Object Storage に連携し、JReport Designer でIBM Cloud Object Storage のレポートを作成する方法を説明します。

IBM Cloud Object Storage データに接続

  1. C:\JReport\Designer\bin\setenv.bat を編集し、JAR ファイルの場所をADDCLASSPATH 変数に追加します。
    ...
    set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for IBMCloudObjectStorage 2016\lib\cdata.jdbc.ibmcloudobjectstorage.jar;
    ...
    
  2. [File][New][Data Source]と進み、新しいデータソースを作成します。
  3. 表示されるダイアログで、データソースの名前(CData JDBC Driver for IBMCloudObjectStorage) を作成し、JDBC を選択して[OK]をクリックします。
  4. [JDBC Connection Information]ダイアログで、JDBC ドライバーへの接続を構成します。
    • Driver:[Driver]ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。 cdata.jdbc.ibmcloudobjectstorage.IBMCloudObjectStorageDriver
    • URL:jdbc:ibmcloudobjectstorage: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。

      Cloud Object Storage 接続プロパティの取得・設定方法

      Cloud Object Storage に接続する前に、Cloud Object Storage インスタンスを登録してCloud Object Storage API キーとCRN を取得していきます。

      Cloud Object Storage の新規インスタンスの登録

      IBM Cloud アカウントにCloud Object Storage がまだない場合は、以下の手順に従ってアカウントにSQL Query のインスタンスをインストールできます。

      1. IBM Cloud アカウントにログインします。
      2. Cloud Object Storage ページに移動して、インスタンス名を指定して「作成」をクリックします。Cloud Object Storage の新規インスタンスにリダイレクトされます。

      API キー

      API キーは以下の手順で取得できます。

      1. まずは、IBM Cloud アカウントにログインします。
      2. API キーページに移動します。
      3. 中央右隅のIBM Cloud APIキーの作成 をクリックして、新しいAPI キーを作成します。
      4. ポップアップウィンドウが表示されたら、API キーの名前を指定して作成をクリックします。ダッシュボードからはアクセスできなくなるため、API Key を控えておきましょう。

      Cloud Object Storage CRN

      デフォルトでは、CData 製品はCloud Object Storage CRN を自動で取得します。ただし、複数のアカウントがある場合は、CloudObjectStorageCRN を明示的に指定する必要があります。この値は、次の2つの方法で取得できます。

      • Services ビューをクエリする。これにより、IBM Cloud Object Storage インスタンスとそれぞれのCRN がリストされます。
      • IBM Cloud で直接CRN を見つける。これを行うには、IBM Cloud のダッシュボードに移動します。リソースリストで、ストレージからCloud Object Storage リソースを選択してCRN を取得します。

      IBM Cloud Object Storage への接続

      これで準備は完了です。以下の接続プロパティを設定してください。

      • InitiateOAuthGETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 認証を繰り返す必要がなく、さらに自動でアクセストークンを設定できます。
      • ApiKey:セットアップ中に控えたAPI キーを指定。
      • CloudObjectStorageCRN(オプション):控えておいたCloud Object Storage のCRN に設定。Cloud Object Storage アカウントが複数ある場合のみ設定する必要があります。

      プロパティを設定したら、これで接続設定は完了です。

      ビルトイン接続文字列デザイナー

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

      java -jar cdata.jdbc.ibmcloudobjectstorage.jar

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

      Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

      JDBC URL を構成する際、Max Rows 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

      以下は一般的なJDBC URLです。

      jdbc:ibmcloudobjectstorage:ApiKey=myApiKey;CloudObjectStorageCRN=MyInstanceCRN;Region=myRegion;OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;
    • User:認証に使用するユーザー名は、通常空白のままにします。
    • Password:User と同様に認証に使用するパスワードも、通常は空白のままにします。
    Configuring the connection to the JDBC Driver (Salesforce is shown.)
  5. [Add Table]ダイアログで、レポート(またはこのデータソースを使用する予定のレポート)に含めるテーブルを選択し、[Add]をクリックします。

    Adding Tables.(Salesforce is shown.)

    ダイアログがテーブルのロードを完了したら、[Done]をクリックします。

  6. [Catalog Browser]では、レポートの作成に使用するクエリを作成できます。今すぐ、またはレポートの作成後に作成できますが、どちらにしても、 データソース(CData JDBC Driver for IBM Cloud Object Storage) を展開()し、[Queries]を右クリックして[Add Query]を選択します。 Adding a query for data to be used in the report.(Salesforce is shown.)
  7. [Add Table/View/Query]ダイアログで、JDBC URL とTables を展開() し、クエリで使用するテーブルを選択して[OK]をクリックします。 Selecting a table for the query.(Salesforce is shown.)
  8. [Query Editor]ダイアログで、含めるカラムを選択するか、[SQL]ボタンをクリックして以下のようにカスタムクエリを手動で入力できます。
    SELECT Key, Etag FROM Objects WHERE Bucket = 'someBucket'
    
    Editing the query.(Salesforce is shown.)

    クエリが作成されたら、[OK]をクリックして[Query Editor]ダイアログを閉じます。この時点で、IBM Cloud Object Storage を新規または既存のレポートに追加する準備が整いました。

    NOTE: クエリが作成されると、クエリに基づいて[Business View]を作成できます。[Business View]を使用すると、クエリに基づいてWeb レポートまたはライブラリコンポーネントを作成できます。これについてのより詳しい情報は、JReport のチュートリアルを参照してください。

レポートにIBM Cloud Object Storage データを追加

IBM Cloud Object Storage を使用してレポートを作成することができるようになりました。

  1. 新しいレポートを作成([File][New][Page Report]) するか、既存のレポートの[Chart Wizard]を開きます。
  2. クエリを選択(または上記を参照して新しいクエリを作成) します。
  3. Selecting the query to use.(Salesforce is shown.)
  4. クエリのカラムからグラフの[Category]と[Value]を割り当て、[Finish]をクリックします。
  5. Assigning columns to define the chart.(Salesforce is shown.)
  6. レポートの[View]タブをクリックし、チャートを表示します。
Sample chart based on live data.(Salesforce is shown.)

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。