tablediff 公用程式用來比較兩份資料表之資料的非聚合狀況,當進行複寫拓撲中之非聚合狀況的疑難排解時,它尤其有用。您可以在命令提示字元之下,或在批次檔中,利用這個公用程式來執行下列工作:
-
在扮演複寫發行者之 Microsoft SQL Server 執行個體的來源資料表,與扮演複製訂閱者的一或多個 SQL Server 執行個體的目的地資料表之間,每個資料列做比較。
-
執行快速比較,只比較資料列計數和結構描述。
-
進行資料行層級的比較。
-
產生 Transact-SQL 指令碼來修正目的地伺服器不一致的情形,以便聚合來源和目的地資料表。
-
將結果記錄在輸出檔中,或記錄在目的地資料庫的資料表中。

語法
tablediff
[ -? ] |
{
-sourceserver source_server_name[\instance_name]
-sourcedatabase source_database
-sourcetable source_table_name
[ -sourceschema source_schema_name ]
[ -sourcepassword source_password ]
[ -sourceuser source_login ]
[ -sourcelocked ]
-destinationserver destination_server_name[\instance_name]
-destinationdatabase subscription_database
-destinationtable destination_table
[ -destinationschema destination_schema_name ]
[ -destinationpassword destination_password ]
[ -destinationuser destination_login ]
[ -destinationlocked ]
[ -b large_object_bytes ]
[ -bf number_of_statements ]
[ -c ]
[ -dt ]
[ -et table_name ]
[ -f [ file_name ] ]
[ -o output_file_name ]
[ -q ]
[ -rc number_of_retries ]
[ -ri retry_interval ]
[ -strict ]
[ -t connection_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
-
設定通往來源伺服器和目的地伺服器之連接的連接逾時期限 (以秒為單位)。

傳回值

備註
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 選項,您必須具有指定檔案目錄位置的寫入權限。

請參閱