> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> يتيح قراءة البيانات المعروضة عبر خادم Apache Arrow Flight والكتابة إليها.

# arrowFlight

يتيح قراءة البيانات المعروضة عبر خادم [Apache Arrow Flight](/ar/concepts/features/interfaces/arrowflight) والكتابة إليها.

**الصيغة**

```sql theme={null}
arrowFlight('host:port', 'dataset_name' [, 'username', 'password'])
```

**الوسيطات**

* `host:port` — عنوان خادم Arrow Flight. إذا لم يُحدَّد المنفذ، فسيُستخدم المنفذ الافتراضي `8815`. [String](/ar/reference/data-types/string).
* `dataset_name` — اسم مجموعة البيانات أو الواصف المتاح على خادم Arrow Flight. [String](/ar/reference/data-types/string).
* `username` — اسم المستخدم للمصادقة الأساسية عبر HTTP. [String](/ar/reference/data-types/string).
* `password` — كلمة المرور للمصادقة الأساسية عبر HTTP. [String](/ar/reference/data-types/string).

إذا لم يتم تحديد `username` و`password`، فلن تُستخدم المصادقة (ولا يعمل ذلك إلا إذا كان خادم Arrow Flight يسمح بالوصول دون مصادقة).

تدعم الدالة أيضًا [named collections](/ar/concepts/features/configuration/server-config/named-collections) — راجع [ArrowFlight table engine](/ar/reference/engines/table-engines/integrations/arrowflight#named-collections) للاطلاع على قائمة المعلمات المدعومة.

**القيمة المعادة**

كائن table يمثّل مجموعة البيانات البعيدة. يُستدل على المخطط تلقائيًا من خادم Arrow Flight.

**الإعدادات**

* `arrow_flight_request_descriptor_type` — يتحكم في كيفية إرسال اسم مجموعة البيانات إلى خادم Flight. القيم: `path` (الافتراضي) أو `command`. راجع [ArrowFlight table engine](/ar/reference/engines/table-engines/integrations/arrowflight#settings) للتفاصيل.

**أمثلة**

القراءة من خادم Arrow Flight بعيد:

```sql title="Query" theme={null}
SELECT * FROM arrowFlight('127.0.0.1:9005', 'sample_dataset') ORDER BY id;
```

```text title="Response" theme={null}
┌─id─┬─name────┬─value─┐
│  1 │ foo     │ 42.1  │
│  2 │ bar     │ 13.3  │
│  3 │ baz     │ 77.0  │
└────┴─────────┴───────┘
```

إدراج البيانات في خادم Arrow Flight بعيد:

```sql theme={null}
INSERT INTO FUNCTION arrowFlight('127.0.0.1:9005', 'sample_dataset') VALUES (4, 'qux', 99.9);
```

استخدام مجموعة مسمّاة:

```sql theme={null}
SELECT * FROM arrowFlight(named_collection_name);
```

**انظر أيضًا**

* [محرك الجدول ArrowFlight](/ar/reference/engines/table-engines/integrations/arrowflight)
* [واجهة Arrow Flight](/ar/concepts/features/interfaces/arrowflight)
* [مواصفة Apache Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html)