PARSENAME (Transact-SQL)
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.
PARSENAME
tidak menunjukkan apakah objek dengan nama yang ditentukan ada. PARSENAME
hanya mengembalikan bagian yang ditentukan dari nama objek yang ditentukan.
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'
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 sysname, yang setara dengan nvarchar(128) atau 256 byte. Jika ada bagian dari string melebihi 256 byte, PARSENAME
mengembalikan NULL
untuk bagian tersebut, karena bukan nama sysname yang valid.
object_piece
Bagian objek yang akan dikembalikan. object_piece int, dan bisa menjadi salah satu nilai ini:
Nilai | Description |
---|---|
1 | Nama Objek |
2 | Nama skema |
3 | Nama database |
4 | Nama server |
Jenis yang dikembalikan
nama sysname
Keterangan
PARSENAME
mengembalikan NULL
jika salah satu kondisi berikut ini benar:
Baik object_name atau object_piece adalah
NULL
.Terjadi kesalahan sintaks.
Bagian objek yang diminta memiliki panjang
0
dan bukan pengidentifikasi 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('AdventureWorks2022.Person.Person', 1) AS 'Object Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 2) AS 'Schema Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 3) AS 'Database Name';
SELECT PARSENAME('AdventureWorks2022.Person.Person', 4) AS 'Server Name';
GO
Berikut adalah hasil yang ditetapkan.
Object Name
------------------------------
Person
Schema Name
------------------------------
Person
Database Name
------------------------------
AdventureWorks2022
Server Name
------------------------------
(null)
Konten terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk