PARSENAME (Transact-SQL)
Berlaku untuk:
SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Mengembalikan bagian yang ditentukan dari nama objek. Bagian dari objek yang dapat diambil adalah nama objek, nama skema, nama database, dan nama server.
Catatan
Fungsi PARSENAME tidak menunjukkan apakah objek dengan nama yang ditentukan ada. PARSENAME hanya mengembalikan bagian yang ditentukan dari nama objek yang ditentukan.
Sintaks
PARSENAME ('object_name' , object_piece )
Catatan
Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.
Argumen
'object_name' Adalah parameter yang menyimpan nama objek untuk mengambil bagian objek yang ditentukan. Parameter ini adalah nama objek yang memenuhi syarat secara opsional. Jika semua bagian dari nama objek memenuhi syarat, nama ini dapat memiliki empat bagian: nama server, nama database, nama skema, dan nama objek. Setiap bagian dari string 'object_name' adalah jenis sysname yang setara dengan nvarchar(128) atau 256 byte. Jika ada bagian dari string yang melebihi 256 byte, PARSENAME akan mengembalikan NULL untuk bagian tersebut karena bukan nama sysname yang valid.
object_piece
Adalah bagian objek yang akan dikembalikan. object_piece berjenis int, dan dapat memiliki nilai-nilai ini:
1 = Nama objek
2 = Nama skema
3 = Nama database
4 = Nama server
Jenis Hasil
nama sysname
Keterangan
PARSENAME mengembalikan NULL jika salah satu kondisi berikut ini benar:
Baik object_name atau object_piece NULL.
Terjadi kesalahan sintaks.
Bagian objek yang diminta memiliki panjang 0 dan bukan pengidentifikasi Microsoft SQL Server yang valid. Nama objek panjang nol merender nama lengkap yang memenuhi syarat sebagai tidak valid.
Contoh
Contoh berikut menggunakan PARSENAME untuk mengembalikan informasi tentang Person tabel dalam AdventureWorks2012 database.
-- Uses AdventureWorks
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorksPDW2012.dbo.DimCustomer', 4) AS 'Server Name';
GO
Berikut adalah hasil yang ditetapkan.
Object Name
------------------------------
DimCustomer
(1 row(s) affected)
Schema Name
------------------------------
dbo
(1 row(s) affected)
Database Name
------------------------------
AdventureWorksPDW2012
(1 row(s) affected)
Server Name
------------------------------
(null)
(1 row(s) affected)