重要なお知らせ: NetSuite SuiteQL スキーマの変更について

対応のお願い: この更新は NetSuite SuiteQL スキーマをご利用のお客様に影響があります。SuiteTalk スキーマをご利用の場合は影響ありません。

概要

NetSuite が netsuite.com から netsuite2.com への移行を進めているため、SuiteQL スキーマに重要な変更が発生しています。この変更により複数のオブジェクトが非推奨となり、データ接続に影響を及ぼす可能性がありますので、CData をご利用のお客様にお知らせいたします。

• 影響レベル: 高
• 影響を受けるスキーマ: SuiteQL のみ
• 影響を受けないスキーマ: SuiteTalk

確認された状況

NetSuite は netsuite.com から netsuite2.com への移行を進めており、これに伴い SuiteQL スキーマに大きな変更が生じています。この移行の過程で、NetSuite は多数のオブジェクトを非推奨としたため、SuiteQL を使用するアプリケーションで不安定な動作が発生しています。

発生が確認されているエラーメッセージ

お使いの NetSuite インスタンスが移行済みの場合、CData ドライバー / コネクタで影響を受けるオブジェクトをクエリすると、以下のようなエラーが発生することがあります:

• ERROR: Unable to retrieve columns for table [TABLENAME].
• ERROR: [INVALID_PARAMETER] Invalid search query. Detailed unprocessed description follows. Search error occurred: Invalid or unsupported search. Bad Request.

影響を受けるケース

以下に該当する場合は影響があります:

• SuiteQL スキーマを使用している
• 上記のエラーメッセージが発生している
• NetSuite インスタンスが netsuite2.com に移行済み

以下に該当する場合は影響ありません:

• SuiteTalk スキーマのみを使用している
• 上記のエラーが発生していない

対処方法

1. Netsuite.com から Netsuite2.com への移行に際して、NetSuite ではロールベースのアクセス権限の違い、レコードやフィールド名の違い、レコードやフィールドタイプの利用可否について確認することを推奨しています。詳細は Oracle NetSuite のドキュメントをご参照ください: https://docs.oracle.com/en/ai/saas/netsuite/ns-online-help/article_164258362224.html#subsect_162885561735
2. 一部のオブジェクトには代替のクエリ方法があります。例:
   • Invoice は次のクエリで取得可能: SELECT * FROM Transactions WHERE RecordType='Invoice'（注: パフォーマンスが低下する可能性があります）
   • TimeEntry テーブルのデータは TimeBill テーブルから取得できます
3. SuiteTalk スキーマへの切り替え（非推奨）:
   • 移行の影響を受けません
   • ドキュメント: CData JDBC Driver for NetSuite - SuiteTalk データモデル
   • 注意: SuiteTalk（SOAP）API はレガシー API です。Oracle NetSuite は新規の統合開発には推奨していません。
4. オブジェクトの移行についてサポートが必要な場合:
   • メール: support@cdata.co.jp
   • 製品バージョンとエラーメッセージを添えてお問い合わせください

影響を受ける CData 製品

CData ドライバー

• CData ODBC Driver for NetSuite
• CData JDBC Driver for NetSuite
• CData ADO.NET Provider for NetSuite
• CData Python Connector for NetSuite
• CData Power BI Connector for NetSuite
• CData Tableau Connector for NetSuite
• CData Excel Add-in for NetSuite
• CData SSIS Components for NetSuite
• CData PowerShell Cmdlets for NetSuite
• CData MCP Server for NetSuite

その他の CData 製品

• CData Sync - SuiteQL スキーマで NetSuite コネクタを使用している場合
• CData Connect AI - SuiteQL スキーマで NetSuite コネクタを使用している場合

注: SuiteQL スキーマを使用した実装のみが影響を受けます。SuiteTalk スキーマは引き続き正常に動作します。