tablediff 公用程式

tablediff 公用程式

全部折疊

語言篩選

SQL Server 2005 線上叢書 (2007 年 9 月)

tablediff 公用程式

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 驗證。

-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 驗證。

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

-b large_object_bytes: 這是用來進行下列大型物件資料類型之資料行比較的位元組數目，其中包括：text、ntext、image、varchar(max)、nvarchar(max) 和 varbinary(max)。large_object_bytes 預設為最多 8000 個位元組。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	成功
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)