bitrix-database

データベースへの直接アクセス

基準：main 23.0+・検証済み：main 26.800.0

まず ORM を使用します（bitrix-orm：query()、バッチ書き込み、マージ、deleteByFilter）。アップサート、ウィンドウ関数／CTE、負荷の高いレポート、追加接続、スキーマ変更には SQL を使用します。

タスク	参照先
connections 設定、追加 DB、文字セット、接続後フック、名前付きロック	rules/connections.md
query*、add／addMulti、SqlHelper、プレースホルダー、アップサート、トランザクション	rules/queries.md
DDL ビルダー、テーブル／インデックスの変更、SqlTracker	rules/ddl-debug.md

不変条件

• すべての値は、SqlExpression プレースホルダーまたは SqlHelper（forSql、convertToDb*）を経由して SQL に渡します。query()／queryExecute() の $binds 引数はプリペアドステートメントではありません。
• 入力由来の識別子は、まずホワイトリストで確認してから quote()／?# を使用します。
• 生の書き込みでは ORM イベントとキャッシュがスキップされます。その後、XxxTable::cleanCache() を呼び出してください。
• SQL は移植性を保ちます。SqlHelper の関数のみを使用し、バッククォート、ENGINE、UNSIGNED は使用しません（bitrix-postgresql）。
• トランザクションごとに接続を 1 つ使用し、トランザクションは短時間に保ちます。