This chapter describes regular expressions and explains how to use them in database applications.
See Also:
Oracle Database Globalization Support Guide for information about using SQL regular expression functions in a multilingual environment
Oracle Regular Expressions Pocket Reference by Jonathan Gennick, O'Reilly & Associates
Mastering Regular Expressions by Jeffrey E. F. Friedl, O'Reilly & Associates
A regular expression specifies a search pattern, using metacharacters (which are, or belong to, operators) and character literals (described in Oracle Database SQL Language Reference).
The search pattern can be complex. For example, this regular expression matches any string that begins with either f
or ht
, followed by tp
, optionally followed by s
, followed by the colon (:
):
(f|ht)tps?:
The metacharacters (which are also operators) in the preceding example are the parentheses, the pipe symbol (|
), and the question mark (?
). The character literals are f
, ht
, tp
, s
, and the colon (:
).
Parentheses group multiple pattern elements into a single element. The pipe symbol (|
) indicates a choice between the elements on either side of it, f
and ht
. The question mark (?
) indicates that the preceding element, s
, is optional. Thus, the preceding regular expression matches these strings:
http:
https:
ftp:
ftps:
Regular expressions are a powerful text-processing component of the programming languages Java and PERL. For example, a PERL script can read the contents of each HTML file in a directory into a single string variable and then use a regular expression to search that string for URLs. This robust pattern-matching functionality is one reason that many application developers use PERL.
Oracle SQL support for regular expressions lets application developers implement complex pattern-matching logic in the database, which is useful for these reasons:
By centralizing pattern-matching logic in the database, you avoid intensive string processing of SQL results sets by middle-tier applications.
For example, life science customers often rely on PERL to do pattern analysis on bioinformatics data stored in huge databases of DNA and proteins. Previously, finding a match for a protein sequence such as [AG]
.{4}GK[ST]
was handled in the middle tier. The SQL regular expression functions move the processing logic closer to the data, thereby providing a more efficient solution.
By using server-side regular expressions to enforce constraints, you avoid duplicating validation logic on multiple clients.
Oracle SQL supports regular expressions with the pattern-matching condition and functions summarized in Table 3-1. Each pattern matcher searches a given string for a given pattern (described with a regular expression), and each has the pattern-matching options described in Table 3-2. The functions have additional options (for example, the character position at which to start searching the string for the pattern). For details, see Oracle Database SQL Language Reference.
Table 3-1 Oracle SQL Pattern-Matching Condition and Functions
Name | Description |
---|---|
Condition that can appear in the Example: This WHERE REGEXP_LIKE((hr.employees.first_name, '^Ste(v|ph)en$') |
|
Function that returns the number of times the given pattern appears in the given string. Example: This function invocation returns the number of times that REGEXP_COUNT('Albert Einstein', 'e', 7, 'c') (The returned value is 1, because the |
|
Function that returns an integer that indicates the starting position of the given pattern in the given string. Alternatively, the integer can indicate the position immediately following the end of the pattern. Example: This function invocation returns the starting position of the first valid email address in the column REGEXP_INSTR(hr.employees.email, '\w+@\w+(\.\w+)+') If the returned value is greater than zero, then the column contains a valid email address. |
|
Function that returns the string that results from replacing occurrences of the given pattern in the given string with a replacement string. Example: This function invocation puts a space after each character in the column REGEXP_REPLACE(hr.countries.country_name, '(.)', '\1 ') |
|
Function that is like Example: This function invocation returns REGEXP_SUBSTR('Oracle 2010', 'O r a c l e', 1, 1, 'x') |
Table 3-2 describes the pattern-matching options that are available to each pattern matcher in Table 3-1.
Table 3-2 Pattern-Matching Options for Oracle SQL Pattern-Matching Condition and Functions
Option | Description | Example |
---|---|---|
|
Specifies case-insensitive matching. |
This function invocation returns 3:
REGEXP_COUNT('Albert Einstein', 'e', 'i')
|
|
Specifies case-sensitive matching. |
This function invocation returns 2:
REGEXP_COUNT('Albert Einstein', 'e', 'c')
|
|
Allows the Dot operator ( |
In this function invocation, the string and search pattern match only because the
REGEXP_SUBSTR('a'||CHR(10)||'d', 'a.d', 1, 1, 'n')
|
|
Specifies multiline mode, where a newline character inside a string terminates a line. The string can contain multiple lines. Multiline mode affects POSIX operators Beginning-of-Line Anchor ( |
This function invocation returns
REGEXP_SUBSTR('ab'||CHR(10)||'ac', '^a.', 1, 2, 'm')
|
|
Ignores whitespace characters in the search pattern. By default, whitespace characters match themselves. |
This function invocation returns
REGEXP_SUBSTR('abcd', 'a b c d', 1, 1, 'x')
|
Oracle SQL implementation of regular expressions conforms to these standards:
IEEE Portable Operating System Interface (POSIX) standard draft 1003.2/D11.2
Oracle SQL follows exactly the syntax and matching semantics for regular expression operators as defined in the POSIX standard for matching ASCII (English language) data. You can find the POSIX standard draft at this URL:
http://www.opengroup.org/onlinepubs/007908799/xbd/re.html
For more information, see "POSIX Operators in Oracle SQL Regular Expressions".
Unicode Regular Expression Guidelines of the Unicode Consortium
Oracle SQL extends regular expression support beyond the POSIX standard in these ways:
Extends the matching capabilities for multilingual data
For details, see "Oracle SQL Multilingual Extensions to POSIX Standard".
Supports some commonly used PERL regular expression operators that are not included in the POSIX standard but do not conflict with it (for example, character class shortcuts and the nongreedy modifier (?
))
For details, see "Oracle SQL PERL-Influenced Extensions to POSIX Standard".
Oracle SQL supports a set of common operators (composed of metacharacters) used in regular expressions.
Caution:
The interpretation of metacharacters differs between tools that support regular expressions. If you are porting regular expressions from another environment to Oracle Database, ensure that Oracle SQL supports their syntax and interprets them as you expect.Table 3-3 summarizes the POSIX operators defined in the POSIX standard Extended Regular Expression (ERE) syntax. Oracle SQL follows the exact syntax and matching semantics for these operators as defined in the POSIX standard for matching ASCII (English language) data. Any differences in action between Oracle SQL and the POSIX standard are noted in the Description column.
Table 3-3 POSIX Operators in Oracle SQL Regular Expressions
Operator Syntax | Names | Description | Examples |
---|---|---|---|
|
Any Character Dot |
Matches any character in the database character set, including the newline character if you specify matching option The Linux, UNIX, and Windows platforms recognize the newline character as the linefeed character ( The Macintosh platforms recognize the newline character as the carriage return character ( Note: In the POSIX standard, this operator matches any English character except NULL and the newline character. |
The expression |
|
One or More Plus Quantifier |
Matches one or more occurrences of the preceding subexpression (greedyFoot 1 ). |
The expression |
|
Zero or More Star Quantifier |
Matches zero or more occurrences of the preceding subexpression (greedyFootref 1). |
The expression |
|
Zero or One Question Mark Quantifier |
Matches zero or one occurrences of the preceding subexpression (greedyFootref 1). |
The expression |
|
Interval Exact Count |
Matches exactly |
The expression |
|
Interval At-Least Count |
Matches at least |
The expression |
|
Interval Between Count |
Matches at least |
The expression |
|
Matching Character List |
Matches any single character in the list within the brackets. In the list, all operators except these are treated as literals:
A dash ( Note: In the POSIX standard, a range includes all collation elements between the start and end of the range in the linguistic definition of the current locale. Thus, ranges are linguistic rather than byte value ranges; the semantics of the range expression are independent of the character set. In Oracle Database, the linguistic range is determined by the |
The expression |
|
Nonmatching Character List |
Matches any single character not in the list within the brackets. For information about operators and ranges in the character list, see the description of the Matching Character List operator. |
The expression The expression |
|
Or |
Matches either alternative. |
The expression |
|
Subexpression Grouping |
Treats the expression within the parentheses as a unit. The expression can be a string or a complex expression containing operators. You can refer to a subexpression in a back reference. |
The expression |
|
Back Reference |
Matches the nth preceding subexpression, where A back reference lets you search for a repeated string without knowing what it is. For the |
The expression The expression |
|
Escape Character |
Treats the subsequent character as a literal. A backslash (\) lets you search for a character that would otherwise be treated as a metacharacter. Use consecutive backslashes ( |
The expression |
|
Beginning-of-Line Anchor |
Default mode: Matches the beginning of a string. Multiline mode:Foot 2 Matches the beginning of any line the source string. |
The expression |
|
End-of-Line Anchor |
Default mode: Matches the end of a string. Multiline mode:Footref 2 Matches the end of any line the source string. |
The expression |
|
POSIX Character Class |
Matches any character in the specified POSIX character class (such as uppercase characters, digits, or punctuation characters). Note: In English regular expressions, range expressions often indicate a character class. For example, |
The expression |
|
POSIX Collating Element Operator |
Specifies a collating element defined in the current locale. The This syntax lets you use a multicharacter collating element where otherwise only single-character collating elements are allowed. For example, you can ensure that the collating element |
The expression The expression |
|
POSIX Character Equivalence Class |
Matches all characters that belong to the same POSIX character equivalence class as the specified character, in the current locale. This syntax must appear within a character list; that is, it must be nested within the brackets for a character list. Character equivalents depend on how canonical rules are defined for your database locale. For details, see Oracle Database Globalization Support Guide. |
The expression |
Footnote 1 A greedy operator matches as many occurrences as possible while allowing the rest of the match to succeed. To make the operator nongreedy, follow it with the nongreedy modifier (?
) (see Table 3-5).
Footnote 2 Specify multiline mode with the pattern-matching option m
, described in Table 3-2.
When applied to multilingual data, Oracle SQL POSIX operators extend beyond the matching capabilities specified in the POSIX standard.
Table 3-4 shows, for each POSIX operator, which POSIX standards define its syntax and whether Oracle SQL extends its semantics for handling multilingual data. The POSIX standards are Basic Regular Expression (BRE) and Extended Regular Expression (ERE).
Table 3-4 POSIX Operators and Multilingual Operator Relationships
Operator | POSIX BRE Syntax | POSIX ERE Syntax | Multilingual Enhancement |
---|---|---|---|
|
Yes |
Yes |
-- |
|
Yes |
Yes |
-- |
|
-- |
Yes |
-- |
|
-- |
Yes |
-- |
|
-- |
Yes |
-- |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
-- |
|
Yes |
Yes |
-- |
|
Yes |
Yes |
-- |
|
Yes |
Yes |
-- |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
|
Yes |
Yes |
Yes |
Multilingual data might have multibyte characters. Oracle Database lets you enter multibyte characters directly (if you have a direct input method) or use functions to compose them. You cannot use the Unicode hexadecimal encoding value of the form \
xxxx
. Oracle Database evaluates the characters based on the byte values used to encode the character, not the graphical representation of the character.
Oracle SQL supports some commonly used PERL regular expression operators that are not included in the POSIX standard but do not conflict with it.
Table 3-5 summarizes the PERL-influenced operators that Oracle SQL supports.
Caution:
PERL character class matching is based on the locale model of the operating system, whereas Oracle SQL regular expressions are based on the language-specific data of the database. In general, you cannot expect a regular expression involving locale data to produce the same results in PERL and Oracle SQL.Table 3-5 PERL-Influenced Operators in Oracle SQL Regular Expressions
Operator Syntax | Description | Examples |
---|---|---|
|
Matches a digit character. Equivalent to POSIX expression |
The expression |
|
Matches a nondigit character. Equivalent to POSIX expression |
The expression |
|
Matches a word character (that is, an alphanumeric or underscore ( Equivalent to POSIX expression |
The expression |
|
Matches a nonword character. Equivalent to POSIX expression |
The expression |
|
Matches a whitespace character. Equivalent to POSIX expression |
The expression |
|
Matches a nonwhitespace character. Equivalent to POSIX expression |
The expression |
|
Matches the beginning of a string, in either single-line or multiline mode. Not equivalent to POSIX operator |
The expression |
|
Matches the end of a string, in either single-line or multiline mode. Not equivalent to POSIX operator |
The expression |
|
Matches the end of a string, in either single-line or multiline mode. Not equivalent to POSIX operator |
The expression |
|
Matches one or more occurrences of the preceding subexpression (nongreedyFoot 1 ). |
The expression |
|
Matches zero or more occurrences of the preceding subexpression (nongreedyFootref 1). Matches the empty string whenever possible. |
The expression |
|
Matches zero or one occurrences of the preceding subexpression (nongreedyFootref 1). Matches the empty string whenever possible. |
The expression |
|
Matches exactly |
The expression Both the expression |
|
Matches at least |
The expression |
|
Matches at least |
The expression |
Footnote 1 A nongreedy operator matches as few occurrences as possible while allowing the rest of the match to succeed. To make the operator greedy, omit the nongreedy modifier (?
).
Regular expressions are useful for enforcing constraints—for example, to ensure that phone numbers are entered into the database in a standard format. Example 3-1 creates a contacts
table and adds a CHECK
constraint to the p_number
column to enforce this format model:
(XXX) XXX-XXXX
Example 3-1 Enforcing a Phone Number Format with Regular Expressions
DROP TABLE contacts; CREATE TABLE contacts ( l_name VARCHAR2(30), p_number VARCHAR2(30) CONSTRAINT c_contacts_pnf CHECK (REGEXP_LIKE (p_number, '^\(\d{3}\) \d{3}-\d{4}$')) );
Table 3-6 explains the elements of the regular expression.
Table 3-6 Explanation of the Regular Expression Elements in Example 3-1
Regular Expression Element | Matches . . . |
---|---|
|
The beginning of the string. |
|
A left parenthesis. The backslash ( |
|
Exactly three digits. |
|
A right parenthesis. The backslash ( |
space character |
A space character. |
|
Exactly three digits. |
|
A hyphen. |
|
Exactly four digits. |
|
The end of the string. |
Example 3-2 shows some statements that correctly and incorrectly insert phone numbers into the contacts
table.
Example 3-2 Inserting Phone Numbers in Correct and Incorrect Formats
These are correct:
INSERT INTO contacts (p_number) VALUES('(650) 555-0100'); INSERT INTO contacts (p_number) VALUES('(215) 555-0100');
These generate CHECK
constraint errors:
INSERT INTO contacts (p_number) VALUES('650 555-0100'); INSERT INTO contacts (p_number) VALUES('650 555 0100'); INSERT INTO contacts (p_number) VALUES('650-555-0100'); INSERT INTO contacts (p_number) VALUES('(650)555-0100'); INSERT INTO contacts (p_number) VALUES(' (650) 555-0100');
A back reference (described in Table 3-3) stores the referenced subexpression in a temporary buffer. Therefore, you can use back references to reposition characters, as in Example 3-3. For an explanation of the elements of the regular expression in Example 3-3, see Table 3-7.
Example 3-3 Using Back References to Reposition Characters
Create table and populate it with names in different formats:
DROP TABLE famous_people; CREATE TABLE famous_people (names VARCHAR2(20)); INSERT INTO famous_people (names) VALUES ('John Quincy Adams'); INSERT INTO famous_people (names) VALUES ('Harry S. Truman'); INSERT INTO famous_people (names) VALUES ('John Adams'); INSERT INTO famous_people (names) VALUES (' John Quincy Adams'); INSERT INTO famous_people (names) VALUES ('John_Quincy_Adams');
SQL*Plus formatting command:
COLUMN "names after regexp" FORMAT A20
For each name in the table whose format is "first middle last", use back references to reposition characters so that the format becomes "last, first middle":
SELECT names "names", REGEXP_REPLACE(names, '^(\S+)\s(\S+)\s(\S+)$', '\3, \1 \2') AS "names after regexp" FROM famous_people ORDER BY "names";
Result:
names names after regexp -------------------- -------------------- John Quincy Adams John Quincy Adams Harry S. Truman Truman, Harry S. John Adams John Adams John Quincy Adams Adams, John Quincy John_Quincy_Adams John_Quincy_Adams 5 rows selected.
Table 3-7 explains the elements of the regular expression.
Table 3-7 Explanation of the Regular Expression Elements in Example 3-3
Regular Expression Element | Description |
---|---|
|
Matches the beginning of the string. |
|
Matches the end of the string. |
|
Matches one or more nonspace characters. The parentheses are not escaped so they function as a grouping expression. |
|
Matches a whitespace character. |
|
Substitutes the first subexpression, that is, the first group of parentheses in the matching pattern. |
|
Substitutes the second subexpression, that is, the second group of parentheses in the matching pattern. |
|
Substitutes the third subexpression, that is, the third group of parentheses in the matching pattern. |
|
Inserts a comma character. |