Bagikan melalui

PARSENAME (Transact-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform 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.

Konvensi sintaks transact-SQL

Sintaks

PARSENAME ('object_name' , object_piece )

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 set hasilnya.

Object Name
------------------------------
Person

Schema Name
------------------------------
Person

Database Name
------------------------------
AdventureWorks2022

Server Name
------------------------------
(null)

Konten terkait