NetSuite の始め方 | SuiteQL: 接続サービスの構文要件

NetSuite の始め方| SuiteQL の概要の記事では、SuiteQLの基本的な概念と機能について調査しました。ここでは、SuiteQLクエリを記述する際、特に接続サービスの使用時に従う必要のある基本的な構文要件に焦点を当てます。これらのルールを理解すると、クエリがNetSuite内で正しく効率的に実行されるようになります。

接続サービスでSuiteQLを使用してクエリを記述する場合は、次の重要な構文ルールに従ってエラーを回避します。

文字列連結

• +演算子は、連結文字列には使用できません。
• かわりに、フィールド連結とリテラル連結の両方に||演算子を使用します。
• 例:

SELECT firstName || ' ' || lastName AS fullName FROM customer;

• これにより、firstNameとlastNameが1つのfullNameフィールドに正しく結合されます。

IN句引数制限

• 1つのIN句に1,000を超える引数を含めることはできません。
• 大規模なデータセットに対してチェックする必要がある場合は、かわりに複数のクエリまたは結合の使用を検討してください。
• 無効なクエリーの例:

SELECT * FROM customer WHERE id IN (1, 2, 3, ..., 1001);

• 代替ソリューション: ORで複数のIN句を使用するか、副クエリで最適化します。

WITH Clauses Are Not Supported

• WITH句(共通表式またはCTEとも呼ばれる)は、SuiteQLでは使用できません。
• かわりに、副クエリまたは一時表を使用してデータを構造化します。

Date Literals Must Use TO_DATE()

• SuiteQLは、直接日付リテラルをサポートしていません(例: '2024-01-01')。
• かわりに、互換性を確保するために、TO_DATE()関数で日付を囲みます。
• 例:

SELECT * FROM transactions WHERE transactionDate = TO_DATE('2024-01-01', 'YYYY-MM-DD');

Right Outer Joins Are Not Supported

• SuiteQLでは、右外部結合(右結合)は許可されません。
• 同じ結果が必要な場合は、かわりに左外部結合(LEFT JOIN)を使用してクエリを書き直します。
• 無効なクエリ(Oracleスタイルの右外部結合):

SELECT a1.id FROM account a1, account a2 WHERE a1.id (+) = a2.id;

• 左結合の代替方法:

SELECT a2.id FROM account a1 LEFT JOIN account a2 ON a1.id = a2.id;

• また、SuiteQLはANSI結合構文と非ANSI結合構文の両方をサポートしますが、1つのクエリ内で混在させることはできません。