@rex0220/kintone-sql-tools 3.71.0 → 3.73.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -5
- package/dist-cli/ksql.js +376 -39
- package/dist-engine/index.cjs +14 -14
- package/dist-engine/index.mjs +14 -14
- package/dist-engine/ksql-engine.umd.js +14 -14
- package/dist-engine/meta/bundle-baseline.json +7 -7
- package/dist-engine/meta/cjs.json +12 -12
- package/dist-engine/meta/esm.json +12 -12
- package/dist-engine/meta/umd.json +12 -12
- package/dist-flow/flow-library/index.d.ts +1 -1
- package/dist-flow/flow-library/publicTypes.d.ts +31 -1
- package/dist-flow/index.cjs +12 -12
- package/dist-flow/index.mjs +12 -12
- package/dist-flow/meta/cjs.json +12 -12
- package/dist-flow/meta/esm.json +12 -12
- package/dist-flow/types/ast.d.ts +6 -4
- package/dist-mcp/ksql-mcp.js +342 -35
- package/dist-mcpb/ksql-mcp.mcpb +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -269,6 +269,8 @@ npm パッケージは 2 つのサブパスを **semver 対象の公開 API**
|
|
|
269
269
|
| `@rex0220/kintone-sql-tools/engine` | **read-only** のクエリ実行（ダッシュボード等）。書込 API は構造的に遮断 | `runQuery` / `runBatch` / `explainQuery` / `createReadonlyKintoneClient` / `KsqlEngineError` / `version` |
|
|
270
270
|
| `@rex0220/kintone-sql-tools/flow` | **Flow dialect 1**（→ [言語リファレンス §27](docs/ksql_language_reference.md)）のスクリプト解析・検証・**文単位実行**（バッチランナー向け・書込可能） | `parseScript` / `validateScript` / `explainScript`（`asOf`/`timezone` 注入可） / `createExecutionContext`（`onChunkWritten` 書込チャンク通知） / `executeStatement` / `previewStatement`（dry-run 差分プレビュー・書込 0 回） / `disposeExecutionContext` / `createKintoneClient` / `isDmlResult`（`FlowDmlResult` 型ガード） / `version` |
|
|
271
271
|
|
|
272
|
+
バッチ実行ランナー **kSQL Flow**（`/flow` API を使った公式ランナー・別リポジトリ）: https://github.com/rex0220/ksql-flow
|
|
273
|
+
|
|
272
274
|
`/flow` の典型的な使い方（1 文ずつ実行して結果で継続判断する）:
|
|
273
275
|
|
|
274
276
|
```ts
|
|
@@ -287,13 +289,23 @@ try {
|
|
|
287
289
|
}
|
|
288
290
|
```
|
|
289
291
|
|
|
292
|
+
読取上限は既定 10,000 件（`maxRecords`）です。一時テーブルの実体化には**独立の** `tempTableMaxRows`（既定 10,000 行・超過は常にエラー）が適用されるため、大きなバッチでは両方を併せて指定してください:
|
|
293
|
+
|
|
294
|
+
```ts
|
|
295
|
+
const ctx = createExecutionContext({ client, script: source, maxRecords: 25000, tempTableMaxRows: 25000 });
|
|
296
|
+
await explainScript(source, { client, maxRecords: 25000 }); // EXPLAIN 面にも同じ上限を渡せる
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
`executeStatement` / `previewStatement` は実行コンテキストの `maxRecords` を共有します（3 面同値）。詳細は[言語リファレンス §27.9](docs/ksql_language_reference.md)。
|
|
300
|
+
|
|
290
301
|
### エンジンバージョン × dialect 対応表
|
|
291
302
|
|
|
292
|
-
| エンジン | dialect 0（既定・宣言なし） | dialect 1（`-- @ksql dialect: 1`） |
|
|
293
|
-
|
|
294
|
-
| 〜 v3.67.0 | ✅ | —（未実装） |
|
|
295
|
-
| v3.68.0 | ✅ | 解析のみ（エンジン内部 API。実行できる出荷面なし・実験的） |
|
|
296
|
-
| v3.69.0 〜 | ✅ | ✅ CLI / MCP / プラグイン / `/flow` で実行可 |
|
|
303
|
+
| エンジン | dialect 0（既定・宣言なし） | dialect 1（`-- @ksql dialect: 1`） | ksql-flow |
|
|
304
|
+
|---|---|---|---|
|
|
305
|
+
| 〜 v3.67.0 | ✅ | —（未実装） | — |
|
|
306
|
+
| v3.68.0 | ✅ | 解析のみ（エンジン内部 API。実行できる出荷面なし・実験的） | — |
|
|
307
|
+
| v3.69.0 〜 v3.70.0 | ✅ | ✅ CLI / MCP / プラグイン / `/flow` で実行可 | — |
|
|
308
|
+
| v3.71.0 〜 | ✅ | ✅ 同上 + `previewStatement` | **0.1.0**（要求: `^3.71.0`） |
|
|
297
309
|
|
|
298
310
|
dialect は後方互換で管理します: dialect 0 のスクリプトはどのエンジン版でも挙動不変・破壊的変更は dialect 番号の繰り上げでのみ導入します。変更履歴は [CHANGELOG.md](CHANGELOG.md) を参照してください。
|
|
299
311
|
|