Bagikan melalui

Ekstensi Azure AI di Azure Database for PostgreSQL

BERLAKU UNTUK: Azure Database for PostgreSQL - Flexible Server

Ekstensi server fleksibel Azure Database for PostgreSQL untuk Azure AI memungkinkan Anda menggunakan model bahasa besar (LLMS) dan membangun aplikasi AI generatif yang kaya dalam database.  Ekstensi Azure AI memungkinkan database untuk memanggil berbagai layanan Azure AI termasuk Azure OpenAI dan Azure Cognitive Services yang menyederhanakan proses pengembangan yang memungkinkan integrasi yang mulus ke dalam layanan tersebut.

Mengaktifkan ekstensi azure_ai

Sebelum Anda dapat mengaktifkan azure_ai instans server fleksibel Azure Database for PostgreSQL, Anda perlu menambahkannya ke daftar yang diizinkan seperti yang dijelaskan dalam cara menggunakan ekstensi PostgreSQL dan memeriksa apakah ditambahkan dengan benar dengan menjalankan SHOW azure.extensions;.

Petunjuk / Saran

Anda mungkin juga ingin mengaktifkan pgvector ekstensi karena umumnya digunakan dengan azure_ai.

Kemudian Anda dapat menginstal ekstensi, dengan menyambungkan ke database target Anda dan menjalankan perintah CREATE EXTENSION . Anda perlu mengulangi perintah secara terpisah untuk setiap database yang Anda inginkan agar ekstensi tersedia.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Nota

Untuk menghapus ekstensi dari database yang saat ini tersambung, gunakan DROP EXTENSION azure_ai;.

Menginstal ekstensi azure_ai membuat tiga skema berikut:

  • azure_ai: skema utama tempat tabel konfigurasi berada dan berfungsi untuk berinteraksi dengannya.
  • azure_openai: fungsi dan jenis komposit yang terkait dengan OpenAI.
  • azure_cognitive: fungsi dan jenis komposit yang terkait dengan Cognitive Services.

Ekstensi ini juga memungkinkan panggilan Azure OpenAI dan Azure Cognitive Services.

Konfigurasi ekstensi azure_ai

Mengonfigurasi ekstensi mengharuskan Anda menyediakan titik akhir untuk terhubung ke layanan Azure AI dan kunci API yang diperlukan untuk autentikasi. Pengaturan layanan disimpan menggunakan fungsi berikut:

Hak akses

Kunci akses Azure AI Anda mirip dengan kata sandi root untuk akun Anda. Selalu berhati-hatilah untuk melindungi kunci akses Anda. Gunakan Azure Key Vault untuk mengelola dan memutar kunci Anda dengan aman. Pengguna memerlukan peran yang diberikan kepada mereka azure_ai_settings_manager untuk mengelola kunci layanan yang digunakan oleh ekstensi. Fungsi berikut memerlukan peran:

  • azure_ai.setel_pengaturan
  • azure_ai.get_setting

Peran azure_ai_settings_manager secara default diberikan kepada peran azure_pg_admin.

azure_ai.set_setting

Digunakan untuk mengatur opsi konfigurasi.

azure_ai.set_setting(key TEXT, value TEXT)

Argumen

key

Nama opsi konfigurasi. Nilai valid untuk key adalah:

  • azure_openai.endpoint: Titik akhir OpenAI yang didukung (misalnya, https://example.openai.azure.com).
  • azure_openai.subscription_key: Kunci langganan untuk sumber daya OpenAI.
  • azure_cognitive.endpoint: Titik akhir Cognitive Services yang didukung (misalnya, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Kunci langganan untuk sumber daya Cognitive Services.
value

TEXT mewakili nilai yang diinginkan dari pengaturan yang dipilih.

azure_ai.get_setting

Digunakan untuk mendapatkan nilai opsi konfigurasi saat ini.

azure_ai.get_setting(key TEXT)

Argumen

Kunci

Nama opsi konfigurasi. Nilai valid untuk key adalah:

  • azure_openai.endpoint: Titik akhir OpenAI yang didukung (misalnya, https://example.openai.azure.com).
  • azure_openai.subscription_key: Kunci langganan untuk sumber daya OpenAI.
  • azure_cognitive.endpoint: Titik akhir Cognitive Services yang didukung (misalnya, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Kunci langganan untuk sumber daya Cognitive Services.

Tipe pengembalian

TEXT mewakili nilai pengaturan yang dipilih saat ini.

azure_ai.version

azure_ai.version()

Tipe pengembalian

TEXT mewakili versi ekstensi Azure AI saat ini.

Contoh

Mengatur Titik Akhir dan Kunci API untuk 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>');

Mendapatkan Titik Akhir dan Kunci API untuk Azure OpenAI

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

Periksa versi ekstensi Azure AI

select azure_ai.version();

Hak akses

azure_ai Ekstensi mendefinisikan peran yang disebut azure_ai_settings_manager, yang memungkinkan pembacaan dan penulisan pengaturan yang terkait dengan ekstensi. Hanya pengguna super dan anggota dari peran azure_ai_settings_manager yang dapat memanggil fungsi azure_ai.get_settings dan azure_ai.set_settings. Di server fleksibel Azure Database untuk PostgreSQL, semua pengguna admin diberikan peran azure_ai_settings_manager.

Meningkatkan ekstensi Azure AI

Versi ekstensi yang lebih baru bisa memperkenalkan fungsionalitas baru dan peningkatan langsung ekstensi diperbolehkan. Anda dapat membandingkan versi yang saat ini diinstal dengan versi terbaru yang diizinkan dengan menggunakan perintah SQL:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Untuk memperbarui ekstensi yang diinstal ke versi terbaru yang tersedia yang didukung oleh Azure, gunakan perintah SQL berikut:

ALTER EXTENSION azure_ai UPDATE;

Konten terkait