メインコンテンツへスキップ

基本的なトラブルシューティング

パフォーマンスに関する考慮事項

NetSuite が遅すぎると感じる場合は、パフォーマンスを改善するために以下を試すことができます:
  • 選択するカラムを制限する

    NetSuite オブジェクトはバックエンドのJOIN に大きく依存しています。未使用のカラムを削除するとJOIN 全体を除外でき、パフォーマンスが大幅に改善されます。

  • ページサイズを縮小する

    Pagesize プロパティを小さくすると、リクエストごとに返されるレコード数が減り、すべての結果が返される前のタイムアウトを回避できます。このプロパティはEdit NetSuite Connection > Advanced Settings にあります。

  • キャッシュ

    パフォーマンス向上のため、Connect AI のキャッシュ機能の使用も検討してください。

スキーマのサポートとパフォーマンス

一般的に、パフォーマンスは SuiteAnalytics で最高です。Connect AI は、CData のNetSuite ドライバーとNetSuite ネイティブのSuiteAnalytics ドライバーをそれぞれ別のコネクタとして公開しています。最高のパフォーマンスを得るために、組織がSuiteAnalytics にアクセスできる場合はネイティブのSuiteAnalytics ドライバーを使用することをお勧めします。SuiteAnalytics にアクセスできない場合は、CData のNetSuite ドライバーを使用してください。

Manage Integrations の表示

NetSuite でSetup > Integrations > Manage Integrations を表示するには、ロールに以下の両方の権限が必要です:
  • Setup の下のIntegration Application (Full)。
  • Lists の下のIntegration Applications (Full)。
詳細については権限設定を参照してください。

よくあるエラー

SuiteQL のエラー

この問題は通常、SuiteQL スキーマを使用しているときにオブジェクトタイプへのアクセス権限が不足していることが原因です。権限はテーブルまたはテーブル内の任意のカラムに適用される可能性があります。ドライバーはRowScan を実行して利用可能なフィールドを判別しようとします。NetSuite のロールにテーブルが含まれているかどうかを確認します:
  1. 管理者としてNetSuite アカウントにログインします。
  2. Setup > Users/Roles > Manage Roles に移動します。
  3. ドライバーで接続に使用しているロールを選択します。
  4. Edit > Permissions をクリックします。
  5. Setup の下で、必要なテーブルにFull 権限を追加します。
CData ドライバーで必要となる権限の完全なリストはこちらで確認できます。テーブルがNetSuite によって非推奨化または削除されている場合もあります。同じデータを公開する別のテーブルがないか確認してください。
  • Connect AI でカラムが見つからない場合、メタデータがキャッシュされているか古くなっている可能性があります。該当する場合は、Edit NetSuite Connection ページでClear Metadata をクリックし、確認ダイアログでContinue をクリックしてメタデータキャッシュをクリアしてください。キャッシュをクリアすると、実行中のクエリに影響する可能性があります。
  • RowScanDepth プロパティが 0 になっている可能性もあります。その場合は、Edit NetSuite Connection ページのAdvanced Settings タブでRow Scan Depth プロパティを 0 以外の値に増やしてください。
SuiteQL スキーマは最大 100,000 レコードしか返せません。この制限はNetSuite 自体が課しているものです。以下の 2 つの方法のいずれかでこの制限を回避できます:
  • Schema をSuiteQL ではなくSuiteTalk に設定する。
  • SuiteAnalytics Connect 機能を使用する。アカウントがSuiteAnalytics Connect を持っている場合は、AccountSupportsSuiteAnalyticsConnect プロパティをTrue に設定してSuiteAnalytics Connect 機能を有効にします。
このエラーが表示される場合、NetSuite で必要なCustom Fields 権限が設定されていません。権限設定を参照してください。

SuiteTalk のエラー

カスタムレコードの権限を調整します。権限設定を参照してください。
このエラーは、OAuth ログイン時に選択したロールがOAuth 用に設定されていない場合に表示されます。OAuth 設定済みのロールがある場合は、NetSuite 認証ページでChoose another role をクリックしてそのロールを選択します。OAuth 設定済みのロールがない場合は、ロールの設定セクションの手順に従ってください。
このソースをAI でご利用ください。 クイックスタートの手順に従い、Claude、ChatGPT、Copilot、またはその他のAI クライアントをMCP 経由でこのソースに接続してください。アプリケーションのモデルリクエストを、ガバナンスされた単一のエンドポイント経由でルーティングするには、LLM Gateway を参照してください。Connect AI を初めてご利用になる場合は、Connect AI の無料アカウントを作成し、わずか数分で最初のコネクション設定を完了できます。
最終更新日 2026年10月30日