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(oceanbase): add read-only constraints page in Oracle mode

efeire692c63b78723
diff --git a/agents/common/src/main/java/com/dbx/agent/ConstraintInfo.java b/agents/common/src/main/java/com/dbx/agent/ConstraintInfo.java
new file mode 100644
index 0000000000..cbed895861
--- /dev/null
+++ b/agents/common/src/main/java/com/dbx/agent/ConstraintInfo.java
@@ -0,0 +1,10 @@
+package com.dbx.agent;
+
+import java.util.List;
+
+/** Shared wire shape; null state properties mean the database did not report them. */
+public record ConstraintInfo(
+ String name, String constraint_type, String definition, List<String> columns,
+ Boolean deferrable, Boolean initially_deferred, Boolean enabled, Boolean valid
+) {
+}
diff --git a/agents/common/src/main/java/com/dbx/agent/DatabaseAgent.java b/agents/common/src/main/java/com/dbx/agent/DatabaseAgent.java
index a26f610e3d..8db41236e9 100644
--- a/agents/common/src/main/java/com/dbx/agent/DatabaseAgent.java
+++ b/agents/common/src/main/java/com/dbx/agent/DatabaseAgent.java
@@ -156,6 +156,10 @@ public interface DatabaseAgent {
List<ForeignKeyInfo> listForeignKeys(String schema, String table);
+ default List<ConstraintInfo> listConstraints(String schema, String table) {
+ throw new UnsupportedOperationException("Constraint metadata is not supported by this driver");
+ }
+
List<TriggerInfo> listTriggers(String schema, String table);
default List<PartitionInfo> listPartitions(String schema, String table) {
diff --git a/agents/common/src/main/java/com/dbx/agent/JsonRpcServer.java b/agents/common/src/main/java/com/dbx/agent/JsonRpcServer.java
index e851434207..708d898eed 100644
--- a/agents/common/src/main/java/com/dbx/agent/JsonRpcServer.java
+++ b/agents/common/src/main/java/com/dbx/agent/JsonRpcServer.java
@@ -279,6 +279,10 @@ public final class JsonRpcServer {
switchCatalog(params);
return agent.listTriggers(params.get("schema").getAsString(), params.get("table").getAsString());
}
+ if (AgentProtocol.METHOD_LIST_CONSTRAINTS.equals(method)) {
+ switchCatalog(params);
+ return agent.listConstraints(params.get("schema").getAsString(), params.get("table").getAsString());
+ }
if (AgentProtocol.METHOD_LIST_PARTITIONS.equals(method)) {
switchCatalog(params);
return agent.listPartitions(params.get("schema").getAsString(), params.get("table").getAsString());
diff --git a/agents/common/src/test/java/com/dbx/agent/CommonJavaCompatibilityTest.java b/agents/common/src/test/java/com/dbx/agent/CommonJavaCompatibilityTest.java
index 4e99e9188c..be35c61b69 100644
--- a/agents/common/src/test/java/com/dbx/agent/CommonJavaCompatibilityTest.java
+++ b/agents/common/src/test/java/com/dbx/agent/CommonJavaCompatibilityTest.java
@@ -120,6 +120,17 @@ class CommonJavaCompatibilityTest {
assertTrue(containsCapability(result.getAsJsonArray("capabilities"), "metadata"));
}
+ @Test
+ void constraintMetadataUnsupportedIsNotAnEmptySuccess() {
+ JsonRpcServer server = new JsonRpcServer(new MinimalAgent());
+ JsonObject response = JsonParser.parseString(server.handleRequest(
+ "{\"id\":1,\"method\":\"list_constraints\",\"params\":{\"schema\":\"APP\",\"table\":\"T\"}}"
+ )).getAsJsonObject();
+
+ assertFalse(response.has("result"));
+ assertTrue(response.getAsJsonObject("error").get("message").getAsString().contains("not supported"));
+ }
+
@Test
void jsonRpcConnectionTestAddsOptionalDatabaseInfoWithoutChangingLegacySuccess() {
JsonRpcServer legacyServer = new JsonRpcServer(new MinimalAgent());
diff --git a/agents/drivers/oceanbase-oracle/build.gradle b/agents/drivers/oceanbase-oracle/build.gradle
index ef3e6f3ed9..673e7e5568 100644
--- a/agents/drivers/oceanbase-oracle/build.gradle
+++ b/agents/drivers/oceanbase-oracle/build.gradle
@@ -1,6 +1,7 @@
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.oceanbase:oceanbase-client:2.4.18'
+ testImplementation 'com.google.code.gson:gson:2.12.1'
}
tasks.named('shadowJar') {
diff --git a/agents/drivers/oceanbase-oracle/src/main/java/com/dbx/agent/oceanbaseoracle/OceanBaseOracleAgent.java b/agents/drivers/oceanbase-oracle/src/main/java/com/dbx/agent/oceanbaseoracle/OceanBaseOracleAgent.java
index 43596973df..80fdd611a2 100644
--- a/agents/drivers/oceanbase-oracle/src/main/java/com/dbx/agent/oceanbaseoracle/OceanBaseOracleAgent.java
+++ b/agents/drivers/oceanbase-oracle/src/main/java/com/dbx/agent/oceanbaseoracle/OceanBaseOracleAgent.java
@@ -10,6 +10,7 @@ import com.dbx.agent.CompletionAssistantRequest;
import com.dbx.agent.CompletionAssistantResponse;
import com.dbx.agent.ConfiguredJdbcAgent;
import com.dbx.agent.ConnectParams;
+import com.dbx.agent.ConstraintInfo;
import com.dbx.agent.DatabaseInfo;
import com.dbx.agent.DdlBuilder;
import com.dbx.agent.ExecuteQueryOptions;
@@ -1317,6 +1318,84 @@ public final class OceanBaseOracleAgent extends ConfiguredJdbcAgent {
});
}
+ @Override
+ public List<ConstraintInfo> listConstraints(String schema, String table) {
+ return unchecked(() -> {
+ String owner = normalizeSchema(schema);
+ String tableName = normalizeObjectName(table);
+ String sql = """
+ SELECT c.CONSTRAINT_NAME, c.CONSTRAINT_TYPE, c.SEARCH_CONDITION,
+ c.STATUS, c.VALIDATED, c.DEFERRABLE, c.DEFERRED, c.GENERATED,
+ cc.COLUMN_NAME, tc.NULLABLE
+ FROM ALL_TABLES t
+ LEFT JOIN ALL_CONSTRAINTS c ON c.OWNER = t.OWNER AND c.TABLE_NAME = t.TABLE_NAME
+ AND c.CONSTRAINT_TYPE IN ('P', 'U', 'C')
+ LEFT JOIN ALL_CONS_COLUMNS cc ON cc.OWNER = c.OWNER
+ AND cc.TABLE_NAME = c.TABLE_NAME AND cc.CONSTRAINT_NAME = c.CONSTRAINT_NAME
+ LEFT JOIN ALL_TAB_COLUMNS tc ON tc.OWNER = t.OWNER
+ AND tc.TABLE_NAME = t.TABLE_NAME AND tc.COLUMN_NAME = cc.COLUMN_NAME
+ WHERE t.OWNER = ? AND t.TABLE_NAME = ?
+ ORDER BY c.CONSTRAINT_NAME, cc.POSITION
+ """.stripIndent().trim();
+ Map<String, ConstraintInfo> result = new LinkedHashMap<>();
+ try (var stmt = requireConnection().prepareStatement(sql)) {
+ stmt.setString(1, owner);
+ stmt.setString(2, tableName);
+ try (ResultSet rs = stmt.executeQuery()) {
+ boolean visible = false;
+ while (rs.next()) {
+ visible = true;
+ String name = rs.getString("CONSTRAINT_NAME");
+ if (name == null) continue;
+ String column = rs.getString("COLUMN_NAME");
+ String condition = rs.getString("SEARCH_CONDITION");
+ // NOT NULL already appears in the columns tab, as for native Oracle.
+ if ("C".equals(rs.getString("CONSTRAINT_TYPE"))
+ && "GENERATED NAME".equals(rs.getString("GENERATED"))
+ && "N".equals(rs.getString("NULLABLE"))
+ && column != null && condition != null
+ && condition.matches("\\s*" + Pattern.quote(quoteIdentifier(column))
+ + "\\s+(?i:IS\\s+NOT\\s+NULL)\\s*")) continue;
+ ConstraintInfo constraint = result.get(name);
+ if (constraint == null) {
+ String type = switch (rs.getString("CONSTRAINT_TYPE")) {
+ case "P" -> "PRIMARY KEY";
+ case "U" -> "UNIQUE";
+ default -> "CHECK";
+ };
+ constraint = new ConstraintInfo(name, type, condition,
+ new ArrayList<>(),
+ constraintState(rs.getString("DEFERRABLE"), "DEFERRABLE", "NOT DEFERRABLE"),
+ constraintState(rs.getString("DEFERRED"), "DEFERRED", "IMMEDIATE"),
+ constraintState(rs.getString("STATUS"), "ENABLED", "DISABLED"),
+ constraintState(rs.getString("VALIDATED"), "VALIDATED", "NOT VALIDATED"));
+ result.put(name, constraint);
+ }
+ if (column != null) constraint.columns().add(column);
+ }
+ if (!visible) throw new SQLException("Table does not exist or is not accessible", "42000");
+ }
+ }
+ return result.values().stream().map(constraint -> {
+ String definition = constraint.definition();
+ if (definition == null) definition = "";
+ if (!constraint.constraint_type().equals("CHECK")) {
+ definition = constraint.constraint_type() + " (" + String.join(", ",
+ constraint.columns().stream().map(OceanBaseOracleAgent::quoteIdentifier).toList()) + ")";
+ }
+ return new ConstraintInfo(constraint.name(), constraint.constraint_type(), definition,
+ constraint.columns(), constraint.deferrable(), constraint.initially_deferred(),
+ constraint.enabled(), constraint.valid());
+ }).toList();
+ });
+ }
+
+ private static Boolean constraintState(String value, String yes, String no) {
+ if (yes.equals(value)) return true;
+ if (no.equals(value)) return false;
+ return null;
+ }
+
@Override
public List<TriggerInfo> listTriggers(String schema, String table) {
return unchecked(() -> {
diff --git a/agents/drivers/oceanbase-oracle/src/test/java/com/dbx/agent/OceanBaseOracleConstraintRpcTest.java b/agents/drivers/oceanbase-oracle/src/test/java/com/dbx/agent/OceanBaseOracleConstraintRpcTest.java
new file mode 100644
index 0000000000..ddc56fa994
--- /dev/null
+++ b/agents/drivers/oceanbase-oracle/src/test/java/com/dbx/agent/OceanBaseOracleConstraintRpcTest.java
@@ -0,0 +1,166 @@
+package com.dbx.agent;
+
+import com.dbx.agent.oceanbaseoracle.OceanBaseOracleAgent;
+import com.dbx.agent.test.TestSupport;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+import org.junit.jupiter.api.Test;
+
+import java.lang.reflect.Proxy;
+import java.sql.Connection;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+class OceanBaseOracleConstraintRpcTest {
+ @Test
+ void returnsCompositePrimaryKeyThroughProductionRpc() {
+ Fixture jdbc = new Fixture(List.of(
+ row("PK Orders", "P", null, "Second", "ENABLED", "VALIDATED"),
+ row("PK Orders", "P", null, "First\"Id", "ENABLED", "VALIDATED")
+ ));
+
+ JsonObject response = jdbc.request("Mixed.Owner", "Orders");
+
+ assertFalse(response.has("error"), response.toString());
+ var constraints = response.getAsJsonArray("result");
+ assertEquals(1, constraints.size());
+ JsonObject key = constraints.get(0).getAsJsonObject();
+ assertEquals("PK Orders", key.get("name").getAsString());
+ assertEquals("PRIMARY KEY", key.get("constraint_type").getAsString());
+ assertEquals(List.of("Second", "First\"Id"), key.getAsJsonArray("columns").asList()
+ .stream().map(value -> value.getAsString()).toList());
+ assertEquals("PRIMARY KEY (\"Second\", \"First\"\"Id\")", key.get("definition").getAsString());
+ assertTrue(key.get("enabled").getAsBoolean());
+ assertTrue(key.get("valid").getAsBoolean());
+ assertEquals(List.of("Mixed.Owner", "Orders"), jdbc.parameters);
+ assertTrue(jdbc.closed);
+ }
+
+ @Test
+ void preservesMultilineChecksAndReportsUnknownStatesWithoutInventingValues() {
+ String expression = "\"Amount\" > 0\nAND \"Note\" <> 'line\n two'";
+ Map<String, String> unknown = row("CK_UNKNOWN", "C", null, null, null, "UNRECOGNIZED");
+ unknown.put("DEFERRABLE", null);
+ unknown.put("DEFERRED", null);
+ Fixture jdbc = new Fixture(List.of(
+ row("CK_MULTI", "C", expression, "Amount", "DISABLED", "NOT VALIDATED"),
+ row("CK_MULTI", "C", expression, "Note", "DISABLED", "NOT VALIDATED"), unknown,
+ row("UQ_CODE", "U", null, "Code", "ENABLED", "NOT VALIDATED")
+ ));
+
+ JsonObject response = jdbc.request("APP", "ORDERS");
+
+ assertFalse(response.has("error"), response.toString());
+ var constraints = response.getAsJsonArray("result");
+ assertEquals(3, constraints.size());
+ var check = constraints.get(0).getAsJsonObject();
+ assertEquals(expression, check.get("definition").getAsString());
+ assertFalse(check.get("enabled").getAsBoolean());
+ assertFalse(check.get("valid").getAsBoolean());
+ var unavailable = constraints.get(1).getAsJsonObject();
+ assertEquals("", unavailable.get("definition").getAsString());
+ for (String state : List.of("enabled", "valid", "deferrable", "initially_deferred")) {
+ assertTrue(!unavailable.has(state) || unavailable.get(state).isJsonNull(), unavailable.toString());
+ }
+ assertEquals("UNIQUE (\"Code\")", constraints.get(2).getAsJsonObject().get("definition").getAsString());
+ }
+
+ @Test
+ void emptyVisibleTableIsDifferentFromInaccessibleTableOrQueryFailure() {
+ Fixture empty = new Fixture(List.of(Map.of()));
+ assertEquals(0, empty.request("APP", "EMPTY").getAsJsonArray("result").size());
+ JsonObject hidden = new Fixture(List.of()).request("OTHER", "EMPTY");
+ assertFalse(hidden.has("result"));
+ assertTrue(hidden.getAsJsonObject("error").get("message").getAsString().contains("not accessible"));
+ Fixture denied = new Fixture(List.of());
+ denied.failure = new SQLException("ORA-01031: insufficient privileges", "42000", 1031);
+ JsonObject failure = denied.request("APP", "EMPTY");
+ assertFalse(failure.has("result"));
+ assertTrue(failure.getAsJsonObject("error").get("message").getAsString().contains("ORA-01031"));
+ }
+
+ @Test
+ void excludesOnlyConfirmedSystemNotNullChecks() {
+ Map<String, String> notNull = row("SYS_C01", "C", "\"Required\"\"Id\" IS NOT NULL",
+ "Required\"Id", "ENABLED", "VALIDATED");
+ notNull.put("GENERATED", "GENERATED NAME");
+ notNull.put("NULLABLE", "N");
+ Map<String, String> namedCheck = new java.util.HashMap<>(notNull);
+ namedCheck.put("CONSTRAINT_NAME", "NAMED_NOT_NULL");
+ namedCheck.put("GENERATED", "USER NAME");
+ Map<String, String> userCheck = new java.util.HashMap<>(notNull);
+ userCheck.put("CONSTRAINT_NAME", "SYS_C02");
+ userCheck.put("SEARCH_CONDITION", "\"Required\"\"Id\" > 0");
+
+ var constraints = new Fixture(List.of(notNull, namedCheck, userCheck))
+ .request("APP", "ORDERS").getAsJsonArray("result");
+
+ assertEquals(List.of("NAMED_NOT_NULL", "SYS_C02"), constraints.asList().stream()
+ .map(value -> value.getAsJsonObject().get("name").getAsString()).toList());
+ }
+
+ private static Map<String, String> row(String name, String kind, String condition,
+ String column, String status, String validated) {
+ Map<String, String> row = new java.util.HashMap<>();
+ row.put("CONSTRAINT_NAME", name);
+ row.put("CONSTRAINT_TYPE", kind);
+ row.put("SEARCH_CONDITION", condition);
+ row.put("COLUMN_NAME", column);
+ row.put("STATUS", status);
+ row.put("VALIDATED", validated);
+ row.put("DEFERRABLE", "NOT DEFERRABLE");
+ row.put("DEFERRED", "IMMEDIATE");
+ return row;
+ }
+
+ private static final class Fixture {
+ final List<String> parameters = new ArrayList<>();
+ final JsonRpcServer server;
+ boolean closed;
+ SQLException failure;
+
+ Fixture(List<Map<String, String>> rows) {
+ int[] index = {-1};
+ ResultSet result = (ResultSet) Proxy.newProxyInstance(getClass().getClassLoader(),
+ new Class<?>[]{ResultSet.class}, (proxy, method, args) -> switch (method.getName()) {
+ case "next" -> ++index[0] < rows.size();
+ case "getString" -> rows.get(index[0]).get((String) args[0]);
+ case "close" -> { closed = true; yield null; }
+ default -> throw new UnsupportedOperationException(method.getName());
+ });
+ PreparedStatement statement = (PreparedStatement) Proxy.newProxyInstance(getClass().getClassLoader(),
+ new Class<?>[]{PreparedStatement.class}, (proxy, method, args) -> switch (method.getName()) {
+ case "setString" -> { parameters.add((String) args[1]); yield null; }
+ case "executeQuery" -> { if (failure != null) throw failure; yield result; }
+ case "close" -> null;
+ default -> throw new UnsupportedOperationException(method.getName());
+ });
+ Connection connection = (Connection) Proxy.newProxyInstance(getClass().getClassLoader(),
+ new Class<?>[]{Connection.class}, (proxy, method, args) -> switch (method.getName()) {
+ case "prepareStatement" -> statement;
+ case "isClosed" -> false;
+ default -> throw new UnsupportedOperationException(method.getName());
+ });
+ OceanBaseOracleAgent agent = new OceanBaseOracleAgent();
+ TestSupport.setPrivateConnection(agent, connection);
+ server = new JsonRpcServer(agent);
+ }
+
+ JsonObject request(String schema, String table) {
+ JsonObject params = new JsonObject();
+ params.addProperty("schema", schema);
+ params.addProperty("table", table);
+ JsonObject request = new JsonObject();
+ request.addProperty("id", 1);
+ request.addProperty("method", "list_constraints");
+ request.add("params", params);
+ return JsonParser.parseString(server.handleRequest(request.toString())).getAsJsonObject();
+ }
+ }
+}
diff --git a/apps/desktop/src/components/grid/DataGridTableInfoPanels.vue b/apps/desktop/src/components/grid/DataGridTableInfoPanels.vue
index 2d10e49e47..4aae99fb40 100644
--- a/apps/desktop/src/components/grid/DataGridTableInfoPanels.vue
+++ b/apps/desktop/src/components/grid/DataGridTableInfoPanels.vue
@@ -240,12 +240,12 @@ const overviewRows = computed(() => {
{{ t("grid.tableInfoEmpty") }}
</div>
<div v-else class="divide-y">
- <div v-for="constraint in props.constraints" :key="constraint.name" class="p-3 text-xs" :class="constraint.enabled ? '' : 'opacity-60'">
+ <div v-for="constraint in props.constraints" :key="constraint.name" class="p-3 text-xs" :class="constraint.enabled === false ? 'opacity-60' : ''">
<div class="flex flex-wrap items-center gap-1.5">
<span class="font-medium truncate">{{ constraint.name }}</span>
<span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ constraint.constraint_type }}</span>
- <span v-if="!constraint.enabled" class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t("grid.tableInfoConstraintDisabled") }}</span>
- <span v-else-if="!constraint.valid" class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t("grid.tableInfoConstraintNotValidated") }}</span>
+ <span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t(constraint.enabled === true ? "grid.tableInfoConstraintEnabled" : constraint.enabled === false ? "grid.tableInfoConstraintDisabled" : "grid.tableInfoConstraintEnabledUnknown") }}</span>
+ <span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t(constraint.valid === true ? "grid.tableInfoConstraintValidated" : constraint.valid === false ? "grid.tableInfoConstraintNotValidated" : "grid.tableInfoConstraintValidationUnknown") }}</span>
</div>
<div v-if="constraint.columns.length" class="mt-1 font-mono text-[11px] text-muted-foreground break-all">{{ constraint.columns.join(", ") }}</div>
<div v-if="constraint.ref_table" class="mt-1 font-mono text-[11px] text-muted-foreground break-all">-> {{ constraint.ref_schema ? `${constraint.ref_schema}.` : "" }}{{ constraint.ref_table }}{{ constraint.ref_columns.length ? `(${constraint.ref_columns.join(", ")})` : "" }}</div>
diff --git a/apps/desktop/src/components/grid/__tests__/DataGridTableInfoPanels.constraints.spec.ts b/apps/desktop/src/components/grid/__tests__/DataGridTableInfoPanels.constraints.spec.ts
new file mode 100644
index 0000000000..556fe957dc
--- /dev/null
+++ b/apps/desktop/src/components/grid/__tests__/DataGridTableInfoPanels.constraints.spec.ts
@@ -0,0 +1,110 @@
+// @vitest-environment happy-dom
+
+import { createApp, nextTick } from "vue";
+import { createI18n } from "vue-i18n";
+import { afterEach, describe, expect, it } from "vitest";
+import DataGridTableInfoPanels from "../DataGridTableInfoPanels.vue";
+import en from "@/i18n/locales/en";
+import type { ConstraintInfo } from "@/types/database";
+
+const mountedApps: ReturnType<typeof createApp>[] = [];
+
+async function renderConstraints(constraints: ConstraintInfo[], constraintsError = "") {
+ const container = document.createElement("div");
+ document.body.appendChild(container);
+ const app = createApp(DataGridTableInfoPanels, {
+ activeTab: "constraints",
+ searchQuery: "",
+ tableName: "O01_CONSTRAINTS",
+ tableSchema: "TESTER",
+ database: "TESTER",
+ tableOwner: null,
+ overviewStats: null,
+ overviewComment: null,
+ overviewLoading: false,
+ columns: [],
+ columnsLoading: false,
+ indexes: [],
+ indexesLoading: false,
+ indexesError: "",
+ canManageMongoIndexes: false,
+ foreignKeys: [],
+ foreignKeysLoading: false,
+ foreignKeysError: "",
+ triggers: [],
+ triggersLoading: false,
+ triggersError: "",
+ constraints,
+ constraintsLoading: false,
+ constraintsError,
+ partitioning: null,
+ partitionsLoading: false,
+ partitionsError: "",
+ isProtectedMongoIndex: () => false,
+ formatColumnType: (value: string) => value,
+ });
+ app.use(createI18n({ legacy: false, locale: "en", messages: { en } }));
+ app.mount(container);
+ mountedApps.push(app);
+ await nextTick();
+ return container;
+}
+
+afterEach(() => {
+ mountedApps.splice(0).forEach((app) => app.unmount());
+ document.body.innerHTML = "";
+});
+
+describe("structured constraint information", () => {
+ it("preserves composite column order and definition and distinguishes unknown states", async () => {
+ const container = await renderConstraints([
+ {
+ name: "O01_UK",
+ constraint_type: "UNIQUE",
+ definition: 'UNIQUE ("B", "A")',
+ columns: ["B", "A"],
+ ref_columns: [],
+ enabled: null,
+ valid: null,
+ deferrable: null,
+ initially_deferred: null,
+ },
+ ]);
+
+ expect(container.textContent).toContain("B, A");
+ expect(container.textContent).toContain('UNIQUE ("B", "A")');
+ expect(container.textContent).toContain("Enabled: Unknown");
+ expect(container.textContent).toContain("Validation: Unknown");
+ expect(container.textContent).not.toContain("Disabled");
+ expect(container.textContent).not.toContain("Not validated");
+ expect(container.querySelector("button, input, textarea")).toBeNull();
+ });
+
+ it.each([
+ [true, true, "Enabled", "Validated"],
+ [true, false, "Enabled", "Not validated"],
+ [false, false, "Disabled", "Not validated"],
+ [false, true, "Disabled", "Validated"],
+ [undefined, undefined, "Enabled: Unknown", "Validation: Unknown"],
+ ] as const)("shows enablement %s and validation %s independently", async (enabled, valid, enabledLabel, validLabel) => {
+ const container = await renderConstraints([
+ {
+ name: "O01_CK",
+ constraint_type: "CHECK",
+ definition: 'CHECK ("AMOUNT" > 0)',
+ columns: ["AMOUNT"],
+ ref_columns: [],
+ enabled,
+ valid,
+ },
+ ]);
+ expect(container.textContent).toContain(enabledLabel);
+ expect(container.textContent).toContain(validLabel);
+ });
+
+ it("shows a metadata permission error instead of an empty result", async () => {
+ const container = await renderConstraints([], "ORA-01031: insufficient privileges");
+ expect(container.textContent).toContain("ORA-01031: insufficient privileges");
+ expect(container.textContent).not.toContain(en.grid.tableInfoEmpty);
+ });
+});
diff --git a/apps/desktop/src/components/objects/ObjectBrowser.vue b/apps/desktop/src/components/objects/ObjectBrowser.vue
index 734abb1e3a..5f6f7f3ad8 100644
--- a/apps/desktop/src/components/objects/ObjectBrowser.vue
+++ b/apps/desktop/src/components/objects/ObjectBrowser.vue
@@ -282,6 +282,7 @@ const tableTriggersLoaded = ref(false);
const tableConstraints = ref<ConstraintInfo[]>([]);
const tableConstraintsLoading = ref(false);
const tableConstraintsLoaded = ref(false);
+const tableConstraintsError = ref("");
const tablePartitions = ref<PgTablePartitioning | null>(null);
const tablePartitionsLoading = ref(false);
const tablePartitionsLoaded = ref(false);
@@ -301,6 +302,7 @@ const activeTableInfoLoading = computed(() => {
if (tableInfoTab.value === "indexes") return tableIndexesLoading.value;
if (tableInfoTab.value === "foreignKeys") return tableForeignKeysLoading.value;
if (tableInfoTab.value === "partitions") return tablePartitionsLoading.value;
+ if (tableInfoTab.value === "constraints") return tableConstraintsLoading.value;
return tableInfoTab.value === "triggers" && tableTriggersLoading.value;
});
const SIDE_PANEL_MIN_WIDTH = 280;
@@ -1196,6 +1198,7 @@ async function openTableInfo(row: ObjectBrowserRow, initialTab?: TableInfoTab) {
tableForeignKeys.value = [];
tableTriggers.value = [];
tableConstraints.value = [];
+ tableConstraintsError.value = "";
tablePartitions.value = null;
tablePartitionsLoaded.value = false;
tablePartitionsLoading.value = false;
@@ -1434,6 +1437,7 @@ async function fetchTableConstraints(force = false) {
if (!row || (tableConstraintsLoaded.value && !force)) return;
const epoch = sidePanelGuard.capture();
tableConstraintsLoading.value = true;
+ tableConstraintsError.value = "";
let loadedSuccessfully = false;
try {
const request = tableMetadataRequest(row);
@@ -1444,7 +1448,7 @@ async function fetchTableConstraints(force = false) {
} catch (error) {
if (sidePanelGuard.isStale(epoch)) return;
tableConstraints.value = [];
- toast(translateBackendError(t, error), 5000);
+ tableConstraintsError.value = translateBackendError(t, error);
} finally {
if (sidePanelGuard.isFresh(epoch)) {
tableConstraintsLoaded.value = loadedSuccessfully;
@@ -4361,6 +4365,9 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
<div v-if="tableConstraintsLoading" class="h-full flex items-center justify-center">
<Loader2 class="w-4 h-4 animate-spin text-muted-foreground" />
</div>
+ <div v-else-if="tableConstraintsError" class="p-3 text-xs text-destructive">
+ {{ tableConstraintsError }}
+ </div>
<div v-else-if="tableInfoSearchQuery && filteredTableConstraints.length === 0" class="p-6 text-center text-xs text-muted-foreground">
{{ t("grid.tableInfoNoResults") }}
</div>
@@ -4368,12 +4375,12 @@ function getObjectBrowserMenuItems(item: ObjectBrowserRow): ContextMenuItem[] {
{{ t("grid.tableInfoEmpty") }}
</div>
<div v-else class="divide-y">
- <div v-for="constraint in filteredTableConstraints" :key="constraint.name" class="p-3 text-xs" :class="constraint.enabled ? '' : 'opacity-60'">
+ <div v-for="constraint in filteredTableConstraints" :key="constraint.name" class="p-3 text-xs" :class="constraint.enabled === false ? 'opacity-60' : ''">
<div class="flex flex-wrap items-center gap-1.5">
<span class="font-medium truncate">{{ constraint.name }}</span>
<span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ constraint.constraint_type }}</span>
- <span v-if="!constraint.enabled" class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t("grid.tableInfoConstraintDisabled") }}</span>
- <span v-else-if="!constraint.valid" class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t("grid.tableInfoConstraintNotValidated") }}</span>
+ <span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t(constraint.enabled === true ? "grid.tableInfoConstraintEnabled" : constraint.enabled === false ? "grid.tableInfoConstraintDisabled" : "grid.tableInfoConstraintEnabledUnknown") }}</span>
+ <span class="rounded border px-1 py-px text-[10px] text-muted-foreground">{{ t(constraint.valid === true ? "grid.tableInfoConstraintValidated" : constraint.valid === false ? "grid.tableInfoConstraintNotValidated" : "grid.tableInfoConstraintValidationUnknown") }}</span>
</div>
<div v-if="constraint.columns.length" class="mt-1 font-mono text-[11px] text-muted-foreground break-all">{{ constraint.columns.join(", ") }}</div>
<div v-if="constraint.ref_table" class="mt-1 font-mono text-[11px] text-muted-foreground break-all">-> {{ constraint.ref_schema ? `${constraint.ref_schema}.` : "" }}{{ constraint.ref_table }}{{ constraint.ref_columns.length ? `(${constraint.ref_columns.join(", ")})` : "" }}</div>
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
new file mode 100644
index 0000000000..c109d9ebd1
--- /dev/null
+++ b/apps/desktop/src/components/objects/__tests__/ObjectBrowser.constraints.component.spec.ts
@@ -0,0 +1,131 @@
+// @vitest-environment happy-dom
+
+import { createApp, defineComponent, h, ref, type App } from "vue";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import ObjectBrowser from "@/components/objects/ObjectBrowser.vue";
+import { invalidateObjectBrowserRowsCache } from "@/lib/table/objectBrowserRowsCache";
+import { invalidateMetadataRuntimeCachePrefix } from "@/lib/metadata/metadataRuntimeCache";
+import type { ConnectionConfig } from "@/types/database";
+
+const mocks = vi.hoisted(() => ({ listConstraints: vi.fn() }));
+vi.mock("@/lib/backend/api", () => ({
+ listObjects: vi.fn().mockResolvedValue([{ name: "O01_CONSTRAINTS", object_type: "TABLE", schema: "TESTER" }]),
+ listSchemas: vi.fn().mockResolvedValue(["TESTER"]),
+ listObjectStatistics: vi.fn().mockResolvedValue([]),
+ getTableDisplayDdl: vi.fn().mockResolvedValue("CREATE TABLE O01_CONSTRAINTS (A NUMBER, B NUMBER)"),
+ loadSchemaCache: vi.fn().mockResolvedValue(null),
+ saveSchemaCache: vi.fn().mockResolvedValue(undefined),
+ deleteSchemaCachePrefix: vi.fn().mockResolvedValue(undefined),
+ listConstraints: (...args: unknown[]) => mocks.listConstraints(...args),
+}));
+vi.mock("@/stores/connectionStore", () => ({
+ useConnectionStore: () => ({
+ getConfig: () => connection,
+ ensureConnected: vi.fn().mockResolvedValue(undefined),
+ orderByPinnedTreeNodes: (rows: unknown[]) => rows,
+ }),
+}));
+vi.mock("@/stores/queryStore", () => ({ useQueryStore: () => ({}) }));
+vi.mock("@/stores/settingsStore", () => ({
+ useSettingsStore: () => ({
+ editorSettings: {
+ shortcuts: { refreshData: "F5" },
+ objectBrowserViewMode: "list",
+ objectBrowserShowCheckbox: false,
+ sidebarActivation: "double",
+ },
+ }),
+}));
+vi.mock("vue-i18n", () => ({ useI18n: () => ({ t: (key: string) => key, locale: ref("en-US") }) }));
+vi.mock("@/i18n", () => ({ default: { install: () => undefined } }));
+vi.mock("@/composables/useSqlHighlighter", () => ({ useSqlHighlighter: () => ({ highlight: (sql: string) => sql }) }));
+vi.mock("@/composables/useToast", () => ({ useToast: () => ({ toast: vi.fn() }) }));
+vi.mock("vue-virtual-scroller", () => ({
+ RecycleScroller: defineComponent({
+ props: { items: { type: Array, default: () => [] } },
+ setup(props, { slots }) {
+ return () =>
+ h(
+ "div",
+ props.items.map((item) => slots.default?.({ item })),
+ );
+ },
+ }),
+}));
+vi.mock("@/components/ui/searchable-select", () => ({ SearchableSelect: { render: () => null } }));
+vi.mock("@/components/ui/ToolbarOverflowMenu.vue", () => ({ default: { render: () => null } }));
+vi.mock("@/components/editor/QueryEditor.vue", () => ({ default: { render: () => null } }));
+vi.mock("@/components/editor/DangerConfirmDialog.vue", () => ({ default: { render: () => null } }));
+vi.mock("@/components/objects/ProcedureExecutionDialog.vue", () => ({ default: { render: () => null } }));
+vi.mock("@/components/objects/CustomTypeInfoPanel.vue", () => ({ default: { render: () => null } }));
+vi.mock("@/components/export/XlsxHeaderDialog.vue", () => ({ default: { render: () => null } }));
+
+const connection = { id: "ob-o01-constraints", name: "OceanBase Oracle", db_type: "oceanbase-oracle", database: "TESTER", driver_profile: null, url_params: null, transport_layers: [] } as unknown as ConnectionConfig;
+const mountedApps: Array<{ app: App; host: HTMLElement }> = [];
+
+beforeEach(() => {
+ vi.clearAllMocks();
+ mocks.listConstraints.mockResolvedValue([
+ {
+ name: "O01_UK",
+ constraint_type: "UNIQUE",
+ definition: 'UNIQUE ("B", "A")',
+ columns: ["B", "A"],
+ ref_columns: [],
+ enabled: true,
+ valid: true,
+ },
+ ]);
+ invalidateObjectBrowserRowsCache({});
+ invalidateMetadataRuntimeCachePrefix("");
+});
+afterEach(() => {
+ for (const { app, host } of mountedApps.splice(0)) {
+ app.unmount();
+ host.remove();
+ }
+ invalidateObjectBrowserRowsCache({});
+ invalidateMetadataRuntimeCachePrefix("");
+});
+
+async function openConstraints() {
+ const host = document.createElement("div");
+ document.body.append(host);
+ const app = createApp(ObjectBrowser, { connection, database: "TESTER", schema: "TESTER" });
+ mountedApps.push({ app, host });
+ app.mount(host);
+ await vi.waitFor(() => expect(host.querySelector('[title="O01_CONSTRAINTS"]')).not.toBeNull());
+ host.querySelector<HTMLElement>('[title="O01_CONSTRAINTS"]')!.closest<HTMLElement>(".cursor-default")!.click();
+ await vi.waitFor(() => expect(host.querySelector('button[title="grid.tableInfoConstraints"]')).not.toBeNull());
+ host.querySelector<HTMLButtonElement>('button[title="grid.tableInfoConstraints"]')!.click();
+ return host;
+}
+
+describe("OceanBase Oracle constraint information", () => {
+ it("opens its read-only Constraints tab and displays ordered metadata from the agent", async () => {
+ const host = await openConstraints();
+ await vi.waitFor(() => expect(host.textContent).toContain('UNIQUE ("B", "A")'));
+ expect(host.textContent).toContain("B, A");
+ expect(host.textContent).toContain("grid.tableInfoConstraintEnabled");
+ expect(host.textContent).toContain("grid.tableInfoConstraintValidated");
+ expect(mocks.listConstraints).toHaveBeenCalledWith(connection.id, "TESTER", "TESTER", "O01_CONSTRAINTS", undefined);
+ });
+
+ it("keeps permission errors visible instead of an empty list and can retry", async () => {
+ mocks.listConstraints.mockRejectedValueOnce(new Error("ORA-01031: insufficient privileges"));
+ const host = await openConstraints();
+ await vi.waitFor(() => expect(host.textContent).toContain("ORA-01031: insufficient privileges"));
+ expect(host.textContent).not.toContain("grid.tableInfoEmpty");
+
+ host.querySelector<HTMLButtonElement>('button[aria-label="structureEditor.refresh"]')!.click();
+ await vi.waitFor(() => expect(host.textContent).toContain('UNIQUE ("B", "A")'));
+ expect(host.textContent).not.toContain("ORA-01031");
+ });
+
+ it("shows an empty result only after a successful empty catalog read", async () => {
+ mocks.listConstraints.mockResolvedValue([]);
+ const host = await openConstraints();
+ await vi.waitFor(() => expect(host.textContent).toContain("grid.tableInfoEmpty"));
+ expect(host.textContent).not.toContain("ORA-01031");
+ });
+});
diff --git a/apps/desktop/src/components/structure/TableStructureEditor.vue b/apps/desktop/src/components/structure/TableStructureEditor.vue
index 1cc8e70383..af07b3cf24 100644
--- a/apps/desktop/src/components/structure/TableStructureEditor.vue
+++ b/apps/desktop/src/components/structure/TableStructureEditor.vue
@@ -6541,12 +6541,12 @@ watch(
{{ t("structureEditor.emptyReadonly") }}
</div>
<div v-else class="space-y-1.5">
- <div v-for="constraint in constraintsForTab" :key="constraint.name" class="rounded-md border px-[var(--structure-cell-px)] py-[var(--structure-header-py)] text-[length:var(--structure-font-size)]" :class="constraint.enabled ? '' : 'opacity-60'">
+ <div v-for="constraint in constraintsForTab" :key="constraint.name" class="rounded-md border px-[var(--structure-cell-px)] py-[var(--structure-header-py)] text-[length:var(--structure-font-size)]" :class="constraint.enabled === false ? 'opacity-60' : ''">
<div class="flex flex-wrap items-center gap-1.5">
<span class="font-mono font-medium">{{ constraint.name }}</span>
<Badge variant="outline" class="shrink-0">{{ constraint.constraint_type }}</Badge>
- <Badge v-if="!constraint.enabled" variant="outline" class="shrink-0 text-muted-foreground">{{ t("structureEditor.constraintDisabled") }}</Badge>
- <Badge v-else-if="!constraint.valid" variant="outline" class="shrink-0 text-muted-foreground">{{ t("structureEditor.constraintNotValidated") }}</Badge>
+ <Badge variant="outline" class="shrink-0 text-muted-foreground">{{ t(constraint.enabled === true ? "grid.tableInfoConstraintEnabled" : constraint.enabled === false ? "structureEditor.constraintDisabled" : "grid.tableInfoConstraintEnabledUnknown") }}</Badge>
+ <Badge variant="outline" class="shrink-0 text-muted-foreground">{{ t(constraint.valid === true ? "grid.tableInfoConstraintValidated" : constraint.valid === false ? "structureEditor.constraintNotValidated" : "grid.tableInfoConstraintValidationUnknown") }}</Badge>
</div>
<div v-if="constraint.columns.length" class="mt-1 truncate font-mono text-muted-foreground">{{ constraint.columns.join(", ") }}</div>
<div v-if="constraint.ref_table" class="mt-1 truncate font-mono text-muted-foreground">-> {{ constraint.ref_schema ? `${constraint.ref_schema}.` : "" }}{{ constraint.ref_table }}{{ constraint.ref_columns.length ? `(${constraint.ref_columns.join(", ")})` : "" }}</div>
diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.ts
index 5285507242..f63c07560c 100644
--- a/apps/desktop/src/i18n/locales/en.ts
+++ b/apps/desktop/src/i18n/locales/en.ts
@@ -2951,6 +2951,10 @@ export default {
openUrl: "Open URL in browser",
tableInfoConstraints: "Constraints",
tableInfoConstraintDisabled: "Disabled",
+ tableInfoConstraintEnabled: "Enabled",
+ tableInfoConstraintEnabledUnknown: "Enabled: Unknown",
+ tableInfoConstraintValidated: "Validated",
+ tableInfoConstraintValidationUnknown: "Validation: Unknown",
tableInfoConstraintNotValidated: "Not validated",
tableInfoTriggers: "Triggers",
tableInfoNullable: "Nullable",
diff --git a/apps/desktop/src/i18n/locales/es.ts b/apps/desktop/src/i18n/locales/es.ts
index 3f21e329e8..64a1c17bfc 100644
--- a/apps/desktop/src/i18n/locales/es.ts
+++ b/apps/desktop/src/i18n/locales/es.ts
@@ -2778,6 +2778,10 @@ export default withEnglishFallback({
openUrl: "Abrir URL en el navegador",
tableInfoConstraints: "Restricciones",
tableInfoConstraintDisabled: "Deshabilitada",
+ tableInfoConstraintEnabled: "Habilitada",
+ tableInfoConstraintEnabledUnknown: "Activación: desconocida",
+ tableInfoConstraintValidated: "Validada",
+ tableInfoConstraintValidationUnknown: "Validación: desconocida",
tableInfoConstraintNotValidated: "Sin validar",
tableInfoTriggers: "Disparadores",
tableInfoNullable: "Nulable",
diff --git a/apps/desktop/src/i18n/locales/it.ts b/apps/desktop/src/i18n/locales/it.ts
index e86789ba5c..8dabc2fcc6 100644
--- a/apps/desktop/src/i18n/locales/it.ts
+++ b/apps/desktop/src/i18n/locales/it.ts
@@ -2655,6 +2655,10 @@ export default withEnglishFallback({
openUrl: "Apri URL nel browser",
tableInfoConstraints: "Vincoli",
tableInfoConstraintDisabled: "Disabilitata",
+ tableInfoConstraintEnabled: "Abilitata",
+ tableInfoConstraintEnabledUnknown: "Abilitazione: sconosciuta",
+ tableInfoConstraintValidated: "Validata",
+ tableInfoConstraintValidationUnknown: "Validazione: sconosciuta",
tableInfoConstraintNotValidated: "Non validata",
tableInfoTriggers: "Trigger",
tableInfoNullable: "Nullabile",
diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.ts
index efd778b294..ea015a6d8c 100644
--- a/apps/desktop/src/i18n/locales/ja.ts
+++ b/apps/desktop/src/i18n/locales/ja.ts
@@ -2661,6 +2661,10 @@ export default withEnglishFallback({
openUrl: "URLをブラウザーで開く",
tableInfoConstraints: "制約",
tableInfoConstraintDisabled: "無効",
+ tableInfoConstraintEnabled: "有効",
+ tableInfoConstraintEnabledUnknown: "有効状態:不明",
+ tableInfoConstraintValidated: "検証済み",
+ tableInfoConstraintValidationUnknown: "検証状態:不明",
tableInfoConstraintNotValidated: "未検証",
tableInfoTriggers: "トリガー",
tableInfoNullable: "NULL許容",
diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.ts
index 2dffc339c2..d8f60dcaac 100644
--- a/apps/desktop/src/i18n/locales/ko.ts
+++ b/apps/desktop/src/i18n/locales/ko.ts
@@ -2698,6 +2698,10 @@ export default withEnglishFallback({
openUrl: "브라우저에서 URL 열기",
tableInfoConstraints: "제약 조건",
tableInfoConstraintDisabled: "비활성화됨",
+ tableInfoConstraintEnabled: "활성화됨",
+ tableInfoConstraintEnabledUnknown: "활성화 상태: 알 수 없음",
+ tableInfoConstraintValidated: "검증됨",
+ tableInfoConstraintValidationUnknown: "검증 상태: 알 수 없음",
tableInfoConstraintNotValidated: "검증 안 됨",
tableInfoTriggers: "트리거",
tableInfoNullable: "NULL 허용",
diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.ts
index fd41595e2c..814a4f9120 100644
--- a/apps/desktop/src/i18n/locales/pt-BR.ts
+++ b/apps/desktop/src/i18n/locales/pt-BR.ts
@@ -2656,6 +2656,10 @@ export default withEnglishFallback({
openUrl: "Abrir URL no navegador",
tableInfoConstraints: "Restrições",
tableInfoConstraintDisabled: "Desabilitada",
+ tableInfoConstraintEnabled: "Habilitada",
+ tableInfoConstraintEnabledUnknown: "Ativação: desconhecida",
+ tableInfoConstraintValidated: "Validada",
+ tableInfoConstraintValidationUnknown: "Validação: desconhecida",
tableInfoConstraintNotValidated: "Não validada",
tableInfoTriggers: "Gatilhos",
tableInfoNullable: "Permite Nulo",
diff --git a/apps/desktop/src/i18n/locales/ru.ts b/apps/desktop/src/i18n/locales/ru.ts
index 0101e4c0fc..751dd8ae4c 100644
--- a/apps/desktop/src/i18n/locales/ru.ts
+++ b/apps/desktop/src/i18n/locales/ru.ts
@@ -2835,6 +2835,10 @@ export default withEnglishFallback({
openUrl: "Открыть URL в браузере",
tableInfoConstraints: "Ограничения",
tableInfoConstraintDisabled: "Отключено",
+ tableInfoConstraintEnabled: "Включено",
+ tableInfoConstraintEnabledUnknown: "Состояние включения: неизвестно",
+ tableInfoConstraintValidated: "Проверено",
+ tableInfoConstraintValidationUnknown: "Состояние проверки: неизвестно",
tableInfoConstraintNotValidated: "Не проверено",
tableInfoTriggers: "Триггеры",
tableInfoNullable: "Допускает NULL",
diff --git a/apps/desktop/src/i18n/locales/zh-CN.ts b/apps/desktop/src/i18n/locales/zh-CN.ts
index 96e53969f7..a2b23668bf 100644
--- a/apps/desktop/src/i18n/locales/zh-CN.ts
+++ b/apps/desktop/src/i18n/locales/zh-CN.ts
@@ -2886,6 +2886,10 @@ export default withEnglishFallback({
openUrl: "在浏览器中打开 URL",
tableInfoConstraints: "约束",
tableInfoConstraintDisabled: "已禁用",
+ tableInfoConstraintEnabled: "已启用",
+ tableInfoConstraintEnabledUnknown: "启用状态:未知",
+ tableInfoConstraintValidated: "已验证",
+ tableInfoConstraintValidationUnknown: "验证状态:未知",
tableInfoConstraintNotValidated: "未验证",
tableInfoTriggers: "触发器",
tableInfoNullable: "可空",
diff --git a/apps/desktop/src/i18n/locales/zh-TW.ts b/apps/desktop/src/i18n/locales/zh-TW.ts
index 7bb9864be8..3164e117c5 100644
--- a/apps/desktop/src/i18n/locales/zh-TW.ts
+++ b/apps/desktop/src/i18n/locales/zh-TW.ts
@@ -2661,6 +2661,10 @@ export default withEnglishFallback({
openUrl: "在瀏覽器中開啟 URL",
tableInfoConstraints: "約束",
tableInfoConstraintDisabled: "已停用",
+ tableInfoConstraintEnabled: "已啟用",
+ tableInfoConstraintEnabledUnknown: "啟用狀態:未知",
+ tableInfoConstraintValidated: "已驗證",
+ tableInfoConstraintValidationUnknown: "驗證狀態:未知",
tableInfoConstraintNotValidated: "未驗證",
tableInfoTriggers: "觸發器",
tableInfoNullable: "可為空",
diff --git a/apps/desktop/src/lib/table/__tests__/tableMetadataCapabilities.spec.ts b/apps/desktop/src/lib/table/__tests__/tableMetadataCapabilities.spec.ts
index 72471a3143..a2a080c850 100644
--- a/apps/desktop/src/lib/table/__tests__/tableMetadataCapabilities.spec.ts
+++ b/apps/desktop/src/lib/table/__tests__/tableMetadataCapabilities.spec.ts
@@ -31,6 +31,8 @@ describe("tableMetadataCapabilities", () => {
it("exposes structured constraints only for dialects that implement list_constraints", () => {
expect(getTableMetadataCapabilities("oracle").constraints).toBe(true);
+ expect(getTableMetadataCapabilities("oceanbase-oracle").constraints).toBe(true);
+ expect(getTableMetadataCapabilities("oceanbase-mysql").constraints).toBe(false);
expect(getTableMetadataCapabilities("postgres").constraints).toBe(true);
expect(getTableMetadataCapabilities("kingbase").constraints).toBe(true);
expect(getTableMetadataCapabilities("vastbase").constraints).toBe(true);
diff --git a/apps/desktop/src/lib/table/tableMetadataCapabilities.ts b/apps/desktop/src/lib/table/tableMetadataCapabilities.ts
index 3322563ac5..8a8c906e78 100644
--- a/apps/desktop/src/lib/table/tableMetadataCapabilities.ts
+++ b/apps/desktop/src/lib/table/tableMetadataCapabilities.ts
@@ -15,7 +15,7 @@ const defaultCapabilities: TableMetadataCapabilities = {
indexes: true,
foreignKeys: true,
// Structured constraint metadata (list_constraints) is only enabled for
- // drivers that implement it (PostgreSQL natively; Oracle/Xugu via agents);
+ // drivers that implement it (PostgreSQL natively; Oracle/OceanBase/Xugu via agents);
// leave it off by default so every other dialect doesn't grow a permanently
// empty tab.
constraints: false,
@@ -30,6 +30,9 @@ const capabilityByType: Partial<Record<DatabaseType, Partial<TableMetadataCapabi
oracle: {
constraints: true,
},
+ "oceanbase-oracle": {
+ constraints: true,
+ },
// KingbaseES V9 shares PostgreSQL's declarative partition catalog and DDL.
kingbase: {
constraints: true,
diff --git a/apps/desktop/src/types/database.ts b/apps/desktop/src/types/database.ts
index 1f9417f564..0709c09bbb 100644
--- a/apps/desktop/src/types/database.ts
+++ b/apps/desktop/src/types/database.ts
@@ -1217,10 +1217,10 @@ export interface ConstraintInfo {
match_type?: string | null;
on_update?: string | null;
on_delete?: string | null;
- deferrable: boolean;
- initially_deferred: boolean;
- enabled: boolean;
- valid: boolean;
+ deferrable?: boolean | null;
+ initially_deferred?: boolean | null;
+ enabled?: boolean | null;
+ valid?: boolean | null;
}
export interface PartitionInfo {
diff --git a/crates/dbx-core/src/schema/mod.rs b/crates/dbx-core/src/schema/mod.rs
index 78d3431e01..22b362783e 100644
--- a/crates/dbx-core/src/schema/mod.rs
+++ b/crates/dbx-core/src/schema/mod.rs
@@ -12663,10 +12663,10 @@ mod ddl_tests {
match_type: None,
on_update: None,
on_delete: None,
- deferrable: false,
- initially_deferred: false,
- enabled: true,
- valid: true,
+ deferrable: Some(false),
+ initially_deferred: Some(false),
+ enabled: Some(true),
+ valid: Some(true),
},
db::ConstraintInfo {
name: "uq_accounts_code".to_string(),
@@ -12679,10 +12679,10 @@ mod ddl_tests {
match_type: None,
on_update: None,
on_delete: None,
- deferrable: true,
- initially_deferred: true,
- enabled: true,
- valid: true,
+ deferrable: Some(true),
+ initially_deferred: Some(true),
+ enabled: Some(true),
+ valid: Some(true),
},
];
@@ -13194,10 +13194,10 @@ mod ddl_tests {
match_type: None,
on_update: None,
on_delete: None,
- deferrable: false,
- initially_deferred: false,
- enabled: true,
- valid: true,
+ deferrable: Some(false),
+ initially_deferred: Some(false),
+ enabled: Some(true),
+ valid: Some(true),
}];
let partition_info = db::postgres::PostgresTablePartitionInfo {
is_partition: true,
diff --git a/crates/dbx-core/tests/live_opengauss_constraints.rs b/crates/dbx-core/tests/live_opengauss_constraints.rs
index 7be7f2ba93..143b79160c 100644
--- a/crates/dbx-core/tests/live_opengauss_constraints.rs
+++ b/crates/dbx-core/tests/live_opengauss_constraints.rs
@@ -67,8 +67,8 @@ async fn opengauss_constraints_report_structural_metadata() {
let primary = find_constraint(&constraints, "child_pkey");
assert_eq!(primary.constraint_type, "PRIMARY KEY");
assert_eq!(primary.columns, vec!["id"]);
- assert!(primary.enabled);
- assert!(primary.valid);
+ assert_eq!(primary.enabled, Some(true));
+ assert_eq!(primary.valid, Some(true));
let foreign_key = find_constraint(&constraints, "child_parent_fk");
assert_eq!(foreign_key.constraint_type, "FOREIGN KEY");
@@ -79,8 +79,8 @@ async fn opengauss_constraints_report_structural_metadata() {
assert_eq!(foreign_key.on_delete.as_deref(), Some("CASCADE"));
assert_eq!(foreign_key.on_update.as_deref(), Some("NO ACTION"));
assert_eq!(foreign_key.match_type.as_deref(), Some("SIMPLE"));
- assert!(foreign_key.deferrable);
- assert!(foreign_key.initially_deferred);
+ assert_eq!(foreign_key.deferrable, Some(true));
+ assert_eq!(foreign_key.initially_deferred, Some(true));
let unique = find_constraint(&constraints, "child_code_unique");
assert_eq!(unique.constraint_type, "UNIQUE");
diff --git a/crates/dbx-core/tests/live_postgres_constraints.rs b/crates/dbx-core/tests/live_postgres_constraints.rs
index 6d3d7bb7e5..b2ede3f737 100644
--- a/crates/dbx-core/tests/live_postgres_constraints.rs
+++ b/crates/dbx-core/tests/live_postgres_constraints.rs
@@ -59,8 +59,8 @@ async fn postgres_constraints_reports_pk_fk_unique_check_and_not_valid() {
let pk = find_constraint(&child, "child_pkey");
assert_eq!(pk.constraint_type, "PRIMARY KEY");
assert_eq!(pk.columns, vec!["id"]);
- assert!(pk.valid);
- assert!(pk.enabled);
+ assert_eq!(pk.valid, Some(true));
+ assert_eq!(pk.enabled, Some(true));
assert_eq!(pk.ref_table, None);
// FOREIGN KEY: composite referencing columns must keep order (a, b)
@@ -73,7 +73,7 @@ async fn postgres_constraints_reports_pk_fk_unique_check_and_not_valid() {
assert_eq!(fk.on_update.as_deref(), Some("NO ACTION"));
assert_eq!(fk.on_delete.as_deref(), Some("NO ACTION"));
assert_eq!(fk.match_type.as_deref(), Some("SIMPLE"));
- assert!(fk.valid);
+ assert_eq!(fk.valid, Some(true));
// UNIQUE
let unique = find_constraint(&child, "child_code_unique");
@@ -89,8 +89,8 @@ async fn postgres_constraints_reports_pk_fk_unique_check_and_not_valid() {
// NOT VALID CHECK surfaces valid=false
let not_valid = find_constraint(&child, "child_amount_check_not_valid");
assert_eq!(not_valid.constraint_type, "CHECK");
- assert!(!not_valid.valid, "NOT VALID constraint must report valid=false");
- assert!(not_valid.enabled);
+ assert_eq!(not_valid.valid, Some(false), "NOT VALID constraint must report valid=false");
+ assert_eq!(not_valid.enabled, Some(true));
// Composite primary key keeps declared column order (a, b), not b, a
let parent = postgres::list_constraints(&pool, &schema, "parent").await.expect("list parent constraints");
@@ -127,7 +127,7 @@ async fn postgres_constraints_reports_exclude_constraints() {
assert_eq!(exclude.constraint_type, "EXCLUDE");
assert_eq!(exclude.columns, vec!["during"]);
assert!(exclude.definition.contains("EXCLUDE"));
- assert!(exclude.valid);
+ assert_eq!(exclude.valid, Some(true));
let _ = postgres::execute_query(&pool, &format!("DROP SCHEMA IF EXISTS {schema_ident} CASCADE")).await;
}
diff --git a/crates/dbx-driver-postgres/src/postgres.rs b/crates/dbx-driver-postgres/src/postgres.rs
index 2b893f0792..4365762638 100644
--- a/crates/dbx-driver-postgres/src/postgres.rs
+++ b/crates/dbx-driver-postgres/src/postgres.rs
@@ -5607,10 +5607,10 @@ pub async fn list_constraints(pool: &Pool, schema: &str, table: &str) -> Result<
match_type: postgres_constraint_match_type(row.try_get::<_, Option<String>>(7).ok().flatten()),
on_update: postgres_fk_action_label(row.try_get::<_, Option<String>>(8).ok().flatten()),
on_delete: postgres_fk_action_label(row.try_get::<_, Option<String>>(9).ok().flatten()),
- deferrable: row.try_get::<_, bool>(10).unwrap_or(false),
- initially_deferred: row.try_get::<_, bool>(11).unwrap_or(false),
- enabled: true,
- valid: row.try_get::<_, bool>(12).unwrap_or(true),
+ deferrable: Some(row.try_get::<_, bool>(10).unwrap_or(false)),
+ initially_deferred: Some(row.try_get::<_, bool>(11).unwrap_or(false)),
+ enabled: Some(true),
+ valid: Some(row.try_get::<_, bool>(12).unwrap_or(true)),
})
.collect())
}
@@ -5677,10 +5677,10 @@ pub async fn list_opengauss_constraints(pool: &Pool, schema: &str, table: &str)
match_type: postgres_constraint_match_type(pg_row_try_optional_text(&row, 7)),
on_update: postgres_fk_action_label(pg_row_try_optional_text(&row, 8)),
on_delete: postgres_fk_action_label(pg_row_try_optional_text(&row, 9)),
- deferrable: pg_row_try_bool(&row, 10).unwrap_or(false),
- initially_deferred: pg_row_try_bool(&row, 11).unwrap_or(false),
- enabled: true,
- valid: pg_row_try_bool(&row, 12).unwrap_or(true),
+ deferrable: Some(pg_row_try_bool(&row, 10).unwrap_or(false)),
+ initially_deferred: Some(pg_row_try_bool(&row, 11).unwrap_or(false)),
+ enabled: Some(true),
+ valid: Some(pg_row_try_bool(&row, 12).unwrap_or(true)),
});
}
Ok(result)
diff --git a/crates/dbx-driver-sqlserver/src/sqlserver.rs b/crates/dbx-driver-sqlserver/src/sqlserver.rs
index bc1ca362df..ecea9dac9c 100644
--- a/crates/dbx-driver-sqlserver/src/sqlserver.rs
+++ b/crates/dbx-driver-sqlserver/src/sqlserver.rs
@@ -3446,10 +3446,10 @@ pub async fn list_constraints(
match_type: None,
on_update: row.get::<&str, _>(7).filter(|value| !value.is_empty()).map(str::to_string),
on_delete: row.get::<&str, _>(8).filter(|value| !value.is_empty()).map(str::to_string),
- deferrable: false,
- initially_deferred: false,
- enabled: row.get::<bool, _>(9).unwrap_or(true),
- valid: row.get::<bool, _>(10).unwrap_or(true),
+ deferrable: Some(false),
+ initially_deferred: Some(false),
+ enabled: Some(row.get::<bool, _>(9).unwrap_or(true)),
+ valid: Some(row.get::<bool, _>(10).unwrap_or(true)),
}
})
.collect())
diff --git a/crates/dbx-types/src/types.rs b/crates/dbx-types/src/types.rs
index fbcbac5ba6..631f675026 100644
--- a/crates/dbx-types/src/types.rs
+++ b/crates/dbx-types/src/types.rs
@@ -828,13 +828,13 @@ pub struct ConstraintInfo {
#[serde(default, skip_serializing_if = "Option::is_none")]
pub on_delete: Option<String>,
#[serde(default)]
- pub deferrable: bool,
+ pub deferrable: Option<bool>,
#[serde(default)]
- pub initially_deferred: bool,
+ pub initially_deferred: Option<bool>,
#[serde(default)]
- pub enabled: bool,
+ pub enabled: Option<bool>,
#[serde(default)]
- pub valid: bool,
+ pub valid: Option<bool>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
@@ -1508,6 +1508,28 @@ mod tests {
assert_eq!(serialized["session_id"], serde_json::Value::Null);
}
+ #[test]
+ fn constraint_states_preserve_unknown_and_known_values_on_the_agent_ui_wire() {
+ for states in [
+ serde_json::json!({}),
+ serde_json::json!({ "enabled": null, "valid": null, "deferrable": null, "initially_deferred": null }),
+ serde_json::json!({ "enabled": true, "valid": false, "deferrable": false, "initially_deferred": true }),
+ ] {
+ let mut payload = serde_json::json!({
+ "name": "O01_UK", "constraint_type": "UNIQUE",
+ "definition": "UNIQUE (\"B\", \"A\")", "columns": ["B", "A"]
+ });
+ payload.as_object_mut().unwrap().extend(states.as_object().unwrap().clone());
+ let constraint: super::ConstraintInfo = serde_json::from_value(payload).unwrap();
+ let wire = serde_json::to_value(constraint).unwrap();
+ for field in ["enabled", "valid", "deferrable", "initially_deferred"] {
+ assert_eq!(wire[field], states[field], "{field}");
+ }
+ assert_eq!(wire["columns"], serde_json::json!(["B", "A"]));
+ assert_eq!(wire["definition"], "UNIQUE (\"B\", \"A\")");
+ }
+ }
+
#[test]
fn query_result_server_execution_microseconds_survive_agent_and_ui_wire() {
let mut result = bigint_result_sample();
diff --git a/docs/testing/oceanbase-oracle-constraints.md b/docs/testing/oceanbase-oracle-constraints.md
new file mode 100644
index 0000000000..c27417bc37
--- /dev/null
+++ b/docs/testing/oceanbase-oracle-constraints.md
@@ -0,0 +1,36 @@
+# OceanBase Oracle constraint metadata
+
+Issue: [#11415](https://github.com/t8y2/dbx/issues/11415), parent [#11412](https://github.com/t8y2/dbx/issues/11412).
+
+The read-only Constraints tab uses the existing `list_constraints` protocol for primary key, unique and CHECK constraints. Foreign keys remain in their existing tab. Constraint editing is outside this change.
+
+## Contract
+
+- `columns` preserves `ALL_CONS_COLUMNS.POSITION` for composite keys. Primary and unique definitions quote every column identifier. CHECK text is returned without whitespace normalization or truncation.
+- `enabled`, `valid`, `deferrable` and `initially_deferred` are nullable. Missing or unrecognized dictionary states remain unknown through Core and the UI. Existing explicit boolean responses from native Oracle and other drivers retain their meaning.
+- The query starts at `ALL_TABLES` and joins the visible P/U/C constraints by owner and table. A visible table with no constraints returns `[]`; an inaccessible or missing table returns an error without disclosing whether it exists. Dictionary query failures propagate. Drivers without this metadata method return an unsupported error.
+- Confirmed system-generated NOT NULL checks are omitted because the columns tab already shows nullability. Named CHECK constraints remain visible.
+
+## Automated checks
+
+With JDK 21, run from `agents/`:
+
+```sh
+./gradlew :common:test :oceanbase-oracle:test --no-daemon --max-workers=1
+```
+
+`OceanBaseOracleConstraintRpcTest` exercises the production JSON-RPC dispatcher, DTO serialization and OB JDBC implementation with the database boundary replaced. It covers composite keys, quoted names, multiline CHECK text, missing state/definition, visible empty tables, hidden tables, query errors and NOT NULL filtering. `CommonJavaCompatibilityTest` checks that an unsupported driver does not return an empty success.
+
+The Rust wire test checks unknown and known states through serialization. Mounted component regressions cover unknown badges and persistent metadata errors.
+
+## Live verification on 2026-10-09
+
+OceanBase Oracle 4.2.5.7, Connector/J 2.4.18 and the built Java agent process passed 166 assertions. Two disposable schemas had only `CREATE SESSION` and `CREATE TABLE`; all fixture names included `11415`. The checks compared RPC output with dictionary values and covered:
+
+- P/U/C definitions, composite column order, quoted names with spaces and mixed-case owners;
+- enabled/disabled and validated/not-validated states, including `ENABLE NOVALIDATE`;
+- generated NOT NULL filtering with an explicitly named CHECK retained;
+- multiline and 947-character CHECK definitions;
+- same-named objects in different schemas, individually granted SELECT/INSERT/UPDATE visibility, revoked access, nonexistent objects and a visible table without constraints.
+
+All RPC fixture schemas were removed and their absence was read back. The engine rejected embedded double quotes in table, column and constraint names, and rejected larger CHECK expressions at its `check_expr` limit. Escaping is covered at the RPC boundary; those rejected DDL forms are not claimed as live supported cases. No additional OceanBase version or native Oracle instance has been certified by this run.