基本的なトラブルシューティング
パフォーマンスに関する考慮事項
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 のロールにテーブルが含まれているかどうかを確認します:
- 管理者としてNetSuite アカウントにログインします。
- Setup > Users/Roles > Manage Roles に移動します。
- ドライバーで接続に使用しているロールを選択します。
- Edit > Permissions をクリックします。
- Setup の下で、必要なテーブルにFull 権限を追加します。
カラムが見つからない
カラムが見つからない
- 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 のエラー
カスタムレコードタイプの権限が不足
カスタムレコードタイプの権限が不足
カスタムレコードの権限を調整します。権限設定を参照してください。
お使いのロールはOAuth2 ログインをサポートしていません。別のロールを選択してください
お使いのロールはOAuth2 ログインをサポートしていません。別のロールを選択してください
このエラーは、OAuth ログイン時に選択したロールがOAuth 用に設定されていない場合に表示されます。OAuth 設定済みのロールがある場合は、NetSuite 認証ページでChoose another role をクリックしてそのロールを選択します。OAuth 設定済みのロールがない場合は、ロールの設定セクションの手順に従ってください。
このソースをAI でご利用ください。 クイックスタートの手順に従い、Claude、ChatGPT、Copilot、またはその他のAI クライアントをMCP 経由でこのソースに接続してください。アプリケーションのモデルリクエストを、ガバナンスされた単一のエンドポイント経由でルーティングするには、LLM Gateway を参照してください。Connect AI を初めてご利用になる場合は、Connect AI の無料アカウントを作成し、わずか数分で最初のコネクション設定を完了できます。