CREATE FUNCTION (Transact-SQL)
Berlaku untuk: SQL ServerAzure SQL Database Azure SQL Managed Instance
Membuat fungsi yang ditentukan pengguna (UDF), yang merupakan Transact-SQL atau rutinitas runtime bahasa umum (CLR). Fungsi yang ditentukan pengguna menerima parameter, melakukan tindakan seperti perhitungan kompleks, dan mengembalikan hasil tindakan tersebut sebagai nilai. Nilai yang dikembalikan dapat berupa nilai skalar (tunggal) atau tabel. Gunakan pernyataan ini untuk membuat rutinitas yang dapat digunakan kembali yang dapat digunakan dengan cara berikut:
- Dalam pernyataan Transact-SQL seperti
SELECT
- Dalam aplikasi yang memanggil fungsi
- Dalam definisi fungsi lain yang ditentukan pengguna
- Untuk membuat parameter tampilan atau meningkatkan fungsionalitas tampilan terindeks
- Untuk menentukan kolom dalam tabel
- Untuk menentukan
CHECK
batasan pada kolom - Untuk mengganti prosedur tersimpan
- Menggunakan fungsi sebaris sebagai predikat filter untuk kebijakan keamanan
Integrasi .NET Framework CLR ke SQL Server dibahas dalam artikel ini. Integrasi CLR tidak berlaku untuk Azure SQL Database.
Untuk Azure Synapse Analytics atau Microsoft Fabric, lihat CREATE FUNCTION (Azure Synapse Analytics dan Microsoft Fabric).
Sintaks
Sintaks untuk fungsi skalar Transact-SQL.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type [ NULL ]
[ = default ] [ READONLY ] }
[ , ...n ]
]
)
RETURNS return_data_type
[ WITH <function_option> [ , ...n ] ]
[ AS ]
BEGIN
function_body
RETURN scalar_expression
END
[ ; ]
Sintaks untuk fungsi bernilai tabel sebaris Transact-SQL.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type [ NULL ]
[ = default ] [ READONLY ] }
[ , ...n ]
]
)
RETURNS TABLE
[ WITH <function_option> [ , ...n ] ]
[ AS ]
RETURN [ ( ] select_stmt [ ) ]
[ ; ]
Sintaks untuk fungsi bernilai tabel multi-pernyataan Transact-SQL.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type [ NULL ]
[ = default ] [ READONLY ] }
[ , ...n ]
]
)
RETURNS @return_variable TABLE <table_type_definition>
[ WITH <function_option> [ , ...n ] ]
[ AS ]
BEGIN
function_body
RETURN
END
[ ; ]
Sintaks untuk klausa fungsi Transact-SQL.
<function_option> ::=
{
[ ENCRYPTION ]
| [ SCHEMABINDING ]
| [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]
| [ EXECUTE_AS_Clause ]
| [ INLINE = { ON | OFF } ]
}
<table_type_definition> ::=
( { <column_definition> <column_constraint>
| <computed_column_definition> }
[ <table_constraint> ] [ , ...n ]
)
<column_definition> ::=
{
{ column_name data_type }
[ [ DEFAULT constant_expression ]
[ COLLATE collation_name ] | [ ROWGUIDCOL ]
]
| [ IDENTITY [ (seed , increment ) ] ]
[ <column_constraint> [ ...n ] ]
}
<column_constraint> ::=
{
[ NULL | NOT NULL ]
{ PRIMARY KEY | UNIQUE }
[ CLUSTERED | NONCLUSTERED ]
[ WITH FILLFACTOR = fillfactor
| WITH ( <index_option> [ , ...n ] )
[ ON { filegroup | "default" } ] ]
| [ CHECK ( logical_expression ) ] [ , ...n ]
}
<computed_column_definition> ::=
column_name AS computed_column_expression
<table_constraint> ::=
{
{ PRIMARY KEY | UNIQUE }
[ CLUSTERED | NONCLUSTERED ]
( column_name [ ASC | DESC ] [ , ...n ]
[ WITH FILLFACTOR = fillfactor
| WITH ( <index_option> [ , ...n ] )
| [ CHECK ( logical_expression ) ] [ , ...n ]
}
<index_option> ::=
{
PAD_INDEX = { ON | OFF }
| FILLFACTOR = fillfactor
| IGNORE_DUP_KEY = { ON | OFF }
| STATISTICS_NORECOMPUTE = { ON | OFF }
| ALLOW_ROW_LOCKS = { ON | OFF }
| ALLOW_PAGE_LOCKS = { ON | OFF }
}
Sintaks untuk fungsi skalar CLR.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type [ NULL ]
[ = default ] }
[ , ...n ]
)
RETURNS { return_data_type }
[ WITH <clr_function_option> [ , ...n ] ]
[ AS ] EXTERNAL NAME <method_specifier>
[ ; ]
Sintaks untuk fungsi bernilai tabel CLR.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type [ NULL ]
[ = default ] }
[ , ...n ]
)
RETURNS TABLE <clr_table_type_definition>
[ WITH <clr_function_option> [ , ...n ] ]
[ ORDER ( <order_clause> ) ]
[ AS ] EXTERNAL NAME <method_specifier>
[ ; ]
Sintaks untuk klausa fungsi CLR.
<order_clause> ::=
{
<column_name_in_clr_table_type_definition>
[ ASC | DESC ]
} [ , ...n ]
<method_specifier> ::=
assembly_name.class_name.method_name
<clr_function_option> ::=
{
[ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]
| [ EXECUTE_AS_Clause ]
}
<clr_table_type_definition> ::=
( { column_name data_type } [ , ...n ] )
Sintaks OLTP dalam memori untuk fungsi yang dikompilasi secara asli dan ditentukan pengguna skalar.
CREATE [ OR ALTER ] FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type
[ NULL | NOT NULL ] [ = default ] [ READONLY ] }
[ , ...n ]
]
)
RETURNS return_data_type
WITH <function_option> [ , ...n ]
[ AS ]
BEGIN ATOMIC WITH (set_option [ , ... n ] )
function_body
RETURN scalar_expression
END
<function_option> ::=
{
| NATIVE_COMPILATION
| SCHEMABINDING
| [ EXECUTE_AS_Clause ]
| [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]
}
Argumen
ATAU UBAH
Berlaku untuk: SQL Server 2016 (13.x) SP 1 dan versi yang lebih baru, dan Azure SQL Database.
Mengubah fungsi secara kondisional hanya jika sudah ada.
Sintaks opsional OR ALTER
tersedia untuk CLR, dimulai dengan SQL Server 2016 (13.x) SP 1 CU 1.
schema_name
Nama skema tempat fungsi yang ditentukan pengguna berada.
function_name
Nama fungsi yang ditentukan pengguna. Nama fungsi harus mematuhi aturan untuk pengidentifikasi dan harus unik dalam database dan skemanya.
Tanda kurung diperlukan setelah nama fungsi, bahkan jika parameter tidak ditentukan.
@parameter_name
Parameter dalam fungsi yang ditentukan pengguna. Satu atau beberapa parameter dapat dideklarasikan.
Fungsi dapat memiliki maksimum 2.100 parameter. Nilai setiap parameter yang dideklarasikan harus disediakan oleh pengguna ketika fungsi dijalankan, kecuali default untuk parameter ditentukan.
Tentukan nama parameter dengan menggunakan tanda (@) sebagai karakter pertama. Nama parameter harus mematuhi aturan untuk pengidentifikasi. Parameter bersifat lokal untuk fungsi; nama parameter yang sama dapat digunakan dalam fungsi lain. Parameter hanya dapat menggantikan konstanta; mereka tidak dapat digunakan alih-alih nama tabel, nama kolom, atau nama objek database lainnya.
ANSI_WARNINGS
tidak dihormati saat Anda meneruskan parameter dalam prosedur tersimpan, fungsi yang ditentukan pengguna, atau saat Anda mendeklarasikan dan mengatur variabel dalam pernyataan batch. Misalnya, jika variabel didefinisikan sebagai karakter(3), lalu diatur ke nilai yang lebih besar dari tiga karakter, data dipotong ke ukuran yang ditentukan dan INSERT
pernyataan atau UPDATE
berhasil.
[ type_schema_name . ] parameter_data_type
Jenis data parameter, dan secara opsional skema tempat data tersebut berada. Untuk fungsi Transact-SQL, semua jenis data, termasuk jenis yang ditentukan pengguna CLR dan jenis tabel yang ditentukan pengguna, diizinkan kecuali jenis data tanda waktu. Untuk fungsi CLR, semua jenis data, termasuk jenis yang ditentukan pengguna CLR, diizinkan kecuali teks, ntext, gambar, jenis tabel yang ditentukan pengguna, dan jenis data tanda waktu. Jenis nonscalar, kursor, dan tabel, tidak dapat ditentukan sebagai jenis data parameter dalam fungsi Transact-SQL atau CLR.
Jika type_schema_name tidak ditentukan, Mesin Database mencari scalar_parameter_data_type dalam urutan berikut:
- Skema yang berisi nama jenis data sistem SQL Server.
- Skema default pengguna saat ini dalam database saat ini.
- Skema dbo dalam database saat ini.
[ = default ]
Nilai default untuk parameter . Jika nilai default ditentukan, fungsi dapat dijalankan tanpa menentukan nilai untuk parameter tersebut.
Nilai parameter default dapat ditentukan untuk fungsi CLR, kecuali untuk jenis data varchar(max) dan varbinary(max ).
Ketika parameter fungsi memiliki nilai default, kata kunci DEFAULT
harus ditentukan ketika fungsi dipanggil untuk mengambil nilai default. Perilaku ini berbeda dari menggunakan parameter dengan nilai default dalam prosedur tersimpan di mana menghilangkan parameter juga menyiratkan nilai default. Namun, DEFAULT
kata kunci tidak diperlukan saat memanggil fungsi skalar dengan menggunakan EXECUTE
pernyataan .
READONLY
Menunjukkan bahwa parameter tidak dapat diperbarui atau dimodifikasi dalam definisi fungsi. READONLY
diperlukan untuk parameter jenis tabel yang ditentukan pengguna (TVP), dan tidak dapat digunakan untuk jenis parameter lainnya.
return_data_type
Nilai pengembalian fungsi skalar yang ditentukan pengguna. Untuk fungsi Transact-SQL, semua jenis data, termasuk jenis yang ditentukan pengguna CLR, diizinkan kecuali jenis data tanda waktu. Untuk fungsi CLR, semua jenis data, termasuk jenis yang ditentukan pengguna CLR, diizinkan kecuali jenis data teks, ntext, gambar, dan tanda waktu. Jenis, kursor, dan tabel nonscalar, tidak dapat ditentukan sebagai jenis data pengembalian dalam fungsi Transact-SQL atau CLR.
function_body
Menentukan bahwa serangkaian pernyataan Transact-SQL, yang bersama-sama tidak menghasilkan efek samping seperti memodifikasi tabel, menentukan nilai fungsi. function_body hanya digunakan dalam fungsi skalar dan fungsi bernilai tabel multi-pernyataan (MSTVF).
Dalam fungsi skalar, function_body adalah serangkaian pernyataan Transact-SQL yang bersama-sama mengevaluasi ke nilai skalar.
Dalam MSTVF, function_body adalah serangkaian pernyataan Transact-SQL yang mengisi TABLE
variabel pengembalian.
scalar_expression
Menentukan nilai skalar yang dikembalikan fungsi skalar.
TABLE
Menentukan bahwa nilai pengembalian fungsi bernilai tabel (TVF) adalah tabel. Hanya konstanta dan @local_variables yang dapat diteruskan ke TVF.
Dalam TVF sebaris, TABLE
nilai pengembalian didefinisikan melalui satu SELECT
pernyataan. Fungsi sebaris tidak memiliki variabel pengembalian terkait.
Dalam MSTVF, @return_variable adalah TABLE
variabel, digunakan untuk menyimpan dan mengakumulasi baris yang harus dikembalikan sebagai nilai fungsi. @ return_variable hanya dapat ditentukan untuk fungsi Transact-SQL dan bukan untuk fungsi CLR.
select_stmt
Pernyataan tunggal SELECT
yang menentukan nilai pengembalian fungsi bernilai tabel sebaris (TVF).
ORDER (<order_clause>)
Menentukan urutan di mana hasil dikembalikan dari fungsi bernilai tabel. Untuk informasi selengkapnya, lihat bagian , Gunakan urutan pengurutan dalam fungsi bernilai tabel CLR nanti di artikel ini.
ASSEMBLY_NAME METHOD_SPECIFIER> NAMA <EKSTERNAL.class_name.method_name
Berlaku untuk: SQL Server 2008 (10.0.x) SP 1 dan versi yang lebih baru.
Menentukan assembly dan metode yang akan dirujuk oleh nama fungsi yang dibuat.
assembly_name - harus cocok dengan nilai di
name
kolomSELECT * FROM sys.assemblies;
.Nama yang digunakan pada
CREATE ASSEMBLY
pernyataan.class_name - harus cocok dengan nilai di
assembly_name
kolomSELECT * FROM sys.assembly_modules;
.Sering kali nilai berisi titik atau titik yang disematkan. Dalam kasus seperti itu, sintaks Transact-SQL mengharuskan nilai dibatasi dengan sepasang tanda kurung siku (
[]
), atau dengan sepasang tanda kutip ganda (""
).method_name - harus cocok dengan nilai di
method_name
kolomSELECT * FROM sys.assembly_modules;
.Metode harus statis.
Dalam contoh umum untuk MyFood.dll
, di mana semua jenis berada di MyFood
namespace, nilainya EXTERNAL NAME
bisa menjadi MyFood.[MyFood.MyClass].MyStaticMethod
.
Secara default, SQL Server tidak dapat menjalankan kode CLR. Anda dapat membuat, memodifikasi, dan menghilangkan objek database yang mereferensikan modul runtime bahasa umum. Namun, Anda tidak dapat menjalankan referensi ini di SQL Server sampai Anda mengaktifkan opsi yang diaktifkan clr. Untuk mengaktifkan opsi ini, gunakan sp_configure. Opsi ini tidak tersedia dalam database mandiri.
<> table_type_definition ( { <column_definition><column_constraint | <> computed_column_definition } [ <table_constraint> ] [ , ...n ] )
Menentukan jenis data tabel untuk fungsi Transact-SQL. Deklarasi tabel menyertakan definisi kolom dan batasan kolom atau tabel. Tabel selalu dimasukkan ke dalam grup file utama.
<> clr_table_type_definition ( { column_namedata_type } [ , ...n ] )
Berlaku untuk: SQL Server 2008 (10.0.x) SP 1 dan versi yang lebih baru, dan Azure SQL Database (Pratinjau di beberapa wilayah).
Menentukan jenis data tabel untuk fungsi CLR. Deklarasi tabel hanya menyertakan nama kolom dan jenis data. Tabel selalu dimasukkan ke dalam grup file utama.
NULL | BUKAN NULL
Hanya didukung untuk fungsi yang dikompilasi secara asli dan ditentukan pengguna skalar. Untuk informasi selengkapnya, lihat Fungsi Yang Ditentukan Pengguna Skalar untuk OLTP Dalam Memori.
NATIVE_COMPILATION
Menunjukkan apakah fungsi yang ditentukan pengguna dikompilasi secara asli. Argumen ini diperlukan untuk fungsi yang dikompilasi secara asli dan ditentukan pengguna skalar.
MULAI ATOM DENGAN
Diperlukan, dan hanya didukung, untuk fungsi yang ditentukan pengguna skalar yang dikompilasi secara asli. Untuk informasi selengkapnya, lihat Blok Atom dalam Prosedur Asli.
SCHEMABINDING
Argumen SCHEMABINDING
diperlukan untuk fungsi yang dikompilasi secara asli dan ditentukan pengguna skalar.
JALANKAN SEBAGAI
EXECUTE AS
diperlukan untuk fungsi yang dikompilasi secara asli dan ditentukan pengguna skalar.
<> function_option ::= dan <clr_function_option> ::=
Menentukan bahwa fungsi memiliki satu atau beberapa opsi berikut.
ENKRIPSI
Berlaku untuk: SQL Server 2008 (10.0.x) SP 1 dan versi yang lebih baru.
Menunjukkan bahwa Mesin Database mengonversi teks CREATE FUNCTION
asli pernyataan ke format yang dikaburkan. Output obfuscation tidak langsung terlihat dalam tampilan katalog apa pun. Pengguna yang tidak memiliki akses ke tabel sistem atau file database tidak dapat mengambil teks yang dikaburkan. Namun, teks tersedia untuk pengguna istimewa yang dapat mengakses tabel sistem melalui koneksi Diagnostik untuk administrator database atau langsung mengakses file database. Selain itu, pengguna yang dapat melampirkan debugger ke proses server dapat mengambil prosedur asli dari memori saat runtime. Untuk informasi selengkapnya tentang mengakses metadata sistem, lihat Konfigurasi Visibilitas Metadata.
Menggunakan opsi ini mencegah fungsi diterbitkan sebagai bagian dari replikasi SQL Server. Opsi ini tidak dapat ditentukan untuk fungsi CLR.
SCHEMABINDING
Menentukan bahwa fungsi terikat ke objek database yang dirujuknya. Ketika SCHEMABINDING
ditentukan, objek dasar tidak dapat dimodifikasi dengan cara yang akan memengaruhi definisi fungsi. Definisi fungsi itu sendiri harus terlebih dahulu dimodifikasi atau dihilangkan untuk menghapus dependensi pada objek yang akan dimodifikasi.
Pengikatan fungsi ke objek yang dirujuknya dihapus hanya ketika ne dari tindakan berikut terjadi:
- Fungsi dihilangkan.
- Fungsi dimodifikasi dengan menggunakan
ALTER
pernyataan dengan opsi yangSCHEMABINDING
tidak ditentukan.
Fungsi dapat terikat skema hanya jika kondisi berikut benar:
- Fungsi ini adalah fungsi Transact-SQL.
- Fungsi dan tampilan yang ditentukan pengguna yang dirujuk oleh fungsi juga terikat skema.
- Objek yang dirujuk oleh fungsi dirujuk menggunakan nama dua bagian.
- Fungsi dan objek yang dirujuknya milik database yang sama.
- Pengguna yang menjalankan
CREATE FUNCTION
pernyataan memilikiREFERENCES
izin pada objek database yang dirujuk fungsi.
MENGEMBALIKAN NULL PADA INPUT NULL | DIPANGGIL PADA INPUT NULL
OnNULLCall
Menentukan atribut fungsi skalar. Jika tidak ditentukan, CALLED ON NULL INPUT
tersirat secara default. Dengan kata lain, isi fungsi dijalankan bahkan jika NULL
diteruskan sebagai argumen.
Jika RETURNS NULL ON NULL INPUT
ditentukan dalam fungsi CLR, itu menunjukkan bahwa SQL Server dapat mengembalikan NULL
ketika salah satu argumen yang diterimanya adalah NULL
, tanpa benar-benar memanggil isi fungsi. Jika metode fungsi CLR yang ditentukan dalam <method_specifier>
sudah memiliki atribut kustom yang menunjukkan RETURNS NULL ON NULL INPUT
, tetapi CREATE FUNCTION
pernyataan menunjukkan CALLED ON NULL INPUT
, pernyataan diutamakan CREATE FUNCTION
. Atribut OnNULLCall
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
JALANKAN SEBAGAI
Menentukan konteks keamanan tempat fungsi yang ditentukan pengguna dijalankan. Oleh karena itu, Anda dapat mengontrol akun pengguna mana yang digunakan SQL Server untuk memvalidasi izin pada objek database apa pun yang dirujuk oleh fungsi.
EXECUTE AS
tidak dapat ditentukan untuk fungsi bernilai tabel sebaris.
Untuk informasi selengkapnya, lihat EXECUTE AS Clause (Transact-SQL).
INLINE = { AKTIF | NONAKTIF }
Berlaku untuk: SQL Server 2019 (15.x) dan versi yang lebih baru, dan Azure SQL Database.
Menentukan apakah UDF skalar ini harus di-inlin atau tidak. Klausa ini hanya berlaku untuk fungsi skalar yang ditentukan pengguna. Klausul INLINE
ini tidak wajib. INLINE
Jika klausul tidak ditentukan, klausul tersebut secara otomatis diatur ke ON
atau OFF
berdasarkan apakah UDF tidak sebaris. Jika INLINE = ON
ditentukan tetapi UDF ditemukan tidak sebaris, kesalahan akan muncul. Untuk informasi selengkapnya, lihat Scalar UDF Inlining.
<> column_definition ::=
Menentukan jenis data tabel. Deklarasi tabel mencakup definisi kolom dan batasan. Untuk fungsi CLR, hanya column_name dan data_type yang dapat ditentukan.
column_name
Nama kolom dalam tabel. Nama kolom harus mematuhi aturan untuk pengidentifikasi dan harus unik dalam tabel. column_name dapat terdiri dari 1 hingga 128 karakter.
data_type
Menentukan jenis data kolom. Untuk fungsi Transact-SQL, semua jenis data, termasuk jenis yang ditentukan pengguna CLR, diizinkan kecuali tanda waktu. Untuk fungsi CLR, semua jenis data, termasuk jenis yang ditentukan pengguna CLR, diizinkan kecuali teks, ntext, gambar, karakter, varchar, varchar(maks), dan tanda waktu. Kursor jenis nonscalar tidak dapat ditentukan sebagai jenis data kolom dalam fungsi Transact-SQL atau CLR.
constant_expression DEFAULT
Menentukan nilai yang disediakan untuk kolom saat nilai tidak disediakan secara eksplisit selama penyisipan. constant_expression adalah nilai fungsi konstanta, NULL
, atau sistem. DEFAULT
definisi dapat diterapkan ke kolom apa pun kecuali yang memiliki IDENTITY
properti . DEFAULT
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
MENYUSUN collation_name
Menentukan kolas untuk kolom. Jika tidak ditentukan, kolom diberi kolase default database. Nama kolase dapat berupa nama kolase Windows atau nama kolase SQL. Untuk daftar dan informasi selengkapnya tentang kolase, lihat Nama Kolase Windows (Transact-SQL) dan Nama Kolase SQL Server (Transact-SQL).
Klausa COLLATE
dapat digunakan untuk mengubah kolase hanya kolom jenis data karakter, varchar, nchar, dan nvarchar . COLLATE
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
ROWGUIDCOL
Menunjukkan bahwa kolom baru adalah kolom pengidentifikasi unik secara global baris. Hanya satu kolom pengidentifikasi unik per tabel yang dapat ditetapkan sebagai ROWGUIDCOL
kolom. Properti ROWGUIDCOL
hanya dapat ditetapkan ke kolom pengidentifikasi unik.
Properti ROWGUIDCOL
tidak memberlakukan keunikan nilai yang disimpan dalam kolom. Ini juga tidak secara otomatis menghasilkan nilai untuk baris baru yang disisipkan ke dalam tabel. Untuk menghasilkan nilai unik untuk setiap kolom, gunakan NEWID
fungsi pada INSERT
pernyataan. Nilai default dapat ditentukan; namun, NEWID
tidak dapat ditentukan sebagai default.
IDENTITY
Menunjukkan bahwa kolom baru adalah kolom identitas. Saat baris baru ditambahkan ke tabel, SQL Server menyediakan nilai unik dan bertahap untuk kolom tersebut. Kolom identitas biasanya digunakan bersama dengan PRIMARY KEY
batasan untuk berfungsi sebagai pengidentifikasi baris unik untuk tabel. Properti IDENTITY
dapat ditetapkan ke kolom tinyint, smallint, int, bigint, decimal(p,0), atau numerik(p,0). Hanya satu kolom identitas yang dapat dibuat per tabel. Default dan DEFAULT
batasan terikat tidak dapat digunakan dengan kolom identitas. Anda harus menentukan benih dan kenaikan atau tidak. Jika tidak ditentukan, defaultnya adalah (1,1).
IDENTITY
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
biji
Nilai bilangan bulat yang akan ditetapkan ke baris pertama dalam tabel.
Kenaikan
Nilai bilangan bulat untuk ditambahkan ke nilai seed untuk baris berturut-turut dalam tabel.
<> column_constraint ::= dan <table_constraint> ::=
Menentukan batasan untuk kolom atau tabel tertentu. Untuk fungsi CLR, satu-satunya jenis batasan yang diizinkan adalah NULL
. Batasan bernama tidak diizinkan.
NULL | BUKAN NULL
Menentukan apakah nilai null diizinkan dalam kolom. NULL
bukan batasan yang ketat tetapi dapat ditentukan seperti NOT NULL
. NOT NULL
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
KUNCI PRIMER
Batasan yang memberlakukan integritas entitas untuk kolom tertentu melalui indeks unik. Dalam fungsi yang ditentukan pengguna bernilai tabel, PRIMARY KEY
batasan hanya dapat dibuat pada satu kolom per tabel. PRIMARY KEY
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
UNIQUE
Batasan yang menyediakan integritas entitas untuk kolom atau kolom tertentu melalui indeks unik. Tabel dapat memiliki beberapa UNIQUE
batasan. UNIQUE
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
BERKLUSTER | NONCLUSTERED
Menunjukkan bahwa indeks berkluster atau non-kluster dibuat untuk PRIMARY KEY
atau UNIQUE
batasan. PRIMARY KEY
batasan menggunakan CLUSTERED
, dan UNIQUE
batasan menggunakan NONCLUSTERED
.
CLUSTERED
hanya dapat ditentukan untuk satu batasan. Jika CLUSTERED
ditentukan untuk UNIQUE
batasan dan PRIMARY KEY
batasan juga ditentukan, PRIMARY KEY
gunakan NONCLUSTERED
.
CLUSTERED
dan NONCLUSTERED
tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
CHECK
Batasan yang memberlakukan integritas domain dengan membatasi kemungkinan nilai yang dapat dimasukkan ke dalam kolom atau kolom. CHECK
batasan tidak dapat ditentukan untuk fungsi bernilai tabel CLR.
logical_expression
Ekspresi logis yang mengembalikan TRUE
atau FALSE
.
<> computed_column_definition ::=
Menentukan kolom komputasi. Untuk informasi selengkapnya tentang kolom komputasi, lihat CREATE TABLE (Transact-SQL).
column_name
Nama kolom komputasi.
computed_column_expression
Ekspresi yang menentukan nilai kolom komputasi.
<> index_option ::=
Menentukan opsi indeks untuk PRIMARY KEY
indeks atau UNIQUE
. Untuk informasi selengkapnya tentang opsi indeks, lihat CREATE INDEX (Transact-SQL).
PAD_INDEX = { ON | NONAKTIF }
Menentukan padding indeks. Default adalah OFF
.
FILLFACTOR = fillfactor
Menentukan persentase yang menunjukkan seberapa lengkap Mesin Database harus membuat tingkat daun setiap halaman indeks selama pembuatan atau perubahan indeks. fillfactor harus berupa nilai bilangan bulat dari 1 hingga 100. Defaultnya adalah 0.
IGNORE_DUP_KEY = { AKTIF | NONAKTIF }
Menentukan respons kesalahan saat operasi sisipkan mencoba menyisipkan nilai kunci duplikat ke dalam indeks unik. Opsi IGNORE_DUP_KEY
hanya berlaku untuk menyisipkan operasi setelah indeks dibuat atau dibangun kembali. Default adalah OFF
.
STATISTICS_NORECOMPUTE = { AKTIF | NONAKTIF }
Menentukan apakah statistik distribusi dikomputasi ulang. Default adalah OFF
.
ALLOW_ROW_LOCKS = { AKTIF | NONAKTIF }
Menentukan apakah kunci baris diizinkan. Default adalah ON
.
ALLOW_PAGE_LOCKS = { AKTIF | NONAKTIF }
Menentukan apakah kunci halaman diizinkan. Default adalah ON
.
Praktik terbaik
Jika fungsi yang ditentukan pengguna tidak dibuat dengan SCHEMABINDING
klausul, perubahan yang dilakukan pada objek yang mendasar dapat memengaruhi definisi fungsi dan menghasilkan hasil yang tidak terduga saat dipanggil. Kami menyarankan agar Anda menerapkan salah satu metode berikut untuk memastikan bahwa fungsi tidak menjadi usang karena perubahan pada objek yang mendasarnya:
WITH SCHEMABINDING
Tentukan klausa saat Anda membuat fungsi. Opsi ini memastikan bahwa objek yang dirujuk dalam definisi fungsi tidak dapat dimodifikasi, kecuali fungsi juga dimodifikasi.Jalankan prosedur tersimpan sp_refreshsqlmodule setelah memodifikasi objek apa pun yang ditentukan dalam definisi fungsi.
Untuk informasi selengkapnya dan pertimbangan performa tentang fungsi bernilai tabel sebaris (TVF sebaris) dan fungsi bernilai tabel multi-pernyataan (MSTVF), lihat Membuat fungsi yang ditentukan pengguna (Mesin Database).
Jenis data
Jika parameter ditentukan dalam fungsi CLR, parameter tersebut harus berupa jenis SQL Server seperti yang didefinisikan sebelumnya untuk scalar_parameter_data_type. Untuk informasi selengkapnya membandingkan jenis data sistem SQL Server dengan jenis data integrasi CLR, atau jenis data runtime bahasa umum .NET Framework, lihat Memetakan Data Parameter CLR.
Agar SQL Server mereferensikan metode yang benar ketika kelebihan beban di kelas, metode yang ditunjukkan harus <method_specifier>
memiliki karakteristik berikut:
- Terima jumlah parameter yang sama seperti yang ditentukan dalam
[ , ...n ]
. - Terima semua parameter menurut nilai, bukan dengan referensi.
- Gunakan jenis parameter yang kompatibel dengan jenis yang ditentukan dalam fungsi SQL Server.
Jika jenis data pengembalian fungsi CLR menentukan jenis tabel (RETURNS TABLE
), jenis data pengembalian metode harus <method_specifier>
berjenis IEnumerator
atau IEnumerable
, dan mengasumsikan bahwa antarmuka diimplementasikan oleh pembuat fungsi. Tidak seperti fungsi Transact-SQL, fungsi CLR tidak dapat menyertakan PRIMARY KEY
, , UNIQUE
atau CHECK
batasan dalam <table_type_definition>
. Jenis data kolom yang ditentukan di <table_type_definition>
harus cocok dengan jenis kolom terkait dari kumpulan hasil yang dikembalikan oleh metode pada <method_specifier>
waktu eksekusi. Pemeriksaan tipe ini tidak dilakukan pada saat fungsi dibuat.
Untuk informasi selengkapnya tentang cara memprogram fungsi CLR, lihat Fungsi yang Ditentukan Pengguna CLR.
Keterangan
Fungsi skalar dapat dipanggil di mana ekspresi skalar digunakan, yang mencakup kolom komputasi dan CHECK
definisi batasan. Fungsi skalar juga dapat dijalankan dengan menggunakan pernyataan EXECUTE (Transact-SQL ). Fungsi skalar harus dipanggil dengan menggunakan setidaknya nama dua bagian fungsi (<schema>.<function>
). Untuk informasi selengkapnya tentang nama multipihak, lihat Konvensi Sintaks Transact-SQL (Transact-SQL). Fungsi bernilai tabel dapat dipanggil di mana ekspresi tabel diizinkan dalam klausul SELECT
pernyataan , , INSERT
UPDATE
, atau DELETE
.FROM
Untuk informasi selengkapnya, lihat Menjalankan fungsi yang ditentukan pengguna.
Interoperabilitas
Pernyataan berikut valid dalam fungsi:
- Pernyataan penugasan.
- Pernyataan Control-of-Flow kecuali
TRY...CATCH
pernyataan. DECLARE
pernyataan yang menentukan variabel data lokal dan kursor lokal.SELECT
pernyataan yang berisi daftar pilihan dengan ekspresi yang menetapkan nilai ke variabel lokal.- Operasi kursor mereferensikan kursor lokal yang dideklarasikan, dibuka, ditutup, dan dibatalkan alokasinya dalam fungsi. Hanya
FETCH
pernyataan yang menetapkan nilai ke variabel lokal menggunakanINTO
klausul yang diizinkan;FETCH
pernyataan yang mengembalikan data ke klien tidak diizinkan. INSERT
,UPDATE
, danDELETE
pernyataan yang memodifikasi variabel tabel lokal.EXECUTE
pernyataan yang memanggil prosedur tersimpan yang diperluas.
Untuk informasi selengkapnya, lihat Membuat fungsi yang ditentukan pengguna (Mesin Database).
Interoperabilitas kolom komputasi
Fungsi memiliki properti berikut. Nilai properti ini menentukan apakah fungsi dapat digunakan dalam kolom komputasi yang dapat dipertahankan atau diindeks.
Properti | Deskripsi | Catatan |
---|---|---|
IsDeterministic |
Fungsi deterministik atau nondeterministik. | Akses data lokal diizinkan dalam fungsi deterministik. Misalnya, fungsi yang selalu mengembalikan hasil yang sama setiap kali dipanggil menggunakan sekumpulan nilai input tertentu, dan dengan status database yang sama akan diberi label deterministik. |
IsPrecise |
Fungsinya tepat atau tidak tepat. | Fungsi yang tidak tepat berisi operasi seperti operasi floating point. |
IsSystemVerified |
Properti presisi dan determinisme fungsi dapat diverifikasi oleh SQL Server. | |
SystemDataAccess |
Fungsi mengakses data sistem (katalog sistem atau tabel sistem virtual) dalam instans lokal SQL Server. | |
UserDataAccess |
Fungsi mengakses data pengguna dalam instans lokal SQL Server. | Termasuk tabel yang ditentukan pengguna dan tabel sementara, tetapi bukan variabel tabel. |
Properti presisi dan determinisme fungsi Transact-SQL ditentukan secara otomatis oleh SQL Server. Properti akses data dan determinisme fungsi CLR dapat ditentukan oleh pengguna. Untuk informasi selengkapnya, lihat Integrasi CLR: atribut kustom untuk rutinitas CLR.
Untuk menampilkan nilai saat ini untuk properti ini, gunakan OBJECTPROPERTYEX (Transact-SQL).
Penting
Fungsi harus dibuat dengan SCHEMABINDING
menjadi deterministik.
Kolom komputasi yang memanggil fungsi yang ditentukan pengguna dapat digunakan dalam indeks saat fungsi yang ditentukan pengguna memiliki nilai properti berikut:
IsDeterministic
istrue
IsSystemVerified
adalahtrue
(kecuali kolom komputasi dipertahankan)UserDataAccess
isfalse
SystemDataAccess
isfalse
Untuk informasi selengkapnya, lihat Indeks pada kolom komputasi.
Memanggil prosedur tersimpan yang diperluas dari fungsi
Prosedur tersimpan yang diperluas, saat memanggilnya dari dalam fungsi, tidak dapat mengembalikan tataan hasil ke klien. API ODS apa pun yang mengembalikan tataan hasil ke klien, kembalikan FAIL
. Prosedur tersimpan yang diperluas dapat terhubung kembali ke instans SQL Server; namun, seharusnya tidak mencoba menggabungkan transaksi yang sama dengan fungsi yang memanggil prosedur tersimpan yang diperpanjang.
Mirip dengan pemanggilan dari batch atau prosedur tersimpan, prosedur tersimpan yang diperluas dijalankan dalam konteks akun keamanan Windows tempat SQL Server berjalan. Pemilik prosedur tersimpan harus mempertimbangkan skenario ini saat memberikan EXECUTE
izin kepada pengguna.
Batasan
Fungsi yang ditentukan pengguna tidak dapat digunakan untuk melakukan tindakan yang mengubah status database.
Fungsi yang ditentukan pengguna tidak boleh berisi OUTPUT INTO
klausul yang memiliki tabel sebagai targetnya.
Pernyataan Service Broker berikut tidak dapat disertakan dalam definisi fungsi yang ditentukan pengguna Transact-SQL:
BEGIN DIALOG CONVERSATION
END CONVERSATION
GET CONVERSATION GROUP
MOVE CONVERSATION
RECEIVE
SEND
Fungsi yang ditentukan pengguna dapat ditumpuk; artinya, satu fungsi yang ditentukan pengguna dapat memanggil fungsi lain. Tingkat berlapis bertahpa ketika fungsi yang disebut memulai eksekusi, dan dikurangi ketika fungsi yang dipanggil menyelesaikan eksekusi. Fungsi yang ditentukan pengguna dapat ditumpuk hingga 32 tingkat. Melebihi tingkat maksimum bersarang menyebabkan seluruh rantai fungsi panggilan gagal. Referensi apa pun ke kode terkelola dari fungsi yang ditentukan pengguna Transact-SQL dihitung sebagai satu tingkat terhadap batas berlapis 32 tingkat. Metode yang dipanggil dari dalam kode terkelola tidak dihitung terhadap batas ini.
Menggunakan urutan pengurutan dalam fungsi bernilai tabel CLR
Saat menggunakan ORDER
klausa dalam fungsi bernilai tabel CLR, ikuti panduan berikut:
Anda harus memastikan bahwa hasil selalu diurutkan dalam urutan yang ditentukan. Jika hasilnya tidak dalam urutan yang ditentukan, SQL Server menghasilkan pesan kesalahan saat kueri dijalankan.
ORDER
Jika klausa ditentukan, output fungsi bernilai tabel harus diurutkan sesuai dengan kolase kolom (eksplisit atau implisit). Misalnya, jika kolase kolom adalah Bahasa Tionghoa, hasil yang dikembalikan harus diurutkan sesuai dengan aturan pengurutan Bahasa Tionghoa. (Kolase ditentukan baik di DDL untuk fungsi bernilai tabel, atau diperoleh dari kolase database.)SQL Server selalu memverifikasi
ORDER
klausul jika ditentukan, saat mengembalikan hasil, apakah prosesor kueri menggunakannya untuk melakukan pengoptimalan lebih lanjut atau tidak. Hanya gunakanORDER
klausa jika Anda tahu bahwa klausul tersebut berguna untuk prosesor kueri.Prosesor kueri SQL Server memanfaatkan
ORDER
klausul secara otomatis dalam kasus berikut:- Sisipkan kueri di mana
ORDER
klausa kompatibel dengan indeks. ORDER BY
klausa yang kompatibel denganORDER
klausa.- Agregat, di mana
GROUP BY
kompatibel denganORDER
klausul. DISTINCT
agregat di mana kolom yang berbeda kompatibel denganORDER
klausa.
- Sisipkan kueri di mana
Klausa ORDER
tidak menjamin hasil yang SELECT
diurutkan saat kueri dijalankan, kecuali ORDER BY
juga ditentukan dalam kueri. Lihat sys.function_order_columns (Transact-SQL) untuk informasi tentang cara mengkueri kolom yang disertakan dalam urutan pengurutan untuk fungsi bernilai tabel.
Metadata
Tabel berikut mencantumkan tampilan katalog sistem yang bisa Anda gunakan untuk mengembalikan metadata tentang fungsi yang ditentukan pengguna.
Tampilan sistem | Deskripsi |
---|---|
sys.sql_modules | Lihat contoh E di bagian Contoh. |
sys.assembly_modules | Menampilkan informasi tentang fungsi yang ditentukan pengguna CLR. |
sys.parameters | Menampilkan informasi tentang parameter yang ditentukan dalam fungsi yang ditentukan pengguna. |
sys.sql_expression_dependencies | Menampilkan objek yang mendasar yang dirujuk oleh fungsi. |
Izin
CREATE FUNCTION
Memerlukan izin dalam database dan ALTER
izin pada skema tempat fungsi sedang dibuat. Jika fungsi menentukan jenis yang ditentukan pengguna, memerlukan EXECUTE
izin pada jenis tersebut.
Contoh
Untuk contoh dan pertimbangan performa selengkapnya tentang UDF, lihat Membuat fungsi yang ditentukan pengguna (Mesin Database).
J. Menggunakan fungsi bernilai skalar yang ditentukan pengguna yang menghitung minggu ISO
Contoh berikut membuat fungsi ISOweek
yang ditentukan pengguna . Fungsi ini mengambil argumen tanggal dan menghitung nomor minggu ISO. Agar fungsi ini dihitung dengan benar, SET DATEFIRST 1
harus dipanggil sebelum fungsi dipanggil.
Contohnya juga menunjukkan penggunaan klausul EXECUTE AS Clause (Transact-SQL) untuk menentukan konteks keamanan tempat prosedur tersimpan dapat dijalankan. Dalam contoh, opsi CALLER
menentukan bahwa prosedur dijalankan dalam konteks pengguna yang memanggilnya. Opsi lain yang dapat Anda tentukan adalah SELF
, , OWNER
dan user_name.
Berikut adalah panggilan fungsi. DATEFIRST
diatur ke 1
.
CREATE FUNCTION dbo.ISOweek (@DATE DATETIME)
RETURNS INT
WITH EXECUTE AS CALLER
AS
BEGIN
DECLARE @ISOweek INT;
SET @ISOweek = DATEPART(wk, @DATE) + 1 -
DATEPART(wk, CAST(DATEPART(yy, @DATE) AS CHAR(4)) + '0104');
--Special cases: Jan 1-3 may belong to the previous year
IF (@ISOweek = 0)
SET @ISOweek = dbo.ISOweek(CAST(DATEPART(yy, @DATE) - 1 AS CHAR(4))
+ '12' + CAST(24 + DATEPART(DAY, @DATE) AS CHAR(2))) + 1;
--Special case: Dec 29-31 may belong to the next year
IF ((DATEPART(mm, @DATE) = 12)
AND ((DATEPART(dd, @DATE) - DATEPART(dw, @DATE)) >= 28))
SET @ISOweek = 1;
RETURN (@ISOweek);
END;
GO
SET DATEFIRST 1;
SELECT dbo.ISOweek(CONVERT(DATETIME, '12/26/2004', 101)) AS 'ISO Week';
Berikut set hasilnya.
ISO Week
----------------
52
B. Membuat fungsi bernilai tabel sebaris
Contoh berikut mengembalikan fungsi bernilai tabel sebaris dalam database AdventureWorks2022. Ini mengembalikan tiga kolom ProductID
, Name
, dan agregat total tahun ke tanggal berdasarkan penyimpanan untuk YTD Total
setiap produk yang dijual ke toko.
CREATE FUNCTION Sales.ufn_SalesByStore (@storeid INT)
RETURNS TABLE
AS
RETURN (
SELECT P.ProductID, P.Name, SUM(SD.LineTotal) AS 'Total'
FROM Production.Product AS P
INNER JOIN Sales.SalesOrderDetail AS SD ON SD.ProductID = P.ProductID
INNER JOIN Sales.SalesOrderHeader AS SH ON SH.SalesOrderID = SD.SalesOrderID
INNER JOIN Sales.Customer AS C ON SH.CustomerID = C.CustomerID
WHERE C.StoreID = @storeid
GROUP BY P.ProductID, P.Name
);
GO
Untuk memanggil fungsi, jalankan kueri ini.
SELECT * FROM Sales.ufn_SalesByStore (602);
C. Membuat fungsi bernilai tabel multi-pernyataan
Contoh berikut membuat fungsi fn_FindReports(InEmpID)
bernilai tabel dalam AdventureWorks2022
database. Ketika disediakan dengan ID karyawan yang valid, fungsi mengembalikan tabel yang sesuai dengan semua karyawan yang melaporkan kepada karyawan baik secara langsung maupun tidak langsung. Fungsi ini menggunakan ekspresi tabel umum rekursif (CTE) untuk menghasilkan daftar hierarkis karyawan. Untuk informasi selengkapnya tentang CTE rekursif, lihat WITH common_table_expression (Transact-SQL).
CREATE FUNCTION dbo.ufn_FindReports (@InEmpID INT)
RETURNS @retFindReports TABLE (
EmployeeID INT PRIMARY KEY NOT NULL,
FirstName NVARCHAR(255) NOT NULL,
LastName NVARCHAR(255) NOT NULL,
JobTitle NVARCHAR(50) NOT NULL,
RecursionLevel INT NOT NULL
)
--Returns a result set that lists all the employees who report to the
--specific employee directly or indirectly.
AS
BEGIN
WITH EMP_cte (
EmployeeID,
OrganizationNode,
FirstName,
LastName,
JobTitle,
RecursionLevel
) -- CTE name and columns
AS (
-- Get the initial list of Employees for Manager n
SELECT e.BusinessEntityID,
OrganizationNode = ISNULL(e.OrganizationNode, CAST('/' AS HIERARCHYID)),
p.FirstName,
p.LastName,
e.JobTitle,
0
FROM HumanResources.Employee e
INNER JOIN Person.Person p
ON p.BusinessEntityID = e.BusinessEntityID
WHERE e.BusinessEntityID = @InEmpID
UNION ALL
-- Join recursive member to anchor
SELECT e.BusinessEntityID,
e.OrganizationNode,
p.FirstName,
p.LastName,
e.JobTitle,
RecursionLevel + 1
FROM HumanResources.Employee e
INNER JOIN EMP_cte
ON e.OrganizationNode.GetAncestor(1) = EMP_cte.OrganizationNode
INNER JOIN Person.Person p
ON p.BusinessEntityID = e.BusinessEntityID
)
-- Copy the required columns to the result of the function
INSERT @retFindReports
SELECT EmployeeID,
FirstName,
LastName,
JobTitle,
RecursionLevel
FROM EMP_cte
RETURN
END;
GO
-- Example invocation
SELECT EmployeeID,
FirstName,
LastName,
JobTitle,
RecursionLevel
FROM dbo.ufn_FindReports(1);
GO
D. Membuat fungsi CLR
Contoh membuat fungsi len_s
CLR . Sebelum fungsi dibuat, rakitan SurrogateStringFunction.dll
terdaftar di database lokal.
Berlaku untuk: SQL Server 2008 (10.0.x) SP 1 dan versi yang lebih baru.
DECLARE @SamplesPath NVARCHAR(1024);
-- You may have to modify the value of this variable if you have
-- installed the sample in a location other than the default location.
SELECT @SamplesPath = REPLACE(physical_name,
'Microsoft SQL Server\MSSQL13.MSSQLSERVER\MSSQL\DATA\master.mdf',
'Microsoft SQL Server\130\Samples\Engine\Programmability\CLR\'
)
FROM master.sys.database_files
WHERE name = 'master';
CREATE ASSEMBLY [SurrogateStringFunction]
FROM @SamplesPath + 'StringManipulate\CS\StringManipulate\bin\debug\SurrogateStringFunction.dll'
WITH PERMISSION_SET = EXTERNAL_ACCESS;
GO
CREATE FUNCTION [dbo].[len_s] (@str NVARCHAR(4000))
RETURNS BIGINT
AS
EXTERNAL NAME [SurrogateStringFunction].[Microsoft.Samples.SqlServer.SurrogateStringFunction].[LenS];
GO
Untuk contoh cara membuat fungsi bernilai tabel CLR, lihat Fungsi Bernilai Tabel CLR.
E. Menampilkan definisi fungsi yang ditentukan pengguna
SELECT DEFINITION,
type
FROM sys.sql_modules AS m
INNER JOIN sys.objects AS o
ON m.object_id = o.object_id
AND type IN ('FN', 'IF', 'TF');
GO
Definisi fungsi yang dibuat dengan menggunakan ENCRYPTION
opsi tidak dapat dilihat dengan menggunakan sys.sql_modules
; namun, informasi lain tentang fungsi terenkripsi ditampilkan.
Konten terkait
- Membuat fungsi yang ditentukan pengguna (Mesin Database)
- ALTER FUNCTION (Transact-SQL)
- DROP FUNCTION (Transact-SQL)
- OBJECTPROPERTYEX (Transact-SQL)
- sys.sql_modules (Transact-SQL)
- sys.assembly_modules (T-SQL)
- EXECUTE (Transact-SQL)
- Fungsi yang Ditentukan Pengguna CLR
- EVENTDATA (Transact-SQL)
- MEMBUAT KEBIJAKAN KEAMANAN (Transact-SQL)