TYPE_NAME(Transact-SQL)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

지정된 형식 ID의 정규화되지 않은 형식 이름을 반환합니다.

Transact-SQL 구문 표기 규칙

Syntax

TYPE_NAME ( type_id )   

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

type_id
사용될 형식의 ID입니다. type_id는 int이며 호출자가 액세스할 수 있는 모든 스키마의 형식을 참조할 수 있습니다.

반환 형식

sysname

예외

오류가 발생하거나 호출자가 개체를 볼 수 있는 권한을 갖고 있지 않으면 NULL을 반환합니다.

SQL Server에서 사용자는 소유하고 있거나 사용 권한을 부여받은 보안 개체의 메타데이터만 볼 수 있습니다. 즉, 사용자가 개체에 대한 사용 권한이 없으면 TYPE_NAME과 같은 메타데이터 내보내기 기본 제공 함수가 NULL을 반환합니다. 자세한 내용은 Metadata Visibility Configuration을 참조하세요.

설명

TYPE_NAME은 type_id가 유효하지 않거나 호출자에게 유형을 참조할 수 있는 충분한 권한이 없는 경우 NULL을 반환합니다.

TYPE_NAME은 시스템 데이터 형식에 사용할 수 있으며 사용자 정의 데이터 형식에도 사용할 수 있습니다. 형식은 모든 스키마에 포함될 수 있지만 항상 정규화되지 않은 형식 이름이 반환됩니다. 따라서 이름에 schema. 접두어가 포함되지 않습니다.

시스템 함수는 선택 목록, WHERE 절 및 식이 허용되는 모든 곳에서 사용될 수 있습니다. 자세한 내용은 식(Transact-SQL) 및 WHERE(Transact-SQL)를 참조하세요.

예

다음 예에서는 AdventureWorks2022 데이터베이스의 Vendor 테이블에 있는 각 열의 개체 이름, 열 이름 및 형식 이름을 반환합니다.

SELECT o.name AS obj_name, c.name AS col_name,  
       TYPE_NAME(c.user_type_id) AS type_name  
FROM sys.objects AS o   
JOIN sys.columns AS c  ON o.object_id = c.object_id  
WHERE o.name = 'Vendor'  
ORDER BY col_name;  
GO  

결과 집합은 다음과 같습니다.

obj_name        col_name                  type_name
--------------- ------------------------ --------------
Vendor          AccountNumber            AccountNumber
Vendor          ActiveFlag               Flag
Vendor          BusinessEntityID         int
Vendor          CreditRating             tinyint
Vendor          ModifiedDate             datetime
Vendor          Name                     Name
Vendor          PreferredVendorStatus    Flag
Vendor          PurchasingWebServiceURL  nvarchar

(8 row(s) affected)

예: Azure Synapse Analytics 및 분석 플랫폼 시스템(PDW)

다음 예에서는 TYPE ID ID를 가진 데이터 형식의 1을 반환합니다.

SELECT TYPE_NAME(36) AS Type36, TYPE_NAME(239) AS Type239;  
GO  

형식의 목록을 보려면 sys.types를 쿼리합니다.

SELECT * FROM sys.types;  
GO  

참고 항목

TYPE_ID(Transact-SQL)
TYPEPROPERTY(Transact-SQL)
sys.types(Transact-SQL)
메타데이터 함수(Transact-SQL)