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 ]
}
인수
- [ -? ]
지원되는 매개 변수 목록을 반환합니다.
- -sourceserversource_server_name[**\instance_name]
원본 서버의 이름입니다. 기본 SQL Server 인스턴스의 source_server_name을 지정합니다. 명명된 SQL Server 인스턴스의 source_server_name\**instance_name을 지정합니다.
- -sourcedatabasesource_database
원본 데이터베이스의 이름입니다.
- -sourcetablesource_table_name
검사할 원본 테이블의 이름입니다.
- -sourceschemasource_schema_name
원본 테이블의 스키마 소유자입니다. 기본적으로 테이블 소유자를 dbo로 간주합니다.
-sourcepasswordsource_password
SQL Server 인증을 사용하여 원본 서버에 연결하는 데 사용되는 로그인 암호입니다.보안 정보: 가능하면 런타임 동안 보안 자격 증명을 지정합니다. 스크립트 파일에 자격 증명을 저장해야 하는 경우에는 무단으로 액세스하지 못하도록 파일에 보안을 설정해야 합니다.
- -sourceusersource_login
SQL Server 인증을 사용하여 원본 서버에 연결하는 데 사용되는 로그인입니다. source_login을 지정하지 않으면 원본 서버에 연결할 때 Windows 인증이 사용됩니다.
- -sourcelocked
비교를 수행하는 동안 TABLOCK 및 HOLDLOCK 테이블 힌트를 사용하여 원본 테이블이 잠깁니다.
- -destinationserverdestination_server_name[**\instance_name]
대상 서버의 이름입니다. 기본 SQL Server 인스턴스의 destination_server_name을 지정합니다. 명명된 SQL Server 인스턴스의 destination_server_name\**instance_name을 지정합니다.
- -destinationdatabasesubscription_database
대상 데이터베이스의 이름입니다.
- -destinationtabledestination_table
대상 테이블의 이름입니다.
- -destinationschemadestination_schema_name
대상 테이블의 스키마 소유자입니다. 기본적으로 테이블 소유자를 dbo로 간주합니다.
-destinationpassworddestination_password
SQL Server 인증을 사용하여 대상 서버에 연결하는 데 사용되는 로그인 암호입니다.보안 정보: 가능하면 런타임 동안 보안 자격 증명을 지정합니다. 스크립트 파일에 자격 증명을 저장해야 하는 경우에는 무단으로 액세스하지 못하도록 파일에 보안을 설정해야 합니다.
- -destinationuserdestination_login
SQL Server 인증을 사용하여 대상 서버에 연결하는 데 사용되는 로그인입니다. destination_login을 지정하지 않으면 대상 서버에 연결할 때 Windows 인증이 사용됩니다.
- -destinationlocked
비교를 수행하는 동안 TABLOCK 및 HOLDLOCK 테이블 힌트를 사용하여 대상 테이블이 잠깁니다.
- -blarge_object_bytes
비교할 큰 개체 데이터 형식 열의 바이트 수입니다. 이 데이터 형식에는 text, ntext, image, varchar(max), nvarchar(max) 및 **varbinary(max)**가 있습니다. large_object_bytes의 기본값은 최대값인 8000바이트입니다. large_object_bytes에 지정한 바이트 수를 초과하는 데이터는 비교되지 않습니다.
- -bfnumber_of_statements
-f 옵션을 사용할 경우 현재 Transact-SQL 스크립트 파일에 쓸 Transact-SQL 문의 수입니다. Transact-SQL 문의 수가 number_of_statements를 초과하면 새 Transact-SQL 스크립트 파일이 생성됩니다.
- -c
열 수준에서 차이점을 비교합니다.
- -dt
table_name에 지정된 결과 테이블이 이미 있는 경우 삭제합니다.
- -ettable_name
만들 결과 테이블의 이름을 지정합니다. 이 테이블이 이미 있을 경우 -DT를 사용해야 합니다. 그렇지 않으면 작업이 실패합니다.
- -f [ file_name ]
대상 서버의 테이블을 원본 서버의 테이블과 일치시키는 Transact-SQL 스크립트를 생성합니다. 생성된 Transact-SQL 스크립트 파일의 이름과 경로를 필요에 따라 지정할 수 있습니다. file_name을 지정하지 않으면 유틸리티가 실행되는 디렉터리에 Transact-SQL 스크립트 파일이 생성됩니다.
- -ooutput_file_name
출력 파일의 전체 이름 및 경로입니다.
- -q
행 개수와 스키마만 비교하여 비교 작업을 빨리 수행합니다.
- -rcnumber_of_retries
유틸리티가 실패한 작업을 다시 시도하는 횟수입니다.
- -riretry_interval
다시 시도 작업 사이의 대기 간격(초)입니다.
- -strict
원본 스키마와 대상 스키마를 엄격하게 비교합니다.
- -tconnection_timeouts
원본 서버 및 대상 서버에 대한 연결 제한 시간(초)을 설정합니다.
반환 값
값 | 설명 |
---|---|
0 |
성공 |
1 |
오류 |
2 |
테이블 차이 |
주의
비-SQL Server(Non-SQL Server) 서버에서는 tablediff 유틸리티를 사용할 수 없습니다.
데이터 형식이 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 옵션을 사용하여 이러한 매핑을 허용하지 않고 유효성 검사를 엄격하게 수행할 수 있습니다.
비교할 원본 테이블에는 하나 이상의 기본 키, ID 또는 ROWGUID 열이 있어야 합니다. -strict 옵션을 사용하는 경우에는 대상 테이블에도 기본 키, ID 또는 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 옵션을 사용하려면 지정된 파일 디렉터리 위치에 대한 쓰기 권한이 있어야 합니다.
참고 항목
관련 자료
How to: Compare Replicated Tables for Differences (Replication Programming)