ملحقات PostgreSQL في Azure Cosmos DB ل PostgreSQL
ينطبق على: 
Azure Cosmos DB ل PostgreSQL (مدعوم بملحق قاعدة بيانات Citus إلى PostgreSQL)
يقوم PostgreSQL بتوسيع وظائف قاعدة البيانات باستخدام الملحقات. تسمح الملحقات بتجميع العديد من عناصر SQL ذات الصلة معاً في حزمة واحدة يمكن تحميلها أو إزالتها من قاعدة البيانات باستخدام أمر واحد. يُمكن أن تعمل الامتدادات مثل الميزات المضمنة، بعد تحميلها في قاعدة البيانات. لمزيد من المعلومات بشأن ملحقات PostgreSQL، راجع تجميع العناصر ذات الصلة في ملحق.
استخدم ملحقات PostgreSQL
يجب تثبيت ملحقات PostgreSQL في قاعدة البيانات الخاصة بك قبل أن تصبح لديك الإمكانية لاستخدامها. لتثبيت ملحق معين، قم بتشغيل الأمر CREATE EXTENSION من أداة psql لتحميل العناصر المحزومة في قاعدة البيانات الخاصة بك.
إشعار
إذا فشل CREATE EXTENSION مع ظهور خطأ رفض الإذن، فجرّب الوظيفة create_extension() بدلاً من ذلك. على سبيل المثال،
SELECT create_extension('postgis');
لإزالة ملحق مثبت بهذه الطريقة، استخدم drop_extension().
يدعم Azure Cosmos DB ل PostgreSQL حاليا مجموعة فرعية من ملحقات المفاتيح كما هو موضح هنا. لا يتم دعم الإضافات بخلاف تلك المدرجة. لا يمكنك إنشاء ملحقك الخاص باستخدام Azure Cosmos DB ل PostgreSQL.
الملحقات التي يدعمها Azure Cosmos DB ل PostgreSQL
تسرد الجداول التالية ملحقات PostgreSQL القياسية المدعومة على Azure Cosmos DB ل PostgreSQL. تتوفر هذه المعلومات أيضا عن طريق إجراء عملية التشغيل SELECT * FROM pg_available_extensions;.
تختلف إصدارات كل ملحق مثبت في نظام مجموعة أحيانا استنادا إلى إصدار PostgreSQL (11 أو 12 أو 13 أو 14 أو 15 أو 16). الجداول قائمة إصدارات ملحق لكل إصدار قاعدة البيانات.
تمديد Citus
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| البلد | وزعت Citus قاعدة البيانات. | 9.5 | 10.2 | 11.3 | 12.1 | 12.1 | 12.1 |
ملحقات أنواع البيانات
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| citext | يوفر نوع سلسلة أحرف غير حساس لحالة الأحرف. | 1.5 | 1.6 | 1.6 | 1.6 | 1.6 | 1.6 |
| cube | يوفر نوع بيانات للمكعبات متعددة الأبعاد. | 1.4 | 1.4 | 1.4 | 1.5 | 1.5 | 1.5 |
| hll | يوفر بنية بيانات HyperLogLog. | 2.18 | 2.18 | 2.18 | 2.18 | 2.18 | 2.18 |
| hstore | يوفر نوع بيانات لتخزين مجموعات من أزواج المفتاح والقيمة. | 1.5 | 1.6 | 1.7 | 1.8 | 1.8 | 1.8 |
| isn | يوفر أنواع البيانات لمعايير ترقيم المنتجات الدولية. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| lo | صيانة عنصر كبير. | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
| ltree | يوفر نوع بيانات للبنى الهرمية الشبيهة بالأشجار. | 1.1 | 1.1 | 1.2 | 1.2 | 1.2 | 1.2 |
| مقطع | نوع البيانات لتمثيل مقاطع الخط أو فترات الفاصلة العائمة. | 1.3 | 1.3 | 1.3 | 1.4 | 1.4 | 1.4 |
| tdigest | نوع البيانات للتراكم عبر الإنترنت للإحصاءات المستندة إلى الرتبة مثل الكميات والوسائل المقطوعة. | 1.4.1 | 1.4.1 | 1.4.1 | 1.4.1 | 1.4.1 | 1.4.1 |
| أعلى | نوع لـ top-n JSONB. | 2.6.0 | 2.6.0 | 2.6.0 | 2.6.0 | 2.6.0 | 2.6.0 |
ملحقات البحث عن نص كامل
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| dict_int | يوفر قالب قاموس بحث نصي للأعداد الصحيحة. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| dict_xsyn | قالب قاموس البحث عن النص لمعالجة المرادفات الموسعة. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| unaccent | قاموس بحث نصي يزيل علامات التشكيل من المفردات. | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
ملحقات الوظائف
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 15 |
|---|---|---|---|---|---|---|---|
| autoinc | وظائف لحقول التزايد التلقائي. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| earthdistance | يوفر وسيلة لحساب مسافات الدائرة الكبرى على سطح الأرض. | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
| fuzzystrmatch | يوفر العديد من الوظائف لتحديد أوجه التشابه والمسافة بين السلاسل. | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.2 |
| insert_username | وظائف لتتبع من قام بتغيير الجدول. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| intagg | مُجمّع عدد صحيح وعدّد (عفا عليه الزمن). | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
| intarray | يوفر وظائف وعوامل لمعالجة المصفوفات الخالية من الأعداد الصحيحة. | 1.2 | 1.2 | 1.3 | 1.5 | 1.5 | 1.5 |
| moddatetime | وظائف لتتبع وقت التعديل الأخير. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| orafce | الوظائف والمشغلين الذين يحاكيون مجموعة فرعية من الوظائف والحزم من Oracle RDBMS. | 4.9 | 4.9 | 4.9 | |||
| pg_partman | إدارة الجداول المُقسمة حسب الوقت أو المعرف. | 4.7.4 | 4.7.4 | 4.7.4 | 5.1.0 | 5.1.0 | 5.1.0 |
| pg_surgery | دوال لإجراء جراحة على علاقة تالفة. | 1.0 | 1.0 | 1.0 | |||
| pg_trgm | يوفر وظائف وعوامل لتحديد التشابه بين النص الأبجدي الرقمي بناءً على مطابقة الأشكال ثلاثية الأبعاد. | 1.4 | 1.4 | 1.5 | 1.6 | 1.6 | 1.6 |
| pgcrypto | يوفر وظائف التشفير. | 1.3 | 1.3 | 1.3 | 1.3 | 1.3 | 1.3 |
| إعادة الطباعة | وظائف لتنفيذ التكامل المرجعي (عفا عليها الزمن). | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| tablefunc | يوفر الدالات التي تعالج جداول بأكملها، بما في ذلك علامة تبويب متقاطعة. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| tcn | تم تشغيل إخطارات التغيير. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| السفر عبر الزمن | وظائف لتنفيذ السفر عبر الزمن. | 1.0 | |||||
| uuid-ossp | يولد معرّفات فريدة عالمياً (UUIDs). | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
ملحقات أنواع الفهرس
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| bloom | طريقة وصول بلوم - فهرس مستند إلى ملف التوقيع. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| btree_gin | يوفر نماذج فئات عامل تشغيل GIN التي تنفذ سلوكًا يشبه شجرة B لبعض أنواع البيانات. | 1.3 | 1.3 | 1.3 | 1.3 | 1.3 | 1.3 |
| btree_gist | يوفر فئات عامل تشغيل فهرس GiST التـي تنفذ شجرة B. | 1.5 | 1.5 | 1.5 | 1.6 | 1.7 | 1.7 |
ملحقات اللغة
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| plpgsql | لغة إجرائية PL/pgSQL قابلة للتحميل. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
ملحقات متنوعة
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| amcheck | وظائف للتحقق من سلامة العلاقة. | 1.1 | 1.2 | 1.2 | 1.3 | 1.3 | 1.3 |
| dblink | وحدة تدعم الاتصالات بقواعد بيانات PostgreSQL الأخرى من داخل جلسة قاعدة بيانات. راجع قسم "dblink وpostgres_fdw" للحصول على معلومات بشأن هذا الملحق. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| old_snapshot | يسمح بفحص حالة الخادم المستخدمة لتنفيذ old_snapshot_threshold. | 1.0 | 1.0 | 1.0 | |||
| pageinspect | افحص محتويات صفحات قاعدة البيانات بمستوى منخفض. | 1.7 | 1.7 | 1.8 | 1.9 | 1.11 | 1.12 |
| pg_azure_storage | تكامل Azure ل PostgreSQL. | 1.3 | 1.3 | 1.3 | 1.3 | ||
| pg_buffercache | يوفر وسيلة لفحص ما يحدث في ذاكرة التخزين المؤقت المشتركة في الوقت الحقيقي. | 1.3 | 1.3 | 1.3 | 1.3 | 1.3 | 1.4 |
| pg_cron | الجدول الزمني للوظائف لـ PostgreSQL. | 1.5 | 1.6 | 1.6 | 1.6 | 1.6 | 1.6 |
| pg_freespacemap | افحص خريطة المساحة الحرة (FSM). | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| pg_prewarm | يوفر طريقة لتحميل بيانات العلاقة في ذاكرة التخزين المؤقت. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| pg_stat_statements | يوفر وسيلة لتتبع إحصائيات التنفيذ لجميع جمل SQL التي يتم تنفيذها بواسطة الخادم. راجع قسم "pg_stat_statements" للحصول على معلومات بشأن هذا الملحق. | 1.6 | 1.7 | 1.8 | 1.9 | 1.10 | 1.10 |
| pg_visibility | افحص خريطة الرؤية (VM) ومعلومات الرؤية على مستوى الصفحة. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| pgrowlocks | يوفر وسيلة لإظهار معلومات القفل على مستوى الصف. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| pgstattuple | يوفر وسيلة لعرض إحصائيات على مستوى المجموعة. | 1.5 | 1.5 | 1.5 | 1.5 | 1.5 | 1.5 |
| postgres_fdw | غلاف البيانات الأجنبية المُستخدم للوصول إلى البيانات المخزنة في خوادم PostgreSQL الخارجية. راجع قسم "dblink وpostgres_fdw" للحصول على معلومات بشأن هذا الملحق. | 1.0 | 1.0 | 1.0 | 1.1 | 1.1 | 1.1 |
| sslinfo | معلومات بشأن شهادات TLS/SSL. | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 | 1.2 |
| tsm_system_rows | طريقة TABLESAMPLE، والتي تقبل عدد الصفوف كحد. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| tsm_system_time | طريقة TABLESAMPLE، والتي تقبل الوقت بالملّي ثانية كحد. | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 | 1.0 |
| xml2 | استعلام XPath وXSLT. | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 | 1.1 |
ملحق Pgvector
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| pgvector | البحث عن تشابه المتجهات مفتوحة المصدر ل Postgres | 0.5.1 | 0.7.0 | 0.7.0 | 0.7.0 | 0.7.0 | 0.7.0 |
ملحقات PostGIS
| الملحق | الوصف | PG 11 | PG 12 | PG 13 | PG 14 | PG 15 | PG 16 |
|---|---|---|---|---|---|---|---|
| PostGIS | العناصر المكانية والجغرافية لـ PostgreSQL. | 3.3.4 | 3.4.1 | 3.4.1 | 3.4.1 | 3.4.1 | 3.4.1 |
| address_standardizer | تستخدم لتحليل العنوان الخاص بالعناصر المكونة. يستخدم لدعم خطوة تسوية عنوان الترميز الجغرافي. | 3.3.4 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 |
| postgis_sfcgal | وظائف PostGIS SFCGAL. | 3.3.4 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 |
| postgis_topology | أنواع ووظائف طوبولوجيا PostGIS المكانية. | 3.3.4 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 | 3.4.2 |
pg_stat_statements
يتم تحميل ملحق pg_stat_statements مسبقا على كل Azure Cosmos DB لنظام مجموعة PostgreSQL لتزويدك بوسائل تعقب إحصائيات التنفيذ لعبارات SQL.
يتحكم الإعداد pg_stat_statements.track في العبارات التي يحسبها الملحق. الإعداد الافتراضي هو top، ما يعني أنه يتم تتبع جميع كشوف الحسابات الصادرة مباشرة من العملاء. هناك مستويان تعقب آخران هما none و all.
هناك مقايضة بين معلومات تنفيذ الاستعلام pg_stat_statements التي توفر وتؤثر على أداء الخادم كما أنه يسجل كل عبارة SQL. إذا كنت لا تستخدم الإضافة pg_stat_statements بشكل نشط، فإننا نوصي بتعيين pg_stat_statements.track على none. قد تعتمد بعض خدمات المراقبة التابعة لجهة خارجية على pg_stat_statements لتقديم نتائج تحليلات أداء الاستعلام، لذا تأكد ما إذا كان الأمر كذلك بالنسبة لك أم لا.
dblink and postgres_fdw
يُمكنك استخدام dblink وpostgres_fdw للاتصال من خادم PostgreSQL إلى آخر، أو بقاعدة بيانات أخرى في نفس الخادم. يحتاج الخادم المستلم إلى السماح إجراء الاتصالات من خلال الخادم المرسل عبر جدار الحماية الخاص به. لاستخدام هذه الملحقات للاتصال بين Azure Cosmos DB لمجموعات PostgreSQL مع الوصول العام، قم بتعيين السماح لخدمات وموارد Azure بالوصول إلى نظام المجموعة هذا (أو الخادم) إلى ON. تحتاج أيضاً إلى تشغيل هذا الإعداد إذا كنت تريد استخدام الملحقات للرجوع إلى نفس الخادم. يمكن العثور على إعداد السماح لخدمات وموارد Azure بالوصول إلى نظام المجموعة هذا في صفحة مدخل Microsoft Azure للمجموعة ضمن Networking. حاليا، الاتصالات الصادرة من Azure Cosmos DB ل PostgreSQL غير مدعومة.
ملحق orafce
يتم تعطيل utl_file الدالات في ملحق orafce.