REPLICATE (Transact-SQL)

[アーティクル]
05/23/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス

文字列値を指定した回数だけ繰り返します。

Transact-SQL 構文表記規則

構文

REPLICATE ( string_expression , integer_expression )

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

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)