データの一括インポート時の ID 値の保持 (SQL Server)

2025-06-21

適用対象:SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

ID 値を含んでいるデータファイルを Microsoft SQL Server のインスタンスに一括インポートできます。

既定では、インポートされたデータファイルの ID 列の値は無視され、SQL Server によって固有の値が自動的に割り当てられます。固有の値は、テーブル作成時に指定されたシード値と増分値に基づいています。

データファイルにテーブルの ID 列の値が含まれていない場合は、フォーマットファイルを使用してデータをインポートするときにテーブルの ID 列をスキップするように指定します。詳細については、「フォーマットファイルを使用したテーブル列のスキップ (SQL Server) 」を参照してください。

ID 値を保持する

テーブルにデータ行を一括インポートするときに SQL Server が ID 値を割り当てないようにするには、適切な keep-identity コマンド修飾子を使用します。 keep-identity 修飾子を指定すると、SQL Server ではデータファイルの ID 値を使用します。

このような修飾子は次のとおりです。

command	Keep-identity 修飾子	修飾子の種類
`bcp`	`-E`	スイッチ
`BULK INSERT`	`KEEPIDENTITY`	引数
`INSERT ... SELECT * FROM OPENROWSET(BULK...)`	アイデンティティを維持	テーブルヒント

詳細については、「 bcp ユーティリティ、 BULK INSERT (Transact-SQL)、 OPENROWSET BULK (Transact-SQL)、 INSERT (Transact-SQL)、 SELECT (Transact-SQL)、およびテーブルヒント (Transact-SQL)」を参照してください。

注

複数のテーブルで使用できる自動的に増分する番号、またはテーブルを参照せずにアプリケーションから呼び出すことができる自動的に増分する番号を作成するには、「シーケンス番号」を参照してください。

テスト条件の例

このトピックの例は、以下に定義されたテーブル、データファイル、およびフォーマットファイルに基づいています。

サンプルテーブル

以下のスクリプトでは、テストデータベースと myIdentityという名前のテーブルが作成されます。 Microsoft SQL Server Management Studio (SSMS) で、次の Transact SQL を実行します。

CREATE DATABASE TestDatabase;
GO

USE TestDatabase;
CREATE TABLE dbo.myIdentity ( 
   PersonID smallint IDENTITY(1,1) NOT NULL,
   FirstName varchar(25) NOT NULL,
   LastName varchar(30) NOT NULL,
   BirthDate date
   );

サンプルデータファイル

メモ帳を使用して、空のファイル D:\BCP\myIdentity.bcp を作成し、次のデータを挿入します。

3,Anthony,Grosse,1980-02-23
2,Alica,Fatnowna,1963-11-14
1,Stella,Rosenhain,1992-03-02
4,Miller,Dylan,1954-01-05

また、次の PowerShell スクリプトを実行して、データファイルを作成および設定することもできます。

cls
# revise directory as desired
$dir = 'D:\BCP\';

$bcpFile = $dir + 'myIdentity.bcp';

# Confirm directory exists
IF ((Test-Path -Path $dir) -eq 0)
{
    Write-Host "The path $dir does not exist; please create or modify the directory.";
    RETURN;
};

# clear content, will error if file does not exist, can be ignored
Clear-Content -Path $bcpFile -ErrorAction SilentlyContinue;

# Add data
Add-Content -Path $bcpFile -Value '3,Anthony,Grosse,1980-02-23';
Add-Content -Path $bcpFile -Value '2,Alica,Fatnowna,1963-11-14';
Add-Content -Path $bcpFile -Value '1,Stella,Rosenhain,1992-03-02';
Add-Content -Path $bcpFile -Value '4,Miller,Dylan,1954-01-05';

#Review content
Get-Content -Path $bcpFile;
Invoke-Item $bcpFile;

XML 以外のフォーマットファイルのサンプル

SQL Server は、非 XML 形式と XML 形式の 2 種類のフォーマットファイルをサポートしています。 XML 以外のフォーマットとは、以前のバージョンの SQL Server でサポートされる従来のフォーマットです。詳細については、「 XML 以外のフォーマットファイルの使用 (SQL Server)」を参照してください。

次のコマンドでは、 bcp ユーティリティを使用し、 myIdentity.fmtのスキーマに基づいて XML 以外のフォーマットファイル myIdentityを生成します。

bcp コマンドを使用してフォーマットファイルを作成するには、format引数を指定し、データファイルパスの代わりにnulを使用します。
書式オプションには、 -f オプションも必要です。
c は文字データを指定するために使用されます
t,は、フィールドターミネータとしてコンマを指定するために使用されます
T は、統合セキュリティを使用して信頼できる接続を指定するために使用されます。

コマンドプロンプトで、次のコマンドを入力します。

bcp TestDatabase.dbo.myIdentity format nul -c -f D:\BCP\myIdentity.fmt -t, -T

REM Review file
Notepad D:\BCP\myIdentity.fmt

重要

XML 以外のフォーマットファイルは、キャリッジリターン\ラインフィードで終わるようにします。そうしないと、次のエラーメッセージが発生する可能性があります。

SQLState = S1000, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]I/O error while reading BCP format file

例示

この例では、この記事で作成したデータベース、データファイル、およびフォーマットファイルを使用します。

フォーマットファイルなしで bcp を使用し、ID 値を保持する

-Eスイッチ。

コマンドプロンプトで、次のコマンドを入力します。

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myIdentity;"

REM Import data
bcp TestDatabase.dbo.myIdentity IN D:\BCP\myIdentity.bcp -T -c -t, -E

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myIdentity;"

BCP を使用し、XML 以外のフォーマットファイルで ID 値を保持する

-Eと-fスイッチ。

コマンドプロンプトで、次のコマンドを入力します。

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myIdentity;"

REM Import data
bcp TestDatabase.dbo.myIdentity IN D:\BCP\myIdentity.bcp -f D:\BCP\myIdentity.fmt -T -E

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myIdentity;"

フォーマットファイルなしで bcp と生成された ID 値を使用する

既定値を使用します。

コマンドプロンプトで、次のコマンドを入力します。

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myIdentity;"

REM Import data
bcp TestDatabase.dbo.myIdentity IN D:\BCP\myIdentity.bcp -T -c -t,

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myIdentity;"

XML 以外のフォーマットファイルで bcp と生成された ID 値を使用する

既定値と -f スイッチを使用します。

コマンドプロンプトで、次のコマンドを入力します。

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myIdentity;"

REM Import data
bcp TestDatabase.dbo.myIdentity IN D:\BCP\myIdentity.bcp -f D:\BCP\myIdentity.fmt -T

REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.myIdentity;"