接続の前に

IBM Cloud Object Storage に接続する前に、IBM Cloud Object Storage インスタンスを登録し、IBM 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 キー

ApiKey は次のようにして取得できます。

1. IBM Cloud アカウントにログインします。
2. Platform API Keys ページに移動します。
3. 中央右隅のCreate an IBM Cloud API Key をクリックして、新しいAPI キーを作成します。
4. ポップアップウィンドウが表示されたら、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 プロセスを完了します。

1. アクセストークンを取得し、リクエストを認証します。
2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。