JDBC ソース向けの Palantir 提供ドライバー

Data Connection で Foundry ソースとして表示される JDBC ドライバーを使用して、Foundry エンロールメントをさまざまな外部ソースに接続できます。これらのソースは、カスタマイズ可能な JDBC ドライバーのラッパーであり、推奨プロパティと必須プロパティ、および公式ドキュメントへのリンクが付属しています。

独自の JDBC ドライバーを Foundry にアップロードする場合は、カスタム JDBC ドライバーの設定に関するドキュメントを確認してください。

同期を使用して、外部システムから Foundry にデータを読み込みます。一部の CData コネクターは、Foundry データセットの行を外部システムに書き込むためのテーブルエクスポートもサポートしています。

セットアップ

1. Data Connection アプリケーションを開き、画面右上の +新規ソースを選択します。

2. 表示された選択肢から目的のソースを探します。Foundry 提供ドライバーの全一覧を表示します。

3. ソースの機能を Foundry ワーカーまたは Agent ワーカーで実行することを選択します。

4. ドキュメント ↗ を選択して、ドライバーソースの公式ドキュメントを確認します。
   
   
   
   

5. 以下のセクションの情報を使用し、追加の設定プロンプトに従って、コネクターのセットアップを続けます。

設定オプション

JDBC プロパティ

JDBC 接続にプロパティ ↗ を追加して、動作を設定できます。ドライバーによっては、特定のプロパティが必須となります。これらの必須プロパティはデフォルトで入力されており、ソースを保存する前に設定する必要があります。また、+プロパティを追加を選択し、推奨セクションを表示すると、追加可能な推奨プロパティを確認できます。

必須または推奨プロパティの名前にカーソルを置くと、選択したドライバーの公式ドキュメントページにアクセスできます。

Foundry 提供ドライバーの同期を設定する

SQL クエリ

同期ごとに1つの SQL クエリを実行できます。このクエリは、データのテーブルを出力として生成する必要があります。この出力は Foundry の出力データセットに保存されます。

例外的に、このクエリで、結果としてデータを生成するストアドプロシージャを呼び出すこともできます。詳細は以下を参照してください。

CData 提供のドライバーの設定オプション

Foundry が提供するドライバーの多くは、CData ↗ が開発しています。CData は、ソースシステムで資格情報を生成するための詳細な手順を含む、各ドライバーの完全なドキュメントを提供しています。これらの手順には、各 CData ドライバーのドキュメントページからアクセスできます。

以下のセクションでは、外部システムへの接続を成功させるために役立つ、CData 固有の設定オプションについて説明します。

CData コネクターでデータをエクスポートする

テーブルエクスポートを使用して、Foundry データセットの行を既存の外部テーブルに追加します。テーブルエクスポートのサポートはコネクターによって異なります。利用可能かどうかは、コネクターのドキュメントを確認してください。

CData のテーブルエクスポートは、切り詰めを行わないエクスポートモードのみをサポートし、キーによる更新、削除、アップサートはサポートしていません。本番データをエクスポートする前に、テーブルエクスポートの要件と制限事項を確認し、本番環境ではない対象に対して1行でテストしてください。

Foundry ワーカーのソースでより複雑な処理を行うには、検証済みのコネクター固有のコードベースの接続オプションを使用します。サポートされている処理と認証については、コネクターのドキュメントに従ってください。

ソース探索時に接続テストを自動実行する

デフォルトでは、CData ドライバーは実際にクエリが実行されるまで接続を行いません。このため、ソース探索について誤った判断をすることがあります。ドライバーに保存された静的なメタデータテーブルが表示されることで、探索に成功したように見えても、実際には資格情報やエグレスポリシーの不足、またはその他の問題により、基盤となるシステムへの接続に失敗している場合があります。

ConnectOnOpen JDBC プロパティを true に設定すると、ソースを探索するだけの場合でも、ドライバーに何も操作を行わない接続テストを強制的に実行させることができます。ソース探索時に接続に関するすべての問題を検出できるよう、この設定を推奨します。

証明書認証

多くの CData ドライバーは、特に Azure ベースのシステムで証明書認証をサポートしています。

証明書を使用して接続するには、接続固有の設定要件に加えて、以下の JDBC プロパティを定義する必要があります。

• AuthScheme: AzureServicePrincipalCert
• OAuthJWTCertType: PFXBLOB
• OAuthJWTCert: base64-encoded_cert/pfx/pem_file_content
• （任意）OAuthJWTCertPassword: password_for_the_cert/pfx/pem_file

Windows マシンで証明書ファイルを Base64 形式に変換するには、次のコマンドを使用します：[Convert]::ToBase64String([IO.File]::ReadAllBytes("\path\to\file.pfx"))

ストアドプロシージャ

Amazon Marketplace や Microsoft OneDrive などのファイルベースのソースシステムに接続する一部の CData ドライバーは、データを取り込むためにストアドプロシージャの呼び出し機能を使用します。

ストアドプロシージャを実行すると、ファイルの内容を Base64 エンコードされた文字列として格納するテーブルが生成されます。この文字列は、下流のデータ変換でデコードできます。たとえば、Pipeline Builder では Base64 デコードボードを使用できます。

OAuth 2.0 認証

一部の CData ドライバーは、OAuth 2.0 ↗ の認可コードグラントフローをサポートしています。これにより、ユーザーが自身の資格情報で認証し、そのユーザーに代わってアクションを実行できるようになり、外部システムに安全に接続できます。利用可能なドライバーの一覧には、OAuth 2.0 認証をサポートするドライバーが詳しく記載されています。

OAuth 2.0 認証を使用するには、次の手順に従います。

1. ソース設定に CallbackUrl JDBC プロパティを追加します。プロパティ値には、https://<YOUR_FOUNDRY_URL>/workspace/oauth2-clients/callback という形式の URL が自動入力されます。

2. 外部システムでカスタム OAuth アプリケーションを登録し、コールバック URL を指定します。

   • カスタム OAuth アプリケーションを登録する具体的な方法は、外部システムによって異なります。たとえば、GitHub ↗ の場合は、設定 > 開発者設定 > OAuth Apps に移動します。次に、新規 OAuth アプリを選択します。

3. 生成された OAuth クライアントIDと OAuth クライアントシークレットをコピーし、ソース設定の JDBC プロパティに貼り付けます。
   
   
   
   

4. 設定を保存したら、ソースの概要ページに移動します。上部にあるこのソースの使用を開始するには認可が必要ですというバナーで、権限付与を選択して OAuth フローを開始します。
   
   
   
   

   ソースの概要ページの右側パネルから、認可を更新または取り消すことができます。
   
   
   
   

利用可能なドライバー