TYPE_NAME (T-SQL)

Artikel
12/22/2023

Berlaku untuk:SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics Analytics Platform System (PDW)

Mengembalikan nama tipe yang tidak memenuhi syarat dari ID tipe tertentu.

Konvensi sintaks transact-SQL

Sintaksis

TYPE_NAME ( type_id )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

type_id
Adalah ID dari jenis yang akan digunakan. type_id adalah int, dan dapat merujuk ke jenis dalam skema apa pun yang dapat diakses oleh pemanggil.

Jenis Kembalian

nama sysname

Pengecualian

Mengembalikan NULL pada kesalahan atau jika penelepon tidak memiliki izin untuk melihat objek.

Di SQL Server, pengguna hanya dapat melihat metadata dari securables yang dimiliki pengguna atau tempat pengguna telah diberikan izin. Ini berarti bahwa fungsi bawaan yang memancarkan metadata seperti TYPE_NAME dapat mengembalikan NULL jika pengguna tidak memiliki izin apa pun pada objek. Untuk informasi selengkapnya, lihat Konfigurasi Visibilitas Metadata.

Keterangan

TYPE_NAME akan mengembalikan NULL ketika type_id tidak valid atau ketika pemanggil tidak memiliki izin yang memadai untuk mereferensikan jenis.

TYPE_NAME berfungsi untuk jenis data sistem dan juga untuk jenis data yang ditentukan pengguna. Jenis dapat dimuat dalam skema apa pun, tetapi nama jenis yang tidak memenuhi syarat selalu dikembalikan. Ini berarti nama tidak memiliki skema. awalan.

Fungsi sistem dapat digunakan dalam daftar pemilihan, dalam klausa WHERE, dan di mana saja ekspresi diizinkan. Untuk informasi selengkapnya, lihat Ekspresi (Transact-SQL) dan WHERE (Transact-SQL).

Contoh

Contoh berikut mengembalikan nama objek, nama kolom, dan nama jenis untuk setiap kolom dalam Vendor tabel AdventureWorks2022 database.

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

Berikut adalah hasil yang ditetapkan.

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)

Contoh: Azure Synapse Analytics and Analytics Platform System (PDW)

Contoh berikut mengembalikan TYPE ID untuk jenis data dengan id 1.

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

Untuk daftar jenis, kueri sys.type.

SELECT * FROM sys.types;  
GO

Lihat Juga

TYPE_ID (T-SQL)
TYPEPROPERTY (Transact-SQL)
sys.type (Transact-SQL)
Fungsi Metadata (Transact-SQL)