From 6eb0f020e417f4aa3c6adf8c94d9468317c5de1b Mon Sep 17 00:00:00 2001 From: josh-wong Date: Thu, 28 Aug 2025 05:44:21 +0000 Subject: [PATCH] AUTO: Sync ScalarDB docs in English to docs site repo --- versioned_docs/version-3.15/api-guide.mdx | 9 +++++++++ versioned_docs/version-3.15/scalardb-sql/grammar.mdx | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/versioned_docs/version-3.15/api-guide.mdx b/versioned_docs/version-3.15/api-guide.mdx index 09b28598..82c31751 100644 --- a/versioned_docs/version-3.15/api-guide.mdx +++ b/versioned_docs/version-3.15/api-guide.mdx @@ -18,6 +18,15 @@ The ScalarDB Java API is mainly composed of the Administrative API and Transacti This section explains how to execute administrative operations programmatically by using the Administrative API in ScalarDB. +:::warning + +When an Administrative API call writes to the underlying databases, it triggers several write operations. However, these operations are not executed atomically, meaning that if the call fails midway, you may encounter inconsistent states. To resolve this inconsistency issue, you can repair the table. For details, see the following pages: + +- [Repair a table](#repair-a-table) by using the Java API +- [Repair tables](schema-loader.mdx#repair-tables) by using ScalarDB Schema Loader + +::: + :::note Another method for executing administrative operations is to use [Schema Loader](schema-loader.mdx). diff --git a/versioned_docs/version-3.15/scalardb-sql/grammar.mdx b/versioned_docs/version-3.15/scalardb-sql/grammar.mdx index c7d5045f..1d26b661 100644 --- a/versioned_docs/version-3.15/scalardb-sql/grammar.mdx +++ b/versioned_docs/version-3.15/scalardb-sql/grammar.mdx @@ -55,6 +55,15 @@ displayed_sidebar: docsEnglish ## DDL +:::warning + +Each DDL command triggers several write operations, but these operations are not executed atomically, meaning that if the command fails midway, you may encounter inconsistent states. To resolve this inconsistency issue, you can repair the table. For details, see the following pages: + +- [Repair a table](../api-guide.mdx#repair-a-table) by using the Java API +- [Repair tables](../schema-loader.mdx#repair-tables) by using ScalarDB Schema Loader + +::: + ### CREATE NAMESPACE Before creating tables, namespaces must be created since a table belongs to one namespace.