tablediff 公用程式

tablediff 公用程式用來比較兩份資料表之資料的非聚合狀況，當進行複寫拓撲中之非聚合狀況的疑難排解時，它尤其有用。 您可以在命令提示字元之下，或在批次檔中，利用這個公用程式來執行下列工作：

• 在 Microsoft SQL Server 執行個體的來源資料表 (作為複寫發行者) 與一或多個 SQL Server 執行個體的目的地資料表 (作為複寫訂閱者) 之間，逐一進行資料列比較。

• 執行快速比較，只比較資料列計數和結構描述。

• 進行資料行層級的比較。

• 產生 Transact-SQL 指令碼來修正目的地伺服器不一致的情形，以便聚合來源和目的地資料表。

• 將結果記錄在輸出檔中，或記錄在目的地資料庫的資料表中。

語法

  
      tablediff   
[ -? ] |   
{  
        -sourceserversource_server_name[\instance_name]  
        -sourcedatabasesource_database-sourcetablesource_table_name   
    [ -sourceschemasource_schema_name ]  
    [ -sourcepasswordsource_password ]  
    [ -sourceusersource_login ]  
    [ -sourcelocked ]  
        -destinationserverdestination_server_name[\instance_name]  
        -destinationdatabasesubscription_database-destinationtabledestination_table   
    [ -destinationschemadestination_schema_name ]  
    [ -destinationpassworddestination_password ]  
    [ -destinationuserdestination_login ]  
    [ -destinationlocked ]  
    [ -blarge_object_bytes ]   
    [ -bfnumber_of_statements ]   
    [ -c ]   
    [ -dt ]   
    [ -ettable_name ]   
    [ -f [ file_name ] ]   
    [ -ooutput_file_name ]   
    [ -q ]   
    [ -rcnumber_of_retries ]   
    [ -riretry_interval ]   
    [ -strict ]  
    [ -tconnection_timeouts ]   
}  

引數

[ -？ ]
傳回支援的參數清單。

-sourceserver source_server_name[\instance_name]
這是來源伺服器的名稱。 指定 SQL Server 預設執行個體的 source_server_name。 為 SQL Server 的具名執行個體指定 source_server_name\instance_name。

-sourcedatabase source_database
這是來源資料庫的名稱。

-sourcetable source_table_name
這是所檢查的來源資料表的名稱。

-sourceschema source_schema_name
來源資料表的結構描述擁有者。 依預設，資料表擁有者假設為 dbo。

-sourcepassword source_password
這是用來連接使用 SQL Server 驗證之來源伺服器的登入密碼。

重要

可能的話，請在執行階段提供安全性認證。 如果您必須將認證儲存在指令碼檔案中，您應該維護這個檔案的安全性，使他人無法在未獲授權的情況下擅自存取。

-sourceuser source_login
這是用來連接使用 SQL Server 驗證之來源伺服器的登入。 如果未提供 source_login ，在連接到來源伺服器時，會使用 Windows 驗證。 盡可能使用 Windows 驗證。

-sourcelocked
在比較期間，來源資料表以 TABLOCK 和 HOLDLOCK 資料表提示鎖定。

-destinationserver destination_server_name[\instance_name]
這是目的地伺服器的名稱。 指定 SQL Server 預設執行個體的 destination_server_name。 為 SQL Server 的具名執行個體指定 destination_server_name\instance_name。

-destinationdatabase subscription_database
這是目的地資料庫的名稱。

-destinationtable destination_table
這是目的地資料表的名稱。

-destinationschema destination_schema_name
目的地資料表的結構描述擁有者。 依預設，資料表擁有者假設為 dbo。

-destinationpassword destination_password
這是用來連接使用 SQL Server 驗證之目的地伺服器的登入密碼。

重要

可能的話，請在執行階段提供安全性認證。 如果您必須將認證儲存在指令碼檔案中，您應該維護這個檔案的安全性，使他人無法在未獲授權的情況下擅自存取。

-destinationuser destination_login
這是用來連接使用 SQL Server 驗證之目的地伺服器的登入。 如果未提供 destination_login ，在連接到伺服器時，會使用 Windows 驗證。 盡可能使用 Windows 驗證。

-destinationlocked
在比較期間，目的地資料表以 TABLOCK 和 HOLDLOCK 資料表提示鎖定。

-b large_object_bytes
這是要比較大型物件資料類型資料行的位元元組數目，其中包括： text、 ntext、 image、 varchar(max)、 nvarchar(max) 和 varbinary(max)。 large_object_bytes 預設為資料行的大小。 不比較任何超出 large_object_bytes 的資料。

-bf number_of_statements
這是使用 -f 選項時要寫入目前 Transact-SQL 指令碼檔案中的 Transact-SQL 陳述式數目。 當 Transact-SQL 陳述式數目超出 number_of_statements 時，會建立新的 Transact-SQL 指令碼檔案。

-c
比較資料行層級的差異。

-dt
卸除 table_name 指定的結果資料表 (如果該資料表已存在的話)。

-et table_name
指定要建立的結果資料表名稱。 如果這份資料表已經存在，就必須使用 -DT ，否則作業會失敗。

-f [ file_name ]
產生一份 Transact-SQL 指令碼來聚合目的地伺服器的資料表與來源伺服器的資料表。 您可以選擇性地為所產生的 Transact-SQL 指令碼檔案指定名稱和路徑。 如果未指定 file_name，Transact-SQL 指令碼檔案會產生在執行公用程式的目錄中。

-o output_file_name
這是輸出檔的完整名稱和路徑。

-q
執行快速比較，只比較資料列計數和結構描述。

-rc number_of_retries
公用程式重試失敗作業的次數。

-ri retry_interval
兩次重試之間等待的間隔秒數。

-strict
嚴格比較來源和目的地結構描述。

-t connection_timeouts
設定通往來源伺服器和目的地伺服器之連接的連接逾時期限 (以秒為單位)。

傳回值

值	描述
0	Success
1	嚴重錯誤
2	資料表差異

備註

tablediff 公用程式不能與非 SQL Server 伺服器搭配使用。

不支援具有 sql_variant 數據類型數據行的數據表。

根據預設， tablediff 公用程式支援來源和目的地資料行之間的下列資料類型對應。

來源資料類型	目的地資料類型
tinyint	smallint、 int或 bigint
smallint	int 或 bigint
int	bigint
timestamp	varbinary
varchar(max)	text
nvarchar(max)	ntext
varbinary(max)	image
text	varchar(max)
ntext	nvarchar(max)
image	varbinary(max)

使用 -strict 選項可禁止這些對應並執行嚴格驗證。

比較中的來源資料表必須至少包含一個主索引鍵、身分識別或 ROWGUID 資料行。 當您使用 -strict 選項時，目的地資料表也必須有主索引鍵、識別或 ROWGUID 資料行。

為了使目的地資料表達到聚合而產生的 Transact-SQL 指令碼不包括下列資料類型：

• varchar(max)

• nvarchar(max)

• varbinary(max)

• timestamp

• xml

• text

• ntext

• image

權限

若要比較資料表，您必須具有所比較之資料表物件的 SELECT ALL 權限。

若要使用 -et 選項，您必須是 db_owner 固定資料庫角色的成員，或至少具有訂閱資料庫中的 CREATE TABLE 權限，或目的地伺服器之目的地擁有者結構描述的 ALTER 權限。

若要使用 -dt 選項，您必須是 db_owner 固定資料庫角色的成員，或至少具有目的地伺服器之目的地擁有者結構描述的 ALTER 權限。

若要使用 -o 或 -f 選項，您必須具有指定檔案目錄位置的寫入權限。

另請參閱

比較複寫資料表的差異 (複寫程式設計)