fix(oceanbase-oracle): bound first query result page
This commit is contained in:
1 parent
b5bf45e224
commit
30d8b3970a
8 files changed
+258
-14
No files matched your search
@@ -0,0 +1,36 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import type { QueryResult } from "@/types/database";
|
||||||
|
import { stripPaginationRowNumber } from "@/lib/query/queryPaginationResult";
|
||||||
|
|
||||||
|
const result: QueryResult = {
|
||||||
|
columns: ["__dbx_row_num", "shape", "__dbx_row_num"],
|
||||||
|
rows: [["user value", "POINT(1 2)", 101]],
|
||||||
|
column_types: ["VARCHAR", "GEOMETRY", "NUMBER"],
|
||||||
|
column_sortables: [true, false, true],
|
||||||
|
spatial_columns: [{ column_index: 1, srid: 4326 }],
|
||||||
|
spatial_values: [[null, 4326, null]],
|
||||||
|
large_value_cells: [{ row_index: 0, column_index: 1, original_bytes: 200 }],
|
||||||
|
hidden_column_indexes: [0],
|
||||||
|
affected_rows: 0,
|
||||||
|
execution_time_ms: 1,
|
||||||
|
};
|
||||||
|
|
||||||
|
describe("pagination result columns", () => {
|
||||||
|
it("removes only the generated trailing column and keeps user columns and metadata aligned", () => {
|
||||||
|
const cleaned = stripPaginationRowNumber(result, "__dbx_row_num");
|
||||||
|
expect(cleaned.columns).toEqual(["__dbx_row_num", "shape"]);
|
||||||
|
expect(cleaned.rows).toEqual([["user value", "POINT(1 2)"]]);
|
||||||
|
expect(cleaned.column_types).toEqual(["VARCHAR", "GEOMETRY"]);
|
||||||
|
expect(cleaned.column_sortables).toEqual([true, false]);
|
||||||
|
expect(cleaned.spatial_values).toEqual([[null, 4326]]);
|
||||||
|
expect(cleaned.spatial_columns).toEqual(result.spatial_columns);
|
||||||
|
expect(cleaned.large_value_cells).toEqual(result.large_value_cells);
|
||||||
|
expect(cleaned.hidden_column_indexes).toEqual([0]);
|
||||||
|
expect(result.columns).toHaveLength(3);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("leaves user results untouched when the plan has no helper or the trailing name differs", () => {
|
||||||
|
expect(stripPaginationRowNumber(result, undefined)).toBe(result);
|
||||||
|
expect(stripPaginationRowNumber(result, "different_helper")).toBe(result);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -438,6 +438,7 @@ export interface QueryPaginationExecutionPlan {
|
|||||||
countSql?: string;
|
countSql?: string;
|
||||||
exactQueryRowBound?: number;
|
exactQueryRowBound?: number;
|
||||||
useAgentResultSession: boolean;
|
useAgentResultSession: boolean;
|
||||||
|
paginationRowNumberColumn?: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
export type QuerySortDirection = "asc" | "desc";
|
export type QuerySortDirection = "asc" | "desc";
|
||||||
|
|||||||
@@ -0,0 +1,18 @@
|
|||||||
|
import type { QueryResult } from "@/types/database";
|
||||||
|
|
||||||
|
/** Remove only the trailing helper identified by the pagination plan. */
|
||||||
|
export function stripPaginationRowNumber(result: QueryResult, column: string | undefined): QueryResult {
|
||||||
|
const index = result.columns.length - 1;
|
||||||
|
if (!column || index < 0 || result.columns[index] !== column) return result;
|
||||||
|
return {
|
||||||
|
...result,
|
||||||
|
columns: result.columns.slice(0, index),
|
||||||
|
rows: result.rows.map((row) => row.slice(0, index)),
|
||||||
|
column_types: result.column_types?.slice(0, index),
|
||||||
|
column_sortables: result.column_sortables?.slice(0, index),
|
||||||
|
spatial_values: result.spatial_values?.map((row) => row.slice(0, index)),
|
||||||
|
spatial_columns: result.spatial_columns?.filter((column) => column.column_index < index),
|
||||||
|
large_value_cells: result.large_value_cells?.filter((cell) => cell.column_index < index),
|
||||||
|
hidden_column_indexes: result.hidden_column_indexes?.filter((columnIndex) => columnIndex < index),
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -1787,6 +1787,71 @@ describe("queryStore hidden primary key editing", () => {
|
|||||||
expect(tab.queryAnalysis).toBeUndefined();
|
expect(tab.queryAnalysis).toBeUndefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("removes the generated row number before appending OceanBase Oracle pages", async () => {
|
||||||
|
const sql = "SELECT LEVEL AS N FROM DUAL CONNECT BY LEVEL <= 4";
|
||||||
|
getConnectionConfig.mockReturnValue({ id: "ob-1", name: "OceanBase", db_type: "oceanbase-oracle", database: "app" });
|
||||||
|
analyzeEditableQueryEditability.mockResolvedValue({ editable: false });
|
||||||
|
prepareQueryPaginationExecutionPlan.mockImplementation(async (options) => ({
|
||||||
|
sqlToExecute: options.sql,
|
||||||
|
pageSql: options.sql,
|
||||||
|
pageLimit: options.pagination.limit,
|
||||||
|
pageOffset: options.pagination.offset,
|
||||||
|
countSql: undefined,
|
||||||
|
useAgentResultSession: false,
|
||||||
|
paginationRowNumberColumn: options.pagination.offset > 0 ? "__dbx_row_num" : undefined,
|
||||||
|
}));
|
||||||
|
executeMulti.mockResolvedValueOnce([{ columns: ["N"], rows: [[1], [2]], affected_rows: 0, execution_time_ms: 1 }]).mockResolvedValueOnce([
|
||||||
|
{
|
||||||
|
columns: ["N", "__dbx_row_num"],
|
||||||
|
rows: [
|
||||||
|
[3, 3],
|
||||||
|
[4, 4],
|
||||||
|
],
|
||||||
|
affected_rows: 0,
|
||||||
|
execution_time_ms: 1,
|
||||||
|
},
|
||||||
|
]);
|
||||||
|
const { useQueryStore } = await import("@/stores/queryStore");
|
||||||
|
const store = useQueryStore();
|
||||||
|
const tabId = store.createTab("ob-1", "app", "Query");
|
||||||
|
await store.executeTabSql(tabId, sql, { pagination: { limit: 2, offset: 0 } });
|
||||||
|
await store.executeTabSql(tabId, sql, {
|
||||||
|
pagination: { limit: 2, offset: 2 },
|
||||||
|
preserveResultDuringExecution: true,
|
||||||
|
appendResult: { maxRows: 10 },
|
||||||
|
});
|
||||||
|
const tab = store.tabs.find((item) => item.id === tabId)!;
|
||||||
|
expect(tab.result?.columns).toEqual(["N"]);
|
||||||
|
expect(tab.result?.rows).toEqual([[1], [2], [3], [4]]);
|
||||||
|
|
||||||
|
prepareQueryPaginationExecutionPlan.mockImplementation(async (options) => ({
|
||||||
|
sqlToExecute: options.sql,
|
||||||
|
pageSql: options.sql,
|
||||||
|
pageLimit: 2,
|
||||||
|
pageOffset: options.pagination.offset,
|
||||||
|
countSql: undefined,
|
||||||
|
useAgentResultSession: false,
|
||||||
|
paginationRowNumberColumn: options.pagination.offset > 0 ? "__dbx_row_num" : undefined,
|
||||||
|
}));
|
||||||
|
executeMulti
|
||||||
|
.mockResolvedValueOnce([{ columns: ["N"], rows: [[1], [2]], affected_rows: 0, execution_time_ms: 1 }])
|
||||||
|
.mockResolvedValueOnce([
|
||||||
|
{
|
||||||
|
columns: ["N", "__dbx_row_num"],
|
||||||
|
rows: [
|
||||||
|
[3, 3],
|
||||||
|
[4, 4],
|
||||||
|
],
|
||||||
|
affected_rows: 0,
|
||||||
|
execution_time_ms: 1,
|
||||||
|
},
|
||||||
|
])
|
||||||
|
.mockResolvedValueOnce([{ columns: ["N", "__dbx_row_num"], rows: [], affected_rows: 0, execution_time_ms: 1 }]);
|
||||||
|
const exported = await store.fetchTabResultForExport(tabId);
|
||||||
|
expect(exported?.columns).toEqual(["N"]);
|
||||||
|
expect(exported?.rows).toEqual([[1], [2], [3], [4]]);
|
||||||
|
});
|
||||||
|
|
||||||
it("records the returned row count when a page is known to be incomplete without count sql", async () => {
|
it("records the returned row count when a page is known to be incomplete without count sql", async () => {
|
||||||
prepareQueryPaginationExecutionPlan.mockResolvedValue({
|
prepareQueryPaginationExecutionPlan.mockResolvedValue({
|
||||||
sqlToExecute: "SELECT name FROM users LIMIT 100 OFFSET 0",
|
sqlToExecute: "SELECT name FROM users LIMIT 100 OFFSET 0",
|
||||||
|
|||||||
@@ -59,6 +59,7 @@ import { connectionObjectTreeNodeSchema, connectionQueryExecutionSchema, connect
|
|||||||
import { frontendQueryTimeoutDelayMs, frontendQueryTimeoutSecsForSql, queryTimeoutSecsForConnection } from "@/lib/sql/queryTimeout";
|
import { frontendQueryTimeoutDelayMs, frontendQueryTimeoutSecsForSql, queryTimeoutSecsForConnection } from "@/lib/sql/queryTimeout";
|
||||||
import { queryResultNameFromPreamble, queryResultSourceLabel } from "@/lib/sql/queryResultSource";
|
import { queryResultNameFromPreamble, queryResultSourceLabel } from "@/lib/sql/queryResultSource";
|
||||||
import { sqlServerCountUsesLocalTempTable } from "@/lib/query/queryResultCountSession";
|
import { sqlServerCountUsesLocalTempTable } from "@/lib/query/queryResultCountSession";
|
||||||
|
import { stripPaginationRowNumber } from "@/lib/query/queryPaginationResult";
|
||||||
import { beginDataGridNativeSelectionBlock, finishDataGridNativeSelectionBlock } from "@/lib/dataGrid/dataGridNativeSelection";
|
import { beginDataGridNativeSelectionBlock, finishDataGridNativeSelectionBlock } from "@/lib/dataGrid/dataGridNativeSelection";
|
||||||
import { appendLargeValueCells, canUseTableDataLargeValuePreview, remapLargeValueCells, tableDataLargeValuePreviewOptions, TABLE_DATA_RESULT_MAX_BYTES } from "@/lib/dataGrid/dataGridLargeValues";
|
import { appendLargeValueCells, canUseTableDataLargeValuePreview, remapLargeValueCells, tableDataLargeValuePreviewOptions, TABLE_DATA_RESULT_MAX_BYTES } from "@/lib/dataGrid/dataGridLargeValues";
|
||||||
import { simpleDataGridOrderByReferencesMissingColumn, sortDataGridRowIndexes, type DataGridSortDirection } from "@/lib/dataGrid/dataGridSort";
|
import { simpleDataGridOrderByReferencesMissingColumn, sortDataGridRowIndexes, type DataGridSortDirection } from "@/lib/dataGrid/dataGridSort";
|
||||||
@@ -6310,6 +6311,7 @@ export const useQueryStore = defineStore("query", () => {
|
|||||||
let countSql: string | undefined;
|
let countSql: string | undefined;
|
||||||
let exactQueryRowBound: number | undefined;
|
let exactQueryRowBound: number | undefined;
|
||||||
let useAgentResultSession = false;
|
let useAgentResultSession = false;
|
||||||
|
let paginationRowNumberColumn: string | undefined;
|
||||||
let executionDispatched = false;
|
let executionDispatched = false;
|
||||||
let producedResult = false;
|
let producedResult = false;
|
||||||
const resumedExecutionTarget = batchResume?.batch.executionTarget;
|
const resumedExecutionTarget = batchResume?.batch.executionTarget;
|
||||||
@@ -7054,6 +7056,7 @@ export const useQueryStore = defineStore("query", () => {
|
|||||||
countSql = sqlServerUseScript && plan.countSql ? replaceSqlServerLeadingUseQuery(queryBaseSql, sqlServerUseScript, plan.countSql) : plan.countSql;
|
countSql = sqlServerUseScript && plan.countSql ? replaceSqlServerLeadingUseQuery(queryBaseSql, sqlServerUseScript, plan.countSql) : plan.countSql;
|
||||||
exactQueryRowBound = plan.exactQueryRowBound;
|
exactQueryRowBound = plan.exactQueryRowBound;
|
||||||
useAgentResultSession = plan.useAgentResultSession;
|
useAgentResultSession = plan.useAgentResultSession;
|
||||||
|
paginationRowNumberColumn = plan.paginationRowNumberColumn;
|
||||||
}
|
}
|
||||||
const hasBoundedPagination = typeof pageLimit === "number" && typeof pageOffset === "number";
|
const hasBoundedPagination = typeof pageLimit === "number" && typeof pageOffset === "number";
|
||||||
if (options?.appendResult && !hasBoundedPagination && !useAgentResultSession) {
|
if (options?.appendResult && !hasBoundedPagination && !useAgentResultSession) {
|
||||||
@@ -7269,6 +7272,9 @@ export const useQueryStore = defineStore("query", () => {
|
|||||||
options?.sourceOffset === undefined ? undefined : tab.sql,
|
options?.sourceOffset === undefined ? undefined : tab.sql,
|
||||||
);
|
);
|
||||||
const results = offsetBatchQueryResultIndexes(annotatedResults.results, batchResume?.startStatementIndex ?? 0);
|
const results = offsetBatchQueryResultIndexes(annotatedResults.results, batchResume?.startStatementIndex ?? 0);
|
||||||
|
if (paginationRowNumberColumn && results.length === 1) {
|
||||||
|
results[0] = markQueryResultsRowsRaw([stripPaginationRowNumber(results[0]!, paginationRowNumberColumn)])[0]!;
|
||||||
|
}
|
||||||
reconcileBatchSqlResults(tab, executionId, results);
|
reconcileBatchSqlResults(tab, executionId, results);
|
||||||
// Sticky proven-read-only aggregation (Oracle/OceanBase-Oracle/MySQL/PG).
|
// Sticky proven-read-only aggregation (Oracle/OceanBase-Oracle/MySQL/PG).
|
||||||
// Only the initial manual execution participates: a later cursor-page
|
// Only the initial manual execution participates: a later cursor-page
|
||||||
@@ -8563,8 +8569,8 @@ export const useQueryStore = defineStore("query", () => {
|
|||||||
}
|
}
|
||||||
: { maxRows: plan.pageLimit, fetchSize: plan.pageLimit, clientSessionId, catalog: location.catalog, timeoutSecs: queryTimeoutSecs };
|
: { maxRows: plan.pageLimit, fetchSize: plan.pageLimit, clientSessionId, catalog: location.catalog, timeoutSecs: queryTimeoutSecs };
|
||||||
const results = await api.executeMulti(location.connectionId, executionDatabase, plan.sqlToExecute, location.schema, exportExecutionId, executionOptions);
|
const results = await api.executeMulti(location.connectionId, executionDatabase, plan.sqlToExecute, location.schema, exportExecutionId, executionOptions);
|
||||||
const result = results[0];
|
if (!results[0]) break;
|
||||||
if (!result) break;
|
const result = stripPaginationRowNumber(results[0], plan.paginationRowNumberColumn);
|
||||||
if (columns.length === 0) columns = result.columns;
|
if (columns.length === 0) columns = result.columns;
|
||||||
rows.push(...result.rows);
|
rows.push(...result.rows);
|
||||||
executionTimeMs += result.execution_time_ms ?? 0;
|
executionTimeMs += result.execution_time_ms ?? 0;
|
||||||
|
|||||||
Generated
+1
-1
@@ -1,3 +1,3 @@
|
|||||||
@font-face{font-family:"Geist Variable";font-style:normal;font-display:swap;font-weight:100 900;src:url("data:font/woff2;base64,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 truncated
|
@font-face{font-family:"Geist Variable";font-style:normal;font-display:swap;font-weight:100 900;src:url("data:font/woff2;base64,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 truncated
|
||||||
.docs-group{--group-c:hsl(var(--h,220), 55%, 38%);--group-tint:hsl(var(--h,220), 55%, 94%)}.dark .docs-group{--group-c:hsl(var(--h,220), 50%, 72%);--group-tint:hsl(var(--h,220), 30%, 18%)}.docs-ground-light .docs-group{--group-c:hsl(var(--h,220), 55%, 38%);--group-tint:hsl(var(--h,220), 55%, 94%)}@supports (color:oklch(1 0 0)){.docs-group{--group-c:oklch(.55 .15 var(--h,220));--group-tint:oklch(.96 .03 var(--h,220))}.dark .docs-group{--group-c:oklch(.76 .13 var(--h,220));--group-tint:oklch(.28 .05 var(--h,220))}.docs-ground-light .docs-group{--group-c:oklch(.55 .15 var(--h,220));--group-tint:oklch(.96 .03 var(--h,220))}}@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-scale-x:1;--tw-scale-y:1;--tw-scale-z:1}}}@layer theme{:root,:host{--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-amber-50:oklch(98.7% .022 95.277);--color-amber-200:oklch(92.4% .12 95.746);--color-amber-300:oklch(87.9% .169 91.605);--color-amber-900:oklch(41.4% .112 45.904);--color-amber-950:oklch(27.9% .077 45.635);--color-neutral-900:oklch(20.5% 0 0);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-lg:32rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height:calc(1.5 / 1);--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--font-weight-medium:500;--font-weight-semibold:600;--tracking-wide:.025em;--leading-relaxed:1.625;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:"Geist Variable", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Segoe UI", system-ui, sans-serif;--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeLine truncated
|
.docs-group{--group-c:hsl(var(--h,220), 55%, 38%);--group-tint:hsl(var(--h,220), 55%, 94%)}.dark .docs-group{--group-c:hsl(var(--h,220), 50%, 72%);--group-tint:hsl(var(--h,220), 30%, 18%)}.docs-ground-light .docs-group{--group-c:hsl(var(--h,220), 55%, 38%);--group-tint:hsl(var(--h,220), 55%, 94%)}@supports (color:oklch(1 0 0)){.docs-group{--group-c:oklch(.55 .15 var(--h,220));--group-tint:oklch(.96 .03 var(--h,220))}.dark .docs-group{--group-c:oklch(.76 .13 var(--h,220));--group-tint:oklch(.28 .05 var(--h,220))}.docs-ground-light .docs-group{--group-c:oklch(.55 .15 var(--h,220));--group-tint:oklch(.96 .03 var(--h,220))}}@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-scale-x:1;--tw-scale-y:1;--tw-scale-z:1}}}@layer theme{:root,:host{--color-amber-50:oklch(98.7% .022 95.277);--color-amber-200:oklch(92.4% .12 95.746);--color-amber-300:oklch(87.9% .169 91.605);--color-amber-900:oklch(41.4% .112 45.904);--color-amber-950:oklch(27.9% .077 45.635);--color-neutral-900:oklch(20.5% 0 0);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-lg:32rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height:calc(1.5 / 1);--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--font-weight-medium:500;--font-weight-semibold:600;--tracking-wide:.025em;--leading-relaxed:1.625;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:"Geist Variable", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Segoe UI", system-ui, sans-serif;--default-mono-font-family:"Fira Code", "Cascadia Code", "Cascadia Mono", "JetBrains Mono", monospace}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:Line truncated
|
||||||
/*$vite$:1*/
|
/*$vite$:1*/
|
||||||
@@ -39,7 +39,7 @@
|
|||||||
"apps/desktop/src/lib/app/localeOptions.ts": "2c19ecb7c91050d5f1c84c381606087ada11870d3ee95029362f84f34de23239",
|
"apps/desktop/src/lib/app/localeOptions.ts": "2c19ecb7c91050d5f1c84c381606087ada11870d3ee95029362f84f34de23239",
|
||||||
"apps/desktop/src/lib/common/utils.ts": "76c4b2af1e03edeb8db389d9b2c1b56b72a57a1b5198d4e224671c1445c527da",
|
"apps/desktop/src/lib/common/utils.ts": "76c4b2af1e03edeb8db389d9b2c1b56b72a57a1b5198d4e224671c1445c527da",
|
||||||
"apps/desktop/src/lib/diagram/erDiagram.ts": "e28aa2b5fbba001ae78bc0c4218b11f93b0e14ab9f54562f14254386b98bad11",
|
"apps/desktop/src/lib/diagram/erDiagram.ts": "e28aa2b5fbba001ae78bc0c4218b11f93b0e14ab9f54562f14254386b98bad11",
|
||||||
"apps/desktop/src/styles/tokens.css": "b8852ce50865ad98ebc992971f7a06670c5d830ca82efcee956f8d3eb7c2e9a3",
|
"apps/desktop/src/styles/tokens.css": "5d0dd04cb28e5354a57ca7365418923aa912ee0cf28e1d0665734de04493c533",
|
||||||
"apps/desktop/tsconfig.json": "ee02ba8f2f257b86235cd3053e8d6fbfefd7c39e0807b4ea5e36e133a78e836c",
|
"apps/desktop/tsconfig.json": "ee02ba8f2f257b86235cd3053e8d6fbfefd7c39e0807b4ea5e36e133a78e836c",
|
||||||
"apps/desktop/vite.docs-export.config.ts": "833bc2cbd99f9c0740cbc1584640458492bad75c9518db4d1ce0edd6958881ec"
|
"apps/desktop/vite.docs-export.config.ts": "833bc2cbd99f9c0740cbc1584640458492bad75c9518db4d1ce0edd6958881ec"
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -63,6 +63,9 @@ pub struct QueryPaginationExecutionPlan {
|
|||||||
#[serde(skip_serializing_if = "Option::is_none")]
|
#[serde(skip_serializing_if = "Option::is_none")]
|
||||||
pub exact_query_row_bound: Option<usize>,
|
pub exact_query_row_bound: Option<usize>,
|
||||||
pub use_agent_result_session: bool,
|
pub use_agent_result_session: bool,
|
||||||
|
/// Trailing helper column added by DBX's ROWNUM pagination wrapper.
|
||||||
|
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||||
|
pub pagination_row_number_column: Option<String>,
|
||||||
/// True when the statement cannot be paginated server-side and must be
|
/// True when the statement cannot be paginated server-side and must be
|
||||||
/// executed once with the whole result streamed back (single execution).
|
/// executed once with the whole result streamed back (single execution).
|
||||||
/// Only meaningful to in-process callers (query-result export); never
|
/// Only meaningful to in-process callers (query-result export); never
|
||||||
@@ -149,6 +152,7 @@ pub fn build_query_pagination_execution_plan(
|
|||||||
count_sql: None,
|
count_sql: None,
|
||||||
exact_query_row_bound,
|
exact_query_row_bound,
|
||||||
use_agent_result_session: false,
|
use_agent_result_session: false,
|
||||||
|
pagination_row_number_column: None,
|
||||||
single_execution: false,
|
single_execution: false,
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -175,16 +179,27 @@ pub fn build_query_pagination_execution_plan(
|
|||||||
return plan;
|
return plan;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Existing top-level ROWNUM predicates/projections cannot be wrapped without
|
||||||
|
// changing their semantics. Keep one cursor so later pages advance it.
|
||||||
|
if options.database_type == Some(DatabaseType::OceanbaseOracle)
|
||||||
|
&& options.use_agent_cursor
|
||||||
|
&& has_top_level_rownum(&options.sql)
|
||||||
|
{
|
||||||
|
plan.page_limit = Some(options.pagination.limit);
|
||||||
|
plan.page_offset = Some(options.pagination.offset);
|
||||||
|
plan.use_agent_result_session = true;
|
||||||
|
return plan;
|
||||||
|
}
|
||||||
|
|
||||||
let can_use_first_page_cursor = options.use_agent_cursor && options.pagination.offset == 0;
|
let can_use_first_page_cursor = options.use_agent_cursor && options.pagination.offset == 0;
|
||||||
// HighGo's PostgreSQL-compatible JDBC driver can buffer an unbounded result
|
// HighGo and OceanBase Oracle can spend substantially more time executing
|
||||||
// before the Agent has a chance to expose its cursor page. Prefer an actual
|
// an unbounded query before the Agent exposes its first cursor page. Prefer
|
||||||
// LIMIT/OFFSET query whenever it can be rewritten safely. For an unordered
|
// a bounded SQL query whenever it can be rewritten safely. Independent
|
||||||
// query, independent pages are not guaranteed to preserve row order; this is
|
// pages of an unordered query do not have a stable row order; callers
|
||||||
// an intentional tradeoff to keep HighGo execution bounded. Kingbase keeps
|
// should add ORDER BY when that matters.
|
||||||
// the cursor for unordered queries because separate executions may not
|
// Kingbase keeps the cursor for unordered queries to preserve its behavior.
|
||||||
// preserve row order there.
|
|
||||||
let prefer_server_pagination = match options.database_type {
|
let prefer_server_pagination = match options.database_type {
|
||||||
Some(DatabaseType::Highgo) => true,
|
Some(DatabaseType::Highgo | DatabaseType::OceanbaseOracle) => true,
|
||||||
Some(DatabaseType::Kingbase) => kingbase_server_pagination_is_stable(&options.query_base_sql),
|
Some(DatabaseType::Kingbase) => kingbase_server_pagination_is_stable(&options.query_base_sql),
|
||||||
_ => false,
|
_ => false,
|
||||||
};
|
};
|
||||||
@@ -209,6 +224,15 @@ pub fn build_query_pagination_execution_plan(
|
|||||||
plan.page_sql = paginated.sql;
|
plan.page_sql = paginated.sql;
|
||||||
plan.page_limit = Some(options.pagination.limit);
|
plan.page_limit = Some(options.pagination.limit);
|
||||||
plan.page_offset = Some(options.pagination.offset);
|
plan.page_offset = Some(options.pagination.offset);
|
||||||
|
if options.pagination.offset > 0
|
||||||
|
&& pagination_strategy(options.database_type, PaginationContext::UserQuery)
|
||||||
|
== TablePaginationStrategy::Rownum
|
||||||
|
&& !has_top_level_rownum(&options.sql)
|
||||||
|
{
|
||||||
|
plan.pagination_row_number_column = single_selectable_statement(&options.sql, options.database_type)
|
||||||
|
.ok()
|
||||||
|
.map(|statement| rownum_pagination_column_name(&statement));
|
||||||
|
}
|
||||||
if options.use_agent_cursor
|
if options.use_agent_cursor
|
||||||
&& matches!(
|
&& matches!(
|
||||||
pagination_strategy(options.database_type, PaginationContext::UserQuery),
|
pagination_strategy(options.database_type, PaginationContext::UserQuery),
|
||||||
@@ -1858,12 +1882,25 @@ fn add_rownum_limit(statement: &str, limit: usize, offset: usize) -> String {
|
|||||||
return derived_table_sql("SELECT * FROM", statement, &format!("WHERE ROWNUM <= {limit};"));
|
return derived_table_sql("SELECT * FROM", statement, &format!("WHERE ROWNUM <= {limit};"));
|
||||||
}
|
}
|
||||||
let end = offset + limit;
|
let end = offset + limit;
|
||||||
|
let column = rownum_pagination_column_name(statement);
|
||||||
let inner = derived_table_sql(
|
let inner = derived_table_sql(
|
||||||
"SELECT dbx_inner.*, ROWNUM AS \"__dbx_row_num\" FROM",
|
&format!("SELECT dbx_inner.*, ROWNUM AS \"{column}\" FROM"),
|
||||||
statement,
|
statement,
|
||||||
&format!("dbx_inner WHERE ROWNUM <= {end}"),
|
&format!("dbx_inner WHERE ROWNUM <= {end}"),
|
||||||
);
|
);
|
||||||
format!("SELECT * FROM ({inner}) WHERE \"__dbx_row_num\" > {offset};")
|
format!("SELECT * FROM ({inner}) WHERE \"{column}\" > {offset};")
|
||||||
|
}
|
||||||
|
|
||||||
|
fn rownum_pagination_column_name(statement: &str) -> String {
|
||||||
|
let sql = statement.to_ascii_lowercase();
|
||||||
|
let base = "__dbx_row_num";
|
||||||
|
let mut column = base.to_string();
|
||||||
|
let mut suffix = 0;
|
||||||
|
while sql.contains(&column) {
|
||||||
|
suffix += 1;
|
||||||
|
column = format!("{base}_{suffix}");
|
||||||
|
}
|
||||||
|
column
|
||||||
}
|
}
|
||||||
|
|
||||||
fn add_standard_limit(
|
fn add_standard_limit(
|
||||||
@@ -4701,6 +4738,87 @@ WHERE u.id = picked.id;
|
|||||||
assert!(!second_page.use_agent_result_session);
|
assert!(!second_page.use_agent_result_session);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn oceanbase_oracle_prefers_bounded_first_page_and_keeps_cursor_fallback() {
|
||||||
|
let sql = "SELECT * FROM events";
|
||||||
|
let first_page = build_query_pagination_execution_plan(QueryPaginationExecutionPlanOptions {
|
||||||
|
sql: sql.to_string(),
|
||||||
|
query_base_sql: sql.to_string(),
|
||||||
|
database_type: Some(DatabaseType::OceanbaseOracle),
|
||||||
|
pagination: QueryPagination { limit: 500, offset: 0, session_id: None },
|
||||||
|
use_agent_cursor: true,
|
||||||
|
first_page_uses_actual_sql: false,
|
||||||
|
});
|
||||||
|
assert_eq!(first_page.sql_to_execute, "SELECT * FROM (SELECT * FROM events) WHERE ROWNUM <= 500;");
|
||||||
|
assert_eq!(first_page.page_sql.as_deref(), Some(first_page.sql_to_execute.as_str()));
|
||||||
|
assert_eq!(first_page.page_limit, Some(500));
|
||||||
|
assert_eq!(first_page.page_offset, Some(0));
|
||||||
|
assert!(!first_page.use_agent_result_session);
|
||||||
|
assert!(first_page.count_sql.is_some());
|
||||||
|
assert!(first_page.pagination_row_number_column.is_none());
|
||||||
|
|
||||||
|
let next_page = build_query_pagination_execution_plan(QueryPaginationExecutionPlanOptions {
|
||||||
|
sql: sql.to_string(),
|
||||||
|
query_base_sql: sql.to_string(),
|
||||||
|
database_type: Some(DatabaseType::OceanbaseOracle),
|
||||||
|
pagination: QueryPagination { limit: 500, offset: 500, session_id: None },
|
||||||
|
use_agent_cursor: true,
|
||||||
|
first_page_uses_actual_sql: false,
|
||||||
|
});
|
||||||
|
assert!(next_page.sql_to_execute.contains("ROWNUM <= 1000"));
|
||||||
|
assert!(next_page.sql_to_execute.contains("\"__dbx_row_num\" > 500"));
|
||||||
|
assert_eq!(next_page.page_sql.as_deref(), Some(next_page.sql_to_execute.as_str()));
|
||||||
|
assert!(!next_page.use_agent_result_session);
|
||||||
|
assert_eq!(next_page.pagination_row_number_column.as_deref(), Some("__dbx_row_num"));
|
||||||
|
|
||||||
|
let unrewritable = "SELECT * FROM events; SELECT 1";
|
||||||
|
let fallback = build_query_pagination_execution_plan(QueryPaginationExecutionPlanOptions {
|
||||||
|
sql: unrewritable.to_string(),
|
||||||
|
query_base_sql: unrewritable.to_string(),
|
||||||
|
database_type: Some(DatabaseType::OceanbaseOracle),
|
||||||
|
pagination: QueryPagination { limit: 500, offset: 0, session_id: None },
|
||||||
|
use_agent_cursor: true,
|
||||||
|
first_page_uses_actual_sql: false,
|
||||||
|
});
|
||||||
|
assert_eq!(fallback.sql_to_execute, unrewritable);
|
||||||
|
assert!(fallback.page_sql.is_none());
|
||||||
|
assert!(fallback.use_agent_result_session);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn rownum_helper_avoids_names_in_the_original_query() {
|
||||||
|
let sql = "SELECT LEVEL AS \"__dbx_row_num\" FROM DUAL CONNECT BY LEVEL <= 10";
|
||||||
|
let plan = build_query_pagination_execution_plan(QueryPaginationExecutionPlanOptions {
|
||||||
|
sql: sql.to_string(),
|
||||||
|
query_base_sql: sql.to_string(),
|
||||||
|
database_type: Some(DatabaseType::OceanbaseOracle),
|
||||||
|
pagination: QueryPagination { limit: 5, offset: 5, session_id: None },
|
||||||
|
use_agent_cursor: true,
|
||||||
|
first_page_uses_actual_sql: false,
|
||||||
|
});
|
||||||
|
assert_eq!(plan.pagination_row_number_column.as_deref(), Some("__dbx_row_num_1"));
|
||||||
|
assert!(plan.sql_to_execute.contains("ROWNUM AS \"__dbx_row_num_1\""));
|
||||||
|
assert!(plan.sql_to_execute.contains("WHERE \"__dbx_row_num_1\" > 5"));
|
||||||
|
assert!(plan.sql_to_execute.contains(sql));
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn existing_rownum_keeps_a_cursor_and_does_not_mark_a_user_column_as_generated() {
|
||||||
|
let sql = "SELECT ROWNUM AS \"__dbx_row_num\", name FROM events WHERE ROWNUM <= 1000";
|
||||||
|
let plan = build_query_pagination_execution_plan(QueryPaginationExecutionPlanOptions {
|
||||||
|
sql: sql.to_string(),
|
||||||
|
query_base_sql: sql.to_string(),
|
||||||
|
database_type: Some(DatabaseType::OceanbaseOracle),
|
||||||
|
pagination: QueryPagination { limit: 500, offset: 500, session_id: None },
|
||||||
|
use_agent_cursor: true,
|
||||||
|
first_page_uses_actual_sql: false,
|
||||||
|
});
|
||||||
|
assert!(plan.pagination_row_number_column.is_none());
|
||||||
|
assert!(plan.use_agent_result_session);
|
||||||
|
assert_eq!(plan.page_offset, Some(500));
|
||||||
|
assert_eq!(plan.sql_to_execute, sql);
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn highgo_avoids_agent_cursor_for_unrewritable_queries() {
|
fn highgo_avoids_agent_cursor_for_unrewritable_queries() {
|
||||||
let sql = "SELECT * FROM events; SELECT 1";
|
let sql = "SELECT * FROM events; SELECT 1";
|
||||||
|
|||||||
Reference in new issue
Block a user