Partilhar via

Extensão Azure AI no Banco de Dados do Azure para PostgreSQL

APLICA-SE A: Base 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.

Habilite a extensão azure_ai

Antes de habilitar azure_ai na sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL, você precisa adicioná-lo à 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 pgvector extensão, pois é comumente usada com azure_ai.

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 IF NOT EXISTS 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 extensão azure_ai

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 gerir chaves de serviço usadas pela extensão, os utilizadores requerem a função azure_ai_settings_manager concedida a eles. As seguintes funções requerem a função:

  • azure_ai.definir_configuração
  • 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: Endpoint 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: Endpoint 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>');

Obtenha o endpoint e a chave 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 do papel azure_ai_settings_manager podem invocar as funções azure_ai.get_settings 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 permitir atualizações diretas da extensão. 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;

Conteúdos relacionados