REPLICATE (Transact-SQL)
Applies to: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス
文字列値を指定した回数だけ繰り返します。
構文
REPLICATE ( string_expression , integer_expression )
引数
string_expression
文字列またはバイナリ データ型の式です。
注意
string_expression の型が binary の場合、REPLICATE では、varchar への暗黙的変換が実行され、そのため、バイナリ入力は保持されません。
注意
string_expression 入力の型が varchar(max) か nvarchar(max) でない場合、REPLICATE では、8,000 バイトで戻り値が切り詰められます。 8,000 バイトの場合より大きい値を返す string_expression 適切な大きな値のデータ型に明示的にキャストする必要があります。
integer_expression
bigint を含む、整数型の式を指定します。 場合 であれば、任意 は負の場合、NULL が返されます。
戻り値の型
同じ型を返します string_expressionです。
例
A. REPLICATE を使用する
次の例では、AdventureWorks2022 データベースの取り扱い品目コードの前に文字 0 を 4 回繰り返します。
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 という文字を 4 回繰り返します。
-- 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)