SQL-CLR 형식 매핑(LINQ to SQL)

업데이트: November 2007

LINQ to SQL에서 관계형 데이터베이스의 데이터 모델은 사용자가 선택한 프로그래밍 언어로 표현되는 개체 모델에 매핑됩니다. 응용 프로그램을 실행하면 LINQ to SQL에서는 개체 모델의 통합 언어 쿼리를 SQL로 변환하여 실행을 위해 데이터베이스로 전송합니다. 데이터베이스에서 결과가 반환되면 LINQ to SQL에서는 해당 결과를 사용자의 프로그래밍 언어로 작업할 수 있는 개체로 다시 변환합니다.

개체 모델과 데이터베이스 간에 데이터를 변환하기 위해서는 형식 매핑을 정의해야 합니다. LINQ to SQL에서는 형식 매핑을 사용하여 각 CLR(공용 언어 런타임) 형식을 특정 SQL Server 형식과 연결합니다. 특성 기반 매핑을 사용하여 개체 모델 내부에 형식 매핑 및 데이터베이스 구조와 테이블 관계 같은 다른 매핑 정보를 정의할 수 있습니다. 또는 외부 매핑 파일을 사용하여 개체 모델 외부에 매핑 정보를 지정할 수도 있습니다. 자세한 내용은 특성 기반 매핑(LINQ to SQL) 및 외부 매핑 참조(LINQ to SQL)를 참조하십시오.

이 항목에서는 다음 사항에 대해 설명합니다.

• 기본 형식 매핑

• 형식 매핑 런타임 동작 매트릭스

• CLR 및 SQL 실행 간의 동작 차이

• Enum 매핑

• 숫자 매핑

• 텍스트 및 XML 매핑

• 날짜 및 시간 매핑

• 이진 매핑

• 기타 매핑

기본 형식 매핑

개체 모델 또는 외부 매핑 파일은 O/R 디자이너(개체 관계형 디자이너) 또는 SQLMetal 명령줄 도구를 사용하여 자동으로 만들 수 있습니다. 이러한 도구의 기본 형식 매핑은 SQL Server 데이터베이스 내의 열에 매핑될 CLR 형식을 정의합니다. 이러한 도구의 사용 방법에 대한 자세한 내용은 개체 모델 만들기(LINQ to SQL)를 참조하십시오.

CreateDatabase 메서드를 사용하여 개체 모델 또는 외부 매핑 파일의 매핑 정보를 기초로 SQL Server 데이터베이스를 만들 수도 있습니다. CreateDatabase 메서드의 기본 형식 매핑은 개체 모델의 CLR 형식에 매핑되도록 만들 SQL Server 열의 형식을 정의합니다. 자세한 내용은 방법: 동적으로 데이터베이스 만들기(LINQ to SQL)를 참조하십시오.

형식 매핑 런타임 동작 매트릭스

다음 다이어그램에서는 데이터를 데이터베이스에서 검색하거나 데이터베이스에 저장할 때 특정 형식 매핑에 대해 예상되는 런타임 동작을 보여 줍니다. serialization의 경우를 제외하고 LINQ to SQL에서는 이 매트릭스에 지정되어 있는 CLR 또는 SQL Server 데이터 형식 간 매핑만 지원합니다. serialization 지원에 대한 자세한 내용은 이진 Serialization을 참조하십시오.

참고:
일부 형식 매핑의 경우 데이터베이스 관련 변환 과정에서 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다.

사용자 지정 형식 매핑

LINQ to SQL을 사용할 경우 O/R 디자이너, SQLMetal 및 CreateDatabase 메서드에 사용되는 기본 형식 매핑에 제한이 없습니다. DBML 파일에 명시적으로 지정하는 방법으로 사용자 지정 형식 매핑을 만들 수 있습니다. 그런 다음 이 DBML 파일을 사용하여 개체 모델 코드 및 매핑 파일을 만들 수 있습니다. 자세한 내용은 SQL-CLR 사용자 지정 형식 매핑(LINQ to SQL)을 참조하십시오.

CLR 및 SQL 실행 간의 동작 차이

CLR과 SQL Server는 전체 자릿수 및 실행 측면에서 차이점이 있기 때문에 어디서 계산을 수행하는지에 따라 결과나 동작이 다를 수 있습니다. LINQ to SQL 쿼리에서 계산을 수행하면 실제로 계산은 Transact-SQL로 변환된 후 SQL Server 데이터베이스에서 실행됩니다. LINQ to SQL 쿼리 외부에서 수행되는 계산은 CLR 컨텍스트 내에서 실행됩니다.

예를 들어 다음은 CLR과 SQL Server 사이의 몇 가지 동작 차이점입니다.

• SQL Server에서는 일부 데이터 형식이 CLR에서 이에 해당되는 데이터 형식과 다르게 정렬됩니다. 예를 들어 SQL Server의 UNIQUEIDENTIFIER 데이터 형식은 CLR의 System.Guid 데이터 형식과 다르게 정렬됩니다.

• SQL Server에서는 일부 문자열의 비교 연산이 CLR과 다르게 처리됩니다. SQL Server의 경우 문자열 비교 동작은 서버의 데이터 정렬 설정에 따라 다릅니다. 자세한 내용은 Microsoft SQL Server 온라인 설명서에서 데이터 정렬 작업을 참조하십시오.

• SQL Server에서는 매핑된 일부 함수에 대해 CLR과는 다른 값을 반환할 수 있습니다. 예를 들어 두 문자열이 후행 공백에서만 차이가 있는 경우 SQL Server에서는 두 문자열이 동일한 것으로 간주되는 반면 CLR에서는 두 문자열이 다른 것으로 간주되기 때문에 같음 함수가 각각 다른 값을 반환합니다.

Enum 매핑

LINQ to SQL에서는 다음과 같은 두 가지 방법으로 CLR System.Enum 형식을 SQL Server 형식에 매핑합니다.

• SQL 숫자 형식에 대한 매핑(TINYINT, SMALLINT, INT, BIGINT)

  CLR System.Enum 형식을 SQL 숫자 형식에 매핑할 경우 CLR System.Enum의 기본 정수 값이 SQL Server 데이터베이스 열의 값에 매핑됩니다. 예를 들어 DaysOfWeek라는 System.Enum에 기본 정수 값이 3인 Tue라는 멤버가 포함된 경우 해당 멤버는 데이터베이스 값 3에 매핑됩니다.

• SQL 텍스트 형식에 대한 매핑(CHAR, NCHAR, VARCHAR, NVARCHAR)

  CLR System.Enum 형식을 SQL 텍스트 형식에 매핑할 경우 SQL 데이터베이스 값이 CLR System.Enum 멤버의 이름에 매핑됩니다. 예를 들어 DaysOfWeek라는 System.Enum에 기본 정수 값이 3인 Tue라는 멤버가 포함된 경우 해당 멤버는 데이터베이스 값 Tue에 매핑됩니다.

참고:
SQL 텍스트 형식을 CLR System.Enum에 매핑할 경우에는 매핑되는 SQL 열에 Enum 멤버의 이름만 포함해야 합니다. 다른 값은 Enum에 매핑되는 SQL 열에 사용할 수 없습니다.

O/R 디자이너 및 SQLMetal 명령줄 도구는 SQL 형식을 CLR Enum 클래스에 자동으로 매핑할 수 없습니다. O/R 디자이너 및 SQLMetal에 사용하려면 DBML 파일을 사용자 지정하여 이 매핑을 명시적으로 구성해야 합니다. 사용자 지정 형식 매핑에 대한 자세한 내용은 SQL-CLR 사용자 지정 형식 매핑(LINQ to SQL)을 참조하십시오.

열거형이 사용되는 SQL 열은 다른 숫자 및 텍스트 열과 형식이 같으므로 이러한 도구는 원래 의도와는 달리 다음 숫자 매핑 및 텍스트 및 XML 매핑 단원에서 설명하는 것처럼 기본적으로 매핑됩니다. DBML 파일에서 코드를 생성하는 방법에 대한 자세한 내용은 LINQ to SQL의 코드 생성을 참조하십시오.

DataContext.CreateDatabase 메서드는 CLR System.Enum 형식에 매핑되는 숫자 형식의 SQL 열을 만듭니다.

숫자 매핑

LINQ to SQL에서는 여러 CLR 및 SQL Server 숫자 형식을 매핑할 수 있습니다. 다음 표에는 데이터베이스를 기초로 개체 모델 또는 외부 매핑 파일을 빌드할 때 O/R 디자이너와 SQLMetal에서 선택하는 CLR 형식이 나와 있습니다.

SQL Server 형식	O/R 디자이너 및 SQLMetal에서 사용하는 기본 CLR 형식 매핑
BIT	System.Boolean
TINYINT	System.Int16
INT	System.Int32
BIGINT	System.Int64
SMALLMONEY	System.Decimal
MONEY	System.Decimal
DECIMAL	System.Decimal
NUMERIC	System.Decimal
REAL/FLOAT(24)	System.Single
FLOAT/FLOAT(53)	System.Double

다음 표에는 개체 모델 또는 외부 매핑 파일에 정의된 CLR 형식에 매핑되도록 만들 SQL 열의 형식을 정의하기 위해 DataContext.CreateDatabase 메서드에서 사용하는 기본 형식 매핑이 나와 있습니다.

CLR 형식	DataContext.CreateDatabase에서 사용하는 기본 SQL Server 형식
System.Boolean	BIT
System.Byte	TINYINT
System.Int16	SMALLINT
System.Int32	INT
System.Int64	BIGINT
System.SByte	SMALLINT
System.UInt16	INT
System.UInt32	BIGINT
System.UInt64	DECIMAL(20)
System.Decimal	DECIMAL(29,4)
System.Single	REAL
System.Double	FLOAT

이 외에도 여러 가지 숫자 매핑을 선택할 수 있지만 일부의 경우에는 데이터베이스 관련 변환 과정에서 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다. 자세한 내용은 형식 매핑 런타임 동작 매트릭스를 참조하십시오.

Decimal 및 Money 형식

SQL Server DECIMAL 형식의 기본 전체 자릿수(소수점을 기준으로 왼쪽과 오른쪽에 18자리)는 이 형식과 기본적으로 쌍을 이루는 CLR System.Decimal 형식의 전체 자릿수보다 훨씬 적습니다. 이 때문에 데이터베이스에 데이터를 저장할 때 전체 자릿수가 손실될 수 있습니다. 그러나 SQL Server의 DECIMAL 형식이 30자리 이상으로 구성된 경우에는 그 반대의 결과가 발생할 수 있습니다. SQL Server DECIMAL 형식의 전체 자릿수가 CLR System.Decimal의 전체 자릿수보다 크게 구성된 경우 데이터베이스에서 데이터를 검색할 때 전체 자릿수가 손실될 수 있습니다.

CLR System.Decimal 형식과 기본적으로 쌍을 이루는 SQL Server MONEY 및 SMALLMONEY 형식도 전체 자릿수가 훨씬 적기 때문에 데이터베이스에 데이터를 저장할 때 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다.

텍스트 및 XML 매핑

LINQ to SQL에서는 여러 텍스트 기반 형식 및 XML 형식을 매핑할 수도 있습니다. 다음 표에는 데이터베이스를 기초로 개체 모델 또는 외부 매핑 파일을 빌드할 때 O/R 디자이너와 SQLMetal에서 선택하는 CLR 형식이 나와 있습니다.

SQL Server 형식	O/R 디자이너 및 SQLMetal에서 사용하는 기본 CLR 형식 매핑
CHAR	System.String
NCHAR	System.String
VARCHAR	System.String
NVARCHAR	System.String
TEXT	System.String
NTEXT	System.String
XML	System.Xml.Linq.XElement

다음 표에는 개체 모델 또는 외부 매핑 파일에 정의된 CLR 형식에 매핑되도록 만들 SQL 열의 형식을 정의하기 위해 DataContext.CreateDatabase 메서드에서 사용하는 기본 형식 매핑이 나와 있습니다.

CLR 형식	DataContext.CreateDatabase에서 사용하는 기본 SQL Server 형식
System.Char	NCHAR(1)
System.String	NVARCHAR(4000)
System.Char[]	NVARCHAR(4000)
Parse() 및 ToString()을 구현하는 사용자 지정 형식	NVARCHAR(MAX)

이 외에도 여러 가지 텍스트 기반 및 XML 매핑을 선택할 수 있지만 일부의 경우에는 데이터베이스 관련 변환 과정에서 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다. 자세한 내용은 형식 매핑 런타임 동작 매트릭스를 참조하십시오.

XML 형식

SQL Server XML 데이터 형식은 Microsoft SQL Server 2005부터 사용할 수 있습니다. SQL Server XML 데이터 형식은 XElement, XDocument 또는 String에 매핑할 수 있습니다. XElement로 읽어 들일 수 없는 XML 조각이 열에 저장된 경우 런타임 오류를 방지하기 위해 해당 열을 String에 매핑해야 합니다. String에 매핑해야 하는 XML 조각은 다음과 같습니다.

• XML 요소의 시퀀스

• 특성

• PI(공용 식별자)

• 주석

형식 매핑 런타임 동작 매트릭스에 나와 있는 것처럼 XElement 및 XDocument를 SQL Server에 매핑할 수 있지만 DataContext.CreateDatabase 메서드에는 이러한 형식에 대한 기본 SQL Server 형식 매핑이 없습니다.

사용자 지정 형식

클래스에서 Parse()와 ToString()을 구현하는 경우 개체를 모든 SQL 텍스트 형식(CHAR, NCHAR, VARCHAR, NVARCHAR, TEXT, NTEXT, XML)에 매핑할 수 있습니다. 개체는 ToString()에서 반환하는 값을 매핑된 데이터베이스 열에 전송함으로써 데이터베이스에 저장되고, 데이터베이스에서 반환하는 문자열에 대해 Parse()를 호출함으로써 다시 생성됩니다.

참고:
LINQ to SQL에서 System.Xml.Serialization.IXmlSerializable을 사용한 serialization은 지원되지 않습니다.

날짜 및 시간 매핑

LINQ to SQL을 사용하면 여러 SQL Server 날짜 및 시간 형식을 매핑할 수 있습니다. 다음 표에는 데이터베이스를 기초로 개체 모델 또는 외부 매핑 파일을 빌드할 때 O/R 디자이너와 SQLMetal에서 선택하는 CLR 형식이 나와 있습니다.

SQL Server 형식	O/R 디자이너 및 SQLMetal에서 사용하는 기본 CLR 형식 매핑
SMALLDATETIME	System.DateTime
DATETIME	System.DateTime
DATETIME2	System.DateTime
DATETIMEOFFSET	System.DateTimeOffset
DATE	System.DateTime
TIME	System.TimeSpan

다음 표에는 개체 모델 또는 외부 매핑 파일에 정의된 CLR 형식에 매핑되도록 만들 SQL 열의 형식을 정의하기 위해 DataContext.CreateDatabase 메서드에서 사용하는 기본 형식 매핑이 나와 있습니다.

CLR 형식	DataContext.CreateDatabase에서 사용하는 기본 SQL Server 형식
System.DateTime	DATETIME
System.DateTimeOffset	DATETIMEOFFSET
System.TimeSpan	TIME

이 외에도 여러 가지 날짜 및 시간 매핑을 선택할 수 있지만 일부의 경우에는 데이터베이스 관련 변환 과정에서 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다. 자세한 내용은 형식 매핑 런타임 동작 매트릭스를 참조하십시오.

참고:
SQL Server 형식 DATETIME2, DATETIMEOFFSET, DATE 및 TIME은 Microsoft SQL Server 2008부터 사용할 수 있습니다. LINQ to SQL에서는 .NET Framework 버전 3.5 SP1부터 이러한 새로운 형식의 매핑이 지원됩니다.

System.Datetime

CLR System.DateTime 형식의 범위 및 전체 자릿수는 DataContext.CreateDatabase 메서드의 기본 형식 매핑인 SQL Server DATETIME 형식의 범위 및 전체 자릿수보다 큽니다. DATETIME의 범위를 벗어나는 날짜와 관련된 예외가 발생하지 않도록 하려면 Microsoft SQL Server 2008부터 사용할 수 있는 DATETIME2를 사용하십시오. <languageKeyword>DATETIME2</languageKeyword>를 사용하면 CLR System.DateTime의 범위 및 전체 자릿수에 맞출 수 있습니다.

SQL Server 날짜에는 CLR에서 지원되는 기능인 TimeZone 개념이 없습니다. 원래 DateTimeKind 정보에 관계없이 TimeZone 값은 TimeZone 변환 없이 데이터베이스에 있는 그대로 저장됩니다. DateTime 값이 데이터베이스에서 검색될 경우 해당 값은 DateTimeKind가 Unspecified로 지정되어 DateTime에 있는 그대로 로드됩니다. 지원되는 System.DateTime 메서드에 대한 자세한 내용은 System.DateTime 메서드(LINQ to SQL)를 참조하십시오.

System.TimeSpan

Microsoft SQL Server 2008 및 .NET Framework 3.5 SP1에서는 CLR System.TimeSpan 형식을 SQL Server TIME 형식에 매핑할 수 있습니다. 그러나 CLR System.TimeSpan에서 지원되는 범위와 SQL Server TIME 형식에서 지원되는 범위에는 상당한 차이가 있습니다. 0보다 작거나 23:59:59.9999999시간보다 큰 값을 SQL TIME에 매핑하면 오버플로 예외가 발생합니다. 자세한 내용은 System.TimeSpan 메서드(LINQ to SQL)를 참조하십시오.

Microsoft SQL Server 2000 및 SQL Server 2005에서는 데이터베이스 필드를 TimeSpan에 매핑할 수 없습니다. 그러나 TimeSpan 값은 DateTime 빼기에서 반환되거나 리터럴 또는 바인딩된 변수로 식에 삽입될 수 있기 때문에 TimeSpan에 대한 연산은 지원됩니다.

이진 매핑

여러 SQL Server 형식을 CLR System.Data.Linq.Binary 형식에 매핑할 수 있습니다. 다음 표에는 데이터베이스를 기초로 개체 모델 또는 외부 매핑 파일을 빌드할 때 O/R 디자이너와 SQLMetal에서 CLR System.Data.Linq.Binary 형식을 정의하는 SQL Server 형식이 나와 있습니다.

SQL Server 형식	O/R 디자이너 및 SQLMetal에서 사용하는 기본 CLR 형식 매핑
BINARY(50)	System.Data.Linq.Binary
VARBINARY(50)	System.Data.Linq.Binary
VARBINARY(MAX)	System.Data.Linq.Binary
FILESTREAM 특성이 있는 VARBINARY(MAX)	System.Data.Linq.Binary
IMAGE	System.Data.Linq.Binary
TIMESTAMP	System.Data.Linq.Binary

다음 표에는 개체 모델 또는 외부 매핑 파일에 정의된 CLR 형식에 매핑되도록 만들 SQL 열의 형식을 정의하기 위해 DataContext.CreateDatabase 메서드에서 사용하는 기본 형식 매핑이 나와 있습니다.

CLR 형식	DataContext.CreateDatabase에서 사용하는 기본 SQL Server 형식
System.Data.Linq.Binary	VARBINARY(MAX)
System.Byte	VARBINARY(MAX)
System.Runtime.Serialization.ISerializable	VARBINARY(MAX)

이 외에도 여러 가지 이진 매핑을 선택할 수 있지만 일부의 경우에는 데이터베이스 관련 변환 과정에서 오버플로 또는 데이터 손실 예외가 발생할 수 있습니다. 자세한 내용은 형식 매핑 런타임 동작 매트릭스를 참조하십시오.

SQL Server FILESTREAM

VARBINARY(MAX) 열의 FILESTREAM 특성은 Microsoft SQL Server 2008부터 사용할 수 있으며 .NET Framework 버전 3.5 SP1부터 LINQ to SQL을 사용하여 매핑할 수 있습니다.

Binary 개체에 FILESTREAM 특성이 있는 VARBINARY(MAX) 열을 매핑할 수는 있지만 DataContext.CreateDatabase 메서드에서 FILESTREAM 특성이 있는 열을 자동으로 생성할 수는 없습니다. FILESTREAM에 대한 자세한 내용은 Microsoft SQL Server 온라인 설명서에서 FILESTREAM 개요를 참조하십시오.

이진 Serialization

클래스에서 ISerializable 인터페이스를 구현하는 경우 개체를 모든 SQL 이진 필드(BINARY, VARBINARY, IMAGE)로 serialize할 수 있습니다. 개체는 ISerializable 인터페이스가 구현되는 방법에 따라 serialize 및 deserialize됩니다. 자세한 내용은 이진 Serialization을 참조하십시오.

기타 매핑

다음 표에서는 위에서 언급하지 않은 기타 형식의 기본 형식 매핑을 보여 줍니다. 다음 표에는 데이터베이스를 기초로 개체 모델 또는 외부 매핑 파일을 빌드할 때 O/R 디자이너와 SQLMetal에서 선택하는 CLR 형식이 나와 있습니다.

SQL Server 형식	O/R 디자이너 및 SQLMetal에서 사용하는 기본 CLR 형식 매핑
UNIQUEIDENTIFIER	System.Guid
SQL_VARIANT	System.Object

다음 표에는 개체 모델 또는 외부 매핑 파일에 정의된 CLR 형식에 매핑되도록 만들 SQL 열의 형식을 정의하기 위해 DataContext.CreateDatabase 메서드에서 사용하는 기본 형식 매핑이 나와 있습니다.

CLR 형식	DataContext.CreateDatabase에서 사용하는 기본 SQL Server 형식
System.Guid	UNIQUEIDENTIFIER
System.Object	SQL_VARIANT

LINQ to SQL에서는 이러한 기타 형식에 대해 여기에 나와 있는 것 이외의 형식 매핑은 지원하지 않습니다. 자세한 내용은 형식 매핑 런타임 동작 매트릭스를 참조하십시오.

참고 항목

참조

특성 기반 매핑(LINQ to SQL)

외부 매핑 참조(LINQ to SQL)

SQL-CLR 형식 불일치(LINQ to SQL)

기타 리소스

데이터 형식 및 함수(LINQ to SQL)