Gemini in Datenbanken einrichten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Führen Sie die Schritte in diesem Dokument aus, um Gemini in Datenbanken einzurichten:

1. Gemini for Google Cloud API in einem Google Cloud-Projekt aktivieren Dieser Schritt wird normalerweise von einem Administrator ausgeführt.

2. IAM-Rollen (Identity and Access Management) in einem Google Cloud-Projekt gewähren Dieser Schritt wird normalerweise von einem Administrator ausgeführt.

3. Gemini in Datenbanken aktivieren

4. Aktivieren Sie die Recommender API.

5. Indexierungsberater aktivieren (gilt nur für AlloyDB for PostgreSQL, Cloud SQL for PostgreSQL und Cloud SQL for MySQL).

Hinweis

Zum Aktivieren von Gemini in Datenbanken benötigen Sie die IAM-Rolle (Identity and Access Management) roles/billing.admin.

Gemini for Google Cloud API in einem Google Cloud-Projekt aktivieren

In diesem Abschnitt werden die Schritte beschrieben, die zum Aktivieren des Gemini für die Google Cloud API in einem Google Cloud-Projekt.

Console

1. Rufen Sie die Seite Gemini for Google Cloud auf, um die Gemini for Google Cloud API zu aktivieren.

   Zu Gemini for Google Cloud

2. Klicken Sie auf die Projektauswahl Projekt auswählen.

3. Klicken Sie auf Aktivieren.

   Die Seite wird aktualisiert und der Status Aktiviert wird angezeigt. Gemini ist jetzt in den ausgewählten Google Cloud-Projekt an alle Nutzer, die die erforderlichen IAM-Rollen

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Wählen Sie im Menü „Projektauswahl“ Ihr Projekt aus.

3. Aktivieren Sie die Gemini for Google Cloud API für Gemini mit den Befehl gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Wenn Sie die Gemini for Google Cloud API in einem anderen Google Cloud-Projekt aktivieren möchten, fügen Sie den Parameter --project hinzu:

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

   Die Ausgabe sieht in etwa so aus:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

Gemini for Google Cloud ist jetzt im angegebenen Google Cloud-Projekt für alle Nutzer verfügbar, die die erforderlichen IAM-Rollen haben.

IAM-Rollen in einem Google Cloud-Projekt zuweisen

In diesem Abschnitt werden die Schritte beschrieben, die erforderlich sind, um Gemini für Google Cloud-Nutzer zu gewähren. und Service Usage Consumer IAM-Rollen.

Console

1. Zum Zuweisen der IAM-Rollen, die für die Verwendung erforderlich sind Gemini erhalten Sie unter IAM & Verwaltung.

   IAM & Verwaltung aufrufen

2. Suchen Sie in der Spalte Hauptkonto nach Hauptkonto, für das Sie die Zugriff auf Gemini gewähren möchten, und klicken Sie Wählen Sie in dieser Zeile Hauptkonto bearbeiten aus.

3. Klicken Sie im Bereich Berechtigungen bearbeiten auf Weitere Rolle hinzufügen.

4. Wählen Sie unter Rolle auswählen die Option Gemini for Google Cloud-Nutzer aus.

5. Klicken Sie auf Weitere Rolle hinzufügen und wählen Sie Nutzer der Dienstnutzung aus.

6. Klicken Sie auf Speichern.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Wählen Sie im Menü „Projektauswahl“ Ihr Projekt aus.

3. Weisen Sie die Rolle „Gemini for Google Cloud-Nutzer“ zu:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   Ersetzen Sie PRINCIPAL durch die Kennung des Hauptkontos. Die Kennung hat das Format user|group|serviceAccount:email oder domain:domain, z. B. user:[e-mail], group:[e-mail], serviceAccount:[e-mail] oder domain:example.domain.com.

   Die Ausgabe ist eine Liste von Richtlinienbindungen, die Folgendes enthält:

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

4. Gewähren Sie die Rolle „Service Usage-Nutzer“:

   gcloud projects add-iam-policy-binding  PROJECT_ID \
       --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
   

   Die Ausgabe ist eine Liste von Richtlinienbindungen mit den folgenden Informationen:

   - members:
     - user:PRINCIPAL
     role: roles/serviceusage.serviceUsageConsumer
   

Weitere Informationen finden Sie unter Einzelne Rolle zuweisen und gcloud projects add-iam-policy-binding

Alle Nutzer, denen diese Rollen zugewiesen wurden, können in der Google Cloud Console des angegebenen Projekts auf Gemini for Google Cloud-Funktionen zugreifen. Weitere Informationen finden Sie unter Gemini for Google Cloud – Übersicht.

Gemini in Datenbanken aktivieren

Wichtig :Es kann zwischen 24 und 48 Stunden dauern, bis Gemini in Datenbanken aktiviert wird.

So aktivieren Sie Gemini in einem Google Cloud-Projekt in der Datenbank: Ein Administrator oder Projektinhaber führt diese Aufgaben Schritte.

1. Rufen Sie in der Google Cloud Console die Seite Gemini für Google Cloud auf.

   Gemini für Google Cloud

2. Klicken Sie auf Gemini in Datenbanken.

   Der Bereich Gemini untersuchen wird angezeigt.

3. Klicken Sie auf Gemini in Datenbanken aktivieren.

   Die Seite Verwaltung für Gemini wird angezeigt.

4. Wählen Sie das Rechnungskonto aus, für das Sie es aktivieren möchten Gemini in Datenbanken und klicken Sie auf Weiter zu Gemini in Datenbanken .

   Die Seite Gemini in Datenbanken wird angezeigt.

5. Klicken Sie auf Nutzungsbedingungen lesen und aktivieren.

   Die Seite Gemini in Datenbanken aktivieren wird angezeigt.

6. Klicken Sie auf Kaufen, um Gemini in Datenbanken zu aktivieren.

Recommender API aktivieren

Enable the Recommender API.

Enable the API

Wenn die Recommender API nicht aufgeführt ist, ist sie bereits für für Ihr Projekt.

Indexberater aktivieren

Sie können den Indexberater für AlloyDB for PostgreSQL, Cloud SQL for MySQL 8.0-Instanzen und Cloud SQL for PostgreSQL 12- und höher-Instanzen aktivieren.

AlloyDB for PostgreSQL

In den folgenden Schritten wird beschrieben, wie Sie den Indexberater für AlloyDB for PostgreSQL aktivieren.

1. Bevor Sie den Indexberater aktivieren, müssen Sie erweiterte Query Insights für die Instanz aktivieren.

2. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

   Zu den Clustern

3. Klicken Sie in der Liste der Cluster und Instanzen auf eine Instanz.
4. Klicken Sie auf Query Insights.
5. Wählen Sie die Datenbank und den Nutzer aus.
6. Klicken Sie auf Einstellungen bearbeiten.
7. So aktivieren Sie Empfehlungen zur Indexerstellung in Query Insights eines Clusters: die Option Empfehlungen aktivieren aus.
8. Speichern Sie die Änderungen.

Weitere Informationen zur Verwendung des Index-Advisors in AlloyDB for PostgreSQL finden Sie unter Index-Advisor mit Abfragestatistiken verwenden.

Cloud SQL for MySQL

In den folgenden Schritten wird beschrieben, wie Sie den Indexberater für Cloud SQL for MySQL Der Indexberater für Cloud SQL for MySQL verwendet Daten aus dem MySQL-Leistungsschema. Standardmäßig aktiviert Cloud SQL MySQL Performance Schema auf allen MySQL 8.0-Versionen. Instanzen mit mehr als 15 GB Arbeitsspeicher.

1. Bevor Sie Index Advisor aktivieren, aktivieren Sie Query Insights für die Instanz.
2. Wenn Sie das MySQL-Leistungsschema bereits in Ihren Cloud SQL for MySQL-Instanzen aktiviert haben, führen Sie den folgenden gcloud CLI-Befehl aus, um den Index-Advisor zu aktivieren:

gcloud sql instances patch INSTANCE_NAME \
    --database-flags=cloudsql_index_advisor=on

Ersetzen Sie dabei INSTANCE_NAME durch den Namen Ihrer Instanz.

3. Wenn das MySQL-Leistungsschema in Ihren Cloud SQL for MySQL-Instanzen nicht aktiviert ist, führen Sie den folgenden gcloud CLI-Befehl aus, um den Indexierungsberater zu aktivieren:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql_index_advisor=on,performance_schema=on

Ersetzen Sie dabei INSTANCE_NAME durch den Namen Ihrer Instanz.

Achtung: Wenn Sie das Flag performance_schema auf on festlegen, wird die Instanz automatisch neu gestartet.

Weitere Informationen zum Konfigurieren von Flags finden Sie unter Datenbank-Flags konfigurieren

Cloud SQL for PostgreSQL

In den folgenden Schritten wird beschrieben, wie Sie den Indexberater für Cloud SQL for PostgreSQL aktivieren.

1. Bevor Sie den Indexberater aktivieren, müssen Sie Abfragestatistiken für die Instanz aktivieren.
2. Führen Sie den folgenden Google Cloud CLI-Befehl aus, um den Indexberater für Cloud SQL for PostgreSQL-Instanzen zu aktivieren:

gcloud sql instances patch INSTANCE_NAME \
   --database-flags=cloudsql.enable_index_advisor=on
    

Ersetzen Sie dabei INSTANCE_NAME durch den Namen Ihrer Instanz.

Weitere Informationen zum Konfigurieren von Flags finden Sie unter Datenbank-Flags konfigurieren