유니코드 문자 형식을 사용하여 데이터 가져오기 또는 내보내기(SQL Server)

  • 아티클

적용 대상:SQL ServerAzure SQL 데이터베이스Azure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System(PDW)

확장/DBCS 문자가 포함된 데이터 파일을 사용하여 SQL Server의 여러 인스턴스 간에 데이터를 대량 전송할 때 유니코드 문자 형식을 사용하는 것이 좋습니다. 유니코드 문자 데이터 형식을 사용하면 작업을 수행 중인 클라이언트에서 사용되는 코드 페이지와 다른 코드 페이지를 사용하여 서버에서 데이터를 내보낼 수 있습니다. 이런 경우 유니코드 문자 형식을 사용하면 다음과 같은 이점이 있습니다.

  • 원본 및 대상 데이터가 유니코드 데이터 형식인 경우 유니코드 문자 형식을 사용하면 모든 문자 데이터가 유지됩니다.

  • 원본 및 대상 데이터가 유니코드 데이터 형식이 아닌 경우 유니코드 문자 형식을 사용하면 대상에 표시될 수 없는 원본 데이터의 확장 문자 손실이 최소화됩니다.

항목 내용
유니코드 문자 형식 사용 시 고려 사항
유니코드 문자 형식, bcp 및 서식 파일 사용 시 특별 고려 사항
유니코드 문자 형식의 명령 옵션
예제 테스트 조건
 ● 샘플 테이블
 ● 샘플 비 XML 서식 파일
예제
 ● bcp 및 유니코드 문자 형식을 사용하여 데이터 내보내기
 ● bcp 및 유니코드 문자 형식을 사용하여 서식 파일 없이 데이터 가져오기
 ● bcp 및 유니코드 문자 형식을 사용하여 XML 이외의 서식 파일과 함께 데이터 가져오기
 ● 서식 파일 없이 BULK INSERT 및 유니코드 문자 형식 사용
 ● XML 이외의 서식 파일과 함께 BULK INSERT 및 유니코드 문자 형식 사용하기
 ● XML 이외의 서식 파일과 함께 OPENROWSET 및 유니코드 문자 형식 사용하기
관련 작업

유니코드 문자 형식 사용 시 고려 사항

유니코드 문자 형식을 사용할 때 다음 사항을 고려하세요.

  • 기본적으로 bcp 유틸리티 는 탭 문자로 문자 데이터 필드를 구분하며 줄 바꿈 문자로 레코드를 종료합니다. 다른 종결자를 지정하는 방법에 대한 자세한 내용은 필드 및 행 종결자 지정(SQL Server)을 참조하세요.

  • 유니코드 문자 형식 데이터 파일에 저장된 sql_variant 데이터는 데이터가 char 데이터 대신 nchar로 저장된다는 점을 제외하고 문자 형식 데이터 파일에서 작동하는 방식과 동일한 방식으로 작동합니다. 문자 형식에 대한 자세한 내용은 데이터 정렬 및 유니코드 지원을 참조하세요.

유니코드 문자 형식, bcp 및 서식 파일 사용 시 특별 고려 사항

유니코드 문자 형식 데이터 파일은 유니코드 파일 규칙을 따릅니다. 파일의 처음 2바이트는 0xFFFE 16진수입니다. 이러한 바이트는 BOM(바이트 순서 표시) 역할을 하며 상위 바이트가 파일에 첫 번째 또는 마지막으로 저장되는지 여부를 지정합니다. bcp 유틸리티는 BOM을 잘못 해석하여 가져오기 프로세스의 일부가 실패할 수 있으며 다음과 유사한 오류 메시지가 표시될 수 있습니다.

Starting copy...
SQLState = 22005, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]Invalid character value for cast specification

BOM은 다음 조건에서 잘못 해석될 수 있습니다.

  • bcp 유틸리티가 사용되고 -w 스위치는 유니코드 문자를 나타내는 데 사용됩니다.

  • 서식 파일을 사용하는 경우

  • 데이터 파일의 첫 번째 필드는 문자가 아닌 필드입니다.

특정 상황에서 다음 해결 방법을 사용할 수 있는지 여부를 고려합니다.

유니코드 문자 형식의 명령 옵션

bcp, BULK INSERT 또는 INSERT ... SELECT * FROM OPENROWSET(BULK...)를 사용하여 테이블로 유니코드 문자 형식 데이터를 가져올 수 있습니다. bcp 명령 또는 BULK INSERT 문의 경우 문에서 데이터 형식을 지정할 수 있습니다. INSERT ... SELECT * FROM OPENROWSET(BULK...) 문의 경우 서식 파일에서 데이터 형식을 지정해야 합니다.

유니코드 문자 형식은 다음 명령 옵션에서 지원됩니다.

명령 옵션 설명
bcp -w 유니코드 문자 형식을 사용합니다.
BULK INSERT DATAFILETYPE ='widechar' 데이터를 대량 가져올 때 유니코드 문자 형식을 사용합니다.
OPENROWSET 해당 없음 서식 파일을 사용해야 합니다.

참고 항목

또는 서식 파일에서 필드별로 서식을 지정할 수 있습니다. 자세한 내용은 데이터를 가져오거나 내보내기 위한 서식 파일(SQL Server)을 참조하세요.

예제 테스트 조건

이 주제에 대한 예제는 표와 아래에 정의된 서식 파일을 기반으로 합니다.

샘플 테이블

다음 스크립트에서는 테스트 데이터베이스, myWidechar 테이블을 만들고 테이블을 몇몇 초기 값으로 채웁니다. Microsoft SSMS(SQL Server Management Studio)에서 다음 TRANSACT-SQL을 실행합니다.

CREATE DATABASE TestDatabase;
GO

USE TestDatabase;
CREATE TABLE dbo.myWidechar ( 
	PersonID smallint NOT NULL,
	FirstName nvarchar(25) NOT NULL,
	LastName nvarchar(30) NOT NULL,
	BirthDate date,
	AnnualSalary money
);

-- Populate table
INSERT TestDatabase.dbo.myWidechar
VALUES 
(1, N'ϴAnthony', N'Grosse', '02-23-1980', 65000.00),
(2, N'❤Alica', N'Fatnowna', '11-14-1963', 45000.00),
(3, N'☎Stella', N'Rossenhain', '03-02-1992', 120000.00);

-- Review Data
SELECT * FROM TestDatabase.dbo.myWidechar;

샘플 비 XML 서식 파일

SQL Server 은(는) 두 유형의 서식 파일, 즉 비 XML 서식 파일과 XML 서식 파일을 지원합니다. 비 XML 서식 파일은 이전 버전의 SQL Server에서 원래 지원했던 서식 파일입니다. 자세한 내용은 비 XML 서식 파일(SQL Server)을 검토하세요. 다음 명령에서는 bcp 유틸리티를 사용하여 myWidechar 스키마에 따라 비 xml 서식 파일(myWidechar.fmt)을 생성합니다. bcp 명령을 사용하여 서식 파일을 만들려면 데이터 파일 경로 대신 format 인수를 지정하고 NUL 을 사용합니다. format 옵션을 사용하려면 -f 옵션도 필요합니다. 또한 이 예제에서는 한정자 c를 사용하여 문자 데이터를 지정하며 T는 통합 보안을 사용하여 신뢰할 수 있는 연결을 지정하는 데 사용됩니다. 명령 프롬프트에서 다음 명령을 입력합니다.

bcp TestDatabase.dbo.myWidechar format nul -f D:\BCP\myWidechar.fmt -T -w

REM Review file
Notepad D:\BCP\myWidechar.fmt

Important

비 XML 서식 파일이 캐리지 리턴\줄 바꿈로 끝나는지 확인합니다. 그러지 않으면 다음과 같은 오류 메시지가 표시될 수 있습니다.

SQLState = S1000, NativeError = 0
Error = [Microsoft][ODBC Driver 13 for SQL Server]I/O error while reading BCP format file

예

다음 예제에서는 위에서 만든 데이터베이스와 서식 파일을 사용합니다.

bcp 및 유니코드 문자 형식을 사용하여 데이터 내보내기

-w 스위치 및 OUT 명령. 참고: 이 예제에서 만든 데이터 파일은 모든 후속 예제에서 사용됩니다. 명령 프롬프트에서 다음 명령을 입력합니다.

bcp TestDatabase.dbo.myWidechar OUT D:\BCP\myWidechar.bcp -T -w

REM Review results
NOTEPAD D:\BCP\myWidechar.bcp

bcp 및 유니코드 문자 형식을 사용하여 서식 파일 없이 데이터 가져오기

-w 스위치 및 IN 명령. 명령 프롬프트에서 다음 명령을 입력합니다.

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myWidechar;"

REM Import data
bcp TestDatabase.dbo.myWidechar IN D:\BCP\myWidechar.bcp -T -w

REM Review results is SSMS

bcp 및 유니코드 문자 형식을 사용하여 비 XML 서식 파일과 함께 데이터 가져오기

-w 및 -f 스위치와 IN 명령. 이 예제에는 bcp, 형식 파일, 유니코드 문자 및 데이터 파일의 첫 번째 데이터 필드가 문자가 아니므로 해결 방법을 사용해야 합니다. 위의 유니코드 문자 형식, bcp 및 서식 파일 사용 시 특별 고려 사항. 추가 레코드를 "더미" 레코드로 추가하여 데이터 파일 myWidechar.bcp를 변경한 다음, -F 2 스위치를 사용하여 이 레코드를 건너뜁니다.

명령 프롬프트에서 다음 명령을 입력하고 수정 단계를 수행합니다.

REM Truncate table (for testing)
SQLCMD -Q "TRUNCATE TABLE TestDatabase.dbo.myWidechar;"

REM Open data file
Notepad D:\BCP\myWidechar.bcp
REM Copy first record and then paste as new first record.  This additional record is the "dummy" record.
REM Close file.

REM Import data instructing bcp to skip dummy record with the -F 2 switch.
bcp TestDatabase.dbo.myWidechar IN D:\BCP\myWidechar.bcp -f D:\BCP\myWidechar.fmt -T -F 2

REM Review results is SSMS

REM Return data file to original state for usage in other examples
bcp TestDatabase.dbo.myWidechar OUT D:\BCP\myWidechar.bcp -T -w

서식 파일 없이 BULK INSERT 및 유니코드 문자 형식 사용

DATAFILETYPE 인수. Microsoft SSMS(SQL Server Management Studio)에서 다음 TRANSACT-SQL을 실행합니다.

TRUNCATE TABLE TestDatabase.dbo.myWidechar; -- for testing
BULK INSERT TestDatabase.dbo.myWidechar
	FROM 'D:\BCP\myWidechar.bcp'
	WITH (
		DATAFILETYPE = 'widechar'
		);

-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;

비 XML 서식 파일과 함께 BULK INSERT 및 유니코드 문자 형식 사용

FORMATFILE 인수. Microsoft SSMS(SQL Server Management Studio)에서 다음 TRANSACT-SQL을 실행합니다.

TRUNCATE TABLE TestDatabase.dbo.myWidechar; -- for testing
BULK INSERT TestDatabase.dbo.myWidechar
   FROM 'D:\BCP\myWidechar.bcp'
   WITH (
		FORMATFILE = 'D:\BCP\myWidechar.fmt'
		);

-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;

XML 이외의 서식 파일과 함께 OPENROWSET 및 유니코드 문자 형식 사용하기

FORMATFILE 인수. Microsoft SSMS(SQL Server Management Studio)에서 다음 TRANSACT-SQL을 실행합니다.

TRUNCATE TABLE TestDatabase.dbo.myWidechar;  -- for testing
INSERT INTO TestDatabase.dbo.myWidechar
	SELECT *
	FROM OPENROWSET (
		BULK 'D:\BCP\myWidechar.bcp', 
		FORMATFILE = 'D:\BCP\myWidechar.fmt'  
		) AS t1;

-- review results
SELECT * FROM TestDatabase.dbo.myWidechar;

대량 가져오기 또는 대량 내보내기를 위한 데이터 형식을 사용하려면

참고 항목

bcp 유틸리티
BULK INSERT(Transact-SQL)
OPENROWSET(Transact-SQL)
데이터 형식(Transact-SQL)
데이터 정렬 및 유니코드 지원