Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

feat(oracle): add object relationships to table properties

efeirec0f87a61116d
diff --git a/apps/desktop/src/App.vue b/apps/desktop/src/App.vue
index f2d24e150a..1ad13d2e58 100644
--- a/apps/desktop/src/App.vue
+++ b/apps/desktop/src/App.vue
@@ -3445,6 +3445,12 @@ function tableTargetFromActiveTab(table: string | SqlObjectNavigationTarget, con
}
async function onClickTable(table: SqlObjectNavigationTarget, context?: SqlObjectNavigationContext) {
+ if (table.type === "index") {
+ const origin = context ?? activeTab.value;
+ if (!origin || !table.parentName || !table.parentSchema || !table.schema) return;
+ queryStore.openObjectProperties({ connectionId: origin.connectionId, database: origin.database, catalog: origin.catalog, schema: table.parentSchema, name: table.parentName, objectType: "TABLE", initialTab: "indexes", focusObject: { owner: table.schema, name: table.name, type: "INDEX" } });
+ return;
+ }
// Procedures/functions/packages open source (same as sidebar view-source), not table data/DDL.
if (isSqlObjectNavigationRoutineType(table.type)) {
await onOpenObjectSource(table, false, context);
diff --git a/apps/desktop/src/components/grid/DataGrid.vue b/apps/desktop/src/components/grid/DataGrid.vue
index e936052b47..adca21d73a 100644
--- a/apps/desktop/src/components/grid/DataGrid.vue
+++ b/apps/desktop/src/components/grid/DataGrid.vue
@@ -105,6 +105,9 @@ import DataGridCellDetailHexViewer from "@/components/grid/DataGridCellDetailHex
import TemporalCellEditor from "@/components/grid/TemporalCellEditor.vue";
import EnumCellEditor from "@/components/grid/EnumCellEditor.vue";
import DataGridReadonlyTextSelection from "@/components/grid/DataGridReadonlyTextSelection.vue";
+import ObjectDependenciesPanel from "@/components/objects/ObjectDependenciesPanel.vue";
+import { objectDependencyTarget, type ObjectDependencyTarget, type ObjectDetailsSection } from "@/lib/database/objectDependencyDetails";
+import type { SqlObjectNavigationTarget } from "@/lib/sql/sqlNavigation";
import GridSnapshotDialog from "@/components/grid/GridSnapshotDialog.vue";
import type { QueryResult, ColumnInfo, ConstraintInfo, DatabaseType, ForeignKeyInfo, IndexInfo, ObjectStatistics, PgTablePartitioning, TriggerInfo, TableInfoTab, QueryResultSourceColumnRef, QueryPageJumpProgress } from "@/types/database";
import { isQueryExecutionErrorResult } from "@/lib/query/queryResultError";
@@ -733,6 +736,7 @@ const emit = defineEmits<{
"local-column-filters-change": [value: Record<string, string[]>];
changeQueryTimeout: [connectionId: string];
cancel: [];
+ openDependencyObject: [context: ObjectDependencyTarget, target: SqlObjectNavigationTarget];
}>();
const autoRefresh = useDataGridAutoRefresh({
@@ -861,6 +865,16 @@ const columnTypeMap = computed(() => {
});
const resolvedConnectionConfig = computed(() => connectionStore.getConfig(props.connectionId ?? ""));
const resolvedDatabaseType = computed(() => props.databaseType ?? effectiveDatabaseTypeForConnection(resolvedConnectionConfig.value));
+const tableRelationsSection = ref<ObjectDetailsSection>("dependencies");
+const tableDependencyTarget = computed(() => {
+ const metadata = props.tableMeta;
+ const database = metadata?.database || props.database;
+ if (!metadata?.tableName || !props.connectionId || !database) return undefined;
+ return objectDependencyTarget({ connectionId: props.connectionId, database, catalog: metadata.catalog, schema: metadata.schema || props.schema || database, name: metadata.tableName, objectType: (metadata.tableType || "TABLE").toUpperCase().replaceAll(" ", "_") }, resolvedDatabaseType.value);
+});
+function viewRelationSql(context: ObjectDependencyTarget, sql: string) {
+ queryStore.createTab(context.connectionId, context.database, t("objectDependencies.viewSql"), "query", context.schema, sql, context.catalog, { forceNew: true });
+}
const productionContext = computed(() => productionContextForDatabase(resolvedConnectionConfig.value, props.database));
// The collection grid and Mongo query-result grids share the document-grid value
// encoding (BSON null sentinel + JSON-prefixed containers), so every display,
@@ -13087,6 +13101,7 @@ const tableInfoTabs = computed(() => {
count: partitioning.value?.partitions.length,
});
}
+ if (tableDependencyTarget.value) tabs.push({ id: "relations", label: t("objectRelations.title"), icon: Network });
return tabs;
});
const tableInfoTabListStyle = computed(() => ({
@@ -13113,7 +13128,7 @@ async function selectTableInfoTab(tab: TableInfoTab) {
// The drawer is often opened after the table was already selected, so the
// partition status may never have been probed; do it here (once) before the
// tab list is consulted, or the Partitions tab would be missing entirely.
- if (!partitionStatusResolved.value) await probeTablePartitionStatus();
+ if (tab !== "relations" && !partitionStatusResolved.value) await probeTablePartitionStatus();
const tabSupported = tableInfoTabs.value.some((item) => item.id === tab);
const nextTab = tabSupported ? tab : tableInfoTabs.value[0]?.id;
if (!nextTab) return;
@@ -13520,7 +13535,7 @@ function copyDdl() {
function openTableStructureEditor(initialTab: TableInfoTab = "columns"): boolean {
if (!props.connectionId || !props.database || !props.tableMeta?.tableName || !canOpenTableStructureEditor.value) return false;
- queryStore.openTableStructure(props.connectionId, props.database, props.tableMeta.schema, props.tableMeta.tableName, initialTab, undefined, props.tableMeta.catalog, (props.tableMeta.tableType || "").toUpperCase() === "VIEW" ? "view" : "table");
+ queryStore.openTableStructure(props.connectionId, props.database, props.tableMeta.schema, props.tableMeta.tableName, initialTab === "relations" ? "columns" : initialTab, undefined, props.tableMeta.catalog, (props.tableMeta.tableType || "").toUpperCase() === "VIEW" ? "view" : "table");
return true;
}
@@ -16389,7 +16404,7 @@ useUpdateBlocker(() => (hasPendingChanges.value || hasPendingDataEditorDraft.val
</button>
</div>
- <div class="px-2 py-1.5 border-b shrink-0 bg-background">
+ <div v-if="activeTableInfoTab !== 'relations'" class="px-2 py-1.5 border-b shrink-0 bg-background">
<div class="flex min-w-0 items-center gap-1">
<div class="relative min-w-0 flex-1">
<Search class="absolute left-2 top-1/2 -translate-y-1/2 w-3.5 h-3.5 text-muted-foreground" />
@@ -16415,8 +16430,9 @@ useUpdateBlocker(() => (hasPendingChanges.value || hasPendingDataEditorDraft.val
</div>
</div>
+ <ObjectDependenciesPanel v-if="activeTableInfoTab === 'relations'" :target="tableDependencyTarget" v-model:section="tableRelationsSection" :include-source="false" @view-sql="viewRelationSql" @open-object="(context, target) => emit('openDependencyObject', context, target)" />
<DataGridTableInfoPanels
- v-if="activeTableInfoTab !== 'ddl'"
+ v-else-if="activeTableInfoTab !== 'ddl'"
:active-tab="activeTableInfoTab"
:search-query="searchQuery"
:table-name="props.tableMeta?.tableName ?? ''"
diff --git a/apps/desktop/src/components/grid/__tests__/DataGridEditTableStructureShortcut.spec.ts b/apps/desktop/src/components/grid/__tests__/DataGridEditTableStructureShortcut.spec.ts
index 717ed4fa9e..0f0c3e97e1 100644
--- a/apps/desktop/src/components/grid/__tests__/DataGridEditTableStructureShortcut.spec.ts
+++ b/apps/desktop/src/components/grid/__tests__/DataGridEditTableStructureShortcut.spec.ts
@@ -29,6 +29,16 @@ import { useQueryStore } from "@/stores/queryStore";
import { useSettingsStore } from "@/stores/settingsStore";
const mountedApps: Array<{ app: App; host: HTMLElement }> = [];
+const backend = vi.hoisted(() => ({
+ executeQuery: vi.fn(),
+ cancelQuery: vi.fn(async () => true),
+ checkConnectionHealth: vi.fn(async () => undefined),
+ getTableOwner: vi.fn(async () => undefined),
+ getTablePartitionStatus: vi.fn(async () => ({ isPartitionedParent: false, isPartition: false })),
+ listTriggers: vi.fn(async () => []),
+}));
+vi.mock("@/lib/backend/api", async (original) => ({ ...(await original<typeof import("@/lib/backend/api")>()), ...backend }));
+import { useConnectionStore } from "@/stores/connectionStore";
const RecycleScroller = defineComponent({
props: {
@@ -79,6 +89,12 @@ function mountGrid(
},
});
const queryStore = useQueryStore();
+ if (options.databaseType === "oracle" || options.databaseType === "oceanbase-oracle") {
+ const connections = useConnectionStore();
+ connections.addEphemeralConnection({ id: options.connectionId ?? "connection-1", name: "Relations", db_type: options.databaseType, host: "localhost", port: 1, username: "test", password: "" });
+ connections.connectedIds.add(options.connectionId ?? "connection-1");
+ }
+ const onOpenDependencyObject = vi.fn();
const openTableStructure = vi.spyOn(queryStore, "openTableStructure").mockImplementation(() => "structure-tab");
const result = markRaw<QueryResult>({
columns: ["id"],
@@ -114,6 +130,7 @@ function mountGrid(
database: options.database ?? "app",
tableMeta: options.tableMeta === null ? undefined : (options.tableMeta ?? defaultTableMeta),
autoShowTableInfo: options.autoShowTableInfo ?? false,
+ onOpenDependencyObject,
}),
},
);
@@ -125,7 +142,7 @@ function mountGrid(
app.component("RecycleScroller", RecycleScroller);
app.mount(host);
mountedApps.push({ app, host });
- return { host, openTableStructure, grid };
+ return { host, openTableStructure, grid, onOpenDependencyObject };
}
async function settle() {
@@ -155,6 +172,31 @@ afterEach(() => {
});
describe("DataGrid edit-table-structure shortcut", () => {
+ it("opens captured table relations in the real drawer and keeps the edit action on a supported structure tab", async () => {
+ backend.executeQuery.mockResolvedValue({
+ columns: ["DIRECTION", "OBJECT_OWNER", "OBJECT_NAME", "OBJECT_TYPE", "REFERENCED_OWNER", "REFERENCED_NAME", "REFERENCED_TYPE", "DEPENDENCY_TYPE", "REFERENCED_LINK_NAME"],
+ rows: [["REFERENCED_BY", "Other.Owner", "Uses.Table", "FUNCTION", "Captured.Schema", "Mixed.Table", "TABLE", "HARD", null]],
+ affected_rows: 0,
+ execution_time_ms: 1,
+ });
+ const { host, grid, openTableStructure, onOpenDependencyObject } = mountGrid({
+ databaseType: "oceanbase-oracle",
+ database: "Captured.Database",
+ tableInfoTab: "relations",
+ autoShowTableInfo: true,
+ tableMeta: { schema: "Captured.Schema", catalog: "Captured.Catalog", tableName: "Mixed.Table", columns: [], primaryKeys: [] },
+ });
+ await vi.waitFor(() => expect(backend.executeQuery).toHaveBeenCalled());
+ expect(backend.executeQuery.mock.calls.at(-1)).toEqual(["connection-1", "Captured.Database", expect.stringContaining("ALL_DEPENDENCIES"), "Captured.Schema", expect.any(String), { catalog: "Captured.Catalog" }]);
+ expect(host.querySelector('[data-object-section="source"]')).toBeNull();
+ host.querySelector<HTMLButtonElement>('[data-object-section="dependents"]')!.click();
+ await vi.waitFor(() => expect([...host.querySelectorAll("button")].some((button) => button.textContent?.trim() === "Uses.Table")).toBe(true));
+ [...host.querySelectorAll("button")].find((button) => button.textContent?.trim() === "Uses.Table")!.click();
+ expect(onOpenDependencyObject).toHaveBeenCalledWith(expect.objectContaining({ connectionId: "connection-1", database: "Captured.Database", schema: "Captured.Schema", catalog: "Captured.Catalog" }), expect.objectContaining({ name: "Uses.Table", schema: "Other.Owner", type: "function" }));
+ expect(grid.value!.openTableStructureEditor("relations")).toBe(true);
+ expect(openTableStructure).toHaveBeenLastCalledWith("connection-1", "Captured.Database", "Captured.Schema", "Mixed.Table", "columns", undefined, "Captured.Catalog", "table");
+ });
+
it("exposes columns navigation to the table header even when the information drawer is closed", async () => {
const { host, openTableStructure, grid } = mountGrid({ tableInfoTab: "indexes" });
await settle();
diff --git a/apps/desktop/src/components/layout/ContentArea.vue b/apps/desktop/src/components/layout/ContentArea.vue
index 89f758d76c..1c3c271b55 100644
--- a/apps/desktop/src/components/layout/ContentArea.vue
+++ b/apps/desktop/src/components/layout/ContentArea.vue
@@ -2831,6 +2831,7 @@ defineExpose({
<DataGrid
v-else-if="activeTab.result && hasTabularResult && (!activeTab.isExecuting || !isQueryExecutionErrorResult(activeTab.result))"
ref="dataGridRef"
+ @open-dependency-object="(context, target) => emit('openDependencyObject', context, target)"
:key="activeResultGridInstanceKey"
:cache-key="activeResultGridCacheKey"
:column-width-cache-key="activeResultGridColumnWidthCacheKey"
@@ -3379,6 +3380,7 @@ defineExpose({
<DataGrid
v-if="activeTab.result && (!activeTab.isExecuting || !isQueryExecutionErrorResult(activeTab.result))"
ref="dataGridRef"
+ @open-dependency-object="(context, target) => emit('openDependencyObject', context, target)"
class="flex-1 min-h-0"
:key="activeTab.id"
:cache-key="activeTab.id"
@@ -3693,6 +3695,13 @@ defineExpose({
:selected-object-filter="activeTab.objectBrowser?.filter"
:initial-search-query="activeTab.objectBrowser?.searchQuery"
:viewport="activeTab.objectBrowser?.viewport"
+ :property-request="activeTab.objectPropertiesRequest"
+ @property-request-consumed="
+ (id) => {
+ if (activeTab.objectPropertiesRequest?.requestId === id) activeTab.objectPropertiesRequest = undefined;
+ }
+ "
+ @open-dependency-object="(context, target) => emit('openDependencyObject', context, target)"
@open-table="emit('openObjectTable', activeTab.id, $event)"
@locate-table="onLocateObjectTable"
@schema-change="emit('objectSchemaChange', activeTab.id, $event)"
diff --git a/apps/desktop/src/components/objects/ObjectBrowser.vue b/apps/desktop/src/components/objects/ObjectBrowser.vue
index bc947806ea..34d098cf5c 100644
--- a/apps/desktop/src/components/objects/ObjectBrowser.vue
+++ b/apps/desktop/src/components/objects/ObjectBrowser.vue
@@ -81,6 +81,10 @@ import CustomTypeInfoPanel from "@/components/objects/CustomTypeInfoPanel.vue";
import TablePartitionsPanel from "@/components/structure/TablePartitionsPanel.vue";
import XlsxHeaderDialog from "@/components/export/XlsxHeaderDialog.vue";
import * as api from "@/lib/backend/api";
+import ObjectDependenciesPanel from "@/components/objects/ObjectDependenciesPanel.vue";
+import { objectDependencyTarget, type ObjectDependencyTarget, type ObjectDetailsSection } from "@/lib/database/objectDependencyDetails";
+import type { SqlObjectNavigationTarget } from "@/lib/sql/sqlNavigation";
+import type { QueryTab } from "@/types/database";
import type { ColumnInfo, ConnectionConfig, ConstraintInfo, ForeignKeyInfo, IndexInfo, ObjectBrowserViewMode, ObjectBrowserViewport, ObjectInfo, ObjectSourceKind, ObjectStatistics, PgTablePartitioning, SchemaIndexIdentity, TableInfoTab, TreeNode, TriggerInfo } from "@/types/database";
import { sortTablesByFkDependency, type TableWithFk } from "@/lib/table/tableDependencySort";
import { isSchemaAware, supportsTableVacuum, supportsTransfer } from "@/lib/database/databaseCapabilities";
@@ -229,6 +233,7 @@ const props = defineProps<{
selectedObjectFilter?: ObjectFilter;
initialSearchQuery?: string;
viewport?: ObjectBrowserViewport;
+ propertyRequest?: QueryTab["objectPropertiesRequest"];
}>();
const emit = defineEmits<{
@@ -240,6 +245,8 @@ const emit = defineEmits<{
filterChange: [filter: ObjectFilter];
indexRequestConsumed: [kind: "create" | "view"];
addToAi: [tables: Array<{ name: string; schema?: string }>];
+ openDependencyObject: [context: ObjectDependencyTarget, target: SqlObjectNavigationTarget];
+ propertyRequestConsumed: [requestId: string];
}>();
const { t } = useI18n();
@@ -366,6 +373,22 @@ const sidePanelGuard = createSidePanelRequestGuard();
const sidePanelRef = ref<InstanceType<typeof CustomTypeInfoPanel> | null>(null);
const tableMetadataCapabilities = computed<TableMetadataCapabilities>(() => getTableMetadataCapabilities(effectiveDatabaseType.value, { connectionType: props.connection.db_type, exactIdentity: sidePanelRow.value?.type === "INDEX" }));
const effectiveDatabaseType = computed(() => effectiveDatabaseTypeForConnection(props.connection) ?? props.connection.db_type);
+const sourceSection = ref<ObjectDetailsSection>("source");
+const tableRelationsSection = ref<ObjectDetailsSection>("dependencies");
+const propertyFocus = ref<NonNullable<QueryTab["objectPropertiesRequest"]>["focusObject"]>();
+const dependencyTarget = computed(() => {
+ const row = sidePanelRow.value;
+ if (row && sidePanelMode.value === "table-info" && propertyFocus.value)
+ return objectDependencyTarget({ connectionId: props.connection.id, database: props.database, catalog: props.catalog, schema: propertyFocus.value.owner, name: propertyFocus.value.name, objectType: propertyFocus.value.type }, effectiveDatabaseType.value);
+ return row ? objectDependencyTarget({ connectionId: props.connection.id, database: props.database, catalog: props.catalog, schema: row.schema || selectedSchema.value || props.database, name: row.name, objectType: row.type }, effectiveDatabaseType.value) : undefined;
+});
+function viewRelationSql(context: ObjectDependencyTarget, sql: string) {
+ queryStore.createTab(context.connectionId, context.database, t("objectDependencies.viewSql"), "query", context.schema, sql, context.catalog, { forceNew: true });
+}
+function openRelationObject(context: ObjectDependencyTarget, target: SqlObjectNavigationTarget) {
+ if (sidePanelMode.value === "source" && sourceEditing.value && sourceDraft.value !== sourceEditableText.value && !window.confirm(t("objectDependencies.navigateDiscardConfirm"))) return;
+ emit("openDependencyObject", context, target);
+}
const oracleInvalidObjectsSupported = computed(() => effectiveDatabaseType.value === "oracle" || effectiveDatabaseType.value === "oceanbase-oracle");
const supportsSchemaIndexes = computed(() => supportsSchemaIndexManagement(effectiveDatabaseType.value));
const exactIndexList = computed(() => supportsSchemaIndexes.value && objectFilter.value === "indexes");
@@ -1293,7 +1316,8 @@ const tableInfoTabs = computed<TableInfoTabItem[]>(() => {
if (tableMetadataCapabilities.value.partitions && tableIsPartitioned.value) {
tabs.push({ id: "partitions", label: t("structureEditor.partitions"), icon: Network, count: tablePartitions.value?.partitions.length });
}
- return sidePanelRow.value?.type === "INDEX" ? tabs.filter((tab) => ["info", "ddl", "columns", "indexes"].includes(tab.id)) : tabs;
+ if (dependencyTarget.value) tabs.push({ id: "relations", label: t("objectRelations.title"), icon: Network });
+ return sidePanelRow.value?.type === "INDEX" ? tabs.filter((tab) => ["info", "ddl", "columns", "indexes", "relations"].includes(tab.id)) : tabs;
});
const tableInfoTabListStyle = computed(() => ({
@@ -1435,7 +1459,7 @@ const filteredTableDdlContent = computed(() => {
});
});
-async function openTableInfo(row: ObjectBrowserRow, initialTab?: TableInfoTab) {
+async function openTableInfo(row: ObjectBrowserRow, initialTab?: TableInfoTab, focusObject?: NonNullable<QueryTab["objectPropertiesRequest"]>["focusObject"]) {
if (row.type === "INDEX" && (!supportsSchemaIndexes.value || !schemaIndexIdentity(row))) {
toast(t("schemaIndex.parentUnavailable"), 4000);
return;
@@ -1452,6 +1476,7 @@ async function openTableInfo(row: ObjectBrowserRow, initialTab?: TableInfoTab) {
}
sidePanelRow.value = row;
sidePanelMode.value = "table-info";
+ propertyFocus.value = focusObject;
sourceRow.value = null;
const epoch = sidePanelGuard.start();
// Reset state
@@ -1478,10 +1503,11 @@ async function openTableInfo(row: ObjectBrowserRow, initialTab?: TableInfoTab) {
tableTriggersLoaded.value = false;
tableConstraintsLoaded.value = false;
tableInfoSearchQuery.value = "";
+ tableRelationsSection.value = focusObject ? "ownership" : "dependencies";
// Determine initial tab: explicit request > previously activated. Resolve the
// partition status first so a persisted `partitions` tab is not rejected (and
// overwritten) before the probe lands.
- await probeTablePartitionStatus();
+ if (initialTab !== "relations") await probeTablePartitionStatus();
if (sidePanelGuard.isStale(epoch)) return;
const firstTab = initialTab ?? tableInfoTab.value;
await selectTableInfoTab(firstTab);
@@ -1491,7 +1517,7 @@ async function selectTableInfoTab(tab: TableInfoTab) {
const epoch = sidePanelGuard.capture();
// The panel can be re-selected (or restored) without `openTableInfo`, so make
// sure the partition status has been probed before the tab list is consulted.
- if (!tablePartitionStatusResolved.value) await probeTablePartitionStatus();
+ if (tab !== "relations" && !tablePartitionStatusResolved.value) await probeTablePartitionStatus();
if (sidePanelGuard.isStale(epoch)) return;
const nextTab = tableInfoTabs.value.some((item) => item.id === tab) ? tab : tableInfoTabs.value[0]?.id;
if (!nextTab) return;
@@ -1921,7 +1947,7 @@ const canOpenTableStructureEditor = computed(() => sidePanelRow.value?.type ===
function openTableStructureEditor() {
const row = sidePanelRow.value;
if (!row || row.type !== "TABLE" || !canOpenTableStructureEditor.value) return;
- queryStore.openTableStructure(props.connection.id, props.database, row.schema || selectedSchema.value, row.name, tableInfoTab.value, undefined, props.catalog);
+ queryStore.openTableStructure(props.connection.id, props.database, row.schema || selectedSchema.value, row.name, tableInfoTab.value === "relations" ? "columns" : tableInfoTab.value, undefined, props.catalog);
}
/**
@@ -2032,6 +2058,7 @@ async function openInvalidObjectSource(object: { owner: string; name: string; ty
let sourceIdentity: SourceIdentitySnapshot | undefined;
async function loadSourcePanel(row: ObjectBrowserRow, options?: { preserveEditing?: boolean }) {
+ sourceSection.value = "source";
selectedRowId.value = row.id;
// Starting a different object must invalidate slower source requests before
// any state is reset, otherwise an old response can populate the new row.
@@ -2103,6 +2130,19 @@ async function refreshActiveSource() {
await loadSourcePanel(row, { preserveEditing: true });
}
+async function openRequestedProperties() {
+ const request = props.propertyRequest;
+ if (!request || request.connectionId !== props.connection.id || request.database !== props.database || (request.catalog || "") !== (props.catalog || "") || request.schema !== (props.schema || props.database)) return;
+ if (sourceEditing.value && sourceDraft.value !== sourceEditableText.value && !window.confirm(t("objectDependencies.navigateDiscardConfirm"))) {
+ emit("propertyRequestConsumed", request.requestId);
+ return;
+ }
+ const row: ObjectBrowserRow = { id: JSON.stringify([request.objectType, request.schema, request.name]), name: request.name, displayName: request.name, schema: request.schema, type: request.objectType };
+ await openTableInfo(row, request.initialTab, request.focusObject);
+ if (props.propertyRequest?.requestId !== request.requestId) return;
+ emit("propertyRequestConsumed", request.requestId);
+}
+
function openEventEditor(row: ObjectBrowserRow) {
selectedRowId.value = row.id;
sidePanelGuard.start();
@@ -4774,6 +4814,7 @@ watch(
);
// ---- CustomContextMenu helpers ----
+watch(() => props.propertyRequest?.requestId, openRequestedProperties, { immediate: true, flush: "post" });
function exportDataSubmenu(item: ObjectBrowserRow): ContextMenuItem {
const formats: ContextMenuItem[] = [
@@ -5633,7 +5674,7 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
<span class="block truncate">{{ tab.label }}</span>
</button>
</div>
- <div class="flex items-center gap-1 px-2 py-1.5 border-b shrink-0 bg-background">
+ <div v-if="tableInfoTab !== 'relations'" class="flex items-center gap-1 px-2 py-1.5 border-b shrink-0 bg-background">
<div class="relative min-w-0 flex-1">
<Search class="absolute left-2 top-1/2 -translate-y-1/2 w-3.5 h-3.5 text-muted-foreground" />
<input v-model="tableInfoSearchQuery" data-table-info-search :placeholder="t('grid.tableInfoSearch')" class="w-full h-7 pl-7 pr-6 text-xs bg-muted/50 rounded border border-border focus:outline-none focus:border-primary/50" @keydown.escape="tableInfoSearchQuery = ''" />
@@ -5648,7 +5689,9 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
<div v-if="tableInfoTab === 'ddl' && effectiveDatabaseType === 'oceanbase-oracle'" class="border-b px-3 py-2">
<DdlStorageToggle :database-type="effectiveDatabaseType" :disabled="tableDdlLoading" />
</div>
- <div v-if="tableInfoTab === 'info'" class="flex-1 min-h-0 overflow-auto">
+ <p v-if="propertyFocus && (tableInfoTab === 'indexes' || tableInfoTab === 'relations')" class="break-all border-b px-3 py-2 font-mono text-sm text-muted-foreground">{{ propertyFocus.owner }}.{{ propertyFocus.name }}</p>
+ <ObjectDependenciesPanel v-if="tableInfoTab === 'relations'" :target="dependencyTarget" v-model:section="tableRelationsSection" :include-source="false" @view-sql="viewRelationSql" @open-object="openRelationObject" />
+ <div v-else-if="tableInfoTab === 'info'" class="flex-1 min-h-0 overflow-auto">
<div v-if="tableOverviewLoading" class="h-full flex items-center justify-center">
<Loader2 class="w-4 h-4 animate-spin text-muted-foreground" />
</div>
@@ -5835,35 +5878,56 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
<span v-if="sourceRow?.valid != null" class="shrink-0 rounded border px-1 py-px text-[10px] font-medium" :class="sourceRow.valid ? 'border-emerald-500/30 text-emerald-600' : 'border-destructive/30 text-destructive'">
{{ t(sourceRow.valid ? "objects.validStatus" : "objects.invalidStatus") }}
</span>
- <Button v-if="sourceEditing" variant="ghost" size="sm" class="h-6 px-2 text-xs" :disabled="sourceSaving || !sourceDraft.trim()" @click="saveSource">
- <Loader2 v-if="sourceSaving" class="mr-1 h-3 w-3 animate-spin" />
- {{ t("objects.saveSource") }}
- </Button>
- <Button v-if="sourceEditing" variant="ghost" size="sm" class="h-6 px-2 text-xs" :disabled="sourceSaving" @click="cancelEditSource">
- {{ t("objects.cancelEdit") }}
- </Button>
- <Button v-if="!sourceEditing" variant="ghost" size="icon" class="h-5 w-5" :disabled="!sourceContent" @click="copySource">
- <Copy class="h-3 w-3" />
- </Button>
- <Button v-if="!sourceEditing && sourceCanEdit" variant="ghost" size="icon" class="h-5 w-5" :disabled="!sourceContent" @click="editSource">
- <PencilLine class="h-3 w-3" />
- </Button>
- <Button variant="ghost" size="icon" class="h-5 w-5" :disabled="sourceLoading || sourceSaving" :title="t('structureEditor.refresh')" :aria-label="t('structureEditor.refresh')" @click="refreshActiveSource">
- <RefreshCw class="h-3 w-3" :class="{ 'animate-spin': sourceLoading }" />
- </Button>
+ <template v-if="sourceSection === 'source'">
+ <Button v-if="sourceEditing" variant="ghost" size="sm" class="h-6 px-2 text-xs" :disabled="sourceSaving || !sourceDraft.trim()" @click="saveSource">
+ <Loader2 v-if="sourceSaving" class="mr-1 h-3 w-3 animate-spin" />
+ {{ t("objects.saveSource") }}
+ </Button>
+ <Button v-if="sourceEditing" variant="ghost" size="sm" class="h-6 px-2 text-xs" :disabled="sourceSaving" @click="cancelEditSource">
+ {{ t("objects.cancelEdit") }}
+ </Button>
+ <Button v-if="!sourceEditing" variant="ghost" size="icon" class="h-5 w-5" :disabled="!sourceContent" @click="copySource">
+ <Copy class="h-3 w-3" />
+ </Button>
+ <Button v-if="!sourceEditing && sourceCanEdit" variant="ghost" size="icon" class="h-5 w-5" :disabled="!sourceContent" @click="editSource">
+ <PencilLine class="h-3 w-3" />
+ </Button>
+ <Button variant="ghost" size="icon" class="h-5 w-5" :disabled="sourceLoading || sourceSaving" :title="t('structureEditor.refresh')" :aria-label="t('structureEditor.refresh')" @click="refreshActiveSource">
+ <RefreshCw class="h-3 w-3" :class="{ 'animate-spin': sourceLoading }" />
+ </Button>
+ </template>
<Button variant="ghost" size="icon" class="h-5 w-5" @click="closeSource">
<X class="h-3 w-3" />
</Button>
</div>
- <div v-if="sourceLoading" class="flex flex-1 items-center justify-center">
- <Loader2 class="h-4 w-4 animate-spin text-muted-foreground" />
- </div>
- <div v-else-if="sourceError" class="flex flex-1 items-center justify-center px-4 text-sm text-destructive">
- {{ sourceError }}
- </div>
- <div v-else-if="sourceEditing" class="flex min-h-0 flex-1 flex-col" data-object-source-editor>
+ <ObjectDependenciesPanel :target="dependencyTarget" v-model:section="sourceSection" @view-sql="viewRelationSql" @open-object="openRelationObject">
+ <div v-if="sourceLoading" class="flex flex-1 items-center justify-center">
+ <Loader2 class="h-4 w-4 animate-spin text-muted-foreground" />
+ </div>
+ <div v-else-if="sourceError" class="flex flex-1 items-center justify-center px-4 text-sm text-destructive">
+ {{ sourceError }}
+ </div>
+ <div v-else-if="sourceEditing" class="flex min-h-0 flex-1 flex-col" data-object-source-editor>
+ <QueryEditor
+ v-model="sourceDraft"
+ class="min-h-0 flex-1"
+ :connection-id="props.connection.id"
+ :database="props.database"
+ :schema="selectedSchema"
+ :database-type="props.connection.db_type"
+ :dialect="sourceDialect"
+ :format-dialect="sourceFormatDialect"
+ force-word-wrap
+ @save="sourceSection === 'source' && saveSource()"
+ />
+ <div v-if="sourceSaveError" class="shrink-0 whitespace-pre-wrap break-words border-t px-3 py-2 text-xs text-destructive">
+ {{ sourceSaveError }}
+ </div>
+ </div>
<QueryEditor
- v-model="sourceDraft"
+ v-else
+ :key="`source-preview-${sourceRow?.id}`"
+ :model-value="sourceContent"
class="min-h-0 flex-1"
:connection-id="props.connection.id"
:database="props.database"
@@ -5872,27 +5936,10 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
:dialect="sourceDialect"
:format-dialect="sourceFormatDialect"
force-word-wrap
- @save="saveSource"
+ read-only
+ data-object-source-preview
/>
- <div v-if="sourceSaveError" class="shrink-0 whitespace-pre-wrap break-words border-t px-3 py-2 text-xs text-destructive">
- {{ sourceSaveError }}
- </div>
- </div>
- <QueryEditor
- v-else
- :key="`source-preview-${sourceRow?.id}`"
- :model-value="sourceContent"
- class="min-h-0 flex-1"
- :connection-id="props.connection.id"
- :database="props.database"
- :schema="selectedSchema"
- :database-type="props.connection.db_type"
- :dialect="sourceDialect"
- :format-dialect="sourceFormatDialect"
- force-word-wrap
- read-only
- data-object-source-preview
- />
+ </ObjectDependenciesPanel>
</template>
</div>
</div>
diff --git a/apps/desktop/src/components/objects/ObjectDependenciesPanel.vue b/apps/desktop/src/components/objects/ObjectDependenciesPanel.vue
index 3cf8f8231e..bea8a5a0d3 100644
--- a/apps/desktop/src/components/objects/ObjectDependenciesPanel.vue
+++ b/apps/desktop/src/components/objects/ObjectDependenciesPanel.vue
@@ -6,10 +6,22 @@ import { Button } from "@/components/ui/button";
import { useObjectDependencies } from "@/composables/useObjectDependencies";
import { useToast } from "@/composables/useToast";
import { copyToClipboard } from "@/lib/common/clipboard";
-import { objectDependencyNavigation, objectDependencySql, type ObjectDependencyTarget, type ObjectDependencyRow, type ObjectDetailsSection } from "@/lib/database/objectDependencyDetails";
+import {
+ objectDependencyNavigation,
+ objectDependencySql,
+ objectRelationKinds,
+ objectForeignKeyRows,
+ objectOwnershipRows,
+ relationObjectNavigation,
+ objectOwnershipNavigation,
+ type ObjectDependencyTarget,
+ type ObjectDependencyRow,
+ type ObjectDetailsSection,
+ type RelationObjectIdentity,
+} from "@/lib/database/objectDependencyDetails";
import type { SqlObjectNavigationTarget } from "@/lib/sql/sqlNavigation";
-const props = defineProps<{ target?: ObjectDependencyTarget; section: ObjectDetailsSection; open?: boolean }>();
+const props = withDefaults(defineProps<{ target?: ObjectDependencyTarget; section: ObjectDetailsSection; open?: boolean; includeSource?: boolean }>(), { open: true, includeSource: true });
const emit = defineEmits<{
"update:section": [section: ObjectDetailsSection];
"open-object": [context: ObjectDependencyTarget, target: SqlObjectNavigationTarget];
@@ -20,29 +32,60 @@ const { toast } = useToast();
const id = useId();
const target = computed(() => (props.open === false ? undefined : props.target));
const enabled = computed(() => !!target.value && props.section !== "source");
-const { rows, loading, error, loaded, truncated, refresh } = useObjectDependencies(target, enabled);
+const dependencies = useObjectDependencies(
+ target,
+ computed(() => enabled.value && (props.section === "dependencies" || props.section === "dependents")),
+);
+const foreignKeys = useObjectDependencies(
+ target,
+ computed(() => enabled.value && props.section === "foreignKeys" && !!target.value && objectRelationKinds(target.value).includes("foreignKeys")),
+ { kind: "foreignKeys", parse: objectForeignKeyRows },
+);
+const ownership = useObjectDependencies(
+ target,
+ computed(() => enabled.value && props.section === "ownership" && !!target.value && objectRelationKinds(target.value).includes("ownership")),
+ { kind: "ownership", parse: objectOwnershipRows },
+);
+const rows = dependencies.rows;
+const activeState = computed(() => (props.section === "foreignKeys" ? foreignKeys : props.section === "ownership" ? ownership : dependencies));
+const loading = computed(() => activeState.value.loading.value),
+ error = computed(() => activeState.value.error.value),
+ loaded = computed(() => activeState.value.loaded.value),
+ truncated = computed(() => activeState.value.truncated.value);
+const refresh = () => activeState.value.refresh();
const sourceVisited = ref(props.section === "source");
watch(toRef(props, "section"), (section) => {
if (section === "source") sourceVisited.value = true;
});
-const sections = ["source", "dependencies", "dependents"] as const;
-const directions = ["dependencies", "dependents"] as const;
+const sections = computed<ObjectDetailsSection[]>(() => [...(props.includeSource !== false ? ["source" as const] : []), "dependencies", "dependents", ...(target.value ? objectRelationKinds(target.value).filter((kind) => kind !== "dependencies") : [])]);
+const directions = computed(() => sections.value.filter((section) => section !== "source"));
+watch(sections, (value) => {
+ if (!value.includes(props.section)) emit("update:section", value[0]!);
+});
const hasLinks = computed(() => rows.value.some((row) => !!row.link));
-const label = (section: ObjectDetailsSection) => t(section === "source" ? "objects.source" : `objectDependencies.${section}`);
+const label = (section: ObjectDetailsSection) => t(section === "source" ? "objects.source" : section === "foreignKeys" || section === "ownership" ? `objectRelations.${section}` : `objectDependencies.${section}`);
const rowsFor = (section: ObjectDetailsSection) => rows.value.filter((row) => row.direction === (section === "dependencies" ? "DEPENDS_ON" : "REFERENCED_BY"));
+const countFor = (section: ObjectDetailsSection) => (section === "foreignKeys" ? foreignKeys.rows.value.length : section === "ownership" ? ownership.rows.value.length : rowsFor(section).length);
+const activeKind = computed(() => (props.section === "foreignKeys" || props.section === "ownership" ? props.section : "dependencies"));
+function openNavigation(navigation?: SqlObjectNavigationTarget) {
+ if (target.value && navigation) emit("open-object", { ...target.value }, navigation);
+}
+function openRelation(object: RelationObjectIdentity) {
+ openNavigation(relationObjectNavigation(object));
+}
async function switchSection(event: KeyboardEvent, current: number) {
let index: number;
- if (event.key === "ArrowRight") index = (current + 1) % sections.length;
- else if (event.key === "ArrowLeft") index = (current + sections.length - 1) % sections.length;
+ if (event.key === "ArrowRight") index = (current + 1) % sections.value.length;
+ else if (event.key === "ArrowLeft") index = (current + sections.value.length - 1) % sections.value.length;
else if (event.key === "Home") index = 0;
- else if (event.key === "End") index = sections.length - 1;
+ else if (event.key === "End") index = sections.value.length - 1;
else return;
event.preventDefault();
const parent = (event.currentTarget as HTMLElement).parentElement;
- emit("update:section", sections[index]!);
+ emit("update:section", sections.value[index]!);
await nextTick();
- parent?.querySelector<HTMLButtonElement>(`[data-object-section="${sections[index]}"]`)?.focus();
+ parent?.querySelector<HTMLButtonElement>(`[data-object-section="${sections.value[index]}"]`)?.focus();
}
function openObject(row: ObjectDependencyRow) {
@@ -62,7 +105,7 @@ async function copyName(row: ObjectDependencyRow) {
<template>
<div v-if="target" class="flex min-h-0 flex-1 flex-col overflow-hidden" data-object-details>
- <div role="tablist" :aria-label="t('contextMenu.viewDependencies')" class="flex shrink-0 gap-1 border-b px-3 pt-1">
+ <div role="tablist" :aria-label="t('contextMenu.viewDependencies')" class="flex shrink-0 flex-wrap gap-1 border-b px-3 pt-1">
<button
v-for="(section, index) in sections"
:id="`${id}-${section}-tab`"
@@ -81,24 +124,24 @@ async function copyName(row: ObjectDependencyRow) {
{{ label(section) }}
</button>
</div>
- <div v-if="sourceVisited" v-show="props.section === 'source'" :id="`${id}-source-panel`" role="tabpanel" :aria-labelledby="`${id}-source-tab`" class="relative flex min-h-0 flex-1 flex-col overflow-hidden">
+ <div v-if="sourceVisited && props.includeSource !== false" v-show="props.section === 'source'" :id="`${id}-source-panel`" role="tabpanel" :aria-labelledby="`${id}-source-tab`" class="relative flex min-h-0 flex-1 flex-col overflow-hidden">
<slot />
</div>
<section v-for="section in directions" v-show="props.section === section" :id="`${id}-${section}-panel`" :key="section" role="tabpanel" :aria-labelledby="`${id}-${section}-tab`" :aria-busy="loading" class="flex min-h-0 flex-1 flex-col overflow-hidden">
<div class="flex shrink-0 flex-wrap items-center justify-between gap-3 border-b px-4 py-3">
<div class="min-w-0">
<h3 class="text-sm font-medium">
- {{ label(section) }} <span v-if="loaded" class="ml-1 text-muted-foreground">({{ rowsFor(section).length }})</span>
+ {{ label(section) }} <span v-if="loaded" class="ml-1 text-muted-foreground">({{ countFor(section) }})</span>
</h3>
<p class="mt-1 break-all font-mono text-sm text-muted-foreground">{{ target.schema }}.{{ target.name }}</p>
</div>
<div class="flex items-center gap-2">
<Button variant="outline" size="sm" :disabled="loading" @click="refresh"><RefreshCw class="h-4 w-4" :class="loading ? 'animate-spin' : ''" />{{ t("common.refresh") }}</Button>
- <Button variant="ghost" size="sm" @click="emit('view-sql', { ...target }, objectDependencySql(target))"><Code class="h-4 w-4" />{{ t("objectDependencies.viewSql") }}</Button>
+ <Button variant="ghost" size="sm" @click="emit('view-sql', { ...target }, objectDependencySql(target, activeKind))"><Code class="h-4 w-4" />{{ t("objectDependencies.viewSql") }}</Button>
</div>
</div>
<div class="shrink-0 space-y-1 px-4 py-2 text-sm text-muted-foreground">
- <p>{{ t("objectDependencies.visibility") }}</p>
+ <p>{{ t(activeKind === "dependencies" ? "objectDependencies.visibility" : "objectRelations.visibility") }}</p>
<p v-if="target.objectType === 'PACKAGE'">{{ t("objectDependencies.packageScope") }}</p>
<p v-if="truncated" class="text-amber-700 dark:text-amber-400">{{ t("objectDependencies.partial") }}</p>
</div>
@@ -110,9 +153,38 @@ async function copyName(row: ObjectDependencyRow) {
<Button variant="outline" size="sm" :disabled="loading" @click="refresh">{{ t("common.retry") }}</Button>
</div>
<div v-if="loading && !loaded" role="status" class="flex flex-1 items-center justify-center gap-2 text-sm text-muted-foreground"><RefreshCw class="h-4 w-4 animate-spin" />{{ t("common.loading") }}</div>
- <div v-else-if="loaded && !rowsFor(section).length" class="flex flex-1 items-center justify-center p-6 text-center text-sm text-muted-foreground">{{ t("objectDependencies.empty") }}</div>
+ <div v-else-if="loaded && !countFor(section)" class="flex flex-1 items-center justify-center p-6 text-center text-sm text-muted-foreground">{{ t(activeKind === "dependencies" ? "objectDependencies.empty" : "objectRelations.empty") }}</div>
+ <div v-else-if="loaded && section === 'foreignKeys'" class="min-h-0 flex-1 overflow-auto border-t">
+ <div v-for="direction in ['REFERENCES', 'REFERENCED_BY'] as const" :key="direction" class="border-b">
+ <h4 class="bg-muted px-4 py-2 text-sm font-medium">{{ t(direction === "REFERENCES" ? "objectRelations.references" : "objectRelations.referencedBy") }}</h4>
+ <div v-for="row in foreignKeys.rows.value.filter((row) => row.direction === direction)" :key="JSON.stringify([row.constraintOwner, row.constraintName])" class="space-y-2 border-t px-4 py-3 text-sm">
+ <p class="break-all font-mono">{{ row.constraintOwner }}.{{ row.constraintName }}</p>
+ <button
+ v-if="relationObjectNavigation(direction === 'REFERENCES' ? row.parent : row.child)"
+ type="button"
+ class="break-all text-left font-mono text-primary hover:underline focus-visible:ring-2 focus-visible:ring-ring"
+ @click="openRelation(direction === 'REFERENCES' ? row.parent : row.child)"
+ >
+ {{ (direction === "REFERENCES" ? row.parent : row.child).schema }}.{{ (direction === "REFERENCES" ? row.parent : row.child).name }}
+ </button>
+ <p v-else>{{ t("objectRelations.unresolved") }}</p>
+ <p v-for="column in row.columns" :key="column.position" class="break-all font-mono text-muted-foreground">{{ column.position }}. {{ column.child || "—" }} → {{ column.parent || "—" }}</p>
+ <p v-if="!row.complete" class="text-amber-700 dark:text-amber-400">{{ t("objectRelations.incomplete") }}</p>
+ </div>
+ </div>
+ </div>
+ <div v-else-if="loaded && section === 'ownership'" class="min-h-0 flex-1 divide-y overflow-auto border-t">
+ <div v-for="(row, index) in ownership.rows.value" :key="index" class="space-y-2 px-4 py-3 text-sm">
+ <p class="text-muted-foreground">{{ row.child.type }}</p>
+ <button v-if="objectOwnershipNavigation(row)" type="button" class="break-all text-left font-mono text-primary hover:underline focus-visible:ring-2 focus-visible:ring-ring" @click="openNavigation(objectOwnershipNavigation(row))">{{ row.child.schema }}.{{ row.child.name }}</button>
+ <p v-else class="break-all font-mono">{{ row.child.schema }}.{{ row.child.name }}</p>
+ <p class="text-muted-foreground">{{ t("objectRelations.parent") }}</p>
+ <button v-if="relationObjectNavigation(row.parent)" type="button" class="break-all text-left font-mono text-primary hover:underline focus-visible:ring-2 focus-visible:ring-ring" @click="openRelation(row.parent)">{{ row.parent.schema }}.{{ row.parent.name }}</button>
+ <p v-else>{{ t("objectRelations.unresolved") }}</p>
+ </div>
+ </div>
<div v-else-if="loaded" class="min-h-0 flex-1 overflow-auto border-t">
- <table class="w-full text-left text-sm">
+ <table class="w-max min-w-full text-left text-sm">
<thead class="sticky top-0 z-10 bg-muted">
<tr class="border-b">
<th class="px-4 py-2 font-medium">{{ t("objects.name") }}</th>
diff --git a/apps/desktop/src/components/objects/__tests__/ObjectBrowser.constraints.component.spec.ts b/apps/desktop/src/components/objects/__tests__/ObjectBrowser.constraints.component.spec.ts
index 82ea4f4126..baf674f66a 100644
--- a/apps/desktop/src/components/objects/__tests__/ObjectBrowser.constraints.component.spec.ts
+++ b/apps/desktop/src/components/objects/__tests__/ObjectBrowser.constraints.component.spec.ts
@@ -7,7 +7,7 @@ import { invalidateObjectBrowserRowsCache } from "@/lib/table/objectBrowserRowsC
import { invalidateMetadataRuntimeCachePrefix } from "@/lib/metadata/metadataRuntimeCache";
import type { ConnectionConfig } from "@/types/database";
-const mocks = vi.hoisted(() => ({ listConstraints: vi.fn(), getTableComment: vi.fn(), getTablePartitionStatus: vi.fn(), getTablePartitioning: vi.fn(), toast: vi.fn() }));
+const mocks = vi.hoisted(() => ({ listConstraints: vi.fn(), getTableComment: vi.fn(), getTablePartitionStatus: vi.fn(), getTablePartitioning: vi.fn(), toast: vi.fn(), executeQuery: vi.fn(), cancelQuery: vi.fn(async () => true) }));
vi.mock("@/lib/backend/api", () => ({
listObjects: vi.fn().mockResolvedValue([{ name: "O01_CONSTRAINTS", object_type: "TABLE", schema: "TESTER" }]),
listSchemas: vi.fn().mockResolvedValue(["TESTER"]),
@@ -20,6 +20,8 @@ vi.mock("@/lib/backend/api", () => ({
getTableComment: (...args: unknown[]) => mocks.getTableComment(...args),
getTablePartitionStatus: (...args: unknown[]) => mocks.getTablePartitionStatus(...args),
getTablePartitioning: (...args: unknown[]) => mocks.getTablePartitioning(...args),
+ executeQuery: (...args: unknown[]) => mocks.executeQuery(...args),
+ cancelQuery: (...args: unknown[]) => mocks.cancelQuery(...args),
}));
vi.mock("@/stores/connectionStore", () => ({
useConnectionStore: () => ({
@@ -111,6 +113,39 @@ async function openConstraints() {
}
describe("OceanBase Oracle constraint information", () => {
+ it("consumes a captured relation-property request without fetching table data or entering a source editor", async () => {
+ mocks.executeQuery.mockResolvedValue({
+ columns: ["DIRECTION", "OBJECT_OWNER", "OBJECT_NAME", "OBJECT_TYPE", "REFERENCED_OWNER", "REFERENCED_NAME", "REFERENCED_TYPE", "DEPENDENCY_TYPE", "REFERENCED_LINK_NAME"],
+ rows: [["REFERENCED_BY", "Other.Owner", "Uses.Table", "FUNCTION", "TESTER", "Mixed.Table", "TABLE", "HARD", null]],
+ affected_rows: 0,
+ execution_time_ms: 1,
+ });
+ const host = document.createElement("div");
+ document.body.append(host);
+ const consumed = vi.fn(),
+ onOpenDependencyObject = vi.fn();
+ const app = createApp(ObjectBrowser, {
+ connection,
+ database: "TESTER",
+ schema: "TESTER",
+ propertyRequest: { requestId: "request-1", connectionId: connection.id, database: "TESTER", schema: "TESTER", name: "Mixed.Table", objectType: "TABLE", initialTab: "relations" },
+ onPropertyRequestConsumed: consumed,
+ onOpenDependencyObject,
+ });
+ mountedApps.push({ app, host });
+ app.mount(host);
+ await vi.waitFor(() => expect(mocks.executeQuery).toHaveBeenCalledTimes(1));
+ expect(mocks.executeQuery.mock.calls[0]).toEqual([connection.id, "TESTER", expect.stringContaining("ALL_DEPENDENCIES"), "TESTER", expect.any(String), { catalog: undefined }]);
+ expect(consumed).toHaveBeenCalledWith("request-1");
+ expect(host.querySelector("[data-object-source-editor]")).toBeNull();
+ expect(host.querySelector('[data-object-section="source"]')).toBeNull();
+ expect(mocks.getTablePartitionStatus).not.toHaveBeenCalled();
+ host.querySelector<HTMLButtonElement>('[data-object-section="dependents"]')!.click();
+ await vi.waitFor(() => expect([...host.querySelectorAll("button")].find((button) => button.textContent?.trim() === "Uses.Table")).toBeDefined());
+ [...host.querySelectorAll("button")].find((button) => button.textContent?.trim() === "Uses.Table")!.click();
+ expect(onOpenDependencyObject).toHaveBeenCalledWith(expect.objectContaining({ connectionId: connection.id, database: "TESTER", schema: "TESTER", name: "Mixed.Table" }), { name: "Uses.Table", schema: "Other.Owner", type: "function", nameQuoted: true, schemaQuoted: true });
+ });
+
it.each([120, 0])("keeps a constraint request alive beyond 35 seconds with timeout %s", async (timeout) => {
vi.useFakeTimers();
connection.query_timeout_secs = timeout;
@@ -128,6 +163,29 @@ describe("OceanBase Oracle constraint information", () => {
expect(host.textContent).toContain("SLOW_CONSTRAINT");
expect(mocks.toast).not.toHaveBeenCalledWith(expect.stringContaining("Metadata loading timed out"), 5000);
});
+
+ it("reads a requested index relation rather than substituting its parent table", async () => {
+ mocks.executeQuery.mockResolvedValue({ columns: ["CHILD_OWNER", "CHILD_NAME", "CHILD_TYPE", "PARENT_OWNER", "PARENT_NAME", "PARENT_TYPE"], rows: [["Index.Owner", "Idx.Dot", "INDEX", "TESTER", "Parent.Table", "TABLE"]], affected_rows: 0, execution_time_ms: 1 });
+ const host = document.createElement("div");
+ document.body.append(host);
+ const consumed = vi.fn();
+ const app = createApp(ObjectBrowser, {
+ connection,
+ database: "TESTER",
+ schema: "TESTER",
+ propertyRequest: { requestId: "index-request", connectionId: connection.id, database: "TESTER", schema: "TESTER", name: "Parent.Table", objectType: "TABLE", initialTab: "relations", focusObject: { owner: "Index.Owner", name: "Idx.Dot", type: "INDEX" } },
+ onPropertyRequestConsumed: consumed,
+ });
+ mountedApps.push({ app, host });
+ app.mount(host);
+ await vi.waitFor(() => expect(mocks.executeQuery).toHaveBeenCalledTimes(1));
+ const [connectionId, database, sql, schema] = mocks.executeQuery.mock.calls[0]!;
+ expect([connectionId, database, schema]).toEqual([connection.id, "TESTER", "Index.Owner"]);
+ expect(sql).toContain("i.OWNER = 'Index.Owner' AND i.INDEX_NAME = 'Idx.Dot'");
+ expect(host.textContent).toContain("Index.Owner.Idx.Dot");
+ expect(host.querySelector('[data-object-section="foreignKeys"]')).toBeNull();
+ expect(consumed).toHaveBeenCalledWith("index-request");
+ });
it.each(["overview", "partitions"])("ends a stalled %s metadata wait through the actual detail tab", async (kind) => {
// Partition tabs are currently PostgreSQL-only; keep their shared lifecycle bounded too.
if (kind === "partitions") connection.db_type = "postgres";
diff --git a/apps/desktop/src/components/objects/__tests__/ObjectDependenciesPanel.spec.ts b/apps/desktop/src/components/objects/__tests__/ObjectDependenciesPanel.spec.ts
index fb4a2105ed..8bd95928ed 100644
--- a/apps/desktop/src/components/objects/__tests__/ObjectDependenciesPanel.spec.ts
+++ b/apps/desktop/src/components/objects/__tests__/ObjectDependenciesPanel.spec.ts
@@ -5,13 +5,13 @@ import { createI18n } from "vue-i18n";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import ObjectDependenciesPanel from "../ObjectDependenciesPanel.vue";
import { useConnectionStore } from "@/stores/connectionStore";
-import type { ObjectDetailsSection } from "@/lib/database/objectDependencyDetails";
+import type { ObjectDetailsSection, ObjectDependencyTarget } from "@/lib/database/objectDependencyDetails";
const backend = vi.hoisted(() => ({ executeQuery: vi.fn(), cancelQuery: vi.fn(async () => true), checkConnectionHealth: vi.fn(async () => undefined) }));
vi.mock("@/lib/backend/api", async (original) => ({ ...(await original<typeof import("@/lib/backend/api")>()), ...backend }));
const target = { connectionId: "source-connection", database: "ORCL", schema: "Original.Owner", name: "P", objectType: "PROCEDURE" as const };
const mounted: Array<{ app: App; host: HTMLElement; pinia: Pinia }> = [];
-function mountPanel(initial: ObjectDetailsSection = "source") {
+function mountPanel(initial: ObjectDetailsSection = "source", identity: ObjectDependencyTarget = target, includeSource?: boolean) {
const pinia = createPinia();
const connections = useConnectionStore(pinia);
connections.connectedIds.add(target.connectionId);
@@ -24,7 +24,8 @@ function mountPanel(initial: ObjectDetailsSection = "source") {
h(
ObjectDependenciesPanel,
{
- target,
+ target: identity,
+ includeSource,
section: section.value,
open: open.value,
"onUpdate:section": (value: ObjectDetailsSection) => {
@@ -70,6 +71,34 @@ afterEach(() => {
});
describe("object details shared sections", () => {
+ it("shows foreign keys and owning objects separately in table properties without mounting a source editor", async () => {
+ const identity: ObjectDependencyTarget = { ...target, name: "Child.Table", objectType: "TABLE" };
+ const { host, onOpenObject } = mountPanel("dependencies", identity, false);
+ await vi.waitFor(() => expect(backend.executeQuery).toHaveBeenCalledTimes(1));
+ expect(host.querySelector("textarea")).toBeNull();
+ expect(button(host, "objects.source")).toBeUndefined();
+ backend.executeQuery.mockResolvedValueOnce({
+ columns: ["DIRECTION", "CONSTRAINT_OWNER", "CONSTRAINT_NAME", "CHILD_OWNER", "CHILD_NAME", "CHILD_COLUMN", "POSITION", "PARENT_OWNER", "PARENT_NAME", "PARENT_COLUMN", "COLUMN_COUNT"],
+ rows: [["REFERENCES", identity.schema, "FK", identity.schema, identity.name, "Child Column", 1, "Other.Owner", "Parent.Table", "Parent Column", 1]],
+ affected_rows: 0,
+ execution_time_ms: 1,
+ });
+ button(host, "objectRelations.foreignKeys").click();
+ await vi.waitFor(() => expect(host.textContent).toContain("Child Column"));
+ expect(backend.executeQuery.mock.calls[1]![2]).toContain("ALL_CONSTRAINTS");
+ button(host, "Other.Owner.Parent.Table").click();
+ expect(onOpenObject).toHaveBeenLastCalledWith(identity, { name: "Parent.Table", schema: "Other.Owner", type: "table", nameQuoted: true, schemaQuoted: true });
+ backend.executeQuery.mockResolvedValueOnce({ columns: ["CHILD_OWNER", "CHILD_NAME", "CHILD_TYPE", "PARENT_OWNER", "PARENT_NAME", "PARENT_TYPE"], rows: [["Index.Owner", "Index.Name", "INDEX", identity.schema, identity.name, "TABLE"]], affected_rows: 0, execution_time_ms: 1 });
+ button(host, "objectRelations.ownership").click();
+ await vi.waitFor(() => expect(host.textContent).toContain("Index.Owner.Index.Name"));
+ button(host, "Index.Owner.Index.Name").click();
+ expect(onOpenObject).toHaveBeenLastCalledWith(identity, { name: "Index.Name", schema: "Index.Owner", type: "index", parentName: identity.name, parentSchema: identity.schema, nameQuoted: true, schemaQuoted: true, parentNameQuoted: true, parentSchemaQuoted: true });
+ button(host, "objectDependencies.dependencies").click();
+ await nextTick();
+ expect(backend.executeQuery).toHaveBeenCalledTimes(3);
+ expect(host.querySelector("textarea")).toBeNull();
+ });
+
it("preserves the source element, draft and selection while switching and refreshing dependencies", async () => {
const { host, section } = mountPanel();
expect(backend.executeQuery).not.toHaveBeenCalled();
diff --git a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
index c6bf9b966a..8342474130 100644
--- a/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
+++ b/apps/desktop/src/components/sidebar/SidebarTreeRuntimeHost.vue
@@ -3093,6 +3093,19 @@ async function openDatabaseObjectDependencies() {
if (currentDatabaseType() === "oracle" || currentDatabaseType() === "oceanbase-oracle") {
const target = oracleTarget(node);
if (!target) return;
+ const connection = connectionStore.getConfig(node.connectionId);
+ const propertyDatabase = connection && node.schema && connectionUsesVisibleSchemaFilter(connection) ? connection.database || node.database : node.database;
+ if (target.type === "TABLE" || target.type === "VIEW" || target.type === "MATERIALIZED_VIEW") {
+ queryStore.openObjectProperties({ connectionId: node.connectionId, database: propertyDatabase, catalog: node.catalog, schema: target.schema, name: target.name, objectType: target.type, initialTab: "relations" });
+ return;
+ }
+ // TYPE lifecycle belongs to its dedicated integration; do not bypass its source guard.
+ if (target.type === "TYPE" || target.type === "TYPE_BODY") return;
+ if (target.type === "INDEX") {
+ if (node.parentName && node.parentSchema)
+ queryStore.openObjectProperties({ connectionId: node.connectionId, database: propertyDatabase, catalog: node.catalog, schema: node.parentSchema, name: node.parentName, objectType: "TABLE", initialTab: "relations", focusObject: { owner: target.schema, name: target.name, type: "INDEX" } });
+ return;
+ }
openObjectSourceDialog(false, false, { ...node, type: target.type.toLowerCase() as "procedure" | "function" | "package", schema: target.schema, objectName: target.name, label: target.name, parentType: undefined, parentName: undefined, parentSchema: undefined });
return;
}
diff --git a/apps/desktop/src/components/sidebar/__tests__/SidebarTreeRuntimeHost.databaseDependencies.spec.ts b/apps/desktop/src/components/sidebar/__tests__/SidebarTreeRuntimeHost.databaseDependencies.spec.ts
index 2e358691d3..074ee38bdd 100644
--- a/apps/desktop/src/components/sidebar/__tests__/SidebarTreeRuntimeHost.databaseDependencies.spec.ts
+++ b/apps/desktop/src/components/sidebar/__tests__/SidebarTreeRuntimeHost.databaseDependencies.spec.ts
@@ -71,6 +71,23 @@ describe("routine dependency context-menu action", () => {
setActivePinia(undefined);
});
+ it.each(["oracle", "oceanbase-oracle"] as const)("opens table relations in existing properties without executing table data in %s", async (databaseType) => {
+ const { host, queries, onOpenObjectSource } = await mountContextMenu(databaseType);
+ const node: TreeNode = { id: "T", type: "table", label: "Mixed.Table", objectName: "Mixed.Table", schema: "Other.Owner", connectionId: "dependency-test", database: "APP", catalog: "Captured.Catalog" };
+ const action = host.buildContextMenu(node).find((item) => item.label === i18n.global.t("contextMenu.viewDependencies"))?.action;
+ expect(action).toBeDefined();
+ await action?.();
+ const tab = queries.tabs[0]!;
+ expect(tab.mode).toBe("objects");
+ expect(tab.objectPropertiesRequest).toMatchObject({ connectionId: "dependency-test", database: "APP", schema: "Other.Owner", name: "Mixed.Table", objectType: "TABLE", catalog: "Captured.Catalog", initialTab: "relations" });
+ const request = tab.objectPropertiesRequest!.requestId;
+ await action?.();
+ expect(queries.tabs).toHaveLength(1);
+ expect(tab.objectPropertiesRequest!.requestId).not.toBe(request);
+ expect(backend.executeMulti).not.toHaveBeenCalled();
+ expect(onOpenObjectSource).not.toHaveBeenCalled();
+ });
+
it.each(["oracle", "oceanbase-oracle"] as const)("opens object dependencies from an Oracle package member in %s", async (databaseType) => {
const { host, queries } = await mountContextMenu(databaseType);
const member: TreeNode = {
@@ -98,6 +115,16 @@ describe("routine dependency context-menu action", () => {
expect(queryTab?.result).toBeUndefined();
});
+ it("retains an index identity inside its parent property request", async () => {
+ const { host, queries } = await mountContextMenu("oceanbase-oracle");
+ const node: TreeNode = { id: "I", type: "index", label: "Idx.Dot", objectName: "Idx.Dot", schema: "Index.Owner", parentSchema: "Parent.Owner", parentName: "Parent.Table", parentType: "table", connectionId: "dependency-test", database: "APP" };
+ const action = host.buildContextMenu(node).find((item) => item.label === i18n.global.t("contextMenu.viewDependencies"))?.action;
+ expect(action).toBeDefined();
+ await action?.();
+ expect(queries.tabs[0]?.objectPropertiesRequest).toMatchObject({ schema: "Parent.Owner", name: "Parent.Table", objectType: "TABLE", initialTab: "relations", focusObject: { owner: "Index.Owner", name: "Idx.Dot", type: "INDEX" } });
+ expect(backend.executeMulti).not.toHaveBeenCalled();
+ });
+
it("preserves the existing dialog preference and forwards its initial section", async () => {
const { host, queries, onOpenObjectSource } = await mountContextMenu("oracle", "dialog");
const node: TreeNode = { id: "P", type: "procedure", label: "P", schema: "APP", connectionId: "dependency-test", database: "APP" };
diff --git a/apps/desktop/src/composables/__tests__/useObjectDependencies.spec.ts b/apps/desktop/src/composables/__tests__/useObjectDependencies.spec.ts
index d8d1774271..41a75a61b9 100644
--- a/apps/desktop/src/composables/__tests__/useObjectDependencies.spec.ts
+++ b/apps/desktop/src/composables/__tests__/useObjectDependencies.spec.ts
@@ -46,7 +46,7 @@ function mountLoader(enabled = true) {
document.body.append(host);
app.mount(host);
mounted.push({ app, host, pinia });
- return { loader, target, active, app };
+ return { loader, target, active, app, connections };
}
beforeEach(() => {
vi.clearAllMocks();
@@ -61,6 +61,14 @@ afterEach(() => {
});
describe("independent object dependency lifecycle", () => {
+ it("does not report a managed execution error as confirmed empty relations", async () => {
+ backend.executeQuery.mockResolvedValue({ ...result(), rows: [], execution_error: true });
+ const { loader } = mountLoader();
+ await vi.waitFor(() => expect(loader.loading.value).toBe(false));
+ expect(loader.loaded.value).toBe(false);
+ expect(loader.error.value).not.toBe("");
+ });
+
it("loads lazily without a query session and keeps previous rows on refresh failure", async () => {
backend.executeQuery.mockResolvedValue(result());
const { loader, active } = mountLoader(false);
@@ -82,6 +90,35 @@ describe("independent object dependency lifecycle", () => {
expect(loader.truncated.value).toBe(true);
});
+ it("keeps an initial rejection distinct from a confirmed empty retry", async () => {
+ backend.executeQuery.mockRejectedValueOnce(new Error("permission denied")).mockResolvedValueOnce({ ...result(), rows: [] });
+ const { loader } = mountLoader();
+ await vi.waitFor(() => expect(loader.error.value).toBe("permission denied"));
+ expect(loader.loaded.value).toBe(false);
+ await loader.refresh();
+ expect(loader.error.value).toBe("");
+ expect(loader.loaded.value).toBe(true);
+ expect(loader.rows.value).toEqual([]);
+ expect(loader.truncated.value).toBe(false);
+ });
+
+ it("does not dispatch after a hidden connection wait completes and can reopen", async () => {
+ const pending = deferred<void>();
+ const { loader, active, connections } = mountLoader(false);
+ vi.spyOn(connections, "ensureConnected").mockReturnValueOnce(pending.promise);
+ backend.executeQuery.mockResolvedValue(result("REOPENED"));
+ active.value = true;
+ await vi.waitFor(() => expect(connections.ensureConnected).toHaveBeenCalledTimes(1));
+ active.value = false;
+ await nextTick();
+ pending.resolve();
+ await nextTick();
+ expect(backend.executeQuery).not.toHaveBeenCalled();
+ expect(loader.loaded.value).toBe(false);
+ active.value = true;
+ await vi.waitFor(() => expect(loader.rows.value[0]?.name).toBe("REOPENED"));
+ });
+
it("rejects stale refresh responses and cancels only its own execution id", async () => {
const first = deferred<QueryResult>(),
second = deferred<QueryResult>();
@@ -130,4 +167,23 @@ describe("independent object dependency lifecycle", () => {
expect(loader.loading.value).toBe(false);
expect(backend.cancelQuery).toHaveBeenCalledTimes(1);
});
+
+ it("cancels a hidden pending query and reloads on return without accepting the old result", async () => {
+ const first = deferred<QueryResult>(),
+ second = deferred<QueryResult>();
+ backend.executeQuery.mockReturnValueOnce(first.promise).mockReturnValueOnce(second.promise);
+ const { loader, active } = mountLoader();
+ await vi.waitFor(() => expect(backend.executeQuery).toHaveBeenCalledTimes(1));
+ active.value = false;
+ await nextTick();
+ expect(backend.cancelQuery).toHaveBeenCalledWith(backend.executeQuery.mock.calls[0]![4]);
+ expect(loader.loading.value).toBe(false);
+ active.value = true;
+ await vi.waitFor(() => expect(backend.executeQuery).toHaveBeenCalledTimes(2));
+ first.resolve(result("HIDDEN"));
+ await nextTick();
+ expect(loader.rows.value).toEqual([]);
+ second.resolve(result("CURRENT"));
+ await vi.waitFor(() => expect(loader.rows.value[0]?.name).toBe("CURRENT"));
+ });
});
diff --git a/apps/desktop/src/composables/useObjectDependencies.ts b/apps/desktop/src/composables/useObjectDependencies.ts
index c904f74dc5..d4ad7f40b3 100644
--- a/apps/desktop/src/composables/useObjectDependencies.ts
+++ b/apps/desktop/src/composables/useObjectDependencies.ts
@@ -3,10 +3,13 @@ import * as api from "@/lib/backend/api";
import { useConnectionStore } from "@/stores/connectionStore";
import { uuid } from "@/lib/common/utils";
import { objectDependencyRows, objectDependencySql, type ObjectDependencyRow, type ObjectDependencyTarget } from "@/lib/database/objectDependencyDetails";
+import type { ObjectRelationKind } from "@/lib/database/oracleObjectDependencies";
+import type { QueryResult } from "@/types/database";
+import { isQueryExecutionErrorResult } from "@/lib/query/queryResultError";
-export function useObjectDependencies(target: Readonly<Ref<ObjectDependencyTarget | undefined>>, enabled: Readonly<Ref<boolean>>) {
+export function useObjectDependencies<Row = ObjectDependencyRow>(target: Readonly<Ref<ObjectDependencyTarget | undefined>>, enabled: Readonly<Ref<boolean>>, options?: { kind: ObjectRelationKind; parse: (result: QueryResult) => Row[] }) {
const connectionStore = useConnectionStore();
- const rows = ref<ObjectDependencyRow[]>([]);
+ const rows = ref<Row[]>([]) as Ref<Row[]>;
const loading = ref(false);
const error = ref("");
const loaded = ref(false);
@@ -23,7 +26,7 @@ export function useObjectDependencies(target: Readonly<Ref<ObjectDependencyTarge
async function refresh() {
const identity = target.value;
- if (!identity) return;
+ if (!identity || !enabled.value) return;
invalidate();
const serial = generation;
const requestKey = key.value;
@@ -34,9 +37,10 @@ export function useObjectDependencies(target: Readonly<Ref<ObjectDependencyTarge
try {
await connectionStore.ensureConnected(identity.connectionId);
if (serial !== generation || requestKey !== key.value) return;
- const result = await api.executeQuery(identity.connectionId, identity.database, objectDependencySql(identity), identity.schema, id, { catalog: identity.catalog });
+ const result = await api.executeQuery(identity.connectionId, identity.database, objectDependencySql(identity, options?.kind), identity.schema, id, { catalog: identity.catalog });
if (serial !== generation || requestKey !== key.value) return;
- rows.value = objectDependencyRows(result);
+ if (isQueryExecutionErrorResult(result)) throw new Error(String(result.rows[0]?.[0] ?? "Unable to read object relations."));
+ rows.value = options ? options.parse(result) : (objectDependencyRows(result) as Row[]);
truncated.value = !!(result.truncated || result.has_more);
loaded.value = true;
} catch (e: unknown) {
@@ -65,6 +69,10 @@ export function useObjectDependencies(target: Readonly<Ref<ObjectDependencyTarge
watch(
enabled,
(value) => {
+ if (!value) {
+ invalidate();
+ loading.value = false;
+ }
if (value && !loaded.value && !loading.value && target.value) void refresh();
},
{ immediate: true },
diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.ts
index fb00eb5420..aaed5639d8 100644
--- a/apps/desktop/src/i18n/locales/en.ts
+++ b/apps/desktop/src/i18n/locales/en.ts
@@ -65,6 +65,18 @@ const consul = {
};
export default {
+ objectRelations: {
+ title: "Relations",
+ foreignKeys: "Foreign keys",
+ ownership: "Parent and children",
+ references: "Referenced tables",
+ referencedBy: "Referencing tables",
+ parent: "Parent object",
+ unresolved: "Target identity is unavailable",
+ incomplete: "Some columns or targets are not visible. The column mapping may be incomplete.",
+ visibility: "Only dictionary relations visible to the current account are shown.",
+ empty: "No records are visible to the current account.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "Dependencies",
diff --git a/apps/desktop/src/i18n/locales/es.ts b/apps/desktop/src/i18n/locales/es.ts
index 07be9458ff..bbd693a4a5 100644
--- a/apps/desktop/src/i18n/locales/es.ts
+++ b/apps/desktop/src/i18n/locales/es.ts
@@ -67,6 +67,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "Relaciones",
+ foreignKeys: "Claves externas",
+ ownership: "Padre e hijos",
+ references: "Tablas referenciadas",
+ referencedBy: "Tablas que hacen referencia",
+ parent: "Objeto padre",
+ unresolved: "Identidad del destino no disponible",
+ incomplete: "Algunas columnas o destinos no son visibles. El mapeo puede estar incompleto.",
+ visibility: "Solo se muestran relaciones del diccionario visibles para la cuenta actual.",
+ empty: "No hay registros visibles para la cuenta actual.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "Dependencias",
diff --git a/apps/desktop/src/i18n/locales/it.ts b/apps/desktop/src/i18n/locales/it.ts
index ccd78f58ae..349e8c95d8 100644
--- a/apps/desktop/src/i18n/locales/it.ts
+++ b/apps/desktop/src/i18n/locales/it.ts
@@ -65,6 +65,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "Relazioni",
+ foreignKeys: "Chiavi esterne",
+ ownership: "Padre e figli",
+ references: "Tabelle referenziate",
+ referencedBy: "Tabelle referenzianti",
+ parent: "Oggetto padre",
+ unresolved: "Identità di destinazione non disponibile",
+ incomplete: "Alcune colonne o destinazioni non sono visibili. La mappatura può essere incompleta.",
+ visibility: "Sono mostrate solo le relazioni del dizionario visibili all'account corrente.",
+ empty: "Nessun record visibile all'account corrente.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "Dipendenze",
diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.ts
index 8110a27d7b..558e8df8c3 100644
--- a/apps/desktop/src/i18n/locales/ja.ts
+++ b/apps/desktop/src/i18n/locales/ja.ts
@@ -66,6 +66,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "関連",
+ foreignKeys: "外部キー",
+ ownership: "親と子のオブジェクト",
+ references: "参照先テーブル",
+ referencedBy: "参照元テーブル",
+ parent: "親オブジェクト",
+ unresolved: "参照先を特定できません",
+ incomplete: "一部の列または参照先は表示されていません。列の対応が不完全な可能性があります。",
+ visibility: "現在のアカウントから参照できるディクショナリの関連のみ表示します。",
+ empty: "現在のアカウントから参照できる記録はありません。",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "依存先",
diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.ts
index aadd213aa4..92c22efb57 100644
--- a/apps/desktop/src/i18n/locales/ko.ts
+++ b/apps/desktop/src/i18n/locales/ko.ts
@@ -65,6 +65,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "관계",
+ foreignKeys: "외래 키",
+ ownership: "부모 및 자식 객체",
+ references: "참조하는 테이블",
+ referencedBy: "이 테이블을 참조하는 테이블",
+ parent: "부모 객체",
+ unresolved: "대상 정보를 확인할 수 없습니다",
+ incomplete: "일부 열 또는 대상을 볼 수 없어 열 매핑이 불완전할 수 있습니다.",
+ visibility: "현재 계정에서 볼 수 있는 사전 관계만 표시합니다.",
+ empty: "현재 계정에서 볼 수 있는 기록이 없습니다.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "의존하는 객체",
diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.ts
index 993f6b1b79..9f1d8dcb01 100644
--- a/apps/desktop/src/i18n/locales/pt-BR.ts
+++ b/apps/desktop/src/i18n/locales/pt-BR.ts
@@ -66,6 +66,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "Relações",
+ foreignKeys: "Chaves estrangeiras",
+ ownership: "Pai e filhos",
+ references: "Tabelas referenciadas",
+ referencedBy: "Tabelas que referenciam",
+ parent: "Objeto pai",
+ unresolved: "Identidade do destino indisponível",
+ incomplete: "Algumas colunas ou destinos não estão visíveis. O mapeamento pode estar incompleto.",
+ visibility: "Apenas relações do dicionário visíveis para a conta atual são mostradas.",
+ empty: "Nenhum registro visível para a conta atual.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "Dependências",
diff --git a/apps/desktop/src/i18n/locales/ru.ts b/apps/desktop/src/i18n/locales/ru.ts
index fdd1c6d4d0..8fe110f755 100644
--- a/apps/desktop/src/i18n/locales/ru.ts
+++ b/apps/desktop/src/i18n/locales/ru.ts
@@ -8,6 +8,18 @@ import { meilisearchManagementRu } from "./meilisearchManagement";
// Russian locale. Entries omitted here fall back to English at runtime.
export default withEnglishFallback({
+ objectRelations: {
+ title: "Связи",
+ foreignKeys: "Внешние ключи",
+ ownership: "Родитель и дочерние объекты",
+ references: "Целевые таблицы",
+ referencedBy: "Ссылающиеся таблицы",
+ parent: "Родительский объект",
+ unresolved: "Идентификатор цели недоступен",
+ incomplete: "Некоторые столбцы или цели не видны. Сопоставление может быть неполным.",
+ visibility: "Показаны только связи словаря, видимые текущей учётной записи.",
+ empty: "Нет записей, видимых текущей учётной записи.",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "Зависимости",
diff --git a/apps/desktop/src/i18n/locales/th.ts b/apps/desktop/src/i18n/locales/th.ts
index 363aeae8c4..e5f599d493 100644
--- a/apps/desktop/src/i18n/locales/th.ts
+++ b/apps/desktop/src/i18n/locales/th.ts
@@ -50,6 +50,18 @@ const damengDump = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "ความสัมพันธ์",
+ foreignKeys: "คีย์นอก",
+ ownership: "วัตถุแม่และลูก",
+ references: "ตารางที่อ้างอิงถึง",
+ referencedBy: "ตารางที่อ้างอิงตารางนี้",
+ parent: "วัตถุแม่",
+ unresolved: "ไม่สามารถระบุวัตถุเป้าหมายได้",
+ incomplete: "บางคอลัมน์หรือเป้าหมายมองไม่เห็น การจับคู่คอลัมน์อาจไม่ครบถ้วน",
+ visibility: "แสดงเฉพาะความสัมพันธ์ในพจนานุกรมที่บัญชีปัจจุบันมองเห็น",
+ empty: "ไม่มีรายการที่บัญชีปัจจุบันมองเห็น",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "วัตถุที่พึ่งพา",
diff --git a/apps/desktop/src/i18n/locales/zh-CN.ts b/apps/desktop/src/i18n/locales/zh-CN.ts
index 0648200dcb..1862d566b9 100644
--- a/apps/desktop/src/i18n/locales/zh-CN.ts
+++ b/apps/desktop/src/i18n/locales/zh-CN.ts
@@ -11,6 +11,18 @@ import { mongodbDatabaseDumpZhCN as mongoDump } from "./mongodbDatabaseDump";
import { damengDumpZhCN as damengDump } from "./damengDump";
export default withEnglishFallback({
+ objectRelations: {
+ title: "关系",
+ foreignKeys: "外键引用",
+ ownership: "所属与子对象",
+ references: "引用的表",
+ referencedBy: "引用此表的表",
+ parent: "所属对象",
+ unresolved: "目标身份不可见",
+ incomplete: "部分列或目标不可见,已读取的列可能不完整。",
+ visibility: "仅显示当前账号可见的字典关系。",
+ empty: "当前账号可见范围内无记录。",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "依赖对象",
diff --git a/apps/desktop/src/i18n/locales/zh-TW.ts b/apps/desktop/src/i18n/locales/zh-TW.ts
index 8439b12ab5..822438a522 100644
--- a/apps/desktop/src/i18n/locales/zh-TW.ts
+++ b/apps/desktop/src/i18n/locales/zh-TW.ts
@@ -67,6 +67,18 @@ const consul = {
};
export default withEnglishFallback({
+ objectRelations: {
+ title: "關係",
+ foreignKeys: "外鍵參照",
+ ownership: "所屬與子物件",
+ references: "參照的資料表",
+ referencedBy: "參照此表的資料表",
+ parent: "所屬物件",
+ unresolved: "目標身分不可見",
+ incomplete: "部分欄位或目標不可見,已讀取的欄位可能不完整。",
+ visibility: "僅顯示目前帳號可見的字典關係。",
+ empty: "目前帳號可見範圍內沒有記錄。",
+ },
tableColumnPaste,
objectDependencies: {
dependencies: "依賴物件",
diff --git a/apps/desktop/src/lib/__tests__/database/databaseObjectDependencies.spec.ts b/apps/desktop/src/lib/__tests__/database/databaseObjectDependencies.spec.ts
index 429cea6f66..07ac4b87c9 100644
--- a/apps/desktop/src/lib/__tests__/database/databaseObjectDependencies.spec.ts
+++ b/apps/desktop/src/lib/__tests__/database/databaseObjectDependencies.spec.ts
@@ -25,6 +25,14 @@ describe("database dependency providers", () => {
expect(canViewDatabaseObjectDependencies("postgres", node())).toBe(false);
});
+ it.each(["oracle", "oceanbase-oracle"] as const)("exposes table and view relations through the existing provider in %s", (databaseType) => {
+ for (const type of ["table", "view", "materialized_view"] as const) {
+ const target = node({ type });
+ expect(canViewDatabaseObjectDependencies(databaseType, target)).toBe(true);
+ expect(databaseDependencyProviderFor(databaseType)?.buildQuery(target)).toContain("ALL_DEPENDENCIES");
+ }
+ });
+
it("does not expose package members or incomplete nodes", () => {
const provider = databaseDependencyProviderFor("xugu");
expect(provider).not.toBeNull();
diff --git a/apps/desktop/src/lib/__tests__/database/objectDependencyDetails.spec.ts b/apps/desktop/src/lib/__tests__/database/objectDependencyDetails.spec.ts
index b3fa989076..d8523859cf 100644
--- a/apps/desktop/src/lib/__tests__/database/objectDependencyDetails.spec.ts
+++ b/apps/desktop/src/lib/__tests__/database/objectDependencyDetails.spec.ts
@@ -1,5 +1,5 @@
import { describe, expect, it } from "vitest";
-import { isObjectDependencySection, objectDependencyNavigation, objectDependencyRows, objectDependencySql, objectDependencyTarget, type ObjectDependencyRow } from "@/lib/database/objectDependencyDetails";
+import { isObjectDependencySection, objectDependencyNavigation, objectDependencyRows, objectDependencySql, objectDependencyTarget, objectForeignKeyRows, objectOwnershipRows, relationObjectNavigation, type ObjectDependencyRow } from "@/lib/database/objectDependencyDetails";
import { oracleObjectDependenciesSql } from "@/lib/database/oracleObjectDependencies";
import { normalizeOracleNavigationTarget, sqlObjectNavigationContextTarget, sqlObjectNavigationSourceKind } from "@/lib/sql/sqlNavigation";
import type { QueryResult, QueryTab } from "@/types/database";
@@ -14,7 +14,8 @@ describe("object dependency details", () => {
expect(objectDependencySql(target)).toBe(oracleObjectDependenciesSql({ schema: details.schema, objectName: details.name, objectType: "PROCEDURE" }));
expect(objectDependencyTarget({ ...details, objectType: "PACKAGE_BODY" }, "oracle")?.objectType).toBe("PACKAGE");
expect(objectDependencyTarget(details, "xugu")).toBeUndefined();
- expect(objectDependencyTarget({ ...details, objectType: "TYPE" }, "oracle")).toBeUndefined();
+ expect(objectDependencyTarget({ ...details, objectType: "TYPE" }, "oracle")?.objectType).toBe("TYPE");
+ expect(objectDependencyTarget({ ...details, objectType: "TABLE" }, "oracle")?.objectType).toBe("TABLE");
});
it("maps both directions from column names, retaining package body origin and nullable links", () => {
@@ -67,4 +68,49 @@ describe("object dependency details", () => {
expect(isObjectDependencySection({ ...tab, connectionId: "new" })).toBe(false);
expect(isObjectDependencySection({ ...tab, objectDetails: { ...details, section: "source" } })).toBe(false);
});
+
+ it("groups foreign keys by owner and direction and pairs columns by position rather than row order", () => {
+ const result: QueryResult = {
+ columns: ["DIRECTION", "CONSTRAINT_OWNER", "CONSTRAINT_NAME", "CHILD_OWNER", "CHILD_NAME", "CHILD_COLUMN", "POSITION", "PARENT_OWNER", "PARENT_NAME", "PARENT_COLUMN", "COLUMN_COUNT"],
+ rows: [
+ ["REFERENCES", "Child.Owner", "Same.FK", "Child.Owner", "Child.Table", "C Two", 2, "Parent.Owner", "Parent.Table", "P Two", 2],
+ ["REFERENCES", "Child.Owner", "Same.FK", "Child.Owner", "Child.Table", "C One", 1, "Parent.Owner", "Parent.Table", "P One", 2],
+ ["REFERENCED_BY", "Child.Owner", "Same.FK", "Child.Owner", "Child.Table", "C One", 1, "Parent.Owner", "Parent.Table", "P One", 2],
+ ["REFERENCES", "Hidden", "Same.FK", "Hidden", "T", "C", 1, null, null, null, 1],
+ ],
+ affected_rows: 0,
+ execution_time_ms: 1,
+ };
+ const rows = objectForeignKeyRows(result);
+ expect(rows).toHaveLength(3);
+ expect(rows[0]).toMatchObject({
+ direction: "REFERENCES",
+ complete: true,
+ parent: { schema: "Parent.Owner", name: "Parent.Table" },
+ columns: [
+ { position: 1, child: "C One", parent: "P One" },
+ { position: 2, child: "C Two", parent: "P Two" },
+ ],
+ });
+ expect(rows[1]?.complete).toBe(false);
+ expect(rows[2]?.complete).toBe(false);
+ expect(relationObjectNavigation(rows[2]!.parent)).toBeUndefined();
+ });
+
+ it("retains both owners and rejects schema triggers as fabricated table parents", () => {
+ const rows = objectOwnershipRows({
+ columns: ["CHILD_OWNER", "CHILD_NAME", "CHILD_TYPE", "PARENT_OWNER", "PARENT_NAME", "PARENT_TYPE"],
+ rows: [
+ ["Other", "Idx.Dot", "INDEX", "Parent", "Table.Dot", "TABLE"],
+ ["Other", "Tr", "TRIGGER", null, null, "SCHEMA"],
+ ],
+ affected_rows: 0,
+ execution_time_ms: 1,
+ });
+ expect(rows[0]?.child).toEqual({ schema: "Other", name: "Idx.Dot", type: "INDEX" });
+ expect(relationObjectNavigation(rows[0]!.parent)).toMatchObject({ schema: "Parent", name: "Table.Dot", type: "table", nameQuoted: true });
+ expect(relationObjectNavigation(rows[1]!.parent)).toBeUndefined();
+ expect(objectDependencySql({ ...details, objectType: "TABLE" }, "foreignKeys")).toContain("ALL_CONSTRAINTS");
+ expect(() => objectDependencySql({ ...details, objectType: "PROCEDURE" }, "foreignKeys")).toThrow("not supported");
+ });
});
diff --git a/apps/desktop/src/lib/__tests__/database/oracleObjectDependencies.spec.ts b/apps/desktop/src/lib/__tests__/database/oracleObjectDependencies.spec.ts
index 6cb32952bc..4bc0a5f54e 100644
--- a/apps/desktop/src/lib/__tests__/database/oracleObjectDependencies.spec.ts
+++ b/apps/desktop/src/lib/__tests__/database/oracleObjectDependencies.spec.ts
@@ -48,6 +48,7 @@ describe("Oracle object dependencies", () => {
expect(oracleDependencyProvider.buildQuery(node({ schema: undefined }))).toBeNull();
expect(oracleDependencyProvider.supports(node({ type: "procedure", parentType: "package", parentName: "PKG" }))).toBe(false);
expect(oracleDependencyProvider.supports(node({ type: "procedure", parentType: "package", parentName: "PKG", parentSchema: undefined }))).toBe(false);
- expect(oracleDependencyProvider.supports(node({ type: "trigger" }))).toBe(false);
+ expect(oracleDependencyProvider.supports(node({ type: "column" }))).toBe(false);
+ expect(oracleDependencyProvider.supports(node({ type: "trigger" }))).toBe(true);
});
});
diff --git a/apps/desktop/src/lib/database/databaseObjectDependencies.ts b/apps/desktop/src/lib/database/databaseObjectDependencies.ts
index 72b71b1f1c..f031d6e04d 100644
--- a/apps/desktop/src/lib/database/databaseObjectDependencies.ts
+++ b/apps/desktop/src/lib/database/databaseObjectDependencies.ts
@@ -1,6 +1,7 @@
import type { DatabaseType, TreeNode } from "@/types/database";
import { xuguDependencyProvider } from "@/lib/database/xuguObjectDependencies";
import { oracleDependencyProvider } from "@/lib/database/oracleObjectDependencies";
+import { supportsTypeObjectSource } from "@/lib/database/databaseObjectCapabilities";
/**
* The subset of a sidebar node needed by a database dependency provider.
@@ -33,5 +34,9 @@ export function databaseDependencyProviderFor(databaseType?: DatabaseType): Data
}
export function canViewDatabaseObjectDependencies(databaseType: DatabaseType | undefined, node: DependencyTreeNode): boolean {
+ if (databaseType === "oracle" || databaseType === "oceanbase-oracle") {
+ if ((node.type === "type" || node.type === "type-body") && !supportsTypeObjectSource(databaseType)) return false;
+ if (node.type === "index" && (!node.parentName || !node.parentSchema)) return false;
+ }
return databaseDependencyProviderFor(databaseType)?.supports(node) ?? false;
}
diff --git a/apps/desktop/src/lib/database/objectDependencyDetails.ts b/apps/desktop/src/lib/database/objectDependencyDetails.ts
index d7706268a6..4327e3716e 100644
--- a/apps/desktop/src/lib/database/objectDependencyDetails.ts
+++ b/apps/desktop/src/lib/database/objectDependencyDetails.ts
@@ -1,6 +1,6 @@
import type { DatabaseType, QueryResult, QueryTab } from "@/types/database";
import type { SqlObjectNavigationTarget, SqlObjectNavigationType } from "@/lib/sql/sqlNavigation";
-import { oracleObjectDependenciesSql, type OracleDependencyObjectType } from "@/lib/database/oracleObjectDependencies";
+import { oracleObjectRelationsSql, oracleObjectRelationKinds, type ObjectRelationKind, type OracleDependencyObjectType } from "@/lib/database/oracleObjectDependencies";
export type ObjectDetails = NonNullable<QueryTab["objectDetails"]>;
export type ObjectDetailsSection = ObjectDetails["section"];
@@ -8,7 +8,12 @@ export function isObjectDependencySection(tab: QueryTab): boolean {
const details = tab.objectDetails;
return !!details && details.section !== "source" && details.connectionId === tab.connectionId && details.database === tab.database && details.schema === (tab.schema || tab.database) && (details.catalog || "") === (tab.catalog || "");
}
-export interface ObjectDependencyTarget extends Omit<ObjectDetails, "section" | "objectType"> {
+export interface ObjectDependencyTarget {
+ connectionId: string;
+ database: string;
+ schema: string;
+ catalog?: string;
+ name: string;
objectType: OracleDependencyObjectType;
}
@@ -22,16 +27,96 @@ export interface ObjectDependencyRow {
sourceType: string;
}
-export function objectDependencyTarget(details: QueryTab["objectDetails"], databaseType?: DatabaseType): ObjectDependencyTarget | undefined {
+export function objectDependencyTarget(details: (Omit<ObjectDependencyTarget, "objectType"> & { objectType: string; section?: ObjectDetailsSection }) | undefined, databaseType?: DatabaseType): ObjectDependencyTarget | undefined {
if (!details || (databaseType !== "oracle" && databaseType !== "oceanbase-oracle")) return;
const type = details.objectType === "PACKAGE_BODY" ? "PACKAGE" : details.objectType;
- if (type !== "PROCEDURE" && type !== "FUNCTION" && type !== "PACKAGE") return;
+ if (!["TABLE", "VIEW", "MATERIALIZED_VIEW", "PROCEDURE", "FUNCTION", "PACKAGE", "TYPE", "TYPE_BODY", "SEQUENCE", "SYNONYM", "TRIGGER", "INDEX"].includes(type)) return;
const { section: _section, ...identity } = details;
- return { ...identity, objectType: type };
+ return { ...identity, objectType: type as OracleDependencyObjectType };
+}
+
+export function objectDependencySql(target: ObjectDependencyTarget, kind: ObjectRelationKind = "dependencies"): string {
+ return oracleObjectRelationsSql({ schema: target.schema, objectName: target.name, objectType: target.objectType }, kind);
+}
+
+export const objectRelationKinds = (target: ObjectDependencyTarget) => oracleObjectRelationKinds(target.objectType);
+
+export interface RelationObjectIdentity {
+ schema: string;
+ name: string;
+ type: string;
+}
+export interface ObjectForeignKeyRow {
+ kind: "foreignKey";
+ direction: "REFERENCES" | "REFERENCED_BY";
+ constraintOwner: string;
+ constraintName: string;
+ child: RelationObjectIdentity;
+ parent: RelationObjectIdentity;
+ columns: { position: number; child: string; parent: string }[];
+ complete: boolean;
+}
+export interface ObjectOwnershipRow {
+ kind: "ownership";
+ child: RelationObjectIdentity;
+ parent: RelationObjectIdentity;
+}
+
+function resultReader(result: QueryResult, required: string[]) {
+ const indexes = new Map(result.columns.map((name, index) => [name.toUpperCase(), index]));
+ if (required.some((name) => !indexes.has(name))) throw new Error("The relation query returned an unexpected column layout.");
+ return (row: unknown[], name: string) => String(row[indexes.get(name)!] ?? "");
+}
+
+export function objectForeignKeyRows(result: QueryResult): ObjectForeignKeyRow[] {
+ const value = resultReader(result, ["DIRECTION", "CONSTRAINT_OWNER", "CONSTRAINT_NAME", "CHILD_OWNER", "CHILD_NAME", "CHILD_COLUMN", "POSITION", "PARENT_OWNER", "PARENT_NAME", "PARENT_COLUMN", "COLUMN_COUNT"]);
+ const groups = new Map<string, ObjectForeignKeyRow>();
+ const expectedCounts = new Map<string, number>();
+ for (const row of result.rows) {
+ const get = (name: string) => value(row, name);
+ const direction = get("DIRECTION");
+ if (direction !== "REFERENCES" && direction !== "REFERENCED_BY") throw new Error("The foreign key query returned an unknown direction.");
+ const key = JSON.stringify([direction, get("CONSTRAINT_OWNER"), get("CONSTRAINT_NAME")]);
+ let group = groups.get(key);
+ if (!group) {
+ group = {
+ kind: "foreignKey",
+ direction,
+ constraintOwner: get("CONSTRAINT_OWNER"),
+ constraintName: get("CONSTRAINT_NAME"),
+ child: { schema: get("CHILD_OWNER"), name: get("CHILD_NAME"), type: "TABLE" },
+ parent: { schema: get("PARENT_OWNER"), name: get("PARENT_NAME"), type: "TABLE" },
+ columns: [],
+ complete: true,
+ };
+ groups.set(key, group);
+ expectedCounts.set(key, Number(get("COLUMN_COUNT")));
+ }
+ group.columns.push({ position: Number(get("POSITION")), child: get("CHILD_COLUMN"), parent: get("PARENT_COLUMN") });
+ if (!group.parent.name || !group.parent.schema || !get("PARENT_COLUMN") || !get("CHILD_COLUMN") || !Number(get("POSITION"))) group.complete = false;
+ // COLUMN_COUNT is from the visible child constraint, not the truncated result.
+ if (!Number(get("COLUMN_COUNT"))) group.complete = false;
+ }
+ for (const [key, group] of groups) {
+ group.columns.sort((a, b) => a.position - b.position);
+ group.complete &&= group.columns.length === expectedCounts.get(key) && group.columns.every((column, index) => column.position === index + 1);
+ }
+ return [...groups.values()];
+}
+
+export function objectOwnershipRows(result: QueryResult): ObjectOwnershipRow[] {
+ const value = resultReader(result, ["CHILD_OWNER", "CHILD_NAME", "CHILD_TYPE", "PARENT_OWNER", "PARENT_NAME", "PARENT_TYPE"]);
+ return result.rows.map((row) => ({ kind: "ownership", child: { schema: value(row, "CHILD_OWNER"), name: value(row, "CHILD_NAME"), type: value(row, "CHILD_TYPE") }, parent: { schema: value(row, "PARENT_OWNER"), name: value(row, "PARENT_NAME"), type: value(row, "PARENT_TYPE") } }));
+}
+
+export function relationObjectNavigation(object: RelationObjectIdentity): SqlObjectNavigationTarget | undefined {
+ return objectDependencyNavigation({ direction: "DEPENDS_ON", ...object, dependencyType: "", link: "", sourceType: "" });
}
-export function objectDependencySql(target: ObjectDependencyTarget): string {
- return oracleObjectDependenciesSql({ schema: target.schema, objectName: target.name, objectType: target.objectType });
+export function objectOwnershipNavigation(row: ObjectOwnershipRow): SqlObjectNavigationTarget | undefined {
+ if (row.child.type !== "INDEX") return relationObjectNavigation(row.child);
+ if (!row.child.name || !row.child.schema || row.parent.type !== "TABLE" || !row.parent.name || !row.parent.schema) return;
+ return { name: row.child.name, schema: row.child.schema, type: "index", parentName: row.parent.name, parentSchema: row.parent.schema, nameQuoted: true, schemaQuoted: true, parentNameQuoted: true, parentSchemaQuoted: true };
}
export function objectDependencyRows(result: QueryResult): ObjectDependencyRow[] {
@@ -67,6 +152,7 @@ export function objectDependencyNavigation(row: ObjectDependencyRow): SqlObjectN
PACKAGE: "package",
"PACKAGE BODY": "package_body",
SEQUENCE: "sequence",
+ SYNONYM: "synonym",
TRIGGER: "trigger",
};
const type = types[row.type];
diff --git a/apps/desktop/src/lib/database/oracleObjectDependencies.ts b/apps/desktop/src/lib/database/oracleObjectDependencies.ts
index bcb8ca4da6..c220d826a1 100644
--- a/apps/desktop/src/lib/database/oracleObjectDependencies.ts
+++ b/apps/desktop/src/lib/database/oracleObjectDependencies.ts
@@ -1,14 +1,17 @@
import type { TreeNodeType } from "@/types/database";
import type { DatabaseDependencyProvider, DependencyTreeNode } from "@/lib/database/databaseObjectDependencies";
-export type OracleDependencyObjectType = "PROCEDURE" | "FUNCTION" | "PACKAGE";
+export type OracleDependencyObjectType = "TABLE" | "VIEW" | "MATERIALIZED_VIEW" | "PROCEDURE" | "FUNCTION" | "PACKAGE" | "TYPE" | "TYPE_BODY" | "SEQUENCE" | "SYNONYM" | "TRIGGER" | "INDEX";
+export type ObjectRelationKind = "dependencies" | "foreignKeys" | "ownership";
+
+const dictionaryType = (type: OracleDependencyObjectType) => type.replaceAll("_", " ");
/** Direct Oracle dictionary dependency rows, visible to the current account. */
export function oracleObjectDependenciesSql(options: { schema: string; objectName: string; objectType: OracleDependencyObjectType }): string {
const owner = quoteSqlString(options.schema);
const name = quoteSqlString(options.objectName);
- const typeFilter = options.objectType === "PACKAGE" ? "d.TYPE IN ('PACKAGE', 'PACKAGE BODY')" : `d.TYPE = '${options.objectType}'`;
- const referenceTypeFilter = options.objectType === "PACKAGE" ? "d.REFERENCED_TYPE IN ('PACKAGE', 'PACKAGE BODY')" : `d.REFERENCED_TYPE = '${options.objectType}'`;
+ const typeFilter = options.objectType === "PACKAGE" ? "d.TYPE IN ('PACKAGE', 'PACKAGE BODY')" : `d.TYPE = '${dictionaryType(options.objectType)}'`;
+ const referenceTypeFilter = options.objectType === "PACKAGE" ? "d.REFERENCED_TYPE IN ('PACKAGE', 'PACKAGE BODY')" : `d.REFERENCED_TYPE = '${dictionaryType(options.objectType)}'`;
const scopeNote = options.objectType === "PACKAGE" ? " Package/body scope, not member-level dependencies." : "";
return `-- Direct dependencies and reverse references visible to the current account via ALL_DEPENDENCIES. Dynamic SQL references may be absent.${scopeNote}
SELECT 'DEPENDS_ON' AS DIRECTION,
@@ -58,10 +61,63 @@ export function oracleTarget(node: DependencyTreeNode): { schema: string; name:
}
function oracleTypeForTreeNode(type: TreeNodeType): OracleDependencyObjectType | null {
- if (type === "procedure") return "PROCEDURE";
- if (type === "function") return "FUNCTION";
- if (type === "package") return "PACKAGE";
- return null;
+ const types: Partial<Record<TreeNodeType, OracleDependencyObjectType>> = {
+ table: "TABLE",
+ view: "VIEW",
+ materialized_view: "MATERIALIZED_VIEW",
+ procedure: "PROCEDURE",
+ function: "FUNCTION",
+ package: "PACKAGE",
+ "package-body": "PACKAGE",
+ type: "TYPE",
+ "type-body": "TYPE_BODY",
+ sequence: "SEQUENCE",
+ synonym: "SYNONYM",
+ trigger: "TRIGGER",
+ index: "INDEX",
+ };
+ return types[type] ?? null;
+}
+
+export function oracleObjectRelationKinds(type: OracleDependencyObjectType): ObjectRelationKind[] {
+ return ["dependencies", ...(type === "TABLE" ? ["foreignKeys" as const] : []), ...(["TABLE", "VIEW", "MATERIALIZED_VIEW", "TRIGGER", "INDEX"].includes(type) ? ["ownership" as const] : [])];
+}
+
+export function oracleObjectRelationsSql(target: { schema: string; objectName: string; objectType: OracleDependencyObjectType }, kind: ObjectRelationKind): string {
+ if (kind === "dependencies") return oracleObjectDependenciesSql(target);
+ if (!oracleObjectRelationKinds(target.objectType).includes(kind)) throw new Error("This relation kind is not supported for this object.");
+ const owner = quoteSqlString(target.schema),
+ name = quoteSqlString(target.objectName);
+ if (kind === "foreignKeys") {
+ const select = (direction: string, filter: string) => `SELECT '${direction}' AS DIRECTION,
+ f.OWNER AS CONSTRAINT_OWNER, f.CONSTRAINT_NAME,
+ f.OWNER AS CHILD_OWNER, f.TABLE_NAME AS CHILD_NAME,
+ cc.COLUMN_NAME AS CHILD_COLUMN, cc.POSITION,
+ f.R_OWNER AS PARENT_OWNER, p.TABLE_NAME AS PARENT_NAME, pc.COLUMN_NAME AS PARENT_COLUMN,
+ (SELECT COUNT(*) FROM ALL_CONS_COLUMNS cols WHERE cols.OWNER = f.OWNER AND cols.CONSTRAINT_NAME = f.CONSTRAINT_NAME) AS COLUMN_COUNT
+FROM ALL_CONSTRAINTS f
+LEFT JOIN ALL_CONS_COLUMNS cc ON cc.OWNER = f.OWNER AND cc.CONSTRAINT_NAME = f.CONSTRAINT_NAME
+LEFT JOIN ALL_CONSTRAINTS p ON p.OWNER = f.R_OWNER AND p.CONSTRAINT_NAME = f.R_CONSTRAINT_NAME AND p.CONSTRAINT_TYPE IN ('P', 'U')
+LEFT JOIN ALL_CONS_COLUMNS pc ON pc.OWNER = p.OWNER AND pc.CONSTRAINT_NAME = p.CONSTRAINT_NAME AND pc.POSITION = cc.POSITION
+WHERE f.CONSTRAINT_TYPE = 'R' AND ${filter}`;
+ return `${select("REFERENCES", `f.OWNER = ${owner} AND f.TABLE_NAME = ${name}`)}
+UNION ALL
+${select("REFERENCED_BY", `p.OWNER = ${owner} AND p.TABLE_NAME = ${name}`)}
+ORDER BY 1, 2, 3, 7`;
+ }
+ const child = target.objectType === "INDEX" || target.objectType === "TRIGGER";
+ const queries: string[] = [];
+ if (target.objectType !== "TRIGGER")
+ queries.push(`SELECT i.OWNER AS CHILD_OWNER, i.INDEX_NAME AS CHILD_NAME, 'INDEX' AS CHILD_TYPE,
+ i.TABLE_OWNER AS PARENT_OWNER, i.TABLE_NAME AS PARENT_NAME,
+ CASE WHEN EXISTS (SELECT 1 FROM ALL_OBJECTS o WHERE o.OWNER = i.TABLE_OWNER AND o.OBJECT_NAME = i.TABLE_NAME AND o.OBJECT_TYPE = 'MATERIALIZED VIEW') THEN 'MATERIALIZED VIEW' ELSE 'TABLE' END AS PARENT_TYPE
+FROM ALL_INDEXES i WHERE ${child ? `i.OWNER = ${owner} AND i.INDEX_NAME = ${name}` : `i.TABLE_OWNER = ${owner} AND i.TABLE_NAME = ${name}`}`);
+ if (target.objectType !== "INDEX")
+ queries.push(`SELECT t.OWNER AS CHILD_OWNER, t.TRIGGER_NAME AS CHILD_NAME, 'TRIGGER' AS CHILD_TYPE,
+ t.TABLE_OWNER AS PARENT_OWNER, t.TABLE_NAME AS PARENT_NAME,
+ CASE WHEN EXISTS (SELECT 1 FROM ALL_OBJECTS o WHERE o.OWNER = t.TABLE_OWNER AND o.OBJECT_NAME = t.TABLE_NAME AND o.OBJECT_TYPE = 'MATERIALIZED VIEW') THEN 'MATERIALIZED VIEW' ELSE t.BASE_OBJECT_TYPE END AS PARENT_TYPE
+FROM ALL_TRIGGERS t WHERE ${child ? `t.OWNER = ${owner} AND t.TRIGGER_NAME = ${name}` : `t.TABLE_OWNER = ${owner} AND t.TABLE_NAME = ${name}`}`);
+ return `${queries.join("\nUNION ALL\n")}\nORDER BY 1, 2, 3`;
}
export const oracleDependencyProvider: DatabaseDependencyProvider = {
diff --git a/apps/desktop/src/lib/sql/sqlNavigation.ts b/apps/desktop/src/lib/sql/sqlNavigation.ts
index fe8dc9bacc..5f81640651 100644
--- a/apps/desktop/src/lib/sql/sqlNavigation.ts
+++ b/apps/desktop/src/lib/sql/sqlNavigation.ts
@@ -135,7 +135,7 @@ export interface ExtractedSqlIdentifierPart {
quoted: boolean;
}
-export type SqlObjectNavigationType = "table" | "view" | "materialized_view" | "procedure" | "function" | "package" | "package_body" | "sequence" | "trigger";
+export type SqlObjectNavigationType = "table" | "view" | "materialized_view" | "procedure" | "function" | "package" | "package_body" | "sequence" | "synonym" | "trigger" | "index";
/**
* Semantic role of a Ctrl/Cmd+clicked identifier for navigation.
@@ -222,7 +222,7 @@ export function sqlObjectNavigationTarget(table: SqlObjectNavigationTarget): Sql
}
export function isSqlObjectNavigationRoutineType(type?: SqlObjectNavigationType): boolean {
- return type === "procedure" || type === "function" || type === "package" || type === "package_body" || type === "sequence" || type === "trigger";
+ return type === "procedure" || type === "function" || type === "package" || type === "package_body" || type === "sequence" || type === "synonym" || type === "trigger";
}
export function sqlObjectHoverDetail(table: SqlObjectNavigationTarget): string {
@@ -264,6 +264,8 @@ export function sqlObjectNavigationSourceKind(table: SqlObjectNavigationTarget):
return "PACKAGE_BODY";
case "sequence":
return "SEQUENCE";
+ case "synonym":
+ return "SYNONYM";
case "trigger":
return "TRIGGER";
default:
diff --git a/apps/desktop/src/stores/__tests__/queryStore.objectDetails.spec.ts b/apps/desktop/src/stores/__tests__/queryStore.objectDetails.spec.ts
index 63f6d9ce7e..88388b7410 100644
--- a/apps/desktop/src/stores/__tests__/queryStore.objectDetails.spec.ts
+++ b/apps/desktop/src/stores/__tests__/queryStore.objectDetails.spec.ts
@@ -13,6 +13,7 @@ const backend = vi.hoisted(() => ({
buildEditableObjectSource: vi.fn(async (input: { source: string }) => input.source),
executeQuery: vi.fn(),
executeMulti: vi.fn(),
+ analyzeEditableQueryEditability: vi.fn(async () => ({ editable: false, reason: "computed-columns" })),
prepareQueryPaginationExecutionPlan: vi.fn(async (input: { sql: string }) => ({ sqlToExecute: input.sql })),
checkConnectionHealth: vi.fn(async () => undefined),
saveOpenTabsState: vi.fn(async () => {}),
@@ -105,5 +106,7 @@ describe("object detail identity through the real source store", () => {
const outcome = await execution.tryExecute();
expect(outcome, JSON.stringify(outcome)).toMatchObject({ status: "started", ok: true });
expect(backend.executeMulti).toHaveBeenCalledWith("oracle-1", "ORCL", "SELECT 1 FROM DUAL", "APP", expect.any(String), expect.any(Object));
+ await vi.waitFor(() => expect(tab.queryEditabilityReason).toBe("computed-columns"));
+ expect(backend.analyzeEditableQueryEditability).toHaveBeenCalledWith("SELECT 1 FROM DUAL");
});
});
diff --git a/apps/desktop/src/stores/queryStore.ts b/apps/desktop/src/stores/queryStore.ts
index e2bdf458dd..edf9024ff1 100644
--- a/apps/desktop/src/stores/queryStore.ts
+++ b/apps/desktop/src/stores/queryStore.ts
@@ -3560,6 +3560,13 @@ export const useQueryStore = defineStore("query", () => {
return id;
}
+ function openObjectProperties(target: Omit<NonNullable<QueryTab["objectPropertiesRequest"]>, "requestId">) {
+ const id = openObjectBrowser(target.connectionId, target.database, target.schema, target.catalog);
+ const tab = tabs.value.find((candidate) => candidate.id === id);
+ if (tab) tab.objectPropertiesRequest = { ...target, requestId: uuid() };
+ return id;
+ }
+
function openObjectBrowser(
connectionId: string,
database: string,
@@ -11053,6 +11060,7 @@ export const useQueryStore = defineStore("query", () => {
openDatabaseSearch,
openDriverProfileWorkspace,
openObjectBrowser,
+ openObjectProperties,
openMongoGridFs,
openMongoBucket,
openUserAdmin,
diff --git a/apps/desktop/src/stores/settingsStore.ts b/apps/desktop/src/stores/settingsStore.ts
index ee81a82750..3452ce11dc 100644
--- a/apps/desktop/src/stores/settingsStore.ts
+++ b/apps/desktop/src/stores/settingsStore.ts
@@ -1955,7 +1955,7 @@ function normalizeToolbarItems(items: Partial<ToolbarItems> | undefined): Toolba
};
}
-const TABLE_INFO_TABS = new Set<TableInfoTab>(["info", "ddl", "columns", "indexes", "foreignKeys", "constraints", "triggers", "partitions"]);
+const TABLE_INFO_TABS = new Set<TableInfoTab>(["info", "ddl", "columns", "indexes", "foreignKeys", "constraints", "triggers", "partitions", "relations"]);
function normalizeTableInfoTab(value: unknown): TableInfoTab {
return typeof value === "string" && TABLE_INFO_TABS.has(value as TableInfoTab) ? (value as TableInfoTab) : DEFAULT_EDITOR_SETTINGS.tableInfoActiveTab;
diff --git a/apps/desktop/src/types/database.ts b/apps/desktop/src/types/database.ts
index 9b3d3ec4d0..33fad22630 100644
--- a/apps/desktop/src/types/database.ts
+++ b/apps/desktop/src/types/database.ts
@@ -1981,7 +1981,7 @@ export interface TableNameFilter {
excludePatterns: string[];
}
-export type TableInfoTab = "info" | "columns" | "indexes" | "foreignKeys" | "constraints" | "triggers" | "partitions" | "ddl";
+export type TableInfoTab = "info" | "columns" | "indexes" | "foreignKeys" | "constraints" | "triggers" | "partitions" | "ddl" | "relations";
/** PostgreSQL declarative partitioning strategy (`pg_partitioned_table.partstrat`). */
export type PgPartitionKind = "range" | "list" | "hash";
@@ -2423,6 +2423,18 @@ export interface QueryTab {
structureInitialTab?: TableInfoTab;
structureInitialTabRequestId?: number;
structureInitialTarget?: TableStructureEditorTarget;
+ /** Runtime-only request to locate an object in the existing read-only properties. */
+ objectPropertiesRequest?: {
+ requestId: string;
+ connectionId: string;
+ database: string;
+ schema: string;
+ catalog?: string;
+ name: string;
+ objectType: "TABLE" | "VIEW" | "MATERIALIZED_VIEW";
+ initialTab: TableInfoTab;
+ focusObject?: { owner: string; name: string; type: "INDEX" };
+ };
structureDraft?: TableStructureEditorDraft;
databaseSearchState?: DatabaseSearchTabState;
objectBrowser?: {
@@ -2453,7 +2465,7 @@ export interface QueryTab {
catalog?: string;
name: string;
objectType: ObjectSourceKind;
- section: "source" | "dependencies" | "dependents";
+ section: "source" | "dependencies" | "dependents" | "foreignKeys" | "ownership";
};
ddlViewer?: {
schema?: string;
diff --git a/docs/database-object-dependencies.md b/docs/database-object-dependencies.md
index ce1b639bb0..5f74309ef0 100644
--- a/docs/database-object-dependencies.md
+++ b/docs/database-object-dependencies.md
@@ -1,12 +1,20 @@
-# 查看 Oracle 例程依赖
+# 查看 Oracle 对象关系
在 Oracle 或 OceanBase Oracle 对象树中,右键过程、函数、程序包或程序包成员,选择「查看依赖关系」。DBX 会打开现有对象详情,直接显示依赖列表;显示为标签页还是弹窗,沿用源码打开方式设置。
+表和视图的同一菜单会打开对象浏览器的「关系」属性,不执行表数据查询。在对象浏览器的属性面板、表数据页或查询结果的表属性中,也可以选择「关系」。源码侧面板、源码弹窗和源码标签共用关系查看。
+
+![表属性中的跨 Schema 复合外键关系](./images/oracle-table-relations.jpg)
+
## 在对象详情中切换方向
- **源码**:查看或编辑原有源码。
-- **依赖对象**:当前例程直接依赖的对象。
-- **被依赖对象**:直接引用当前例程的对象。
+- **依赖对象**:当前对象直接依赖的对象。
+- **被依赖对象**:直接引用当前对象的对象。
+- **外键引用**:表引用的表,以及引用此表的表;显示约束名称和按位置配对的列。
+- **所属与子对象**:表的索引、触发器,或索引/触发器所属的对象。
+
+只显示当前对象适用的关系种类。表属性不提供源码保存入口;原有外键和索引编辑入口不变。
列表显示名称、类型、Schema 和依赖类型;有远程引用时显示数据库链接。程序包合并显示规范与包体记录,并保留来源类型。包内成员按所属程序包查询,不代表成员级依赖。
@@ -18,12 +26,16 @@
在源码弹窗中打开关联对象前,如果有未保存的修改,DBX 会要求确认是否放弃;取消后保留草稿。
+索引关系定位到所属表的只读索引属性,并保留索引自身与所属表的 Schema 和名称。TYPE/TYPE BODY 结果目前可以查看和复制,尚不能从关系列表打开类型管理。
+
「查看 SQL」在普通查询标签页中生成相应查询,不自动执行。依赖刷新使用独立只读查询,不覆盖源码标签页的 SQL、已有查询结果或手动事务。
## 目录范围与查询状态
列表来自 `ALL_DEPENDENCIES`,仅包含当前账户可见的直接目录记录,不递归展开依赖链。动态 SQL 中的引用可能缺失;空列表表示没有查到当前账户可见的直接记录。
+外键关系另从约束和约束列字典读取,不由对象依赖推断。所属关系来自索引和触发器字典。若当前账户只能看到部分外键列或引用目标,列表会保留已知关系并提示不完整,不将其视为完整的列映射。
+
出向依赖保留远端对象及链接名;通过链接引用的远端同名对象不会计作本地目标的引用者。DBX 不提权补查,也不自动解析同义词或远端链接。
加载、空结果、查询失败及结果截断分别显示。刷新失败时保留上次同一对象的成功结果,并可重试;截断提示表示列表可能不完整。
diff --git a/docs/images/oracle-table-relations.jpg b/docs/images/oracle-table-relations.jpg
new file mode 100644
index 0000000000..1ec72ff9da
Binary files /dev/null and b/docs/images/oracle-table-relations.jpg differ