注
コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。
対話形式またはソース コードで SQL ステートメントを使用して、データベースに格納されているデータを取得および変更します。 これらのタスクには、 select ステートメントと API メソッドを使用します。
データの選択: 表示または変更するデータを選択します。
- select ステートメント – レコードを取得します。
データの挿入: 1 つ以上の新しいレコードをテーブルに追加します。
- insert および doInsert メソッド – 一度に 1 つのレコードを挿入します。
- insert_recordset、RecordInsertList.insertDatabase、および RecordSortedList.insertDatabase メソッド – 複数のレコードを同時に挿入します。
データの更新: 既存のテーブル レコードでデータを変更します。
- update および doUpdate メソッド – 一度に 1 つのレコードを更新します。
- update_recordset ステートメント – 複数のレコードを同時に更新します。
データの削除: 既存のレコードをテーブルから削除します。
- delete および doDelete メソッド – 一度に 1 つのレコードを削除します。
- delete_from ステートメント – 複数のレコードを同時に削除します。
データ アクセスでは、次の他のステートメントを使用します。
- while select ステートメント
- select 式
- next ステートメント
トランザクションの整合性 により、データの破損を防ぎ、スケーラビリティを向上させることができます。
セット ベースからレコード単位への操作の変換の記事では、レコード セット ベースのステートメントおよびメソッドをより効率的に使用するための情報を提供します。
SysDa クラスを使用してデータを取得および変更することもできます。 拡張可能な SysDa API では、X++ で使用できるほとんどすべてのデータアクセス可能性が提供されます。
executeQueryWithParameters API は、SQL インジェクション攻撃の軽減 に役立ちます。
結合の使用の詳細については、Exists 結合および Notexists 結合についてのよくある誤解 を参照してください。
SQL ステートメントのタイムアウト
前述の各 SQL ステートメントには、それを送信するセッションの種類に応じて、各ステートメントにタイムアウトが設定されています。
- 対話型 セッション - 30 分。
- 非対話型 (バッチ、サービス、OData) - 3 時間。
ブロックまたはデータ ボリュームまたはクエリ プランの問題が原因でステートメントがタイムアウトすると、クエリの実行中にデータベースでタイムアウトが発生したというメッセージを含む Exception::Timeout 例外がスローされます。X++ はタイムアウト例外を処理し、この例外に基づいて再試行できます。 既定のタイムアウトをオーバーライドするには、 queryTimeout API を呼び出します。