REPLICATE (Transact-SQL)

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

将一个字符串值重复指定的次数。

Transact-SQL 语法约定

语法

REPLICATE ( string_expression , integer_expression )   

注意

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

参数

string_expression
字符串或二进制数据类型的表达式。

备注

如果 string_expression 的类型为 binary，则 REPLICATE 将执行对 varchar 的隐式转换，因此不会保留二进制输入。

注意

如果 string_expression 输入的类型不为 varchar(max) 或 nvarchar(max)，则 REPLICATE 在 8000 字节处截断返回值。 若要返回大于 8,000 字节的值，则必须将 string_expression 显式转换为适当的大值数据类型。

integer_expression
是任何整数类型的表达式，包括 bigint。 如果 integer_expression 为负，则返回 NULL。

返回类型

返回与 string_expression 相同的类型。

示例

A. 使用 REPLICATE

以下示例在 AdventureWorks2022 数据库中生产行代码的前面将 0 字符复制四次。

SELECT [Name]  
, REPLICATE('0', 4) + [ProductLine] AS 'Line Code'  
FROM [Production].[Product]  
WHERE [ProductLine] = 'T'  
ORDER BY [Name];  
GO  

下面是结果集：

Name                                               Line Code  
-------------------------------------------------- ---------  
HL Touring Frame - Blue, 46                        0000T   
HL Touring Frame - Blue, 50                        0000T   
HL Touring Frame - Blue, 54                        0000T   
HL Touring Frame - Blue, 60                        0000T   
HL Touring Frame - Yellow, 46                      0000T   
HL Touring Frame - Yellow, 50                      0000T  
...  

B. 使用 REPLICATE 和 DATALENGTH

以下示例中，数值从数值数据类型转换为字符型或 Unicode 型时，从左填充数字使达到指定的长度。

IF EXISTS(SELECT name FROM sys.tables  
      WHERE name = 't1')  
   DROP TABLE t1;  
GO  
CREATE TABLE t1   
(  
 c1 varchar(3),  
 c2 char(3)  
);  
GO  
INSERT INTO t1 VALUES ('2', '2'), ('37', '37'),('597', '597');  
GO  
SELECT REPLICATE('0', 3 - DATALENGTH(c1)) + c1 AS 'Varchar Column',  
       REPLICATE('0', 3 - DATALENGTH(c2)) + c2 AS 'Char Column'  
FROM t1;  
GO  

下面是结果集。

  
Varchar Column        Char Column  
--------------------  ------------  
002                   2    
037                   37   
597                   597  
  
(3 row(s) affected)  
  

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

C:使用 REPLICATE

以下示例在 ItemCode 值的前面将 0 字符复制四次。

-- Uses AdventureWorks  
  
SELECT EnglishProductName AS Name,  
   ProductAlternateKey AS ItemCode,  
   REPLICATE('0', 4) + ProductAlternateKey AS FullItemCode  
FROM dbo.DimProduct  
ORDER BY Name;  

结果集中的首行如下。

Name                     ItemCode       FullItemCode
------------------------ -------------- ---------------
Adjustable Race          AR-5381        0000AR-5381
All-Purpose Bike Stand   ST-1401        0000ST-1401
AWC Logo Cap             CA-1098        0000CA-1098
AWC Logo Cap             CA-1098        0000CA-1098
AWC Logo Cap             CA-1098        0000CA-1098
BB Ball Bearing          BE-2349        0000BE-2349

另请参阅

SPACE (Transact-SQL)
数据类型 (Transact-SQL)
字符串函数 (Transact-SQL)