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;.

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;

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;

Próximos passos