...
Eroare SQL · Funcții JSON și text

ESCAPE expression must be a single character

Pe scurt

În LIKE ... ESCAPE 'x', caracterul de escape trebuie să fie exact un caracter. Ai pus un șir gol sau două caractere (de obicei '\\', obișnuință din alte limbaje). În SQL nu se dublează backslash-ul: scrie ESCAPE '\' sau alege alt caracter, de exemplu ESCAPE '!'.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În LIKE, % înseamnă „orice șir” și _ înseamnă „orice caracter”. Ca să cauți chiar caracterele % sau _ (de exemplu „reducere 20%” sau „cod_vechi”), alegi un caracter de escape cu ESCAPE și îl pui înaintea lor: LIKE '%20!%%' ESCAPE '!'.

Mesajul spune că valoarea de după ESCAPE nu are exact un caracter. Cauzele:

  • ESCAPE '\\': în SQL, backslash-ul nu e caracter special în texte, deci '\\' are două caractere; dublarea vine din Python, Java sau JavaScript;
  • ESCAPE '': șir gol;
  • ESCAPE '!!' sau o expresie care întoarce mai multe caractere.

Caracterul de escape se folosește apoi în tipar, simplu: 'cod!_%'.

De ce apare: cauzele frecvente

1Backslash dublat, ca într-un limbaj de programare

Greșit
SQL
SELECT cod FROM produse
WHERE cod LIKE 'PR\\_%' ESCAPE '\\';
Corect
SQL
SELECT cod FROM produse
WHERE cod LIKE 'PR\_%' ESCAPE '\';

În textele SQL, \ e un caracter obișnuit. '\' are deja un singur caracter, deci e un escape valid.

2Alt caracter de escape, mai clar

Greșit
SQL
SELECT titlu FROM promotii
WHERE titlu LIKE '%20!%%' ESCAPE '!!';
Corect
SQL
SELECT titlu FROM promotii
WHERE titlu LIKE '%20!%%' ESCAPE '!';

Un singur ! e suficient. În tipar, !% înseamnă caracterul % propriu-zis, iar % de la capete rămân „orice șir”.

Repară tu

Repară eroarea, direct în pagină

Interogarea caută promoțiile al căror titlu conține exact textul 20% și afișează titlu. Caracterul de escape e scris greșit, iar acum dă ESCAPE expression must be a single character. Repar-o folosind ! ca escape.

Codul care dă eroarea
SQL
SELECT titlu
FROM promotii
WHERE titlu LIKE '%20!%%' ESCAPE '!!';
După reparație, programul afișează
titlu
Reducere 20% la mobilier
Indiciu

După ESCAPE stă exact un caracter, același folosit în tipar înaintea lui %.

Alte forme ale mesajului

  • ERROR: invalid escape string
  • ERROR 1210 (HY000): Incorrect arguments to ESCAPE

Cum o eviți pe viitor

Alege un caracter de escape care nu apare în date și nu e special în limbajul aplicației, de exemplu ! sau ^. Așa nu mai ai de gândit la dublarea backslash-ului în cod. Când trimiți tipare din aplicație, pune valoarea ca parametru și dublează doar ce cere limbajul tău, nu SQL-ul.

Întrebări frecvente

De ce se găsește și „PRX1” când caut 'PR_%'?

Pentru că _ înseamnă orice caracter. Ca să cauți liniuța de jos propriu-zisă, o precedezi de caracterul de escape și adaugi clauza ESCAPE.

Merge ESCAPE și cu GLOB?

Nu. GLOB nu are ESCAPE; acolo cauți caracterele speciale punându-le între paranteze drepte: [*], [?].

Erori înrudite

← Toate erorile SQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.