BULK INSERT以用戶指定的格式復(fù)制一個(gè)數(shù)據(jù)文件至數(shù)據(jù)庫表或視圖中。
語法:
BULK INSERT [ [ 'database_name'.][ 'owner' ].]{ 'table_name' FROM 'data_file' }
WITH (
[ BATCHSIZE [ = batch_size ] ],
[ CHECK_CONSTRAINTS ],
[ CODEPAGE [ = 'ACP' | 'OEM' | 'RAW' | 'code_page' ] ],
[ DATAFILETYPE [ = 'char' | 'native'| 'widechar' | 'widenative' ] ],
[ FIELDTERMINATOR [ = 'field_terminator' ] ],
[ FIRSTROW [ = first_row ] ],
[ FIRE_TRIGGERS ],
[ FORMATFILE = 'format_file_path' ],
[ KEEPIDENTITY ],
[ KEEPNULLS ],
[ KILOBYTES_PER_BATCH [ = kilobytes_per_batch ] ],
[ LASTROW [ = last_row ] ],
[ MAXERRORS [ = max_errors ] ],
[ ORDER ( { column [ ASC | DESC ] } [ ,...n ] ) ],
[ ROWS_PER_BATCH [ = rows_per_batch ] ],
[ ROWTERMINATOR [ = 'row_terminator' ] ],
[ TABLOCK ],
)
參數(shù):
'database_name'
是包含指定表或視圖的數(shù)據(jù)庫的名稱。如果未指定,則系統(tǒng)默認(rèn)為當(dāng)前數(shù)據(jù)庫。
'owner'
是表或視圖所有者的名稱。當(dāng)執(zhí)行大容量復(fù)制操作的用戶擁有指定的表或視圖時(shí),owner 是可選項(xiàng)。如果沒有指定 owner 并且執(zhí)行大容量復(fù)制操作的用戶不擁有指定的表或視圖,則 Microsoft® SQL Server? 將返回錯(cuò)誤信息并取消大容量復(fù)制操作。
'table_name'
是大容量復(fù)制數(shù)據(jù)于其中的表或視圖的名稱。只能使用那些所有的列引用相同基表所在的視圖。有關(guān)向視圖中復(fù)制數(shù)據(jù)的限制的更多信息,請(qǐng)參見 INSERT。
'data_file'
是數(shù)據(jù)文件的完整路徑,該數(shù)據(jù)文件包含要復(fù)制到指定表或視圖的數(shù)據(jù)。BULK INSERT 從磁盤復(fù)制數(shù)據(jù)(包括網(wǎng)絡(luò)、軟盤、硬盤等)。 data_file 必須從運(yùn)行 SQL Server 的服務(wù)器指定有效路徑。如果 data_file 是遠(yuǎn)程文件,則請(qǐng)指定通用命名規(guī)則 (UNC) 名稱。
BATCHSIZE [ = batch_size ]
指定批處理中的行數(shù)。每個(gè)批處理作為一個(gè)事務(wù)復(fù)制至服務(wù)器。SQL Server提交或回滾(在失敗時(shí))每個(gè)批處理的事務(wù)。默認(rèn)情況下,指定數(shù)據(jù)文件中的所有數(shù)據(jù)是一個(gè)批處理。
CHECK_CONSTRAINTS
指定在大容量復(fù)制操作中檢查 table_name 的任何約束。默認(rèn)情況下,將會(huì)忽略約束。
CODEPAGE [ = 'ACP' | 'OEM' | 'RAW' | 'code_page' ]
指定該數(shù)據(jù)文件中數(shù)據(jù)的代碼頁。僅當(dāng)數(shù)據(jù)含有字符值大于 127 或小于 32 的 char、varchar 或 text 列時(shí),CODEPAGE 才是適用的。CODEPAGE 值 描述 ACP char、varchar 或 text 數(shù)據(jù)類型的列從 ANSI/Microsoft Windows® 代碼頁 ISO 1252 轉(zhuǎn)換為 SQL Server 代碼頁。 OEM(默認(rèn)值) char、varchar 或 text 數(shù)據(jù)類型的列被從系統(tǒng) OEM 代碼頁轉(zhuǎn)換為 SQL Server 代碼頁。 RAW 并不進(jìn)行從一個(gè)代碼頁到另一個(gè)代碼頁的轉(zhuǎn)換;這是最快的選項(xiàng)。 code_page 特定的代碼頁號(hào)碼,例如 850。
DATAFILETYPE [ = {'char' | 'native' | 'widechar' | 'widenative' } ]
指定 BULK INSERT 使用指定的默認(rèn)值執(zhí)行復(fù)制操作。DATAFILETYPE 值 描述 char(默認(rèn)值) 從含有字符數(shù)據(jù)的數(shù)據(jù)文件執(zhí)行大容量復(fù)制操作。 native 使用 native(數(shù)據(jù)庫)數(shù)據(jù)類型執(zhí)行大容量復(fù)制操作。要裝載的數(shù)據(jù)文件由大容量復(fù)制數(shù)據(jù)創(chuàng)建,該復(fù)制是用 bcp 實(shí)用工具從 SQL Server 進(jìn)行的。 widechar 從含有 Unicode 字符的數(shù)據(jù)文件中執(zhí)行大容量復(fù)制操作。 widenative 執(zhí)行與 native 相同的大容量復(fù)制操作,不同之處是 char、varchar 和 text 列在數(shù)據(jù)文件中存儲(chǔ)為 Unicode。要裝載的數(shù)據(jù)文件由大容量復(fù)制數(shù)據(jù)創(chuàng)建,該復(fù)制是用 bcp 實(shí)用工具從 SQL Server 進(jìn)行的。該選項(xiàng)是對(duì) widechar 選項(xiàng)的一個(gè)更高性能的替代,并且它用于使用數(shù)據(jù)文件從一個(gè)運(yùn)行 SQL Server 的計(jì)算機(jī)向另一個(gè)計(jì)算機(jī)傳送數(shù)據(jù)。當(dāng)傳送含有 ANSI 擴(kuò)展字符的數(shù)據(jù)時(shí),使用該選項(xiàng)以便利用 native 模式的性能。
FIELDTERMINATOR [ = 'field_terminator' ]
指定用于 char 和 widechar 數(shù)據(jù)文件的字段終止符。默認(rèn)的字段終止符是 /t(制表符)。
FIRSTROW [ = first_row ]
指定要復(fù)制的第一行的行號(hào)。默認(rèn)值是 1,表示在指定數(shù)據(jù)文件的第一行。
FIRE_TRIGGERS
指定目的表中定義的任何插入觸發(fā)器將在大容量復(fù)制操作過程中執(zhí)行。如果沒有指定 FIRE_TRIGGERS,將不執(zhí)行任何插入觸發(fā)器。
FORMATFILE [ = 'format_file_path' ]
指定一個(gè)格式文件的完整路徑。格式文件描述了含有存儲(chǔ)響應(yīng)的數(shù)據(jù)文件,這些存儲(chǔ)響應(yīng)是使用 bcp 實(shí)用工具在相同的表或視圖中創(chuàng)建的。格式文件應(yīng)該用于以下情況: 數(shù)據(jù)文件含有比表或視圖更多或更少的列。列使用不同的順序。列分割符發(fā)生變化。數(shù)據(jù)格式有其它的改變。通常,格式文件通過 bcp 實(shí)用工具創(chuàng)建并且根據(jù)需要用文本編輯器修改。有關(guān)更多信息,請(qǐng)參見 bcp 實(shí)用工具。
KEEPIDENTITY
指定標(biāo)識(shí)列的值存在于導(dǎo)入文件中。如果沒有指定 KEEPIDENTITY,在導(dǎo)入的數(shù)據(jù)文件中此列的標(biāo)識(shí)值將被忽略,并且 SQL Server 將根據(jù)表創(chuàng)建時(shí)指定的種子值和增量值自動(dòng)賦給一個(gè)唯一的值。假如數(shù)據(jù)文件不含該表或視圖中的標(biāo)識(shí)列,使用一個(gè)格式文件來指定在導(dǎo)入數(shù)據(jù)時(shí),表或視圖中的標(biāo)識(shí)列應(yīng)被忽略;SQL Server 自動(dòng)為此列賦予唯一的值。有關(guān)詳細(xì)信息,請(qǐng)參見 DBCC CHECKIDENT。
KEEPNULLS
指定在大容量復(fù)制操作中空列應(yīng)保留一個(gè)空值,而不是對(duì)插入的列賦予默認(rèn)值。
KILOBYTES_PER_BATCH [ = kilobytes_per_batch ]
指定每個(gè)批處理中數(shù)據(jù)的近似千字節(jié)數(shù)(KB)。默認(rèn)情況下,KILOBYTES_PER_BATCH 未知。
LASTROW [ = last_row ]
指定要復(fù)制的最后一行的行號(hào)。默認(rèn)值是 0,表示指定數(shù)據(jù)文件中的最后一行。
MAXERRORS [ = max_errors ]
指定在大容量復(fù)制操作取消之前可能產(chǎn)生的錯(cuò)誤的最大數(shù)目。不能被大容量復(fù)制操作導(dǎo)入的每一行將被忽略并且被計(jì)為一次錯(cuò)誤。如果沒有指定 max_errors,默認(rèn)值為 0。
ORDER ( { column [ ASC | DESC ] } [ ,...n ] )
指定數(shù)據(jù)文件中的數(shù)據(jù)如何排序。如果裝載的數(shù)據(jù)根據(jù)表中的聚集索引進(jìn)行排序,則可以提高大容量復(fù)制操作的性能。如果數(shù)據(jù)文件基于不同的順序排序,或表中沒有聚集索引,ORDER 子句將被忽略。給出的列名必須是目的表中有效的列。默認(rèn)情況下,大容量插入操作假設(shè)數(shù)據(jù)文件未排序。n是表示可以指定多列的占位符。
ROWS_PER_BATCH [ = rows_per_batch ]
指定每一批處理數(shù)據(jù)的行數(shù)(即 rows_per_bacth)。當(dāng)沒有指定 BATCHSIZE 時(shí)使用,導(dǎo)致整個(gè)數(shù)據(jù)文件作為單個(gè)事務(wù)發(fā)送給服務(wù)器。服務(wù)器根據(jù) rows_per_batch 優(yōu)化大容量裝載。默認(rèn)情況下,ROWS_PER_BATCH 未知。
ROWTERMINATOR [ = 'row_terminator' ]
指定對(duì)于 char 和 widechar 數(shù)據(jù)文件要使用的行終止符。默認(rèn)值是 /n(換行符)。
TABLOCK
指定對(duì)于大容量復(fù)制操作期間獲取一個(gè)表級(jí)鎖。如果表沒有索引并且指定了 TABLOCK,則該表可以同時(shí)由多個(gè)客戶端裝載。默認(rèn)情況下,鎖定行為是由表選項(xiàng) table lock on bulk load 決定的。只在大容量復(fù)制操作期間控制鎖會(huì)減少表上的鎖爭(zhēng)奪,極大地提高性能。注釋BULK INSERT 語句能在用戶定義事務(wù)中執(zhí)行。對(duì)于一個(gè)用 BULK INSERT 語句和 BATCHSIZE 子句將數(shù)據(jù)裝載到使用多個(gè)批處理的表或視圖中的用戶定義事務(wù)來說,回滾它將回滾所有發(fā)送給 SQL Server 的批處理。權(quán)限只有 sysadmin 和 bulkadmin 固定服務(wù)器角色成員才能執(zhí)行 BULK INSERT。
示例本例從指定的數(shù)據(jù)文件中導(dǎo)入訂單詳細(xì)信息,該文件使用豎杠 (|) 字符作為字段終止符,使用 |/n 作為行終止符。
BULK INSERT Northwind.dbo.[Order Details] FROM 'f:/orders/lineitem.tbl'
WITH (
FIELDTERMINATOR = '|',
ROWTERMINATOR = '|/n'
)
本例指定 FIRE_TRIGGERS 參數(shù)。
BULK INSERT Northwind.dbo.[Order Details] FROM 'f:/orders/lineitem.tbl'
WITH (
FIELDTERMINATOR = '|',
ROWTERMINATOR = ':/n',
FIRE_TRIGGERS
)
=============================================================
BULK INSERT
[ database_name . [ schema_name ] . | schema_name . ] [ table_name | view_name ]
FROM 'data_file'
[ WITH
(
[ [ , ] BATCHSIZE = batch_size ] --BATCHSIZE指令來設(shè)置在單個(gè)事務(wù)中可以插入到表中的記錄的數(shù)量
[ [ , ] CHECK_CONSTRAINTS ] --指定在大容量導(dǎo)入操作期間,必須檢查所有對(duì)目標(biāo)表或視圖的約束。若沒有 CHECK_CONSTRAINTS 選項(xiàng),則所有 CHECK 和 FOREIGN KEY 約束都將被忽略,并且在此操作之后表的約束將標(biāo)記為不可信。
[ [ , ] CODEPAGE = { 'ACP' | 'OEM' | 'RAW' | 'code_page' } ] --指定該數(shù)據(jù)文件中數(shù)據(jù)的代碼頁
[ [ , ] DATAFILETYPE =
{ 'char' | 'native'| 'widechar' | 'widenative' } ] --指定 BULK INSERT 使用指定的數(shù)據(jù)文件類型值執(zhí)行導(dǎo)入操作。
[ [ , ] FIELDTERMINATOR = 'field_terminator' ] --標(biāo)識(shí)分隔內(nèi)容的符號(hào)
[ [ , ] FIRSTROW = first_row ] --指定要加載的第一行的行號(hào)。默認(rèn)值是指定數(shù)據(jù)文件中的第一行
[ [ , ] FIRE_TRIGGERS ] --是否啟動(dòng)觸發(fā)器
[ [ , ] FORMATFILE = 'format_file_path' ]
[ [ , ] KEEPIDENTITY ] --指定導(dǎo)入數(shù)據(jù)文件中的標(biāo)識(shí)值用于標(biāo)識(shí)列
[ [ , ] KEEPNULLS ] --指定在大容量導(dǎo)入操作期間空列應(yīng)保留一個(gè)空值,而不插入用于列的任何默認(rèn)值
[ [ , ] KILOBYTES_PER_BATCH = kilobytes_per_batch ]
[ [ , ] LASTROW = last_row ] --指定要加載的最后一行的行號(hào)
[ [ , ] MAXERRORS = max_errors ] --指定允許在數(shù)據(jù)中出現(xiàn)的最多語法錯(cuò)誤數(shù),超過該數(shù)量后將取消大容量導(dǎo)入操作。
[ [ , ] ORDER ( { column [ ASC | DESC ] } [ ,...n ] ) ] --指定數(shù)據(jù)文件中的數(shù)據(jù)如何排序
[ [ , ] ROWS_PER_BATCH = rows_per_batch ]
[ [ , ] ROWTERMINATOR = 'row_terminator' ] --標(biāo)識(shí)分隔行的符號(hào)
[ [ , ] TABLOCK ] --指定為大容量導(dǎo)入操作持續(xù)時(shí)間獲取一個(gè)表級(jí)鎖
[ [ , ] ERRORFILE = 'file_name' ] --指定用于收集格式有誤且不能轉(zhuǎn)換為 OLE DB 行集的行的文件。
)]
下面寫個(gè)個(gè)簡(jiǎn)單的應(yīng)用例子
bulk insert xsxt.dbo.tabletest from 'c:/data.txt'
with(
FIELDTERMINATOR=',',
ROWTERMINATOR='/n'
)
您可能感興趣的文章:- mssql server 存儲(chǔ)過程里,bulk insert table from ''路徑+文件'',路徑固定,文件名不固定的實(shí)現(xiàn)方法
- SQL Server Bulk Insert 只需要部分字段時(shí)的方法
- 使用BULK INSERT大批量導(dǎo)入數(shù)據(jù) SQLSERVER