適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)
此文章說明格式檔案在大量匯入作業中的用法。 格式檔案會將資料檔案的欄位對應到資料表的資料行。 如需其他資訊，請參閱使用 bcp 建立格式檔案。
先決條件
若要在 SQL Server 實例上執行 T-SQL 命令，請使用 SQL Server Management Studio （SSMS）、Visual Studio Code、sqlcmd 或您最愛的 T-SQL 查詢工具的 MSSQL 擴充功能。
如果格式檔案要與 Unicode 字元資料檔案搭配使用，則所有的輸入欄位都必須是 Unicode 文字字串 (也就是固定大小或以字元結束的 Unicode 字串)。
若要大容量匯出或匯入 XML 檔案 （SQL Server） 資料的大容量導入和匯出範例 ，請在格式檔案中使用下列其中一種數據類型：
- SQLCHAR 或 SQLVARCHAR (資料是使用用戶端字碼頁或定序所隱含的字碼頁所傳送)
- SQLNCHAR 或 SQLNVARCHAR (資料會以 Unicode 傳送)
- SQLBINARY 或 SQLVARBIN (未經任何轉換即傳送這份資料)。
Azure SQL Database 和 Azure Synapse Analytics 只支援 bcp。 如需相關資訊，請參閱：
Azure Synapse Analytics 不支援包括大量插入在內的此語法。 在 Azure Synapse Analytics 和其他雲端資料庫平台整合中，透過 Azure Data Factory 中的 COPY 陳述式，或使用 COPY INTO 和 PolyBase 等 T-SQL 陳述式來完成資料移動。
範例測試條件
本主題中的格式檔案範例是以下面定義的資料表和資料檔案為基礎。
範例資料表
下列指令碼會建立測試資料庫和名為 myFirstImport的資料表。 在 Microsoft SQL Server Management Studio (SSMS) 中執行下列 Transact-SQL：
CREATE DATABASE TestDatabase;
GO
USE TestDatabase;
CREATE TABLE dbo.MyFirstImport (
PersonID smallint,
FirstName varchar(25),
LastName varchar(30),
BirthDate Date
);
範例資料檔案
使用 [記事本] 建立空白檔案 D:\BCP\myFirstImport.bcp ，並插入下列資料：
1,Anthony,Grosse,1980-02-23
2,Alica,Fatnowna,1963-11-14
3,Stella,Rosenhain,1992-03-02
您也可以執行下列 PowerShell 指令碼以建立並填入資料檔案：
Clear-Host
# revise directory as desired
$dir = 'D:\BCP\';
$bcpFile = Join-Path -Path $dir -ChildPath 'MyFirstImport.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 '1,Anthony,Grosse,1980-02-23';
Add-Content -Path $bcpFile -Value '2,Alica,Fatnowna,1963-11-14';
Add-Content -Path $bcpFile -Value '3,Stella,Rosenhain,1992-03-02';
# Review content
Get-Content -Path $bcpFile;
Notepad.exe $bcpfile;
建立格式檔案
SQL Server 支援兩種類型的格式檔案：非 XML 格式和 XML 格式。 非 XML 格式是舊版 SQL Server 所支援的原始格式。
將程式代碼範例的本機檔案位置變更為計算機上的檔案位置。
建立非 XML 格式檔案
如需詳細資訊，請參閱使用非 XML 格式檔案 （SQL Server）。 下列命令將使用 bcp 公用程式 ，根據 myFirstImport.fmt的結構描述產生非 XML 格式檔案 myFirstImport。
- 若要使用 bcp 命令來建立格式檔案，請指定
format自變數並使用，nul而不是資料文件路徑。 - 格式選項也需要
-f選項。 -
c用來指定字元數據 -
t,用來將逗號指定為 欄位終止符 -
T是用來使用整合式安全性來指定受信任的連線。
請在命令提示字元之下，輸入下列命令：
bcp TestDatabase.dbo.myFirstImport format nul -c -f D:\BCP\myFirstImport.fmt -t, -T
REM Review file
Notepad D:\BCP\myFirstImport.fmt
您的非 XML 格式檔案 D:\BCP\myFirstImport.fmt 應該看起來像這樣︰
13.0
4
1 SQLCHAR 0 7 "," 1 PersonID ""
2 SQLCHAR 0 25 "," 2 FirstName SQL_Latin1_General_CP1_CI_AS
3 SQLCHAR 0 30 "," 3 LastName SQL_Latin1_General_CP1_CI_AS
4 SQLCHAR 0 11 "\r\n" 4 BirthDate ""
重要
請確保您的非 XML 格式檔案以回車符號\換行符號結尾。 否則您可能會收到下列錯誤訊息︰
SQLState = S1000, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]I/O error while reading BCP format file
建立 XML 格式檔案
如需詳細資訊，請檢閱 XML 格式檔案 （SQL Server ）。 下列命令將使用 bcp 公用程式 ，根據 myFirstImport.xml的結構描述建立 XML 格式檔案 myFirstImport。
- 若要使用 bcp 命令來建立格式檔案，請指定
format自變數並使用，nul而不是資料文件路徑。 - 格式選項一律需要
-f選項。 - 若要建立 XML 格式檔案，您也必須指定
-x選項。 -
c用來指定字元數據 -
t,用來將逗號指定為 欄位終止符 -
T是用來使用整合式安全性來指定受信任的連線。
請在命令提示字元之下，輸入下列命令：
bcp TestDatabase.dbo.myFirstImport format nul -c -x -f D:\BCP\myFirstImport.xml -t, -T
REM Review file
Notepad D:\BCP\myFirstImport.xml
您的 XML 格式檔案 D:\BCP\myFirstImport.xml 應該看起來像這樣︰
<?xml version="1.0"?>
<BCPFORMAT xmlns="http://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<RECORD>
<FIELD ID="1" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="7"/>
<FIELD ID="2" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="25" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
<FIELD ID="3" xsi:type="CharTerm" TERMINATOR="," MAX_LENGTH="30" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
<FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n" MAX_LENGTH="11"/>
</RECORD>
<ROW>
<COLUMN SOURCE="1" NAME="PersonID" xsi:type="SQLSMALLINT"/>
<COLUMN SOURCE="2" NAME="FirstName" xsi:type="SQLVARCHAR"/>
<COLUMN SOURCE="3" NAME="LastName" xsi:type="SQLVARCHAR"/>
<COLUMN SOURCE="4" NAME="BirthDate" xsi:type="SQLDATE"/>
</ROW>
</BCPFORMAT>
使用格式檔案大量匯入資料
下列範例會使用上面建立的資料庫、資料檔案和格式檔案。
使用 bcp 和使用 非 XML 格式檔案 （SQL Server）
請在命令提示字元之下，輸入下列命令：
REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.MyFirstImport;"
REM Import data
bcp TestDatabase.dbo.myFirstImport IN D:\BCP\myFirstImport.bcp -f D:\BCP\myFirstImport.fmt -T
REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.MyFirstImport"
使用 bcp 和 XML 格式檔案 （SQL Server）
請在命令提示字元之下，輸入下列命令：
REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.MyFirstImport;"
REM Import data
bcp TestDatabase.dbo.myFirstImport IN D:\BCP\myFirstImport.bcp -f D:\BCP\myFirstImport.xml -T
REM Review results
SQLCMD -Q "SELECT * FROM TestDatabase.dbo.MyFirstImport;"
使用 BULK INSERT （Transact-SQL） 和使用 非 XML 格式檔案 （SQL Server）
在 Microsoft SQL Server Management Studio (SSMS) 中執行下列 Transact-SQL：
USE TestDatabase;
GO
TRUNCATE TABLE myFirstImport; -- (for testing)
BULK INSERT dbo.myFirstImport
FROM 'D:\BCP\myFirstImport.bcp'
WITH (FORMATFILE = 'D:\BCP\myFirstImport.fmt');
GO
-- review results
SELECT * FROM TestDatabase.dbo.myFirstImport;
使用 BULK INSERT （Transact-SQL） 和 XML 格式檔案 （SQL Server）
在 Microsoft SQL Server Management Studio (SSMS) 中執行下列 Transact-SQL：
USE TestDatabase;
GO
TRUNCATE TABLE myFirstImport; -- (for testing)
BULK INSERT dbo.myFirstImport
FROM 'D:\BCP\myFirstImport.bcp'
WITH (FORMATFILE = 'D:\BCP\myFirstImport.xml');
GO
-- review results
SELECT * FROM TestDatabase.dbo.myFirstImport;
使用 OPENROWSET BULK （Transact-SQL） 和使用 非 XML 格式檔案 （SQL Server）
在 Microsoft SQL Server Management Studio (SSMS) 中執行下列 Transact-SQL：
USE TestDatabase;
GO
TRUNCATE TABLE myFirstImport; -- (for testing)
INSERT INTO dbo.myFirstImport
SELECT *
FROM OPENROWSET (
BULK 'D:\BCP\myFirstImport.bcp',
FORMATFILE = 'D:\BCP\myFirstImport.fmt'
) AS t1;
GO
-- review results
SELECT * FROM TestDatabase.dbo.myFirstImport;
使用 OPENROWSET BULK（Transact-SQL） 和 XML 格式檔案（SQL Server）
在 Microsoft SQL Server Management Studio (SSMS) 中執行下列 Transact-SQL：
USE TestDatabase;
GO
TRUNCATE TABLE myFirstImport; -- (for testing)
INSERT INTO dbo.myFirstImport
SELECT *
FROM OPENROWSET (
BULK 'D:\BCP\myFirstImport.bcp',
FORMATFILE = 'D:\BCP\myFirstImport.xml'
) AS t1;
GO
-- review results
SELECT * FROM TestDatabase.dbo.myFirstImport;
更多範例
- 使用 bcp 建立格式檔案 (SQL Server)
- 使用格式檔案以略過資料表資料行 (SQL Server)
- 使用格式檔案略過資料欄位 (SQL Server)
- 使用格式檔案將資料表資料行對應至資料檔案欄位 (SQL Server)