Catégories :

Fonctions de chaîne et fonctions binaires (Correspondance/Comparaison)

REPLACE

Supprime toutes les occurrences d’une sous-chaîne spécifiée et les remplace éventuellement par une autre sous-chaîne.

Syntaxe

REPLACE( <subject> , <pattern> [ , <replacement> ] )
Copy

Arguments

subject

Le sujet est la chaîne dans laquelle effectuer les remplacements. En règle générale, il s’agit d’une colonne, mais il peut s’agir d’un littéral.

pattern

C’est la sous-chaîne que vous souhaitez remplacer. En règle générale, il s’agit d’un littéral, mais il peut s’agir d’une colonne ou d’une expression. Notez que ce n’est pas une « expression régulière » ; si vous souhaitez utiliser des expressions régulières pour rechercher un modèle, utilisez la fonction REGEXP_REPLACE .

replacement

Il s’agit de la valeur utilisée en remplacement du pattern . Si ceci est omis ou s’il s’agit d’une chaîne vide, la fonction REPLACE supprime simplement toutes les occurrences du pattern .

Renvoie

La valeur renvoyée est la chaîne une fois tous les remplacements terminés.

Notes sur l’utilisation

  • Si replacement n’est pas spécifié, subject est renvoyé avec toutes les occurrences de pattern supprimées.

  • Si replacement est spécifié, subject est renvoyé avec toutes les occurrences de pattern remplacées par replacement.

  • Si l’un des arguments est un NULL, le résultat est également un NULL.

Note

Seules les occurrences dans le subject d’origine sont prises en compte. Un pattern apparaissant dans le résultat n’est pas supprimé/remplacé.

Détails du classement

The collation specifications of all input arguments must be compatible.

Cette fonction ne fonctionne pas avec les spécifications de classement suivantes :

  • pi (insensible à la ponctuation).

  • cs-ai (sensible à la casse, insensible aux accents)

Note

Pour utiliser cette fonction avec une colonne qui a les spécificateurs de classement upper ou lower, vous devez activer le bundle de changements de comportement 2024_02 dans votre compte.

Pour activer ce bundle dans votre compte, exécutez l’instruction suivante :

SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2024_02');
Copy

Exemples

Remplacer la chaîne down par la chaîne up :

SELECT REPLACE('down', 'down', 'up');
Copy
+-------------------------------+
| REPLACE('DOWN', 'DOWN', 'UP') |
|-------------------------------|
| up                            |
+-------------------------------+

Remplacer la sous-chaîne Athens de la chaîne Vacation in Athens par la sous-chaîne Rome :

SELECT REPLACE('Vacation in Athens', 'Athens', 'Rome');
Copy
+-------------------------------------------------+
| REPLACE('VACATION IN ATHENS', 'ATHENS', 'ROME') |
|-------------------------------------------------|
| Vacation in Rome                                |
+-------------------------------------------------+

Remplacer la sous-chaîne bc de la chaîne abcd par une sous-chaîne vide :

SELECT REPLACE('abcd', 'bc');
Copy
+-----------------------+
| REPLACE('ABCD', 'BC') |
|-----------------------|
| ad                    |
+-----------------------+

Remplacez les valeurs d’une table par de nouvelles valeurs.

Créer et remplir une table :

CREATE OR REPLACE TABLE replace_example(
  subject VARCHAR(10),
  pattern VARCHAR(10),
  replacement VARCHAR(10));

INSERT INTO replace_example VALUES
  ('old car', 'old car', 'new car'),
  ('sad face', 'sad', 'happy'),
  ('snowman', 'snow', 'fire');
Copy

Remplacez les chaînes d’une valeur par un remplacement spécifié :

SELECT subject,
       pattern,
       replacement,
       REPLACE(subject, pattern, replacement) AS new
  FROM replace_example
  ORDER BY subject;
Copy
+----------+---------+-------------+------------+
| SUBJECT  | PATTERN | REPLACEMENT | NEW        |
|----------+---------+-------------+------------|
| old car  | old car | new car     | new car    |
| sad face | sad     | happy       | happy face |
| snowman  | snow    | fire        | fireman    |
+----------+---------+-------------+------------+

La sortie montre les remplacements suivants :

  • La chaîne old car a été remplacée par la chaîne new car.

  • Dans la chaîne sad face, la sous-chaîne sad a été remplacée par la sous-chaîne happy pour créer la nouvelle chaîne happy face.

  • Dans la chaîne snowman, la sous-chaîne snow a été remplacée par la sous-chaîne fire pour créer la nouvelle chaîne fireman.