diff --git a/versioned_docs/version-3.13/scalardb-sql/grammar.mdx b/versioned_docs/version-3.13/scalardb-sql/grammar.mdx index 7b0d364b..5ea21024 100644 --- a/versioned_docs/version-3.13/scalardb-sql/grammar.mdx +++ b/versioned_docs/version-3.13/scalardb-sql/grammar.mdx @@ -519,6 +519,16 @@ DropCoordinatorTablesStatement statement2 = The `ALTER TABLE` command alters a table (ex. adding a column). +:::warning + +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: + +- **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. +- **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. +- **For relational databases (MySQL, Oracle, etc.):** Adding a column shouldn't take a long time to execute. + +::: + #### Grammar ```sql