mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2026-10-28 16:18:23 +08:00
90 lines
4.1 KiB
Plaintext
90 lines
4.1 KiB
Plaintext
---
|
|
description: 'توثيق FUNCTION'
|
|
sidebarTitle: 'FUNCTION'
|
|
slug: /sql-reference/statements/create/function
|
|
title: 'CREATE FUNCTION'
|
|
doc_type: 'مرجع'
|
|
---
|
|
|
|
{/*AUTOGENERATED_START*/}
|
|
|
|
ينشئ دالة معرّفة من قبل المستخدم (دالة معرّفة من قبل المستخدم) من تعبير لامبدا. ويجب أن يتألف هذا التعبير من معاملات الدالة أو الثوابت أو المعاملات أو استدعاءات دوال أخرى.
|
|
|
|
**الصياغة**
|
|
|
|
```sql
|
|
CREATE [OR REPLACE] FUNCTION name [ON CLUSTER cluster] AS (parameter0, ...) -> expression
|
|
```
|
|
|
|
يمكن أن تحتوي الدالة على أي عدد من المعاملات.
|
|
|
|
توجد بعض القيود:
|
|
|
|
* يجب أن يكون اسم الدالة فريدًا بين الدوال المعرّفة من قبل المستخدم ودوال النظام.
|
|
* الدوال العودية غير مسموح بها.
|
|
* يجب تحديد جميع المتغيرات التي تستخدمها الدالة ضمن قائمة معاملاتها.
|
|
|
|
إذا تم انتهاك أي قيد، فسيتم رفع استثناء.
|
|
|
|
**مثال**
|
|
|
|
```sql title="Query"
|
|
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
|
|
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);
|
|
```
|
|
|
|
```text title="Response"
|
|
┌─number─┬─plus(multiply(2, number), 1)─┐
|
|
│ 0 │ 1 │
|
|
│ 1 │ 3 │
|
|
│ 2 │ 5 │
|
|
└────────┴──────────────────────────────┘
|
|
```
|
|
|
|
تُستدعى [دالة شرطية](/ar/reference/functions/regular-functions/conditional-functions) ضمن دالة معرّفة من قبل المستخدم في الاستعلام التالي:
|
|
|
|
```sql title="Query"
|
|
CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
|
|
SELECT number, parity_str(number) FROM numbers(3);
|
|
```
|
|
|
|
```text title="Response"
|
|
┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
|
|
│ 0 │ even │
|
|
│ 1 │ odd │
|
|
│ 2 │ even │
|
|
└────────┴──────────────────────────────────────┘
|
|
```
|
|
|
|
استبدِل دالة معرّفة من قبل المستخدم موجودة:
|
|
|
|
```sql title="Query"
|
|
CREATE FUNCTION exampleReplaceFunction AS frame -> frame;
|
|
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
|
|
CREATE OR REPLACE FUNCTION exampleReplaceFunction AS frame -> frame + 1;
|
|
SELECT create_query FROM system.functions WHERE name = 'exampleReplaceFunction';
|
|
```
|
|
|
|
```text title="Response"
|
|
┌─create_query─────────────────────────────────────────────┐
|
|
│ CREATE FUNCTION exampleReplaceFunction AS frame -> frame │
|
|
└──────────────────────────────────────────────────────────┘
|
|
|
|
┌─create_query───────────────────────────────────────────────────┐
|
|
│ CREATE FUNCTION exampleReplaceFunction AS frame -> (frame + 1) │
|
|
└────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
<div id="related-content">
|
|
## محتوى ذو صلة
|
|
</div>
|
|
|
|
<div id="executable-udfs">
|
|
### [دوال معرّفة من قبل المستخدم القابلة للتنفيذ](/ar/reference/functions/regular-functions/udf).
|
|
</div>
|
|
|
|
<div id="user-defined-functions-in-clickhouse-cloud">
|
|
### [الدوال المعرّفة من قبل المستخدم في ClickHouse Cloud](https://clickhouse.com/blog/user-defined-functions-clickhouse-udfs)
|
|
</div>
|
|
|
|
{/*AUTOGENERATED_END*/} |