AlloyDB-Datenbank mit der Google Cloud Console erstellen und abfragen

AlloyDB-Datenbank mit der Google Cloud Console erstellen und abfragen

In AlloyDB for PostgreSQL werden Ihre Datenbanken in Clustern gespeichert, die Instanzen enthalten. In dieser Kurzanleitung richten Sie einen Cluster ein, stellen eine Verbindung zu seiner Instanz her und fügen Beispieldaten ein und fragen sie ab. Weitere Informationen zur AlloyDB Architektur, zu Clustern und Instanzen finden Sie unter AlloyDB – Übersicht.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um die Leistung 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.

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

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 APIs

Die Service Networking API ist erforderlich, wenn Sie die Netzwerkkonnektivität zu AlloyDB über ein VPC-Netzwerk 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 Netzwerkkonnektivität zu AlloyDB über ein VPC Netzwerk konfigurieren möchten, das sich in einem anderen Google Cloud Projekt befindet.

1. Wählen Sie aus, wie Sie eine Verbindung zu AlloyDB herstellen möchten.

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-Administrator (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, die erforderlich sind:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Erstellen einer AlloyDB-Datenbank und zum Herstellen einer Verbindung zu ihr erforderlich:

• 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 schnell einen Cluster, eine Instanz und ein Netzwerk für Ihre Entwicklungsumgebung über eine Web-UI einrichten möchten, folgen Sie der Anleitung in diesem Codelab.

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

   Zu den Clustern

2. Klicken Sie auf Cluster erstellen.

3. Gehen Sie unter Cluster konfigurieren so vor:

   1. Geben Sie im Feld Cluster-ID 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 Drop-down-Menü Region unter Standort die Region us-central1 (Iowa) aus.

4. Gehen Sie unter Primäre Instanz konfigurieren so vor:

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

   2. Klicken Sie unter Zonale Verfügbarkeit auf Einzelne Zone.

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

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

   4. Wählen Sie im Drop-down-Menü Netzwerk unter Verbindung das default Netzwerk aus.

      Wenn Sie eine Verbindung für den privaten Zugriff haben, fahren Sie mit dem Schritt zum Erstellen eines Clusters fort. Klicken Sie andernfalls auf Verbindung einrichten und gehen Sie so vor:

      1. Klicken Sie unter IP-Bereich zuweisen auf Automatisch zugewiesenen IP-Bereich verwenden.

      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 Seite Übersicht des primären Clusters angezeigt wird.

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 psql-Client mit einer Instanz verbinden.

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 die folgende Anweisung auf dem Tab Editor 1 ein und klicken Sie dann auf Ausführen, um eine Datenbank zu erstellen:

   CREATE DATABASE guestbook;
   

   Wenn die Meldung Statement executed successfully (Anweisung erfolgreich ausgeführt) im Bereich Ergebnisse angezeigt wird, wurde Ihre Datenbank erstellt.

Verbindung zur Datenbank guestbook 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 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 Instanz erstellen erstellt haben.

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

Datenbankverbindung prüfen

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

2. Geben Sie Folgendes auf dem Tab Editor 1 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 (Anweisung erfolgreich ausgeführt) im Bereich Ergebnisse zeigt an, dass Daten in Ihre Datenbank eingefügt wurden.

4. Klicken Sie auf Löschen , um Text vom Tab Editor 1 zu entfernen, damit Sie einen anderen Befehl ausführen können.

5. Geben Sie die folgende Abfrage auf dem Tab Editor 1 ein, um alle Einträge in der Datenbank auszuwählen:

   SELECT * FROM entries;
   

6. Klicken Sie auf Ausführen. Im Bereich Ergebnisse wird eine Ausgabe angezeigt, die 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 Ihren Cluster löschen möchten.

5. Klicken Sie auf Löschen.

6. Wenn Sie beim Erstellen eines Clusters eine private Verbindung erstellt haben, rufen Sie die Google Cloud Console Seite „Netzwerk“ auf und klicken Sie auf VPC-Netzwerk löschen.

Nächste Schritte

• Weitere Informationen zu anderen Möglichkeiten, eine Verbindung zu AlloyDB herzustellen.

• Projektzugriff auf AlloyDB aktivieren.

• Anderen Nutzern Zugriff gewähren.

• Zugriff auf private Dienste aktivieren.

• AlloyDB-Maschinentyp auswählen

• AlloyDB-Cluster und primäre Instanz erstellen.

• Informationen zu Empfehlungen zur Größenanpassung.

• psql-Client mit einer Instanz verbinden.