Aracılığıyla paylaş

REGEXP_REPLACE (Transact-SQL)

Şunlar için geçerlidir: SQL Server 2025 (17.x) Microsoft Fabric'teAzure SQL VeritabanıAzure SQL Yönetilen Örneği SQL veritabanı

Normal ifade deseninin bulunduğu değiştirme dizesiyle değiştirilen bir kaynak dize döndürür. Eşleşme bulunmazsa, işlev özgün dizeyi döndürür.

REGEXP_REPLACE
(
    string_expression,
    pattern_expression [ , string_replacement [ , start [ , occurrence [ , flags ] ] ] ]
)

Note

Normal ifadeler Azure SQL Yönetilen Örneği'nde SQL Server 2025 veya Always-up-to-dategüncelleştirme ilkesiyle kullanılabilir.

Arguments

string_expression

Karakter dizesinin ifadesi.

Sabit, değişken veya karakter dizesi sütunu olabilir.

Veri türleri: char, nchar, varchar veya nvarchar.

Note

REGEXP_LIKE, REGEXP_COUNTve REGEXP_INSTR işlevleri, string_expression parametresi için 2 MB'a kadar LOB türlerini (varchar(max) ve nvarchar(max)) destekler.

pattern_expression

Eşleşecek normal ifade deseni. Genellikle bir metin değişmez değeridir.

Veri türleri: char, nchar, varchar veya nvarchar. pattern_expression en fazla 8.000 bayt karakter uzunluğunu destekler.

string_replacement

Eşleşen alt dizeler için değiştirme dizesini belirten ve desenle eşleşen alt dizelerin yerini alan dize ifadesi. string_replacement char, varchar, nchar ve nvarchar veri türlerinden oluşabilir. Boş bir dize ('') belirtilirse, işlev eşleşen tüm alt dizeleri kaldırır ve sonuçta elde edilen dizeyi döndürür. Varsayılan değiştirme dizesi boş dizedir ('' ).

string_replacement, desenin n'th parantez grubuyla (alt ifade) eşleşen kaynak alt dizenin eklenmesi gerektiğini ve desenin tamamıyla eşleşen alt dizenin eklenmesi gerektiğini belirtmek için 1 ile 9 arasında olan \niçerebilir & . Değiştirme metnine değişmez değer ters eğik çizgi koymanız gerekiyorsa \ yazın.

Mesela

REGEXP_REPLACE('123-456-7890', '(\d{3})-(\d{3})-(\d{4})', '(\1) \2-\3')

Returns:

(123) 456-7890

içinde sağlanan \nstring_replacement , pattern_expression grup sayısından büyükse işlev değeri yoksayar.

Örneğin:

REGEXP_REPLACE('123-456-7890', '(\d{3})-(\d{3})-(\d{4})', '(\1) (\4)-xxxx')

Returns:

(123) ()-xxxx

start

Arama dizesi içinde aramanın başlangıç konumunu belirtin. Optional. Tür int veya bigint şeklindedir.

Numaralandırma 1 tabanlıdır, yani ifadedeki ilk karakter ve 1 değeri olmalıdır >= 1. Başlangıç ifadesi değerinden 1küçükse hata döndürür. Başlangıç ifadesi string_expression uzunluğundan büyükse işlev string_expression döndürür. Varsayılan değer: 1.

occurrence

Desen ifadesinin kaynak dize içinde hangi oluşumunun arandığını veya değiştirildiğini belirten bir ifade (pozitif tamsayı). Varsayılan 1 değeridir. string_expression ilk karakterinde arar. Pozitif bir tamsayı niçin nth , pattern_expression ilk oluşumunu izleyen ilk karakterle başlayan oluşumu vb. arar.

flags

Eşleşmeleri aramak için kullanılan değiştiricileri belirten bir veya daha fazla karakter. Tür, en fazla 30 karakter içeren varchar veya char'tır.

Örneğin, ims. Varsayılan değer: c. Boş bir dize (' ') sağlanırsa, varsayılan değer ('c')olarak değerlendirilir. Veya c diğer karakter ifadelerini sağlayın. Bayrak birden çok çelişkili karakter içeriyorsa, SQL Server son karakteri kullanır.

Örneğin, regex değerini belirtirseniz ic büyük/küçük harfe duyarlı eşleştirme döndürür.

Değer , Desteklenen bayrak değerleri'nde listelenenlerden farklı bir karakter içeriyorsa, sorgu aşağıdaki örneğe benzer bir hata döndürür:

Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
Desteklenen bayrak değerleri
Flag Description
i Büyük/küçük harfe duyarlı değil (varsayılan false)
m Çok satırlı mod: ^ ve $ başlangıç/bitiş metnine ek olarak başlangıç/bitiş satırını eşleştir (varsayılan false)
s Eşleşmeye . izin ver \n (varsayılan false)
c Büyük/küçük harfe duyarlı (varsayılan true)

Dönüş değeri

Expression.

Examples

ürün adlarında veya a öğelerinin e tüm oluşumlarını ile X değiştirin.

SELECT REGEXP_REPLACE(PRODUCT_NAME, '[ae]', 'X', 1, 0, 'i')
FROM PRODUCTS;

ürün açıklamalarında veya öğesinin cat ilk geçtiği yeri ile dog değiştirin pet

SELECT REGEXP_REPLACE(PRODUCT_DESCRIPTION, 'cat|dog', 'pet', 1, 1, 'i')
FROM PRODUCTS;

Telefon numaralarının son dört basamağını yıldız işaretiyle değiştirme

SELECT REGEXP_REPLACE(PHONE_NUMBER, '\d{4}$', '****')
FROM CUSTOMERS;

İlgili içerik

  • Last updated on