Aracılığıyla paylaş

PostgreSQL için Azure Veritabanı'nda Azure AI uzantısı

Azure AI için PostgreSQL için Azure Veritabanı uzantısı, büyük dil modellerini (LLMS) kullanmanıza ve veritabanında zengin üretken yapay zeka uygulamaları oluşturmanıza olanak tanır.  Azure AI uzantısı, veritabanının Azure OpenAI ve Azure Bilişsel Hizmetler dahil olmak üzere çeşitli Azure yapay zeka hizmetlerini çağırmasını sağlar ve geliştirme sürecini basitleştirerek bu hizmetlerle sorunsuz tümleştirme sağlar.

azure_ai uzantısını etkinleştirme

PostgreSQL için Azure Veritabanı esnek sunucu örneğinizde etkinleştirmeden azure_ai önce, PostgreSQL uzantılarını kullanma konusunda açıklandığı gibi bunu izin verilenler listenize eklemeniz ve komutunu çalıştırarak SHOW azure.extensions;doğru eklenip eklenmediğini denetlemeniz gerekir.

İpucu

pgvector uzantısını, azure_ai ile yaygın olarak kullanıldığı için etkinleştirmek isteyebilirsiniz.

Ardından hedef veritabanınıza bağlanıp CREATE EXTENSION komutunu çalıştırarak uzantıyı yükleyebilirsiniz. Uzantının kullanılabilir olmasını istediğiniz her veritabanı için komutu ayrı ayrı yinelemeniz gerekir.

CREATE EXTENSION IF NOT EXISTS azure_ai;

Not

Uzantıyı şu anda bağlı olan veritabanından kaldırmak için kullanın DROP EXTENSION azure_ai;.

Uzantının azure_ai yüklenmesi aşağıdaki üç şemayı oluşturur:

  • azure_ai: yapılandırma tablosunun bulunduğu asıl şema ve onunla etkileşime geçmek için işlevler.
  • azure_openai: OpenAI ile ilgili işlevler ve bileşik türler.
  • azure_cognitive: Bilişsel Hizmetler ile ilgili işlevler ve bileşik türler.

Uzantı, Azure OpenAI ve Azure Bilişsel Hizmetler'i çağırmaya da olanak tanır.

azure_ai uzantısını yapılandırma

Uzantıyı yapılandırmak için Azure AI hizmetlerine bağlanmak için uç noktaları ve kimlik doğrulaması için gereken API anahtarlarını sağlamanız gerekir. Hizmet ayarları aşağıdaki işlevler kullanılarak depolanır:

İzinler

Azure AI erişim anahtarlarınız hesabınızın kök parolasına benzer. Erişim anahtarlarınızı korumak için her zaman dikkatli olun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek için Azure Key Vault'ı kullanın. Uzantıdaki hizmet anahtarlarını yönetmek için kullanıcılara azure_ai_settings_manager rolünün verilmesi gerekir. Aşağıdaki işlevler rol gerektirir:

  • azure_ai.set_setting
  • azure_ai.get_setting

Rol azure_ai_settings_manager varsayılan olarak azure_pg_admin rolüne verilir.

azure_ai.set_setting

Yapılandırma seçeneklerini ayarlamak için kullanılır.

azure_ai.set_setting(key TEXT, value TEXT)

Argümanlar

key

Yapılandırma seçeneğinin adı. için key geçerli değerler şunlardır:

  • azure_openai.endpoint: Desteklenen OpenAI uç noktası (örneğin, https://example.openai.azure.com).
  • azure_openai.subscription_key: OpenAI kaynağı için abonelik anahtarı.
  • azure_cognitive.endpoint: Desteklenen Bilişsel Hizmetler uç noktası (örneğin, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Bilişsel Hizmetler kaynağı için abonelik anahtarı.
value

TEXT seçili ayarın istenen değerini temsil ediyor.

azure_ai.get_setting

Yapılandırma seçeneklerinin geçerli değerlerini almak için kullanılır.

azure_ai.get_setting(key TEXT)

Argümanlar

Anahtar

Yapılandırma seçeneğinin adı. için key geçerli değerler şunlardır:

  • azure_openai.endpoint: Desteklenen OpenAI uç noktası (örneğin, https://example.openai.azure.com).
  • azure_openai.subscription_key: OpenAI kaynağı için abonelik anahtarı.
  • azure_cognitive.endpoint: Desteklenen Bilişsel Hizmetler uç noktası (örneğin, https://example.cognitiveservices.azure.com).
  • azure_cognitive.subscription_key: Bilişsel Hizmetler kaynağı için abonelik anahtarı.

Dönüş türü

TEXT seçili ayarın geçerli değerini temsil ediyor.

azure_ai.version

azure_ai.version()

Dönüş türü

TEXT Azure AI uzantısının geçerli sürümünü temsil ediyor.

Örnekler

Azure OpenAI için Uç Nokta ve API Anahtarı ayarlama

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

Azure OpenAI için Uç Nokta ve API Anahtarını alma

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

Azure AI uzantısı sürümünü denetleme

select azure_ai.version();

İzinler

Uzantı, azure_ai uzantıyla ilgili ayarların okunmasını ve yazılmasını sağlayan adlı azure_ai_settings_managerbir rol tanımlar. Yalnızca süper kullanıcılar ve azure_ai_settings_manager rolünün üyeleri azure_ai.get_settings ve azure_ai.set_settings işlevlerini çağırabilir. PostgreSQL için Azure Veritabanı esnek sunucu örneklerinde, tüm yönetici kullanıcıların azure_ai_settings_manager rolü atanmıştır.

Azure AI uzantısını yükseltme

Uzantının daha yeni sürümleri yeni işlevsellik sunabilir ve uzantının yerinde yükseltmelere izin verilir. SQL komutunu kullanarak şu anda yüklü olan sürümü izin verilen en yeni sürümle karşılaştırabilirsiniz:

SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'

Yüklü bir uzantıyı Azure tarafından desteklenen en son kullanılabilir sürüme güncelleştirmek için aşağıdaki SQL komutunu kullanın:

ALTER EXTENSION azure_ai UPDATE;

İlgili içerik

  • Last updated on