接続の設定
コネクタには、Tableau の外部で接続設定を構築およびテストできるConnection Builder が付属しています。 また、Tableau の接続ダイアログにリストされていないオプションを提供するために使用できる接続文字列を作成することもできます。
Connection Builder の設定
Connection Builder にアクセスする方法は2つあります。
- Windows では、スタートメニューのCData Tableau Connector for PCA Sales フォルダの下に[Connection Builder]というショートカットが表示されます。
- また、ドライバーのインストールディレクトリに移動し、lib ディレクトリで.jar ファイルを実行することによってもConnection Builder を開始できます。
Connection Builder では、接続プロパティに値を設定し、[接続テスト]ボタンをクリックして、その動作を確認することができます。 また、[クリップボードにコピー]ボタンを使用して、Tableau で使用する接続文字列をコピーすることもできます。
OAuth
認証方法については、OAuth 認証の使用 を参照してください。 ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、次のとおりです。
- InitiateOAuth:GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動での接続文字列のアクセストークン設定の繰り返しを避けられます。
- AuthScheme:アプリ設定でAuthScheme を指定するために設定。
- DefaultDataArea:接続するデータ領域を設定。
- DataCenter:接続するサーバーのDataCenter 名を設定。
接続すると、connector はデフォルトブラウザでPCA Sales OAuth エンドポイントを開きます。ログインして、connector にアクセス許可を与えます。connector がOAuth プロセスを完了します。
- コールバックURL からアクセストークンを取得し、リクエストを認証します。
- 古いトークンの期限が切れたときは、新しいアクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
あるいは、グラント種別をPASSWORD に設定できます。このためにはAuthScheme をOAuthPassword に設定する必要があります。この認証タイプは上記のものと類似していますがユーザーの操作が不要な点が異なります。 次の接続プロパティを設定して接続します。
- InitiateOAuth:GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動での接続文字列のアクセストークン設定の繰り返しを避けられます。
- AuthScheme:アプリ設定でAuthScheme を指定するために設定。
- User:ユーザーアカウントのユーザー名に設定。
- Password:ユーザーアカウントのパスワードに設定。
- ServiceId:サービスアカウントのID に設定。
- ServicePassword:サービスアカウントのパスワードに設定。
- DefaultDataArea:接続するデータ領域を設定。
- DataCenter:接続するサーバーのDataCenter 名を設定。
ヘッドレスマシンの認証など、他のOAuth 認証フローについては、OAuth 認証の使用 を参照してください。 このOAuth フローでは、ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、次のとおりです。
- OAuthClientId:アプリケーション設定のクライアントId に設定。
- OAuthClientSecret:アプリケーション設定のクライアントシークレットに設定。
- CallbackURL:アプリケーション設定のリダイレクトURL に設定。
- ApiVersion:接続するPCA API Server バージョンを設定。
- DefaultDataArea:接続するデータ領域を設定。
- DataCenter:接続するサーバーのDataCenter 名を設定。
- ProductCode:PCA 製品コード名を設定。
[接続]をクリックするとconnector がPCA Sales OAuth エンドポイントを開きます。ログインして、connector にアクセス許可を与えます。connector がOAuth プロセスを完了します。
次のステップ
次の手順については、PCA Sales API への認証を含むデータの取得 を参照してください。