Verbindung zu Cloud SQL for PostgreSQL von Ihrem lokalen Computer herstellen

Verbindung zu Cloud SQL for PostgreSQL von Ihrem lokalen Computer herstellen

MySQL   |  PostgreSQL   |  SQL Server

So stellen Sie eine Beispielanwendung auf Ihrem Linux-, macOS- oder Windows-basierten lokalen Computer bereit, der mit einer PostgreSQL Server-Instanz über die Google Cloud Console und eine Clientanwendung verbunden ist.

Angenommen, Sie führen alle Schritte zeitnah aus. Die in dieser Kurzanleitung erstellten Ressourcen kosten in der Regel weniger als einen Dollar (US-Dollar).

Vorbereitung

Hinweis: Der Name, den Sie für Ihr Projekt verwenden, muss zwischen 4 und 30 Zeichen lang sein. Bei der Eingabe des Namens schlägt das Formular eine Projekt-ID vor, die Sie ändern können. Die Projekt-ID muss zwischen 6 und 30 Zeichen lang sein und mit einem Kleinbuchstaben beginnen. Für die restlichen Zeichen können Sie Bindestriche, Kleinbuchstaben und Ziffern verwenden. Das letzte Zeichen darf jedoch kein Bindestrich sein.

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.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Aktivieren Sie die Cloud APIs, die zum Ausführen einer Cloud SQL-Beispielanwendung auf Ihrem lokalen Computer erforderlich sind.

   Console

   Klicken Sie auf die Schaltfläche APIs aktivieren, um die für diese Kurzanleitung erforderlichen APIs zu aktivieren.

   APIs aktivieren

   Dadurch werden die folgenden APIs aktiviert:

   • Cloud SQL Admin API
   • IAM API

   gcloud

   Installieren Sie die gcloud CLI, die Befehlszeilenzugriff auf Ihre Google Cloud-Ressourcen bietet. Die gcloud CLI dient hier zur Ausführung der in dieser Kurzanleitung vorgestellten gcloud CLI-Befehle. Alle Befehle sind zur Ausführung in einem Linux/macOS-Terminal oder in Windows Powershell formatiert.

   Öffnen Sie das Terminal und führen Sie den folgenden gcloud-Befehl aus:

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Mit diesem Befehl werden die folgenden APIs aktiviert:

   • Cloud SQL Admin API
   • IAM API

Cloud SQL einrichten

Cloud SQL-Instanz erstellen

Console

Instanz mit öffentlicher IP-Adresse erstellen

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

   Cloud SQL-Instanzen aufrufen

2. Klicken Sie auf Instanz erstellen.
3. Klicken Sie auf PostgreSQL auswählen.
4. Geben Sie unter Instanz-ID quickstart-instance ein.
5. Geben Sie das Passwort für den Postgres-Nutzer ein. Speichern Sie dieses Passwort zur späteren Verwendung.
6. Klicken Sie für Region und zonale Verfügbarkeit auswählen auf Einzelne Zone.
7. Klicken Sie auf den Bereich Konfigurationsoptionen einblenden und maximieren Sie ihn.
8. Wählen Sie im Drop-down-Menü Maschinentyp die Option Einfach aus.

9. Klicken Sie auf Instanz erstellen und warten Sie, bis die Instanz initialisiert und gestartet wurde.

gcloud

Instanz mit öffentlicher IP-Adresse erstellen

Bevor Sie den Befehl gcloud sql instances create ausführen, ersetzen Sie DB_ROOT_PASSWORD durch das Passwort Ihres Datenbanknutzers.

Ändern Sie optional die Werte für die folgenden Parameter:

• --database_version: der Typ und die Version des Datenbankmoduls. Falls nicht angegeben, wird der API-Standard verwendet. Die derzeit verfügbaren Versionen finden Sie in der Dokumentation zu gcloud-Datenbankversionen.
• --cpu: Die Anzahl der Kerne, die in der Maschine festgelegt werden sollen.
• --memory: Ganzzahliger Wert, der angibt, wie viel Arbeitsspeicher in der Maschine festgelegt werden soll. Es sollte eine Größeneinheit angegeben werden (z. B. 3.072 MB oder 9 GB). Wenn keine Einheiten angegeben sind, wird von GB ausgegangen.
• --region: Regionaler Standort der Instanz, z. B. asia-east1, us-east1. Wenn nichts anderes angegeben ist, wird standardmäßig us-central verwendet. Eine vollständige Liste der Regionen finden Sie in diesem Artikel.

Führen Sie den Befehl gcloud sql instances create aus, um eine Cloud SQL-Instanz zu erstellen.

gcloud sql instances create quickstart-instance --database-version=POSTGRES_13 --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

Datenbank erstellen

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

   Cloud SQL-Instanzen aufrufen

2. Wählen Sie quickstart-instance aus.
3. Öffnen Sie den Tab Datenbanken.
4. Klicken Sie auf Datenbank erstellen.
1. Geben Sie im Dialogfeld Neue Datenbank quickstart_db als Namen für die Datenbank ein.
   
2. Klicken Sie auf Erstellen.

gcloud

Führen Sie den Befehl gcloud sql databases create aus, um eine Datenbank zu erstellen.

gcloud sql databases create quickstart_db --instance=quickstart-instance

Nutzer erstellen

Console

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

   Cloud SQL-Instanzen aufrufen

2. Klicken Sie auf den Instanznamen, um die Seite Übersicht einer Instanz zu öffnen.
3. Wählen Sie im SQL-Navigationsmenü die Option Nutzer aus.
4. Klicken Sie auf Nutzerkonto hinzufügen.
5. Geben Sie auf der Seite Nutzerkonto zur Instanz instance_name hinzufügen die folgenden Informationen ein:
   • Geben Sie im Feld Nutzername quickstart-user ein.
   • Geben Sie im Feld Passwort ein Passwort für den Datenbanknutzer ein. Notieren Sie dies zur Verwendung in einem späteren Schritt dieser Kurzanleitung.
6. Klicken Sie auf Hinzufügen.

gcloud

Dabei gilt:

1. PASSWORD durch ein Passwort für Ihren Datenbanknutzer. Notieren Sie dies zur Verwendung in einem späteren Schritt dieser Kurzanleitung.

Führen Sie den Befehl gcloud sql users create aus, um den Nutzer zu erstellen.

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

Für Cloud SQL gelten die gleichen Längenbeschränkungen für Nutzernamen wie für lokales PostgreSQL.

Dienstkonto einrichten

Erstellen und konfigurieren Sie ein Google Cloud-Dienstkonto mit der Rolle Cloud SQL-Client mit Berechtigungen zum Herstellen einer Verbindung zu Cloud SQL. Nachdem Sie ein Dienstkonto erstellt haben, müssen Sie möglicherweise 60 Sekunden oder länger warten, bis Sie das Dienstkonto verwenden können.

Console

Dienstkonto erstellen

1. Wechseln Sie in der Google Cloud Console zur Seite Dienstkonto erstellen.

Zur Seite „Dienstkonto erstellen“

2. Wählen Sie ein Google Cloud-Projekt aus.
3. Geben Sie ein quickstart-service-account als Namen des Dienstkontos ein.
4. Optional: Geben Sie eine Beschreibung für das Dienstkonto ein.
5. Klicken Sie auf Erstellen und fortfahren und fahren Sie mit dem nächsten Schritt fort.
6. Wählen Sie die Rolle "Cloud SQL-Client" aus, die dem Dienstkonto für das Projekt zugewiesen werden soll.
7. Klicken Sie auf Weiter.
8. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

Dienstkontoschlüsseldatei erstellen und herunterladen

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

Zur Seite „Dienstkonten“

2. Wählen Sie ein Projekt aus.
3. Klicken Sie auf die E-Mail-Adresse des quickstart-service-account-Dienstkontos, für das Sie einen Schlüssel erstellen möchten.
4. Klicken Sie auf den Tab Schlüssel.
5. Klicken Sie auf das Drop-down-Menü Schlüssel hinzufügen und wählen Sie Neuen Schlüssel erstellen aus.
6. Wählen Sie als JSON JSON aus und klicken Sie dann auf JSON.

Wenn Sie auf Erstellen klicken, wird eine Dienstkontoschlüsseldatei heruntergeladen. Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht noch einmal herunterladen.

Bewahren Sie die Schlüsseldatei sicher auf, da sie zur Authentifizierung als Ihr Dienstkonto verwendet werden kann. Sie können diese Datei beliebig verschieben und umbenennen.

gcloud

Dienstkonto erstellen

1. Führen Sie den Befehl gcloud iam service-accounts create aus, um das Dienstkonto zu erstellen.

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Ersetzen Sie den folgenden Wert:

• DESCRIPTION: Eine optionale Beschreibung des Dienstkontos.
2. Führen Sie den Befehl gcloud projects add-iam-policy-binding aus, um Ihrem Dienstkonto die Rolle "Cloud SQL-Client" für Ihr Projekt zuzuweisen. Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Dienstkontoschlüsseldatei erstellen und herunterladen

Wenn Sie das gerade erstellte Dienstkonto von Ihrem lokalen Computer verwenden möchten, benötigen Sie eine Dienstkontoschlüsseldatei, um die Beispielanwendung als Dienstkonto zu authentifizieren. Führen Sie den Befehl gcloud iam service-accounts keys create aus, um die Dienstkontoschlüsseldatei zu erstellen und herunterzuladen:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Ersetzen Sie die folgenden Werte:

• KEY_FILE: Der Pfad zu einer neuen Ausgabedatei für den privaten Schlüssel, z. B. ~/sa-private-key.json.
• PROJECT_ID: Ihre Google Cloud-Projekt-ID.

Die Dienstkontoschlüsseldatei wird jetzt auf Ihren lokalen Computer heruntergeladen. Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht noch einmal herunterladen.

Bewahren Sie die Schlüsseldatei sicher auf, da jeder sie zur Authentifizierung als Ihr Dienstkonto verwenden kann. Sie können diese Datei beliebig verschieben und umbenennen.

Entwicklungsumgebung für die Programmiersprache einrichten

Richten Sie die Entwicklungsumgebung Ihres lokalen Computers für Ihre bevorzugte Programmiersprache ein.

Go

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung für die Ausführung der Go-Beispielanwendung einzurichten.

1. Rufen Sie den Einrichtungsleitfaden für eine Go-Entwicklungsumgebung auf.
2. Folgen Sie der Anleitung im Abschnitt Go installieren.

Java

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Java-Beispielanwendung einzurichten.

1. Rufen Sie den Einrichtungsleitfaden für eine Java-Entwicklungsumgebung auf.
2. Folgen Sie der Anleitung im Abschnitt JDK (Java Development Kit) installieren.
3. Folgen Sie der Anleitung im Abschnitt Build-Automatisierungstool installieren, um Apache Maven einzurichten.

Node.js

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Node.js-Beispielanwendung einzurichten.

1. Rufen Sie den Einrichtungsleitfaden für eine Node.js-Entwicklungsumgebung auf.
2. Folgen Sie der Anleitung im Abschnitt Node.js und npm installieren.

Python

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung zum Ausführen der Python-Beispielanwendung einzurichten.

1. Rufen Sie den Einrichtungsleitfaden für eine Python-Entwicklungsumgebung auf.
2. Folgen Sie der Anleitung im Abschnitt Python installieren.

Git installieren

Installieren Sie Git, ein Open-Source-Versionsverwaltungssystem.

Linux

Folgen Sie der offiziellen Git-Installationsdokumentation für Linux.

macOS

Folgen Sie der offiziellen Git-Installationsdokumentation für macOS.

Windows

Folgen Sie der offiziellen Git-Installationsdokumentation für Windows.

Beispielanwendung klonen

Klonen Sie eine Beispielanwendung mit dem Befehl git clone auf Ihrem lokalen Computer.

Go

Führen Sie die folgenden Befehle aus, um die Go-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

1. Klonen Sie die Beispielanwendung.

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

   cd golang-samples/cloudsql/postgres/database-sql

Java

Führen Sie die folgenden Befehle aus, um die Java-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

1. Klonen Sie die Beispielanwendung.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

   cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Führen Sie die folgenden Befehle aus, um die Node.js-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

1. Klonen Sie die Beispielanwendung.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

   cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Führen Sie die folgenden Befehle aus, um die Python-Beispielanwendung auf Ihrem lokalen Computer zu klonen, und wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

1. Klonen Sie die Beispielanwendung.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Wechseln Sie in das Verzeichnis, das die Beispielanwendung enthält.

   cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Beispielanwendung konfigurieren und ausführen

Konfigurieren Sie die Beispielanwendung und führen Sie sie aus.

Linux/macOS

Go

Öffnen Sie das Terminal und führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Führen Sie die folgenden Befehle aus, um die Abhängigkeiten der Go-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Rufen Sie die Abhängigkeiten ab, die zum Ausführen der Beispielanwendung erforderlich sind.

   go get ./...
   

2. Führen Sie die Beispielanwendung aus.

   go run cmd/app/main.go
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Terminalfenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Java

Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten der Java-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

   mvn jetty:run
   

2. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

3. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Terminalfenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Node.js

1. Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

   • CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='5432'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'
   

2. Laden Sie den Cloud SQL Auth-Proxy herunter.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Führen Sie den Cloud SQL Auth-Proxy als Hintergrundprozess aus. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Note: The process running the Cloud SQL Auth Proxy in the background can be stopped using the fg command in your Terminal window where you started the sample app. This should bring the running Cloud SQL Auth Proxy job to the terminal foreground. Drücken Sie dann Strg + C, um den Proxy-Job zu beenden.

Führen Sie die folgenden Befehle aus, um die erforderlichen Node.js-Pakete auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Installieren Sie die Node.js-Pakete, die zum lokalen Ausführen der Anwendung erforderlich sind.

   npm install
   

2. Führen Sie die Beispielanwendung aus.

   npm start
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Terminalfenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Python

Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='5432'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Führen Sie die folgenden Befehle aus, um die Anforderungen der Python-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Initialisieren Sie eine virtuelle Umgebung und installieren Sie die Anforderungen zum Ausführen der Beispielanwendung.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. Führen Sie die Beispielanwendung aus.

   python app.py
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Terminalfenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Windows

Go

Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Führen Sie die folgenden Befehle aus, um die Abhängigkeiten der Go-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Rufen Sie die Abhängigkeiten ab, die zum Ausführen der Beispielanwendung erforderlich sind.

   go get ./...
   

2. Führen Sie die Beispielanwendung aus.

   go run cmd\app\main.go
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Powershell-Fenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Java

Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten der Java-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

   mvn jetty:run
   

2. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

3. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Powershell-Fenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Node.js

1. Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

   • CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="5432"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"
   

2. Laden Sie den Cloud SQL Auth-Proxy herunter.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe 
   -O cloud-sql-proxy.exe

3. Führen Sie den Cloud SQL Auth-Proxy als Hintergrundprozess aus. Ersetzen Sie INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Hinweis: Der Prozess, in dem der Cloud SQL Auth-Proxy im Hintergrund ausgeführt wird, kann beendet werden, indem Sie das cmd.exe-Fenster auswählen, das vom Befehl Start-Process aufgerufen wurde. Schließen Sie das Fenster, um den Proxy-Job zu beenden.

Führen Sie die folgenden Befehle aus, um die erforderlichen Node.js-Pakete auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Installieren Sie die Node.js-Pakete, die zum lokalen Ausführen der Anwendung erforderlich sind.

   npm install
   

2. Führen Sie die Beispielanwendung aus.

   npm start
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Powershell-Fenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Python

Führen Sie die folgenden Befehle aus, um Umgebungsvariablen zu initialisieren, die zum Ausführen der Beispielanwendung erforderlich sind. Bevor Sie die Befehle ausführen, ersetzen Sie die folgenden Werte:

• CREDENTIALS_JSON_FILE durch den Dateipfad der JSON-Anmeldedatenschlüsseldatei für Ihr Dienstkonto in einem Format wie C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME durch den Verbindungsnamen Ihrer Instanz, der auf der Seite Übersicht der Cloud SQL-Instanz angezeigt wird.
• YOUR_DB_PASSWORD durch das Passwort des quickstart-user, den Sie im vorherigen Schritt Nutzer erstellen erstellt haben.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="5432"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Führen Sie die folgenden Befehle aus, um die Anforderungen der Python-Beispielanwendung auf Ihrem lokalen Computer abzurufen, und führen Sie die Beispielanwendung aus.

1. Initialisieren Sie eine virtuelle Umgebung und installieren Sie die Anforderungen zum Ausführen der Beispielanwendung.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   

2. Führen Sie die Beispielanwendung aus.

   python app.py
   

3. Sehen Sie sich die laufende Beispielanwendung an. Öffnen Sie ein Browserfenster und rufen Sie http://127.0.0.1:8080 auf.

   

4. Beenden Sie die Beispielanwendung, indem Sie Strg + C in dem Powershell-Fenster drücken, in dem Sie die Beispielanwendung gestartet haben.

Bereinigen

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

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

   Cloud SQL-Instanzen aufrufen

2. Wählen Sie die Instanz quickstart-instance aus, um die Seite Instanzendetails zu öffnen.
3. Klicken Sie oben auf der Seite in der Symbolleiste auf Löschen.
4. Geben Sie im Dialogfeld Instanz löschen quickstart-instance ein und klicken Sie dann auf Löschen, um die Instanz zu löschen.

Optionale Bereinigungsschritte

Wenn Sie nicht die Rolle Cloud SQL-Client verwenden, die Sie dem quickstart-service-account-Dienstkonto zugewiesen haben, können Sie sie entfernen.

1. Öffnen Sie in der Google Cloud Console die Seite IAM.

   IAM aufrufen

2. Klicken Sie auf das Stiftsymbol (Bearbeiten) für das IAM-Konto mit dem Namen quickstart-service-account.
3. Löschen Sie die Rolle Cloud SQL-Client.
4. Klicken Sie auf Speichern.

Wenn Sie die APIs, die im Rahmen dieser Kurzanleitung aktiviert wurden, nicht verwenden, können Sie sie deaktivieren.

• APIs, die in dieser Kurzanleitung aktiviert wurden:
  • Cloud SQL Admin API
  • Identity and Access Management API

1. Öffnen Sie in der Google Cloud Console die Seite APIs.

   Zu „APIs“

2. Wählen Sie eine API aus, die Sie deaktivieren möchten, und klicken Sie dann auf die Schaltfläche API deaktivieren.

Nächste Schritte

Je nach Bedarf können Sie sich eingehender über das Erstellen von Cloud SQL-Instanzen informieren.

Sie können sich auch über das Erstellen von PostgreSQL-Nutzern und Datenbanken für Ihre Cloud SQL-Instanz informieren.

Weitere Informationen zu Preisen finden Sie unter Cloud SQL for PostgreSQL – Preise.

Mehr zu folgenden Themen:

• Cloud SQL-Instanz mit einer öffentlichen IP-Adresse konfigurieren
• Cloud SQL-Instanz mit einer privaten IP-Adresse konfigurieren

Außerdem erfahren Sie, wie Sie von anderen Google Cloud-Anwendungen aus eine Verbindung zu einer Cloud SQL-Instanz herstellen können:

• Aus einer Anwendung, die in der App Engine-Standardumgebung ausgeführt wird
• Aus einer Anwendung, die auf Compute Engine ausgeführt wird
• Aus einer Anwendung, die in GKE ausgeführt wird
• Aus Cloud Run-Funktionen
• Aus Cloud Run