مشاركة عبر

ملحق Azure الذكاء الاصطناعي في قاعدة بيانات Azure ل PostgreSQL

تمكنك قاعدة بيانات Azure لملحق PostgreSQL ل Azure الذكاء الاصطناعي من استخدام نماذج اللغة الكبيرة (LLMS) وإنشاء تطبيقات الذكاء الاصطناعي التوليدية الغنية داخل قاعدة البيانات.  يتيح ملحق Azure الذكاء الاصطناعي لقاعدة البيانات الاتصال بخدمات Azure الذكاء الاصطناعي المختلفة بما في ذلك Azure OpenAI وخدمات Azure المعرفية التي تبسط عملية التطوير مما يسمح بالتكامل السلس في هذه الخدمات.

تمكين ملحق azure_ai

قبل أن تتمكن من التمكين azure_ai على قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن، تحتاج إلى إضافته إلى قائمة السماح الخاصة بك كما هو موضح في كيفية استخدام ملحقات PostgreSQL والتحقق مما إذا تمت إضافتها بشكل صحيح عن طريق تشغيل SHOW azure.extensions;.

تلميح

قد تحتاج أيضا إلى تمكين الملحقpgvector لأنه شائع الاستخدام مع azure_ai.

ثم يمكنك تثبيت الملحق، عن طريق الاتصال بقاعدة البيانات الهدف وتشغيل الأمر CREATE EXTENSION . تحتاج إلى تكرار الأمر بشكل منفصل لكل قاعدة بيانات تريد أن يكون الملحق متوفرا فيها.

CREATE EXTENSION IF NOT EXISTS azure_ai;

ملاحظة

لإزالة الملحق من قاعدة البيانات المتصلة حاليا، استخدم DROP EXTENSION azure_ai;.

يؤدي تثبيت الملحق azure_ai إلى إنشاء المخططات الثلاثة التالية:

  • azure_ai: المخطط الأساسي حيث يوجد جدول التكوين والوظائف للتفاعل معه.
  • azure_openai: الوظائف والأنواع المركبة المتعلقة ب OpenAI.
  • azure_cognitive: الوظائف والأنواع المركبة المتعلقة بالخدمات المعرفية.

يسمح الملحق أيضا باستدعاء Azure OpenAI وAzure Cognitive Services.

تكوين ملحق azure_ai

يتطلب تكوين الملحق توفير نقاط النهاية للاتصال بخدمات Azure الذكاء الاصطناعي ومفاتيح واجهة برمجة التطبيقات المطلوبة للمصادقة. يتم تخزين إعدادات الخدمة باستخدام الوظائف التالية:

الأذونات

مفاتيح الوصول إلى Azure الذكاء الاصطناعي مشابهة لكلمة مرور الجذر لحسابك. كن حذرًا دائمًا لحماية مفاتيح الوصول خاصتك. استخدم Azure Key Vault لإدارة المفاتيح وتدويرها بأمان. لإدارة مفاتيح الخدمة المستخدمة من قبل الملحق، يطلب azure_ai_settings_manager المستخدمون الدور الممنوح لهم. تتطلب الدالات التالية الدور:

  • azure_ai.set_setting
  • azure_ai.get_setting

azure_ai_settings_manager يتم منح الدور بشكل افتراضي للدورazure_pg_admin.

azure_ai.set_setting

يستخدم لتعيين خيارات التكوين.

azure_ai.set_setting(key TEXT, value TEXT)

الوسيطات

key

اسم خيار التكوين. القيم الصالحة key ل هي:

  • azure_openai.endpoint: نقطة نهاية OpenAI المدعومة (على سبيل المثال، https://example.openai.azure.com).
  • azure_openai.subscription_key: مفتاح اشتراك لمورد OpenAI.
  • azure_cognitive.endpoint: نقطة نهاية الخدمات المعرفية المدعومة (على سبيل المثال، https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: مفتاح اشتراك لمورد الخدمات المعرفية.
value

TEXT يمثل القيمة المطلوبة للإعداد المحدد.

azure_ai.get_setting

يستخدم للحصول على القيم الحالية لخيارات التكوين.

azure_ai.get_setting(key TEXT)

الوسيطات

المفتاح

اسم خيار التكوين. القيم الصالحة key ل هي:

  • azure_openai.endpoint: نقطة نهاية OpenAI المدعومة (على سبيل المثال، https://example.openai.azure.com).
  • azure_openai.subscription_key: مفتاح اشتراك لمورد OpenAI.
  • azure_cognitive.endpoint: نقطة نهاية الخدمات المعرفية المدعومة (على سبيل المثال، https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: مفتاح اشتراك لمورد الخدمات المعرفية.

نوع الإرجاع

TEXT يمثل القيمة الحالية للإعداد المحدد.

azure_ai.version

azure_ai.version()

نوع الإرجاع

TEXT يمثل الإصدار الحالي من ملحق Azure الذكاء الاصطناعي.

الأمثلة

تعيين نقطة النهاية ومفتاح API ل Azure OpenAI

select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com'); 
select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');

الحصول على نقطة النهاية ومفتاح API ل Azure OpenAI

select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');

تحقق من إصدار ملحق Azure الذكاء الاصطناعي

select azure_ai.version();

الأذونات

azure_ai يعرف الملحق دورا يسمى azure_ai_settings_manager، والذي يمكن قراءة وكتابة الإعدادات المتعلقة بالملحق. يمكن فقط للمستخدمين الخارقين وأعضاء azure_ai_settings_manager الدور استدعاء azure_ai.get_settings الدالتين و azure_ai.set_settings . في قاعدة بيانات Azure لمثيلات الخادم المرنة PostgreSQL، يتم azure_ai_settings_manager تعيين الدور لجميع مستخدمي المسؤول.

ترقية ملحق azure الذكاء الاصطناعي

يمكن أن تقدم الإصدارات الأحدث من الملحق وظائف جديدة ويسمح بالترقيات الموضعية للملحق. يمكنك مقارنة الإصدار المثبت حاليا بأحدث إصدار مسموح به باستخدام أمر SQL:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

لتحديث ملحق مثبت إلى أحدث إصدار متوفر مدعوم من Azure، استخدم أمر SQL التالي:

ALTER EXTENSION azure_ai UPDATE;

المحتوى ذو الصلة

  • Last updated on