ODBC & JDBC ドライバーの設定時に問題が発生した場合のトラブルシューティング

"ODBC エラー [IM003] 指定されたドライバーを読み込めませんでした"

問題

Windows で ODBC ドライバーを使用しようとすると、次のエラーが発生します。

ODBC: エラー [IM003] 指定されたドライバーをシステムエラー 126 により読み込めませんでした: 指定されたモジュールが見つかりませんでした。 (FoundrySqlDriver, C:\Program Files\Palantir\Foundry ODBC Driver\bin64\<ModuleName>.dll)

解決策

ホストに最新の Microsoft Visual C++ 再頒布可能パッケージ がインストールされていることを確認してください。

"FoundrySqlServer:InvalidDatasetCannotAccess"

問題

ODBC ドライバー、JDBC ドライバー、または Palantir Foundry の BI ツールコネクターで SQL クエリを実行すると、次のエラーが発生します。

FoundrySqlServer:InvalidDatasetCannotAccess

解決策

ODBC 接続で設定されたユーザーアカウントには、クエリで参照されているデータセットに対するアクセス権がない可能性があります。

以下のいずれかの手順を実行して、アクセスを確認してください。

• 関連するユーザーアカウントで Foundry にログインし、関連するデータセットに移動して、データが予想どおりにアクセスできることを確認します。
• 適切な権限を持つ個人は、権限の確認ガイド の手順に従って、関連するアカウントの代わりにアクセスを確認できます。

"FoundrySqlServer:TooManyRows"

問題

ODBC ドライバー、JDBC ドライバー、または Palantir Foundry の BI ツールコネクターで SQL クエリを実行すると、次のエラーが発生します。

FoundrySqlServer:TooManyRows

解決策

パフォーマンス上の理由から、一部の SQL クエリは行制限が適用されます。 Foundry SQL Server の実行エンジン のドキュメントを確認して、これらの制限と、それらを回避するクエリの定義方法について学んでください。

カスタム SSL 証明書での接続エラー

問題

JDBC または ODBC ドライバーを使用して Foundry に接続しようとすると、ドライバーが Foundry との安全な接続を確立できないことを示すエラーメッセージが表示されることがあります。エラーメッセージは次のようになります。

Dialogue transport failure; PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

このエラーは、ドライバーが Foundry の URL に接続する際に、サーバーの SSL 証明書が信頼できる認証局 (CA) によって署名されていることを確認できなかったことを示しています。これは、CA がオペレーティングシステムのトラストストアに登録されていない場合や、ドライバーがオペレーティングシステムのトラストストアにアクセスできない場合に発生することがあります。

次のシナリオでカスタム CA および証明書に遭遇することがあります。

• Foundry の URL が Palantir が提供するドメインではなく、組織のドメインを使用している場合 (例: foundry.[your-organization].com ではなく、[your-organization].palantirfoundry.com)。
• 組織のネットワークが TLS 復号化/検査を実行するように設定されており、ドライバーが Foundry が元々提示した証明書とは異なる証明書を表示するようになる場合。

解決策

以下のいずれかの方法を使用して、ドライバーが組織が使用するカスタム証明書チェーンにアクセスできるようにします。

オプション 1: カスタム証明書チェーンをオペレーティングシステムのトラストストアにロードする

デフォルトでは、ドライバーは SSL 証明書を検証する際にオペレーティングシステムのデフォルトのトラストストアを使用します。組織の IT サポートに連絡して、組織のカスタム証明書チェーンがそれに追加できるかどうかを確認してください。そうであれば、ドライバーは追加の設定なしで Foundry への接続を確認できるようになります。

オプション 2: PEM 形式のカスタム証明書チェーンを手動で提供する

組織がカスタム証明書チェーンをオペレーティングシステムのデフォルトのトラストストアにロードできない場合は、証明書チェーンを手動でドライバーに提供することができます。これを行うには、PEM 形式で証明書チェーンを取得し、JDBC または ODBC ドライバーの TrustStorePath 接続パラメーター にそのファイルへのパスを指定します。

1. 信頼できる接続から証明書チェーンを取得します。 例えば、すでに Google Chrome で Foundry にアクセスできる場合は、以下の手順に従って証明書チェーンを PEM 形式でエクスポートします。別のブラウザーを使用している場合は、証明書チェーンのエクスポート方法についてブラウザーのドキュメントを参照してください。

   1. Google Chrome を開き、新しいタブで Foundry の URL を開きます。
   2. アドレスバーのロックアイコンを選択し、「接続が安全」という選択肢を選択し、「証明書が有効」という選択肢を選択します。

   Chrome が接続が不安全であり、または証明書が無効であると報告する場合、コンピューターから Foundry へのすべての接続で証明書信頼エラーが発生する別の問題がある可能性があります。組織の IT サポートおよび Palantir サポートに相談してください。

   3. 詳細 タブを選択します。
   4. エクスポート... を選択します。
   5. エクスポート形式として Base64 エンコードされた ASCII、証明書チェーン を選択し、証明書ファイルを保存する場所を選択します。 保存 を選択します。

2. TrustStorePath 接続パラメーターを指定して、ドライバーが証明書チェーンを使用するように設定します。 このプロパティの値は、前の手順でエクスポートしたファイルへのフルパスである必要があります。接続パラメーターの指定方法については、ODBC & JDBC ドライバー: 接続パラメーター を参照してください。