Integrazione con Vertex AI

Questa pagina descrive in dettaglio come configurare l'integrazione tra AlloyDB per PostgreSQL e Vertex AI, consentendoti di applicare query ai modelli linguistici di grandi dimensioni (LLM) archiviati nel cloud ai tuoi dati.

Queste istruzioni riguardano specificamente l'utilizzo di AlloyDB e non AlloyDB Omni. Per integrare invece un'installazione locale di AlloyDB Omni utilizzando Vertex AI, vedi Installare AlloyDB Omni con AlloyDB AI.

Per saperne di più sull'utilizzo dei modelli ML con AlloyDB, consulta Crea applicazioni di AI generativa utilizzando AlloyDB AI.

Per saperne di più su Vertex AI, consulta Introduzione a Vertex AI.

Prima di iniziare

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

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

  5. Install the Google Cloud CLI.

  6. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  7. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

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

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

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

  11. Install the Google Cloud CLI.

  12. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  13. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

    14. Concedere l'autorizzazione utente Vertex AI all'agente di servizio AlloyDB

    Per abilitare l'integrazione del database con Vertex AI, segui questi passaggi per concedere all'agente di servizio AlloyDB le autorizzazioni IAM (Identity and Access Management) per accedere a Vertex AI:

    Aggiungi le autorizzazioni Vertex AI all'agente di servizio AlloyDB per il progetto in cui si trova il cluster del database AlloyDB:

    Console

    1. Vai alla pagina Benvenuto nella console Google Cloud e copia il numero di progetto del progetto che contiene cluster o istanze AlloyDB. Utilizzerai questo numero di progetto nei passaggi successivi.

      Vai a Benvenuto

    2. Nella console Google Cloud , vai alla pagina IAM.

      Vai a IAM

    3. Seleziona il progetto con gli endpoint Vertex AI.

    4. Attiva l'opzione Includi concessioni di ruoli fornite da Google.

    5. Fai clic su Concedi l'accesso.

    6. Nel campo Nuove entità, inserisci quanto segue:

          service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

      Sostituisci PROJECT_NUMBER con il numero del progetto.

    7. Nel campo Ruolo, inserisci Vertex AI User.

    8. Fai clic su Salva.

    gcloud

    Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

            gcloud projects add-iam-policy-binding PROJECT_ID 
    
        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com" 
    
        --role="roles/aiplatform.user"

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'endpoint Vertex AI.
    • PROJECT_NUMBER: Il numero di progetto del progetto che contiene cluster o istanze AlloyDB.

    Verificare l'estensione installata

    Verifica se google_ml_integration è installato nel database che contiene i dati su cui vuoi eseguire le previsioni:

    Console

    1. Nella console Google Cloud , vai alla pagina Cluster.

      Vai a Cluster

    2. Per visualizzare la pagina Panoramica del cluster, fai clic sul nome del cluster AlloyDB nella colonna Nome risorsa.

    3. Nel menu di navigazione, fai clic su AlloyDB Studio.

    4. Nella pagina Accedi ad AlloyDB Studio, esegui l'autenticazione utilizzando il nome del database, il nome utente e la password.

    5. Nella scheda Editor 1, completa quanto segue:

      1. Verifica che sia installata la versione 1.4.2 o successiva dell'estensione google_ml_integration:

        SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

      2. Fai clic su Esegui. Attendi che la versione dell'estensione venga visualizzata nel riquadro Risultati.

    psql

    1. Connetti un client psql all'istanza principale del cluster, come descritto in Connettere un client psql a un'istanza.

    2. Al prompt dei comandi psql, connettiti al database: 

      \c DB_NAME

      Sostituisci DB_NAME con il nome del database su cui vuoi installare l'estensione.

    3. Verifica che sia installata la versione 1.4.2 o successiva dell'estensione google_ml_integration: 

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

    Passaggi successivi