عرض مصدر SQL/create function

<noinclude>{{DISPLAYTITLE:إنشاء دالة CREATE FUNCTION في SQL}}</noinclude>
يستخدم هذا الأمر لتعريف دالة جديدة، وله البنية العامّة الآتية:<syntaxhighlight lang="sql">
CREATE  [ OR REPLACE ] FUNCTION name ( [[argmode] [ argname ] argtype [, ...] ] )   [RETURNS rettype]
AS 'definition'

</syntaxhighlight>إذ ينشئ هذا الأمر دالةً جديدةً (أو يستبدلها في حال وجود دالة سابقة) باسم <code>name</code> وتوضع معاملاتها ما بين القوسين وذلك بتحديد نوع المعامل <code>argmode</code> (كدخل <code>IN</code> أو خرج <code>OUT</code> أو دخل وخرج معًا <code>INOUT</code>) ومن ثم اسم المعامل <code>argname</code> ونوع قيمته <code>argtype</code> وكما يمكن تحديد نوع القيمة المُعادة <code>rettype</code>.

== أمثلة ==
لإنشاء دالة باسم add لجمع عددين صحيحين وإعادة الناتج، يُستخدَم الأمر:<syntaxhighlight lang="sql">
CREATE FUNCTION add(x INTEGER, y INTEGER) RETURNS INTEGER AS
  RETURN x + y;

</syntaxhighlight>لإنشاء دالة باسم hello تعيد العبارة النصية Hello مضافةً لها السلسلة s التي تدخل للدالة في لائحة المعاملات، يُستخدَم الأمر:<syntaxhighlight lang="sql">
CREATE FUNCTION hello (s VARCHAR(20)) RETURNS VARCHAR(50) AS
  RETURN CONCAT('Hello, ',s,'!');

</syntaxhighlight>إذ إن الدالة <code>CONCAT</code> تستخدم للربط ما بين السلاسل النصية التي تدخل في معاملاتها.

لإنشاء دالة باسم <code>get_count</code> تعيد عدد السجلات الموجودة في جدول <code>students</code> عبر متحول باسم <code>num</code>، يُستخدَم الأمر:<syntaxhighlight lang="sql">
CREATE FUNCTION get_count (OUT num INTEGER) AS
SELECT COUNT(*) INTO num FROM students;

</syntaxhighlight>

== التوافقية ==
{| class="wikitable"
!SQLServer
!SQLite
!Oracle
!PostgreSQL
!MySQL
|-
|نعم
|لا
|نعم
|نعم
|نعم
|}
لا يدعم محرك SQLite الأمر <code>CREATE FUNCTION</code> ويمكن القيام بذلك اعتمادًا على لغة البرمجة C.

== مصادر ==
* [https://dev.mysql.com/doc/refman/5.7/en/create-procedure.html توثيق CREATE FUNCTION في محرك MySQL]
* [https://www.postgresql.org/docs/10/static/sql-createfunction.html توثيق CREATE FUNCTION في محرك PostgreSQL]
* [https://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_5009.htm توثيق CREATE FUNCTION في محرك Oracle]
* [https://docs.microsoft.com/en-us/sql/t-sql/statements/create-function-transact-sql توثيق CREATE FUNCTION في محرك SQLServer]
[[تصنيف:SQL]]
[[تصنيف:SQL Functions]]