PowerBuilder からIBM Cloud Object Storage のデータに連携

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

CData JDBC Driver for IBMCloudObjectStorage は、標準ベースのコントロールであり、PowerBuilder を含むJDBC をサポートするプラットフォームまたは開発テクノロジーから使用できます。 また、PowerBuilder でCData JDBC Driver for IBMCloudObjectStorage を使用する方法についても詳しく説明します。

この記事では、CData JDBC Driver for IBMCloudObjectStorage を使用してデータを取得し、基本的なPowerBuilder アプリケーションを作成する方法を説明します。

PowerBuilder からIBM Cloud Object Storage のデータに接続

以下のステップに従ってDatabase Painter ツールを使用し、JDBC URL for IBMCloudObjectStorage に基づいてデータベースプロファイルを作成します。データベースプロファイルを使用して、接続プロパティを保存できます。Ⅾatabase Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。

1. ドライバーJAR をPowerBuilder クラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリのlib サブフォルダにあるドライバーJAR へのパスに設定します。

   NotePowerBuilder Classic を使用している場合は、［Tools］->［System Options］->［Java］をクリックし、ドライバーJAR へのパスを追加することもできます。

2. ［Tools］->［Database Painter］と進みます。
3. JDBC のノードを右クリックし、［New Profile］をクリックします。
4. ［Database Profile Setup］ダイアログで、以下を入力します。
   • Profile Name:プロファイルのわかりやすい名前を入力します。
   • Driver Name:ドライバーのクラス名にcdata.jdbc.ibmcloudobjectstorage.IBMCloudObjectStorageDriver を入力します。
   • URL: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 への接続

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

     • InitiateOAuth：GETANDREFRESH に設定。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

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。以下は一般的なJDBC URL です。

     jdbc:ibmcloudobjectstorage:ApiKey=myApiKey;CloudObjectStorageCRN=MyInstanceCRN;Region=myRegion;OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;
5. テーブルを表示および編集するには、テーブルを右クリックして［Edit Data］->［Grid］をクリックします。

IBM Cloud Object Storage をPowerBuilder Controls と共に使用する

標準のPowerBuilder オブジェクトを使用してJDBC データソースに接続し、クエリを実行できます。以下の例は、IBM Cloud Object Storage をDataWindowに取得する方法を示しています。次のコードをopen メソッドに追加できます。