PARSENAME (Transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Mengembalikan bagian yang ditentukan dari nama objek. Bagian 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.

Konvensi sintaks transact-SQL

Sintaksis

PARSENAME ('object_name' , object_piece )

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi 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 dengan panjang nol merender nama lengkap yang memenuhi syarat sebagai tidak valid.

Contoh

Contoh berikut menggunakan PARSENAME untuk mengembalikan informasi tentang Person tabel dalam AdventureWorks2022 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)

Lihat Juga