RazorSQL で Salesforce Data Cloud のデータに接続

Jerod Johnson
Senior Technology Evangelist

RazorSQL データベース管理ツールのウィザードを使用して Salesforce Data Cloud に接続し、GUI で Salesforce Data Cloud のデータをクエリします。

CData JDBC Driver for Salesforce Data Cloud は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して Salesforce Data Cloud に接続する方法を説明します。

Salesforce Data Cloud のデータ用の JDBC データソースを作成

RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
表示される「Connection Wizard」で、以下のプロパティを設定します。
- Driver Location：インストールディレクトリ内の lib サブフォルダへのパスを設定します。
- Driver Class：ドライバークラスを cdata.jdbc.salesforcedatacloud.SalesforceDataCloudDriver に設定します。
- Username：ユーザー名を入力します（このプロパティは JDBC URL 内でも設定できます）。
- Password：パスワードを入力します（このプロパティは JDBC URL 内でも設定できます）。
- JDBC URL：接続パラメータを入力します。JDBC URL は jdbc:salesforcedatacloud: で始まり、その後にセミコロンで区切られた接続プロパティが続きます。
  
  それでは、Salesforce Data Cloud への認証方法を設定していきましょう。Salesforce Data Cloud では、OAuth 標準による認証をサポートしています。
  
  OAuth 認証
  
  AuthScheme をOAuth に設定してください。
  
  デスクトップアプリケーション
  
  CData 製品では、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供しています。
  
  また、Salesforce Data Cloud コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することも可能です。詳しくは、ヘルプドキュメントのカスタムOAuth アプリの作成をご確認ください。
  
  接続する前に、以下のプロパティを設定してください。
  - InitiateOAuth：GETANDREFRESH。InitiateOAuth を使用すれば、繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要がなくなります
  - OAuthClientId（カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントID
  - OAuthClientSecret（カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット
  接続すると、CData 製品がデフォルトブラウザでSalesforce Data Cloud のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えてください。
  
  以下のようにドライバーがOAuth プロセスを完了します。
  - コールバックURL からアクセストークンを取得します
  - 古いトークンの期限が切れた際は、新しいアクセストークンを取得します
  - OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化します
  Web アプリケーションやヘッドレスマシンを含むその他のOAuth 認証方法については、ヘルプドキュメントをご確認ください。
  
  ビルトイン接続文字列デザイナー
  
  JDBC URL の構築には、Salesforce Data Cloud JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから jar ファイルを実行します。
```
java -jar cdata.jdbc.salesforcedatacloud.jar
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  一般的な JDBC URL は以下のとおりです。
```
jdbc:salesforcedatacloud:
```