Integre com o Vertex AI

Esta página detalha como configurar a integração entre o AlloyDB for PostgreSQL e a Vertex AI, o que lhe permite aplicar consultas a grandes modelos de linguagem (GMLs) armazenados na nuvem aos seus dados.

Estas instruções são específicas da utilização do AlloyDB e não do AlloyDB Omni. Em alternativa, para integrar uma instalação local do AlloyDB Omni através do Vertex AI, consulte o artigo Instale o AlloyDB Omni com o AlloyDB AI.

Para mais informações sobre a utilização de modelos de ML com o AlloyDB, consulte o artigo Crie aplicações de IA generativa com o AlloyDB AI.

Para mais informações sobre o Vertex AI, consulte o artigo Introdução ao Vertex AI.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Conceda autorização do utilizador da Vertex AI ao agente do serviço AlloyDB

Para ativar a integração da base de dados com o Vertex AI, siga estes passos para conceder as autorizações da gestão de identidade e de acesso (IAM) do agente de serviço do AlloyDB para aceder ao Vertex AI:

Adicione autorizações da Vertex AI ao agente do serviço do AlloyDB para o projeto onde se encontra o cluster da base de dados do AlloyDB:

Consola

1. Aceda à página Boas-vindas na Google Cloud consola e copie o número do projeto que tem clusters ou instâncias do AlloyDB. Vai usar este número do projeto nos passos seguintes.

   Aceder a Boas-vindas

2. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

3. Selecione o projeto que tem pontos finais da Vertex AI.

4. Ative a opção Incluir concessões de funções fornecidas pela Google.

5. Clique em Conceder acesso.

6. No campo Novos diretores, introduza o seguinte:

       [e-mail]
       

   Substitua PROJECT_NUMBER pelo número do projeto.

7. No campo Função, introduza Utilizador do Vertex AI.

8. Clique em Guardar.

gcloud

Para usar a CLI gcloud, pode instalar e inicializar a CLI Google Cloud ou usar a Cloud Shell.

        gcloud projects add-iam-policy-binding PROJECT_ID 

        --member="serviceAccount:[e-mail]" 

        --role="roles/aiplatform.user"
  

Substitua o seguinte:

• PROJECT_ID: o ID do projeto que tem o ponto final da Vertex AI.
• PROJECT_NUMBER: o número do projeto que tem clusters ou instâncias do AlloyDB.

Nota: a alteração da política entra em vigor no prazo de 60 segundos a 7 minutos.

Valide a extensão instalada

Verifique se o google_ml_integration está instalado na base de dados que contém os dados sobre os quais quer executar previsões:

Consola

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a Clusters

2. Para apresentar a página Vista geral do cluster, clique no nome do cluster do AlloyDB na coluna Nome do recurso.

3. No menu de navegação, clique em AlloyDB Studio.

4. Na página Inicie sessão no AlloyDB Studio, autentique-se com o nome da base de dados, o nome de utilizador e a palavra-passe.

   Nota: o AlloyDB Studio liga-se à instância principal do cluster, que é onde a gestão de extensões e as previsões iniciais são processadas, mesmo que pretenda invocar previsões de instâncias do conjunto de leitura mais tarde.

5. No separador Editor 1, conclua o seguinte:

   1. Verifique se a versão 1.4.2 ou posterior da extensão google_ml_integration está instalada:

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

   2. Clique em Executar. Aguarde até que a versão da extensão seja apresentada no painel Resultados.

psql

1. Associe um cliente do psql à instância principal do cluster, conforme descrito em Associe um cliente do psql a uma instância.

   Nota: tem de estabelecer ligação à instância principal, mesmo que pretenda invocar previsões enquanto estiver ligado a uma instância de conjunto de leitura.

2. Na linha de comandos psql, associe-se à base de dados:

   \c DB_NAME

   Substitua DB_NAME pelo nome da base de dados na qual quer instalar a extensão.

3. Verifique se a versão 1.4.2 ou posterior da extensão google_ml_integration está instalada:

   SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

O que se segue?

• Trabalhe com incorporações

• Invocar previsões

• Quotas e limites do Vertex AI

• Chame pontos finais de modelos remotos