문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

sp_columns_ex(Transact-SQL)

지정한 연결된 서버 테이블에 대해 각 열마다 한 행씩 열 정보를 반환합니다. sp_columns_excolumn이 지정된 경우에 지정된 열에 대해서만 열 정보를 반환합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

sp_columns_ex [ @table_server = ] 'table_server' 
     [ , [ @table_name = ] 'table_name' ] 
     [ , [ @table_schema = ] 'table_schema' ] 
     [ , [ @table_catalog = ] 'table_catalog' ] 
     [ , [ @column_name = ] 'column' ] 
     [ , [ @ODBCVer = ] 'ODBCVer' ]

[ @table_server = ] 'table_server'

열 정보를 반환할 연결된 서버의 이름입니다. table_serversysname이며 기본값은 없습니다.

[ @table_name = ] 'table_name'

열 정보를 반환할 대상이 되는 테이블의 이름입니다. table_namesysname이며 기본값은 NULL입니다.

[ @table_schema = ] 'table_schema'

열 정보를 반환할 대상이 되는 테이블의 스키마 이름입니다. table_schemasysname이며 기본값은 NULL입니다.

[ @table_catalog = ] 'table_catalog'

열 정보를 반환할 대상이 되는 테이블의 카탈로그 이름입니다. table_catalogsysname이며 기본값은 NULL입니다.

[ @column_name = ] 'column'

정보를 제공할 대상이 되는 데이터베이스 열의 이름입니다. columnsysname이며 기본값은 NULL입니다.

[ @ODBCVer = ] 'ODBCVer'

사용하고 있는 ODBC의 버전입니다. ODBCVerint이며 기본값은 2입니다. 이 값은 ODBC 버전 2를 나타내며 유효한 값은 2 또는 3입니다. 버전 2와 버전 3의 동작 차이에 대한 자세한 내용은 ODBC SQLColumns 사양을 참조하십시오.

열 이름

데이터 형식

설명

TABLE_CAT

sysname

테이블 또는 뷰 한정자 이름입니다. 다양한 DBMS 제품에서 테이블에 대해 세 부분으로 구성된 이름(qualifier.owner.name)을 지원합니다. SQL Server에서 이 열은 데이터베이스 이름을 나타냅니다. 일부 제품에서는 테이블 데이터베이스 환경의 서버 이름을 나타냅니다. 이 필드는 NULL이 될 수 있습니다.

TABLE_SCHEM

sysname

테이블 또는 뷰 소유자 이름입니다. SQL Server에서 이 열은 테이블을 만든 데이터베이스 사용자의 이름을 나타냅니다. 이 필드는 항상 값을 반환합니다.

TABLE_NAME

sysname

테이블 또는 뷰 이름입니다. 이 필드는 항상 값을 반환합니다.

COLUMN_NAME

sysname

반환된 TABLE_NAME의 각 열 이름입니다. 이 필드는 항상 값을 반환합니다.

DATA_TYPE

smallint

ODBC 형식 식별자에 해당하는 정수 값입니다. ODBC 형식에 매핑될 수 없는 데이터 형식인 경우에 이 값은 NULL이 됩니다. 네이티브 데이터 형식 이름이 TYPE_NAME 열에 반환됩니다.

TYPE_NAME

varchar( 13)

데이터 형식을 나타내는 문자열입니다. 이 이름은 기본 DBMS에서 제공합니다.

COLUMN_SIZE

int

유효 자릿수입니다. PRECISION 열의 반환 값은 10진수를 기준으로 합니다.

BUFFER_LENGTH

int

데이터의 전송 크기입니다.1

DECIMAL_DIGITS

smallint

소수점 오른쪽 자릿수입니다.

NUM_PREC_RADIX

smallint

숫자 데이터 형식의 기준입니다.

NULLABLE

smallint

NULL 허용 여부를 지정합니다.

1 = NULL을 사용할 수 있습니다.

0 = NULL을 사용할 수 없습니다.

REMARKS

varchar( 254)

이 필드는 항상 NULL을 반환합니다.

COLUMN_DEF

varchar( 254)

열의 기본값입니다.

SQL_DATA_TYPE

smallint

설명자의 TYPE 필드에 표시되는 SQL 데이터 형식의 값입니다. 이 열은 datetime 및 SQL-92 interval 데이터 형식을 제외하고 DATA_TYPE 열과 동일합니다. 이 열은 항상 값을 반환합니다.

SQL_DATETIME_SUB

smallint

datetime 및 SQL-92 interval 데이터 형식에 대한 하위 유형 코드입니다. 이 열은 다른 데이터 형식에 대해서는 NULL을 반환합니다.

CHAR_OCTET_LENGTH

int

문자 또는 정수 데이터 형식 열의 최대 길이를 바이트로 표시한 것입니다. 이 열은 다른 모든 데이터 형식에 대해서는 NULL을 반환합니다.

ORDINAL_POSITION

int

테이블에 있는 열의 순서 위치입니다. 테이블의 첫 번째 열은 1입니다. 이 열은 항상 값을 반환합니다.

IS_NULLABLE

varchar( 254)

테이블에 있는 열의 Null 허용 여부입니다. ISO 규칙을 따라서 Null 허용 여부를 결정합니다. ISO SQL-호환 DBMS에서는 빈 문자열을 반환할 수 없습니다.

YES = 열이 NULL을 포함할 수 있습니다.

NO = 열이 NULL을 포함할 수 없습니다.

Null 허용 여부를 알 수 없으면 이 열에서는 길이가 0인 문자열을 반환합니다.

이 열에 대해 반환되는 값은 NULLABLE 열에 대해 반환되는 값과 다릅니다.

SS_DATA_TYPE

tinyint

확장 저장 프로시저에 사용되는 SQL Server 데이터 형식입니다.

자세한 내용은 Microsoft ODBC 설명서를 참조하십시오.

sp_columns_extable_server에 해당되는 OLE DB 공급자의 IDBSchemaRowset 인터페이스에 있는 COLUMNS 행 집합을 쿼리하여 실행됩니다. 반환되는 행 수를 제한하기 위해 table_name, table_schema, table_catalogcolumn 매개 변수가 이 인터페이스로 전달됩니다.

sp_columns_ex는 지정한 연결된 서버의 OLE DB 공급자가 IDBSchemaRowset 인터페이스의 COLUMNS 행 집합을 지원하지 않는 경우 빈 결과 집합을 반환합니다.

스키마에 대한 SELECT 권한이 필요합니다.

sp_columns_ex는 구분 식별자에 대한 요구 사항을 따릅니다. 자세한 내용은 데이터베이스 식별자를 참조하십시오.

다음 예에서는 연결된 서버 Seattle1의 AdventureWorks2012 데이터베이스에 있는 HumanResources.Employee 테이블의 JobTitle 열에 대한 데이터 형식을 반환합니다.

EXEC sp_columns_ex 'Seattle1', 
   'Employee', 
   'HumanResources', 
   'AdventureWorks2012', 
   'JobTitle';

커뮤니티 추가 항목

추가
표시: