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 in der Regel von einem Administrator ausgeführt.

2. IAM-Rollen (Identity and Access Management) in einem Google Cloud-Projekt gewähren Dieser Schritt wird in der Regel 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).

Hinweise

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 zum Aktivieren der Gemini for Google Cloud API in einem Google Cloud-Projekt beschrieben.

Console

1. Rufen Sie die Seite Gemini für 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 zeigt den Status Aktiviert an. Gemini ist jetzt im ausgewählten Google Cloud-Projekt für alle Nutzer verfügbar, die die erforderlichen IAM-Rollen haben.

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 dem 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 Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zu gewähren.

Console

1. Rufen Sie die Seite IAM und Verwaltung auf, um die IAM-Rollen zu gewähren, die für die Verwendung von Gemini erforderlich sind.

   IAM & Verwaltung aufrufen

2. Suchen Sie in der Spalte Hauptkonto ein Hauptkonto, dem Sie Zugriff auf Gemini gewähren möchten, und klicken Sie dann in dieser Zeile auf Hauptkonto bearbeiten.

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 User“ 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 mit den folgenden Informationen:

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

4. Weisen Sie die Rolle „Service Usage-Nutzer“ zu:

   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 24 bis 48 Stunden dauern, bis Gemini in Datenbanken aktiviert ist.

So aktivieren Sie Gemini in einem Google Cloud-Projekt unter „Datenbanken“: Diese Schritte werden in der Regel von einem Administrator oder Projektinhaber ausgeführt.

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 Abrechnungskonto aus, für das Sie Gemini in Databases aktivieren möchten, und klicken Sie auf Weiter zur Seite „Gemini in Databases“.

   Die Seite Gemini in Datenbanken wird angezeigt.

5. Klicken Sie auf Angebotsbedingungen prüfen 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 Ihr Projekt aktiviert.

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, aktivieren Sie erweiterte Query Insights auf der Instanz.

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. Wenn Sie Empfehlungen zur Indexerstellung auf der Seite Query Insights eines Clusters aktivieren möchten, wählen Sie 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 aktivieren. Der Indexberater für Cloud SQL for MySQL verwendet Daten aus dem MySQL-Leistungsschema. In Cloud SQL ist das MySQL-Leistungsschema standardmäßig für alle MySQL 8.0-Instanzen mit mehr als 15 GB Arbeitsspeicher aktiviert.

1. Bevor Sie den Indexberater aktivieren, müssen Sie Abfragestatistiken für die Instanz aktivieren.
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 Indexierungsberater 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.