Partager via

UPDATE

S’applique à :case marquée oui Databricks SQL case marquée oui Databricks Runtime

Met à jour les valeurs de colonne pour les lignes qui correspondent à un prédicat. Quand aucun prédicat n’est fourni, met à jour les valeurs de colonne pour toutes les lignes.

Cette instruction est uniquement prise en charge pour les tables Delta Lake.

Syntaxe

[ common_table_expression ]
  UPDATE table_name [table_alias]
     SET  { { column_name | field_name }  = [ expr | DEFAULT } [, ...]
     [WHERE clause]

Paramètres

  • expression de table commune

    Les expressions de table communes sont une ou plusieurs requêtes nommées qui peuvent être réutilisées plusieurs fois dans le bloc de requête principal afin d’éviter les calculs répétés ou d’améliorer la lisibilité des requêtes complexes et imbriquées.

  • table_name

    Identifie la table à mettre à jour. Le nom de la table ne doit pas utiliser une spécification temporelle ou une spécification d’options.

    table_name ne doit pas être une table source contenant une clé étrangère.

  • table_alias

    Définissez un alias pour la table. L’alias ne doit pas inclure une liste de colonnes.

  • nom_de_colonne

    Référence à une colonne dans la table. Vous pouvez référencer chaque colonne au maximum une fois.

  • field_name

    Référence à un champ dans une colonne de type STRUCT. Vous pouvez référencer chaque champ au maximum une fois.

  • expr

    Expression arbitraire. Si vous référencez des colonnes table_name, elles représentent l’état de la ligne avant la mise à jour.

  • PAR DÉFAUT

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 11.3 LTS et versions ultérieures

    Expression DEFAULT de la colonne si une colonne est définie ; sinon, NULL.

  • WHERE

    Filtrez les lignes par prédicat. La clause WHERE peut inclure des sous-requêtes avec les exceptions suivantes :

    • Sous-requêtes imbriquées, à savoir une sous-requête à l’intérieur d’une autre sous-requête
    • Une sous-requête NOT IN à l’intérieur d’un OR, par exemple, a = 3 OR b NOT IN (SELECT c from t)

    Dans la plupart des cas, vous pouvez réécrire des sous-requêtes NOT IN à l’aide de NOT EXISTS. Dans la mesure du possible, vous devez utiliser NOT EXISTS, car UPDATE avec des sous-requêtes NOT IN peut être lent.

Mise à jour à partir d’une autre table ou jointure

Databricks SQL ne prend pas en charge la UPDATE ... FROM ... JOIN syntaxe utilisée dans d’autres dialectes SQL (par exemple, mise à jour de colonnes dans une table à partir d’une jointure avec une autre table). Pour mettre à jour une table basée sur une jointure avec une autre table ou une sous-requête, utilisez MERGE INTO plutôt.

Exemples

> UPDATE events SET eventType = 'click' WHERE eventType = 'clk'

> UPDATE all_events
     SET session_time = 0, ignored = true
   WHERE session_time < (SELECT min(session_time) FROM good_events)

> UPDATE orders AS t1
     SET order_status = 'returned'
   WHERE EXISTS (SELECT oid FROM returned_orders WHERE t1.oid = oid)

> UPDATE events
     SET category = 'undefined'
   WHERE category NOT IN (SELECT category FROM events2 WHERE date > '2001-01-01')

> UPDATE events
     SET ignored = DEFAULT
  WHERE eventType = 'unknown'

L’exemple suivant montre comment mettre à jour une table à partir d’une jointure à l’aide MERGE de la syntaxe non prise en charge UPDATE ... FROM ... JOIN :

-- Equivalent to (not supported in Databricks): UPDATE t1 SET t1.c1 = t2.c1 FROM t1 INNER JOIN t2 ON t1.c2 = t2.c2
> MERGE INTO t1
  USING t2 ON t1.c2 = t2.c2
  WHEN MATCHED THEN UPDATE SET t1.c1 = t2.c1;
  • Last updated on