مشاركة عبر


ملحقات PostgreSQL في Azure Cosmos DB ل PostgreSQL

هام

لم يعد Azure Cosmos DB ل 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

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
البلد وزعت Citus قاعدة البيانات. 9.5 10.2 11.3 12.1 12.1 12.1

ملحقات أنواع البيانات

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
اقتباس يوفر نوع سلسلة أحرف غير حساس لحالة الأحرف. 1.5 1.6 1.6 1.6 1.6 1.6
مكعب يوفر نوع بيانات للمكعبات متعددة الأبعاد. 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
يسن يوفر أنواع البيانات لمعايير ترقيم المنتجات الدولية. 1.2 1.2 1.2 1.2 1.2 1.2
لو صيانة عنصر كبير. 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
عسر الهضم نوع البيانات للتراكم عبر الإنترنت للإحصاءات المستندة إلى الرتبة مثل الكميات والوسائل المقطوعة. 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

ملحقات البحث عن نص كامل

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 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
غير لائق قاموس بحث نصي يزيل علامات التشكيل من المفردات. 1.1 1.1 1.1 1.1 1.1 1.1

ملحقات الوظائف

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 15
autoinc وظائف لحقول التزايد التلقائي. 1.0 1.0 1.0 1.0 1.0 1.0
تماثل الأرض يوفر وسيلة لحساب مسافات الدائرة الكبرى على سطح الأرض. 1.1 1.1 1.1 1.1 1.1 1.1
تطابق غير واضح يوفر العديد من الوظائف لتحديد أوجه التشابه والمسافة بين السلاسل. 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
علامة تشعبات مُجمّع عدد صحيح وعدّد (عفا عليه الزمن). 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
وقت التعديل وظائف لتتبع وقت التعديل الأخير. 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

ملحقات أنواع الفهرس

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
وردة طريقة وصول بلوم - فهرس مستند إلى ملف التوقيع. 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

ملحقات اللغة

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
plpgsql لغة إجرائية PL/pgSQL قابلة للتحميل. 1.0 1.0 1.0 1.0 1.0 1.0

ملحقات متنوعة

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
تحديد خانة الاختيار وظائف للتحقق من سلامة العلاقة. 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

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 16
pgvector البحث عن تشابه المتجهات مفتوحة المصدر ل Postgres 0.5.1 0.7.0 0.7.0 0.7.0 0.7.0 0.7.0

ملحقات PostGIS

الملحق الوصف الصفحة 11 الصفحة 12 الصفحة 13 الصفحة 14 الصفحة 15 الصفحة 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 وpostgres_fdw للاتصال من خادم PostgreSQL إلى آخر، أو بقاعدة بيانات أخرى في نفس الخادم. يحتاج الخادم المستلم إلى السماح إجراء الاتصالات من خلال الخادم المرسل عبر جدار الحماية الخاص به. لاستخدام هذه الملحقات للاتصال بين Azure Cosmos DB لمجموعات PostgreSQL مع الوصول العام، قم بتعيين السماح لخدمات وموارد Azure بالوصول إلى نظام المجموعة هذا (أو الخادم) إلى ON. تحتاج أيضاً إلى تشغيل هذا الإعداد إذا كنت تريد استخدام الملحقات للرجوع إلى نفس الخادم. يمكن العثور على إعداد السماح لخدمات وموارد Azure بالوصول إلى نظام المجموعة هذا في صفحة مدخل Microsoft Azure للمجموعة ضمن Networking. حاليا، الاتصالات الصادرة من Azure Cosmos DB ل PostgreSQL غير مدعومة.

ملحق orafce

يتم تعطيل utl_file الدالات في ملحق orafce.

الخطوات التالية