AlloyDB-Datenbank mit der Google Cloud Console erstellen und abfragen

AlloyDB-Datenbank mit der Google Cloud Console erstellen und abfragen

Wenn Sie AlloyDB for PostgreSQL in der Google Cloud Console verwenden möchten, können Sie einen Cluster und eine primäre Instanz erstellen, über AlloyDB Studio eine Verbindung zur Instanz herstellen und Beispieldaten einfügen und abfragen. In AlloyDB werden Ihre Datenbanken in Clustern gespeichert, die Instanzen enthalten. Weitere Informationen zur AlloyDB-Architektur, zu Clustern und Instanzen finden Sie in der AlloyDB-Übersicht.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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 role (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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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 role (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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

1. Die Service Networking API ist erforderlich, wenn Sie die Netzwerkverbindung zu AlloyDB über ein VPC-Netzwerk (Virtual Private Cloud) konfigurieren möchten, das sich im selben Google Cloud -Projekt wie AlloyDB befindet.

   Die Compute Engine API und die Cloud Resource Manager API sind erforderlich, wenn Sie die Netzwerkverbindung zu AlloyDB über ein VPC-Netzwerk konfigurieren möchten, das sich in einem anderen Google Cloud -Projekt befindet.

2. Wählen Sie eine Konnektivitätsoption aus.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer AlloyDB-Datenbank und zum Herstellen einer Verbindung zu ihr benötigen:

• Compute-Netzwerkadministrator (roles/compute.networkAdmin)
• AlloyDB Admin (roles/alloydb.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen einer AlloyDB-Datenbank und zum Herstellen einer Verbindung zu ihr erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um eine AlloyDB-Datenbank zu erstellen und eine Verbindung zu ihr herzustellen:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Cluster und primäre AlloyDB-Instanz erstellen

Hinweis: Wenn Sie einen Cluster, eine Instanz und ein Netzwerk für Ihre Entwicklungsumgebung mithilfe einer interaktiven Anleitung einrichten möchten, folgen Sie den Schritten im Codelab zur AlloyDB-Einrichtung.

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

   Zu den Clustern

2. Klicken Sie auf Cluster erstellen.

3. Führen Sie unter Cluster konfigurieren die folgenden Schritte aus:

   1. Geben Sie im Feld Cluster-ID den Wert my-cluster ein.

   2. Geben Sie ein Passwort ein. Notieren Sie sich dieses Passwort, da Sie es in dieser Kurzanleitung verwenden.

   3. Behalten Sie die Standarddatenbankversion bei.

   4. Wählen Sie im Menü Region unter Standort die Region us-central1 (Iowa) aus.

4. Führen Sie unter Primäre Instanz konfigurieren die folgenden Schritte aus:

   1. Geben Sie im Feld Instanz-ID den Wert my-cluster-primary ein.

   2. Wählen Sie unter Zonale Verfügbarkeit die Option Einzelne Zone aus.

      Hinweis: Wir empfehlen zwar keine Instanz mit einer einzelnen Zone für die Produktion, aber Sie können in dieser Kurzanleitung eine einzelne Zone verwenden, um die Kosten zu minimieren. Weitere Informationen finden Sie unter Kosten mit einfachen Instanzen reduzieren.

   3. Wählen Sie im Menü Maschinentyp den Maschinentyp 2 vCPU, 16 GB aus.

   4. Wählen Sie im Menü Netzwerk unter Konnektivität das Netzwerk default aus.

      Wenn Sie eine Verbindung für den Zugriff auf private Dienste konfiguriert haben, fahren Sie mit dem nächsten Schritt fort. Andernfalls klicken Sie auf Verbindung einrichten und gehen Sie so vor:

      1. Wählen Sie unter IP-Bereich zuweisen die Option Automatisch zugewiesenen IP-Bereich verwenden aus.

      2. Klicken Sie auf Weiter und dann auf Verbindung erstellen.

   5. Behalten Sie die Standardeinstellungen unter Netzwerksicherheit bei.

5. Klicken Sie auf Cluster erstellen. Es kann einige Minuten dauern, bis AlloyDB den Cluster erstellt und auf der Übersichtsseite des primären Clusters anzeigt.

Verbindung zur Instanz herstellen und Datenbank in AlloyDB Studio erstellen

Hinweis: Wenn Sie einen psql-Client mit einer Instanz verbinden möchten, folgen Sie der Anleitung unter Verbindung von Compute Engine herstellen.

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

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres Clusters, my-cluster.

3. Klicken Sie im Navigationsbereich auf AlloyDB Studio.

4. Gehen Sie auf der Seite In AlloyDB Studio anmelden so vor:

   1. Wählen Sie eine Datenbankauthentifizierungsmethode aus.

   2. Wählen Sie die Datenbank postgres aus.

   3. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in der Datenbank postgres angezeigt.

5. Geben Sie auf dem Tab Editor 1 die folgende Anweisung ein, um eine Datenbank zu erstellen, und klicken Sie dann auf Ausführen:

   CREATE DATABASE guestbook;
   

   Die Datenbank wurde erstellt, wenn im Bereich Ergebnisse die Meldung Statement executed successfully angezeigt wird.

Stellen Sie eine Verbindung zur Datenbank guestbook her:

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

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres Clusters, my-cluster.

3. Klicken Sie im Navigationsbereich auf AlloyDB Studio.

4. Gehen Sie auf der Seite In AlloyDB Studio anmelden so vor:

   1. Wählen Sie die Datenbank guestbook aus.

   2. Wählen Sie den Nutzer postgres aus.

   3. Geben Sie das Passwort ein, das Sie unter Cluster und primäre AlloyDB-Instanz erstellen erstellt haben.

   4. Klicken Sie auf Authentifizieren. Im Bereich Explorer wird eine Liste der Objekte in der Datenbank guestbook angezeigt.

Datenbankverbindung überprüfen

1. Folgen Sie der Anleitung unter Verbindung zur Datenbank guestbook herstellen.

2. Geben Sie auf dem Tab Editor 1 Folgendes ein, um Beispieldaten in die Datenbank guestbook einzufügen:

   CREATE TABLE entries (guestName VARCHAR(255),
                         content VARCHAR(255),
                         entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
   INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
   

3. Klicken Sie auf Ausführen. Die Meldung Statement executed successfully im Bereich Ergebnisse gibt an, dass Daten in Ihre Datenbank eingefügt werden.

4. Wenn Sie Text aus dem Tab Editor 1 entfernen möchten, um einen anderen Befehl auszuführen, klicken Sie auf Löschen.

5. Wenn Sie alle Einträge in der Datenbank auswählen möchten, geben Sie die folgende Abfrage auf dem Tab Editor 1 ein:

   SELECT * FROM entries;
   

6. Klicken Sie auf Ausführen. Im Bereich Ergebnisse wird eine Ausgabe angezeigt, die in etwa so aussieht:

       guestname     | content     | entryid
       --------------+-------------+---------
       Alex          | I got here! | 1
       Kai           | Me too!     | 2
   

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

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

   Zu den Clustern

2. Klicken Sie in der Spalte Ressourcenname auf den Namen Ihres Clusters, my-cluster.

3. Klicken Sie auf Cluster löschen.

4. Geben Sie unter Cluster „my-cluster“ löschen my-cluster ein, um zu bestätigen, dass Sie den Cluster löschen möchten.

5. Klicken Sie auf Löschen.

6. Optional: Wenn Sie beim Erstellen des Clusters eine Verbindung für den Zugriff auf private Dienste erstellt haben und den zugewiesenen IP-Adressbereich nicht mehr benötigen, folgen Sie der Anleitung unter Zugewiesenen Bereich für den Zugriff auf private Dienste entfernen.

Nächste Schritte

• Weitere Möglichkeiten zum Herstellen einer Verbindung zu AlloyDB

• Anderen Nutzern Zugriff gewähren

• Zugriff auf private Dienste aktivieren

• AlloyDB-Maschinentyp auswählen

• Erstellen Sie einen AlloyDB-Cluster und die zugehörige primäre Instanz.

• Informationen zu Empfehlungen zur Größenanpassung

• Verbindung von Compute Engine aus herstellen