Extensão Azure AI no Banco de Dados do Azure para PostgreSQL - Servidor Flexível
APLICA-SE A:
Banco de Dados do Azure para PostgreSQL - Servidor Flexível
A extensão de servidor flexível do Banco de Dados do Azure para PostgreSQL para IA do Azure permite que você use modelos de linguagem grandes (LLMS) e crie aplicativos de IA generativos avançados no banco de dados. A extensão de IA do Azure permite que o banco de dados chame vários serviços de IA do Azure, incluindo o Azure OpenAI e os Serviços Cognitivos do Azure, simplificando o processo de desenvolvimento, permitindo uma integração perfeita nesses serviços.
Ativar a azure_ai extensão
Antes de habilitar em sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL, você precisa adicioná-lo azure_ai à sua lista de permissões, conforme descrito em como usar extensões PostgreSQL, e verificar se foi adicionado corretamente executando SHOW azure.extensions;.
Gorjeta
Você também pode querer habilitar a extensão, pois ela é comumente usada com azure_aio pgvector .
Em seguida, você pode instalar a extensão, conectando-se ao seu banco de dados de destino e executando o comando CREATE EXTENSION . Você precisa repetir o comando separadamente para cada banco de dados no qual deseja que a extensão esteja disponível.
CREATE EXTENSION azure_ai;
Nota
Para remover a extensão do banco de dados conectado no momento, use DROP EXTENSION azure_ai;.
A instalação da extensão azure_ai cria os três esquemas a seguir:
azure_ai: esquema principal onde a tabela de configuração reside e funciona para interagir com ela.azure_openai: funções e tipos compostos relacionados com OpenAI.azure_cognitive: funções e tipos compostos relacionados com os Serviços Cognitivos.
A extensão também permite chamar o Azure OpenAI e os Serviços Cognitivos do Azure.
Configurar a azure_ai extensão
A configuração da extensão exige que você forneça os pontos de extremidade para se conectar aos serviços de IA do Azure e as chaves de API necessárias para autenticação. As configurações de serviço são armazenadas usando as seguintes funções:
Permissões
Suas chaves de acesso do Azure AI são semelhantes a uma senha de root para sua conta. Tenha sempre o cuidado de proteger as suas chaves de acesso. Use o Azure Key Vault para gerenciar e girar suas chaves com segurança.
Para gerenciar chaves de serviço usadas pela extensão, os usuários exigem a azure_ai_settings_manager função concedida a eles. As seguintes funções requerem a função:
- azure_ai.set_setting
- azure_ai.get_setting
A azure_ai_settings_manager função é, por padrão, concedida à azure_pg_admin função.
azure_ai.set_setting
Usado para definir opções de configuração.
azure_ai.set_setting(key TEXT, value TEXT)
Argumentos
key
Nome de uma opção de configuração. Os valores válidos para o key são:
azure_openai.endpoint: Ponto de extremidade OpenAI suportado (por exemplo,https://example.openai.azure.com).azure_openai.subscription_key: Uma chave de assinatura para um recurso OpenAI.azure_cognitive.endpoint: Ponto de extremidade de Serviços Cognitivos suportado (por exemplo,https://example.cognitiveservices.azure.com).azure_cognitive.subscription_key: Uma chave de subscrição para um recurso dos Serviços Cognitivos.
value
TEXT representando o valor desejado da configuração selecionada.
azure_ai.get_setting
Usado para obter valores atuais de opções de configuração.
azure_ai.get_setting(key TEXT)
Argumentos
Chave
Nome de uma opção de configuração. Os valores válidos para o key são:
azure_openai.endpoint: Ponto de extremidade OpenAI suportado (por exemplo,https://example.openai.azure.com).azure_openai.subscription_key: Uma chave de assinatura para um recurso OpenAI.azure_cognitive.endpoint: Ponto de extremidade de Serviços Cognitivos suportado (por exemplo,https://example.cognitiveservices.azure.com).azure_cognitive.subscription_key: Uma chave de subscrição para um recurso dos Serviços Cognitivos.
Tipo de retorno
TEXT representando o valor atual da configuração selecionada.
azure_ai.version
azure_ai.version()
Tipo de retorno
TEXT representando a versão atual da extensão Azure AI.
Exemplos
Definir o ponto de extremidade e uma chave de API para o 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>');
Obter o ponto de extremidade e a chave de API para o Azure OpenAI
select azure_ai.get_setting('azure_openai.endpoint');
select azure_ai.get_setting('azure_openai.subscription_key');
Verifique a versão da extensão Azure AI
select azure_ai.version();
Permissões
A azure_ai extensão define uma função chamada azure_ai_settings_manager, que permite a leitura e gravação de configurações relacionadas à extensão. Somente superusuários e membros da azure_ai_settings_manager função podem invocar as azure_ai.get_settings funções e azure_ai.set_settings . No Banco de Dados do Azure para servidor flexível PostgreSQL, todos os usuários administradores têm a azure_ai_settings_manager função atribuída.
Atualizar a extensão Azure AI
Versões mais recentes da extensão podem introduzir novas funcionalidades e atualizações in-loco da extensão são permitidas. Você pode comparar a versão atualmente instalada com a versão mais recente permitida usando o comando SQL:
SELECT * FROM pg_available_extensions
WHERE name = 'azure_ai'
Para atualizar uma extensão instalada para a versão mais recente disponível suportada pelo Azure, utilize o seguinte comando SQL:
ALTER EXTENSION azure_ai UPDATE;