ODBC および JDBC ドライバーの設定時の問題のトラブルシューティング

"ODBC ERROR [IM003] Specified driver could not be loaded"

問題

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

ODBC: ERROR [IM003] Specified driver could not be loaded due to system error 126: The specified module could not be found. (FoundrySqlDriver, C:\Program Files\Palantir\Foundry ODBC Driver\bin64\<ModuleName>.dll)

解決方法

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

"FoundrySqlServer:InvalidDatasetCannotAccess"

問題

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

FoundrySqlServer:InvalidDatasetCannotAccess

解決方法

クエリで参照されているデータセットにアクセスできませんでした。これは、データセットまたはブランチが存在しないか、ODBC 接続に設定されているユーザーアカウントにそのデータセットを閲覧する権限がないためです。別のエラーである FoundrySqlServer:NotAuthorizedToReadInputs は、データセットにアクセスできないことではなく、クエリの入力に対する権限の問題を示します。

クエリで参照されているデータセットへのアクセスを確認するには、次のいずれかを行います。

• 該当するユーザーアカウントで Foundry にログインし、該当するデータセットに移動して、期待どおりにデータにアクセスできることを確認します。
• 十分な権限を持つユーザーは、権限の確認ガイドの手順に従って、該当するアカウントのアクセス権限を代理で確認できます。

"FoundrySqlServer:TooManyRows"

問題

Palantir Foundry の ODBC ドライバー、JDBC ドライバー、または 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 が提供するドメインではなく、組織のドメインを使用している場合（たとえば、[your-organization].palantirfoundry.com ではなく foundry.[your-organization].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 ドライバー：接続パラメーターを参照してください。