Skip to content

Commit 6afdcba

Browse files
committed
AUTO: Sync ScalarDB docs in English to docs site repo
1 parent cc321eb commit 6afdcba

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

versioned_docs/version-3.15/scalardb-sql/grammar.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -552,6 +552,16 @@ DropCoordinatorTablesStatement statement2 =
552552

553553
The `ALTER TABLE` command alters a table (ex. adding a column).
554554

555+
:::warning
556+
557+
You should carefully consider adding a new column to a table because the execution time may vary greatly depending on the underlying storage. Please plan accordingly and consider the following, especially if the database runs in production:
558+
559+
- **For Cosmos DB for NoSQL and DynamoDB:** Adding a column is almost instantaneous as the table schema is not modified. Only the table metadata stored in a separate table is updated.
560+
- **For Cassandra:** Adding a column will only update the schema metadata and will not modify the existing schema records. The cluster topology is the main factor for the execution time. Changes to the schema metadata are shared to each cluster node via a gossip protocol. Because of this, the larger the cluster, the longer it will take for all nodes to be updated.
561+
- **For relational databases (MySQL, Oracle, etc.):** Adding a column shouldn't take a long time to execute.
562+
563+
:::
564+
555565
#### Grammar
556566

557567
```sql

0 commit comments

Comments
 (0)