接続の確立
JDBC データソースの作成
Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for IBM Cloud Object Storage に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。
- ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの[lib]サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
- ドライバークラスを入力します。次に例を示します。
cdata.jdbc.ibmcloudobjectstorage.IBMCloudObjectStorageDriver
- JDBC URL を入力します。次に例を示します。
jdbc:ibmcloudobjectstorage:ApiKey=myApiKey;CloudObjectStorageCRN=MyInstanceCRN;Region=myRegion;OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret; or jdbc:cdata:ibmcloudobjectstorage:ApiKey=myApiKey;CloudObjectStorageCRN=MyInstanceCRN;Region=myRegion;OAuthClientId=MyOAuthClientId;OAuthClientSecret=myOAuthClientSecret;
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:ibmcloudobjectstorage:" または"jdbc:cdata:ibmcloudobjectstorage:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
接続の前に
IBM Cloud Object Storage に接続する前に、IBM Cloud Object Storage インスタンスを登録し、IBM Cloud Object Storage API キーとCRN を控えておく必要があります。
Cloud Object Storage の新規インスタンスの登録
IBM Cloud アカウントにCloud Object Storage がまだない場合は、以下の手順に従ってアカウントにSQL Query のインスタンスをインストールできます。
- IBM Cloud アカウントにログインします。
- Cloud Object Storage ページに移動し、インスタンス名を指定して[作成]をクリックします。作成したばかりのCloud Object Storage のインスタンスにリダイレクトされます。
API キー
ApiKey は次のようにして取得できます。
- IBM Cloud アカウントにログインします。
- Platform API Keys ページに移動します。
- 中央右隅のCreate an IBM Cloud API Key をクリックして、新しいAPI キーを作成します。
- ポップアップウィンドウが表示されたら、API キー名を指定して作成をクリックします。ダッシュボードからは再びアクセスできなくなるため、API Key を控えておきます。
Cloud Object Storage CRN
デフォルトでは、本製品 はCloud Object Storage CRN を自動的に決定しようとします。ただし、複数のアカウントがある場合は、CloudObjectStorageCRN を明示的に指定する必要があります。この値は、次の2つの方法で取得できます。
- Services ビューをクエリする。これにより、IBM Cloud Object Storage インスタンスとそれぞれのCRN がリストされます。
- IBM Cloud で直接CRN を見つける。これを行うには、IBM Cloud Dashboard に移動します。リソースリストで、ストレージからCloud Object Storage リソースを選択してCRN を取得します。
IBM Cloud Object Storage への接続
これで、データに接続するために以下を設定できます。
- InitiateOAuth:GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 交換の繰り返しや、手動でのOAuthAccessToken 設定を避けられます。
- ApiKey:セットアップ中にメモしたAPI キーに設定。
- CloudObjectStorageCRN(オプション):メモしたクラウドオブジェクトストレージのCRN に設定。本製品 はこれを自動的に取得しようとしますが、Cloud Object Storage アカウントが複数ある場合は、これを明示的に指定することをお勧めします。
接続すると、本製品 がOAuth プロセスを完了します。
- アクセストークンを取得し、リクエストを認証します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。