SUBSTRING (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库

返回 SQL Server 中的字符、二进制、文本或图像表达式的一部分。

Transact-SQL 语法约定

语法

SUBSTRING ( expression, start, length )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

参数

expression
为 character、binary、text、ntext 或者 image 表达式。

start
指定返回字符的起始位置的整数或 bigint 表达式 。 （编号从 1 开始，意味着表达式中的第一个字符为 1）。 如果 start 小于 1，则返回的表达式的起始位置为表达式中指定的第一个字符 。 在这种情况下，返回的字符数是后两者中的较大值：start + length 之和减去 1，0。 如果 start 大于值表达式中的字符数，将返回一个零长度的表达式 。

length
是正整数或用于指定要返回的 expression 的字符数的 bigint 表达式 。 如果 length 是负数，会生成错误并终止语句 。 如果 start 和 length 的总和大于表达式中的字符数，则会返回从 start 开始的整个值表达式 。

返回类型

如果 expression 是支持的字符数据类型之一，则返回字符数据 。 如果 expression 是 binary 支持的字符数据类型之一，则返回字符数据 。 返回的字符串类型与指定表达式的类型相同（表中显示的除外）。

指定的表达式 返回类型
char/varchar/text varchar
nchar/nvarchar/ntext nvarchar
binary/varbinary/image varbinary

备注

start 和 length 的值对于 ntext、char 或 varchar 数据类型必须以字符数指定，对于 text、image、binary 或 varbinary 数据类型，则以字节数指定 。

start 或 length 包含大于 2147483647 的值时，expression 必须是 varchar(max) 或 varbinary(max) 。

补充字符（代理项对）

在使用增补字符 (SC) 排序规则时，start 和 length 将 expression 中的每个代理项对计为一个字符 。 有关详细信息，请参阅 排序规则和 Unicode 支持。

示例

A. 对字符串使用 SUBSTRING

以下示例说明如何仅返回字符串的一部分。 从 sys.databases 表中，此查询返回第一列中的系统数据库名称、第二列中的数据库的第一个字母和最后一列中的第三和第四个字符。

SELECT name, SUBSTRING(name, 1, 1) AS Initial ,
SUBSTRING(name, 3, 2) AS ThirdAndFourthCharacters
FROM sys.databases  
WHERE database_id < 5;

下面是结果集。

name 初始 ThirdAndFourthCharacters
主 m st
tempdb t mp
模型 m de
msdb m db

以下示例说明如何显示字符串常量 abcdef 中的第二个、第三个和第四个字符。

SELECT x = SUBSTRING('abcdef', 2, 3);

下面是结果集：

x  
----------  
bcd  
 
(1 row(s) affected)

B. 对 text、ntext 和 image 数据使用 SUBSTRING

注意

若要运行以下示例，必须安装 pubs 数据库 。

以下示例说明如何返回 pubs 数据库的 pub_info 表内每个 text 和 image 数据列的前 10 个字符 。 text 数据返回为 varchar，而 image 数据返回为 varbinary 。

USE pubs;  
SELECT pub_id, SUBSTRING(logo, 1, 10) AS logo,   
   SUBSTRING(pr_info, 1, 10) AS pr_info  
FROM pub_info  
WHERE pub_id = '1756';

下面是结果集。

pub_id logo    pr_info
------ ---------------------- ----------
1756   0x474946383961E3002500 This is sa

(1 row(s) affected)

以下示例说明 SUBSTRING 对 text 和 ntext 数据的影响 。 首先，该示例在 pubs 数据库内创建一个名为 npub_info 的新表。 接着，该示例使用 pr_info 列的前 80 个字符在 npub_info 表中创建 pub_info.pr_info 列，然后将添加 ü 为第一个字符。 最后，INNER JOIN 检索所有出版商标识号以及 text 和 ntext 出版商信息列的SUBSTRING 。

IF EXISTS (SELECT table_name FROM INFORMATION_SCHEMA.TABLES   
      WHERE table_name = 'npub_info')  
   DROP TABLE npub_info;  
GO  
-- Create npub_info table in pubs database. Borrowed from instpubs.sql.  
USE pubs;  
GO  
CREATE TABLE npub_info  
(  
 pub_id CHAR(4) NOT NULL  
    REFERENCES publishers(pub_id)  
    CONSTRAINT UPKCL_npubinfo PRIMARY KEY CLUSTERED,  
pr_info ntext NULL  
);  
  
GO  
  
-- Fill the pr_info column in npub_info with international data.  
RAISERROR('Now at the inserts to pub_info...',0,1);  
  
GO  
  
INSERT npub_info VALUES('0736', N'üThis is sample text data for New Moon Books, publisher 0736 in the pubs database')  
,('0877', N'üThis is sample text data for Binnet & Hardley, publisher 0877 in the pubs databa')  
,('1389', N'üThis is sample text data for Algodata Infosystems, publisher 1389 in the pubs da')  
,('9952', N'üThis is sample text data for Scootney Books, publisher 9952 in the pubs database')  
,('1622', N'üThis is sample text data for Five Lakes Publishing, publisher 1622 in the pubs d')  
,('1756', N'üThis is sample text data for Ramona Publishers, publisher 1756 in the pubs datab')  
,('9901', N'üThis is sample text data for GGG&G, publisher 9901 in the pubs database. GGG&G i')  
,('9999', N'üThis is sample text data for Lucerne Publishing, publisher 9999 in the pubs data');  
GO  
-- Join between npub_info and pub_info on pub_id.  
SELECT pr.pub_id, SUBSTRING(pr.pr_info, 1, 35) AS pr_info,  
   SUBSTRING(npr.pr_info, 1, 35) AS npr_info  
FROM pub_info pr INNER JOIN npub_info npr  
   ON pr.pub_id = npr.pub_id  
ORDER BY pr.pub_id ASC;

示例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

C. 对字符串使用 SUBSTRING

以下示例说明如何仅返回字符串的一部分。 该查询在一列中返回 dbo.DimEmployee 表中的姓氏，在另一列中只返回名字首字母。

-- Uses AdventureWorks  
  
SELECT LastName, SUBSTRING(FirstName, 1, 1) AS Initial  
FROM dbo.DimEmployee  
WHERE LastName LIKE 'Bar%'  
ORDER BY LastName;

下面是结果集。

LastName             Initial
-------------------- -------
Barbariol            A
Barber               D
Barreto de Mattos    P

以下示例显示如何返回字符串常量 abcdef 的第二个、第三个和第四个字符。

USE ssawPDW;  
  
SELECT TOP 1 SUBSTRING('abcdef', 2, 3) AS x FROM dbo.DimCustomer;

下面是结果集。

x
-----
bcd

另请参阅

LEFT (Transact-SQL)
LTRIM (Transact-SQL)
RIGHT (Transact-SQL)
RTRIM (Transact-SQL)
STRING_SPLIT (Transact-SQL)
TRIM (Transact-SQL)
字符串函数 (Transact-SQL)