AnalyticDB:ALTER TABLE

ALTER TABLE db_name.table_name RENAME new_table_name

ALTER TABLE customer RENAME new_customer;

ALTER TABLE db_name.table_name COMMENT 'comment'

ALTER TABLE customer COMMENT 'Customer table';

ALTER TABLE db_name.table_name ADD [COLUMN]
  {column_name column_type [DEFAULT {constant|CURRENT_TIMESTAMP}|AUTO_INCREMENT] [NULL|NOT NULL] [COMMENT 'comment']
  | (column_name column_type [DEFAULT {constant|CURRENT_TIMESTAMP}|AUTO_INCREMENT] [NULL|NOT NULL] [COMMENT 'comment'],...)}

ALTER TABLE adb_demo.customer ADD COLUMN province VARCHAR COMMENT 'Province';

ALTER TABLE adb_demo.customer ADD COLUMN (vip BOOLEAN COMMENT 'Is VIP', tags VARCHAR DEFAULT 'None' COMMENT 'Tag');

ALTER TABLE db_name.table_name DROP [COLUMN] column_name

ALTER TABLE adb_demo.customer DROP COLUMN province;

ALTER TABLE db_name.table_name RENAME COLUMN column_name TO new_column_name

ALTER TABLE customer RENAME COLUMN city_name TO city;

ALTER TABLE db_name.table_name MODIFY [COLUMN] column_name new_column_type

ALTER TABLE adb_demo.customer MODIFY COLUMN age BIGINT;

ALTER TABLE db_name.table_name MODIFY [COLUMN] column_name column_type DEFAULT {constant | CURRENT_TIMESTAMP}

ALTER TABLE adb_demo.customer MODIFY COLUMN sex INT NOT NULL DEFAULT 0;

ALTER TABLE adb_demo.customer MODIFY COLUMN login_time TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP;

ALTER TABLE db_name.table_name MODIFY [COLUMN] column_name column_type NULL

ALTER TABLE adb_demo.customer MODIFY COLUMN province VARCHAR NULL;

ALTER TABLE db_name.table_name MODIFY [COLUMN] column_name column_type COMMENT 'new_comment'

ALTER TABLE adb_demo.customer MODIFY COLUMN province VARCHAR COMMENT 'The province where the customer is located';

ALTER TABLE db_name.table_name ADD {INDEX|KEY} [index_name] (column_name)

ALTER TABLE adb_demo.customer ADD KEY age_idx(age);

Prérequis

La table XUANWU_V2 doit se trouver dans un cluster dont la version du noyau est 3.2.3.7 ou ultérieure, ou 3.2.4.3 ou ultérieure.

Pour afficher et mettre à jour la version mineure de votre cluster, connectez-vous à la console AnalyticDB for MySQL et accédez à la section Configuration Information de la page Cluster Information .

ALTER TABLE db_name.table_name INDEX_ALL = {'Y'|'N'};

Remarques d'utilisation :

• Pour les tables XUANWU, l'indexation sur toutes les colonnes ne peut être configurée qu'au moment de la création de la table. Pour la désactiver, supprimez les index individuellement.

• Si INDEX_ALL='Y' et que vous supprimez un index standard à l'aide d'une instruction DDL (Data Definition Language), la propriété passe automatiquement à INDEX_ALL='N'. Seul l'index cible est supprimé ; les autres index restent inchangés.

• Lorsque INDEX_ALL='N', l'instruction SHOW CREATE TABLE peut ne pas afficher explicitement cette propriété, mais elle reste effective.

Exemple 1 : Désactivez l'indexation sur toutes les colonnes pour la table customer (actuellement INDEX_ALL='Y').

ALTER TABLE adb_demo.customer INDEX_ALL = 'N';

Après l'exécution, les index standards sur les colonnes non primaires telles que customer_name, city_name et sex sont supprimés.

Exemple 2 : Activez l'indexation sur toutes les colonnes pour la table customer (actuellement INDEX_ALL='N', avec des index existants sur customer_id, phone_num et login_time).

ALTER TABLE adb_demo.customer INDEX_ALL = 'Y';

Après l'exécution, des index standards sont créés pour toutes les colonnes qui n'en possèdent pas encore, telles que customer_name, city_name et sex.

Remarques d'utilisation

Le comportement de l'index JSON diffère selon le moteur de table :

• Tables XUANWU_V2 (partitionnées et non partitionnées) : l'index prend effet immédiatement — aucune tâche BUILD n'est nécessaire.

• Tables XUANWU non partitionnées : l'index prend effet uniquement après la fin d'une tâche BUILD.

• Tables XUANWU partitionnées : déclenchez manuellement une tâche BUILD sur toute la table. L'index prend effet uniquement après la fin de la tâche BUILD.

ALTER TABLE db_name.table_name DROP KEY index_name

ALTER TABLE adb_demo.customer DROP KEY age_idx;

ALTER TABLE adb_demo.customer DROP KEY index_vj;

ALTER TABLE db_name.table_name ADD CLUSTERED [INDEX|KEY] [index_name] (column_name1 [ASC|DESC], column_name2 [ASC|DESC])

ALTER TABLE adb_demo.customer ADD CLUSTERED KEY (customer_id ASC);

ALTER TABLE db_name.table_name DROP CLUSTERED KEY index_name

ALTER TABLE adb_demo.customer DROP CLUSTERED KEY index;

Prérequis

Un cluster AnalyticDB for MySQL de version V3.1.4.9 ou ultérieure. Pour de meilleurs résultats, utilisez la version V3.1.4.17 ou ultérieure.

Pour savoir comment interroger la version mineure, consultez la section Comment interroger la version d'un cluster AnalyticDB for MySQL ?

ALTER TABLE db_name.table_name ADD FULLTEXT [INDEX|KEY] index_name (column_name) [index_option]

Exemple : Ajoutez un index full-text à la colonne home_address en utilisant l'analyseur standard.

ALTER TABLE adb_demo.customer ADD FULLTEXT INDEX fidx_k(home_address) WITH ANALYZER standard;

Pour plus d'informations, consultez la section Créer un index full-text.

ALTER TABLE db_name.table_name DROP FULLTEXT INDEX index_name

ALTER TABLE adb_demo.customer DROP FULLTEXT INDEX fidx_k;

Prérequis

Un cluster AnalyticDB for MySQL de version V3.1.4.0 ou ultérieure. Versions mineures recommandées : 3.1.5.16, 3.1.6.8, 3.1.8.6 et ultérieures.

Si votre cluster n'utilise pas l'une des versions recommandées, définissez CSTORE_PROJECT_PUSH_DOWN et CSTORE_PPD_TOP_N_ENABLE sur false avant d'utiliser la recherche vectorielle. Pour mettre à jour la version mineure, contactez le support technique. Pour savoir comment interroger la version mineure, consultez la section Comment interroger la version d'un cluster AnalyticDB for MySQL ?

ALTER TABLE db_name.table_name ADD ANN [INDEX|KEY] [index_name] (column_name) [algorithm=HNSW_PQ] [distancemeasure=SquaredL2]

Exemple : Créez des index vectoriels sur les colonnes float_feature et short_feature.

CREATE TABLE vector (
  xid BIGINT NOT NULL,
  cid BIGINT NOT NULL,
  uid VARCHAR NOT NULL,
  vid VARCHAR NOT NULL,
  wid VARCHAR NOT NULL,
  float_feature array<FLOAT>(4),
  short_feature array<SMALLINT>(4),
  PRIMARY KEY (xid, cid, vid)
) DISTRIBUTED BY HASH(xid);

ALTER TABLE vector ADD ANN INDEX idx_float_feature(float_feature);
ALTER TABLE vector ADD ANN INDEX idx_short_feature(short_feature);

Prérequis

Un cluster AnalyticDB for MySQL de version V3.1.10 ou ultérieure.

Pour afficher et mettre à jour la version mineure, connectez-vous à la console AnalyticDB for MySQL et accédez à la section Configuration Information de la page Cluster Information .

ALTER TABLE db_name.table_name ADD [CONSTRAINT [symbol]] FOREIGN KEY (fk_column_name) REFERENCES db_name.pk_table_name (pk_column_name)

Remarques d'utilisation :

• Une table peut avoir plusieurs index de clé étrangère.

• Un index de clé étrangère ne peut pas s'étendre sur plusieurs colonnes (par exemple, FOREIGN KEY (sr_item_sk, sr_ticket_number) n'est pas pris en charge).

• AnalyticDB for MySQL n'applique pas les contraintes de données. Validez la relation de contrainte entre les clés primaires et étrangères dans votre application.

• Les contraintes de clé étrangère ne peuvent pas être ajoutées aux tables externes.

Exemple : Ajoutez une clé étrangère sur store_sales référençant la table item.

CREATE TABLE item
(
 i_item_sk BIGINT NOT NULL,
 i_current_price BIGINT,
 PRIMARY KEY(i_item_sk)
)
DISTRIBUTED BY HASH(i_item_sk);

CREATE TABLE store_sales
(
 ss_sale_id BIGINT,
 ss_store_sk BIGINT,
 ss_item_sk BIGINT NOT NULL,
 PRIMARY KEY(ss_sale_id)
);

ALTER TABLE store_sales ADD CONSTRAINT ss_item_sk FOREIGN KEY (ss_item_sk) REFERENCES item (i_item_sk);

Pour plus d'informations, consultez la section Éliminer les jointures inutiles à l'aide de contraintes de clé primaire et étrangère.

ALTER TABLE db_name.table_name DROP FOREIGN KEY fk_symbol

ALTER TABLE store_returns DROP FOREIGN KEY sr_item_sk_fk;

ALTER TABLE db_name.table_name PARTITIONS N

ALTER TABLE customer PARTITIONS 0;

ALTER TABLE customer PARTITIONS 40;

ALTER TABLE db_name.table_name DROP PARTITION (partition_name,...)

ALTER TABLE adb_demo.customer DROP PARTITION (20241220);

ALTER TABLE adb_demo.customer DROP PARTITION (20241218,20241219);

Prérequis

• Le cluster est de l'édition Enterprise, Basic, Data Lakehouse ou Data Warehouse (mode élastique).

• Exigences de version du noyau :

  • Tables XUANWU : aucune restriction de version du noyau.

  • Tables XUANWU_V2 : la version du noyau doit être 3.2.2.15 ou ultérieure, 3.2.3.13 ou ultérieure, 3.2.4.9 ou ultérieure, ou 3.2.5.3 ou ultérieure.

Pour afficher et mettre à jour la version mineure, connectez-vous à la console AnalyticDB for MySQL et accédez à la section Configuration Information de la page Cluster Information .

Pour les tables XUANWU_V2, la tâche planifiée de déplacement des données entre le stockage chaud et froid doit être activée :

• Vérifiez l'état : SHOW ADB_CONFIG KEY=SERVERLESS_DATA_STORAGE_CHANGE_SCHEDULE_ENABLE;

  • Si le résultat est FALSE, la tâche est désactivée et doit être activée.

  • Si une erreur est renvoyée, le paramètre n'a pas été défini et la valeur par défaut est TRUE.

• Activez la tâche : SET ADB_CONFIG SERVERLESS_DATA_STORAGE_CHANGE_SCHEDULE_ENABLE = true;

ALTER TABLE db_name.table_name STORAGE_POLICY= {'HOT'|'COLD'|'MIXED' hot_partition_count=N}

La nouvelle politique de stockage prend effet uniquement après le déclenchement et la fin d'une tâche BUILD pour la table. Par défaut, cette tâche s'exécute automatiquement en arrière-plan. Avant la fin de la tâche BUILD, le nombre de partitions chaudes signalé par information_schema.table_usage peut différer de la politique configurée. Exécutez SHOW CREATE TABLE db_name.table_name; pour confirmer que la politique est effective.

Exemple 1 : Définissez la politique de stockage sur COLD.

ALTER TABLE customer storage_policy = 'COLD';

Exemple 2 : Définissez la politique de stockage sur HOT.

ALTER TABLE customer storage_policy = 'HOT';

Exemple 3 : Définissez la politique de stockage sur MIXED avec 10 partitions chaudes.

ALTER TABLE customer storage_policy = 'MIXED' hot_partition_count = 10;