PostgreSQL için Azure Veritabanı üzerinde Azure AI uzantısı - Esnek Sunucu

ŞUNLAR IÇIN GEÇERLIDIR: PostgreSQL için Azure Veritabanı - Esnek Sunucu

Azure AI için esnek sunucu uzantısı PostgreSQL için Azure Veritabanı, 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.

Uzantıyı azure_ai 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

Uzantıyı ile azure_aiyaygın olarak kullanıldığından pgvector da 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 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.

Uzantıyı azure_ai 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ı tarafından kullanılan hizmet anahtarlarını yönetmek için kullanıcılara rolün azure_ai_settings_manager verilmesini gerektirir. Aşağıdaki işlevler rol gerektirir:

• azure_ai.set_setting
• azure_ai.get_setting

Rol azure_ai_settings_manager varsayılan olarak role verilir azure_pg_admin .

azure_ai.set_setting

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

azure_ai.set_setting(key TEXT, value TEXT)

Bağımsız değişkenler

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)

Bağımsız değişkenler

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. ve işlevlerini yalnızca süper kullanıcılar ve rolün azure_ai.get_settings azure_ai.set_settings üyeleri azure_ai_settings_manager çağırabilir. Esnek PostgreSQL için Azure Veritabanı sunucuda, 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şlevlere neden olabilir ve uzantının yerinde yükseltmelerine 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;

Sonraki adımlar

Azure OpenAI ile vektör eklemeleri oluşturma