CData ADO.NET Provider for Salesforce FAQ、コミュニティリソース、トラブルシューティング

よくある質問

  • CData ADO.NET Provider for Salesforce はどのバージョンの .NET をサポートしていますか？

    CData は .NET 4.x、.NET Standard 2.0、.NET 8.0 用のアセンブリを提供しています。

  • どのバージョンの Microsoft Visual Studio がサポートされていますか？

    CData ADO.NET Provider for Salesforce は Visual Studio 2012 以降のバージョンをサポートしています。

  • CData ADO.NET Provider for Salesforce はどのバージョンの Entity Framework をサポートしていますか？

    Entity Framework 6、Entity Framework Core 8.0 をサポートしています。

  • CData ADO.NET Provider for Salesforce はどのオペレーティングシステムをサポートしていますか？

    CData ADO.NET Provider は複数のアセンブリを含んでいます：

    • .NET Framework 4 アセンブリは x64 プロセッサを搭載した Windows 環境で動作します。
    • .NET Standard 2 および .NET 8 アセンブリは、x64 および ARM64 プロセッサを搭載した Windows、Linux、Mac 環境で動作します。

  • CData ADO.NET Provider for Salesforce のコミュニティライセンスの配布やライセンスオプションはどうなっていますか？

    コミュニティライセンスでは、個人使用、開発、またはテスト用に1台のデスクトップまたはワークステーションに Provider をインストールできます。

    開発者ごとのライセンスでは、任意の数のデスクトップまたはワークステーションに Provider をインストールして社内で使用でき、組織内でのロイヤリティフリー配布のオプションがあります。

  • どのバージョンの Salesforce がサポートされていますか？

    CData ADO.NET Provider for Salesforce は接続に Web Services API を必要とします。Web Services API は Salesforce Enterprise、Unlimited、Developer エディションでネイティブにサポートされています。Professional Edition では、Salesforce に連絡することで追加費用で Web Services API を有効にできる場合があります。Provider はデフォルトで Salesforce API のバージョン 62.0 を使用します。

  • CData ADO.NET Provider for Salesforce はどの認証スキームをサポートしていますか？

    CData ADO.NET Provider for Salesforce は、ユーザー資格情報または OAuth 標準のいずれかを使用した認証をサポートしています。また、CData はデスクトップアプリケーションまたはヘッドレスマシンからの認証用に組み込みの OAuth 資格情報を提供しています。Web アプリケーションから接続するには、カスタム OAuth アプリケーションを作成する必要があります。

コミュニティリソース

開発者コミュニティで ADO.NET の記事や ADO.NET の質問を閲覧したり、自分の質問を投稿したり、会話を始めたりできます！

一般的なエラーとトラブルシューティング

  • 「EXCEEDED_ID_LIMIT: ...」というエラーメッセージが表示されます

    このエラーは、主キー以外のフィールドに対して集計クエリを実行しようとし、2000 行以上が返される場合に発生することがあります。このエラーを解決するには、「ServerSideAggregation」プロパティを「False」に設定します。これにより、タスクがクライアント側にオフロードされ、エラーが解決されます。

  • 「REQUEST_LIMIT_EXCEEDED: ...」というエラーメッセージが表示されます

    このエラーメッセージは Salesforce から直接スローされ、認証されたユーザーが組織内の API リクエスト制限を超えたことを示しています。Salesforce の API リクエスト制限の詳細については、こちらをご覧ください：API リクエスト制限と割り当て

  • Sandbox Salesforce アカウントに接続すると、正確に 10,000 行しか返されないのはなぜですか？

    正確に 10,000 行しか返されない場合、Partial Copy sandbox を使用している可能性があります。Partial Copy sandbox には、本番組織のメタデータと、sandbox テンプレートで定義した選択データが含まれています。ただし、sandbox テンプレートで定義されているように、Partial Copy sandbox は本番環境の標準およびカスタムオブジェクトレコード、ドキュメント、添付ファイルを最大 5GB、選択したオブジェクトごとに最大 10,000 レコードしか含めることができません。

  • Provider がサーバーエクスプローラーまたはモデルビルダーのデータソースドロップダウンに表示されません

    これは、ドライバーの Visual Studio 拡張機能のインストールに問題がある場合に発生することがあります。これを解決するには、Visual Studio を閉じてください（インストールを成功させるには Visual Studio を閉じる必要があります）。次に、インストールディレクトリの lib サブフォルダに移動し、お使いの Visual Studio のバージョンに合った .vsix ファイルをダブルクリックします（Visual Studio 2022 を使用している場合は、System.Data.CData.Salesforce.2022.vsix をクリックします）。Visual Studio を再度開くと、Provider が表示されるはずです。

  • 古いバージョンのアセンブリがキャッシュされています

    Visual Studio は古いアセンブリをキャッシュすることがあります。例えば、v22 を使用していて v23 にアップグレードした場合、v23 アセンブリへの参照を追加しても、v22 アセンブリに変更されてしまうことがあります。これは、古いバージョンを削除してプロジェクトをクリーン/リビルドした後でも発生することがあります。これを修正するためのいくつかの解決策があります。例えば、アセンブリを右クリックしてプロパティを開き、表示されている Path を確認します。その Path に表示されている古いアセンブリを削除するか、正しい参照を持つ新しいプロジェクトを作成することでこの問題を解決できます。以下のリンクで他の解決策も提供されています。

  • 「An item with the same key has already been added」というエラーメッセージが表示されます

    このエラーはモデルビルダーを実行する際に発生することがあり、通常は重複するカラム名があることを示しています。これを解決するには、モデルビルダーを再度実行する前に重複を削除する必要があります。

  • リバースエンジニアリング（スキャフォールディング）のデータモデル生成時のエラー：

    • 「The term 'Scaffold-DbContext' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.」というエラーメッセージが表示されます

      このエラーは、「Scaffold-DbContext」コマンドを使用するために必要な Entity Framework Core ツールパッケージ「Microsoft.EntityFrameworkCore.Tools」がプロジェクトにインストールされていない可能性があることを意味します。これを解決するには、NuGet パッケージマネージャーを使用して「Microsoft.EntityFrameworkCore.Tools」パッケージをプロジェクトに追加してください。

    • 「Unable to find provider assembly 'CData.EntityFrameworkCore.Salesforce. Ensure the name is correct and it's referenced by the project.」というエラーメッセージが表示されます

      このエラーは、プロジェクトに「CData.EntityFrameworkCore.Salesforce.dll」への参照が追加されていない可能性があることを意味します。これを解決するには、インストールディレクトリの lib -> net8.0 -> EFCORE80 サブフォルダにある「CData.EntityFrameworkCore.Salesforce.dll」への参照を追加してください。

    • 「Could not load file or assembly 'System.Data.CData.Salesforce, Version=24.0.0.40, Culture=neutral, PublicKeyToken=f57f3fbecba6b076'. The system cannot find the file specified.」というエラーメッセージが表示されます

      このエラーは、プロジェクトに「System.Data.CData.Salesforce.dll」への参照が追加されていない可能性があることを意味します。これを解決するには、インストールディレクトリの lib -> net8.0 サブフォルダにある「System.Data.CData.Salesforce.dll」への参照を追加してください。

    • 「The type 'DbContextOptionsBuilder' is defined in an assembly that is not referenced. You must add a reference to assembly 'Microsoft.EntityFrameworkCore, Version=8.0.0.0...」というエラーメッセージが表示されます

      このエラーは、必要な Entity Framework Core パッケージ「Microsoft.EntityFrameworkCore」がプロジェクトにインストールされていない可能性があることを意味します。これを解決するには、NuGet パッケージマネージャーを使用して「Microsoft.EntityFrameworkCore」パッケージをプロジェクトに追加してください。

    • 「'KeyBuilder' does not contain a definition for 'HasName' and no accessible extension method 'HasName' accepting a first argument of type 'KeyBuilder' could be found (are you missing a using directive or an assembly reference?)」というエラーメッセージが表示されます

      このエラーは、必要な Entity Framework Core リレーショナルパッケージ「Microsoft.EntityFrameworkCore.Relational」がプロジェクトにインストールされていない可能性があることを意味します。これを解決するには、NuGet パッケージマネージャーを使用して「Microsoft.EntityFrameworkCore.Relational」パッケージをプロジェクトに追加してください。

データ開発者向けの無料コミュニティライセンス

CData の Salesforce ADO.NET Provider を使用すれば、.NET アプリケーションを Salesforce データとシームレスに統合できます。CData ADO.NET Provider for Salesforce のコミュニティライセンスを取得すれば、使い慣れた SQL を使用して、個人の .NET プロジェクトでデータにアクセスするためのライブラリを永久に無料で利用できます。今すぐライセンスをリクエストして、Salesforce 連携アプリの構築を始めましょう！