psycopg2 mit einer Datenbank im PostgreSQL-Dialekt verbinden
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird erläutert, wie Sie den PostgreSQL-Treiber „psycopg2“ mit einer Datenbank im PostgreSQL-Dialekt in Spanner verbinden. psycopg2 ist ein Python-Treiber für PostgreSQL.
Prüfen Sie, ob PGAdapter auf demselben Computer wie die Anwendung ausgeführt wird, die eine Verbindung über den PostgreSQL-Treiber psycopg2 herstellt.
APPLICATION_HOST: der Hostname oder die IP-Adresse des Computers, auf dem PGAdapter ausgeführt wird. Bei einer lokalen Ausführung können Sie localhost verwenden.
PORT: Die Portnummer, unter der PGAdapter ausgeführt wird. Ändern Sie dies im Verbindungsstring, wenn PGAdapter auf einem benutzerdefinierten Port ausgeführt wird. Verwenden Sie andernfalls den Standardport 5432.
Unix Domain Sockets
In diesem Abschnitt wird beschrieben, wie Sie Unix-Domain-Sockets verwenden, um eine Verbindung zu einer Datenbank mit PostgreSQL-Dialekt herzustellen. Verwenden Sie Unix-Domain-Socket-Verbindungen, wenn Sie die niedrigstmögliche Latenz benötigen.
Wenn Sie Unix-Domain-Sockets verwenden möchten, muss PGAdapter auf demselben Host wie die Clientanwendung ausgeführt werden.
/tmp: Das Standardverzeichnis für Domain-Sockets für PGAdapter. Dies kann mit dem Befehlszeilenargument -dir geändert werden.
PORT: Die Portnummer, unter der PGAdapter ausgeführt wird. Ändern Sie dies im Verbindungsstring, wenn PGAdapter auf einem benutzerdefinierten Port ausgeführt wird. Verwenden Sie andernfalls den Standardport 5432.
Weitere Informationen zu den Verbindungsoptionen für den PostgreSQL-psycopg2-Treiber finden Sie im GitHub-Repository für PGAdapter unter psycopg2 Connection Options.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[],[],null,["# Connect psycopg2 to a PostgreSQL-dialect database\n\nThis page explains how to connect the PostgreSQL psycopg2 driver to a\nPostgreSQL-dialect database in Spanner. `psycopg2` is a Python\ndriver for PostgreSQL.\n\nVerify that PGAdapter is running on the same machine as the\napplication that is connecting using the PostgreSQL psycopg2 driver.\n\nFor more information, see [Start PGAdapter](/spanner/docs/pgadapter-start). \n\n connection = psycopg2.connect(database=\"\u003cvar translate=\"no\"\u003eDATABASE_NAME\u003c/var\u003e\",\n host=\"\u003cvar translate=\"no\"\u003eAPPLICATION_HOST\u003c/var\u003e\",\n port=\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nx\"\u003ePORT\u003c/span\u003e\u003c/var\u003e)\n\n cursor = connection.cursor()\n cursor.execute('select \\'Hello World\\'')\n for row in cursor:\n print(row)\n\n cursor.close()\n connection.close()\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eAPPLICATION_HOST\u003c/var\u003e: the hostname or IP address of the machine where PGAdapter is running. If running locally, you can use `localhost`.\n- \u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e: the port number where PGAdapter is running. Change this in the connection string if PGAdapter is running on a custom port. Otherwise, use the default port, `5432`.\n\n### Unix domain sockets\n\nThis section explains how to use Unix domain sockets to connect to a\nPostgreSQL-dialect database database. Use Unix domain socket connections when you need to have\nthe lowest possible latency.\n\nTo use Unix domain sockets, PGAdapter must be running on the\nsame host as the client application. \n\n connection = psycopg2.connect(database=\"\u003cvar translate=\"no\"\u003eDATABASE_NAME\u003c/var\u003e\",\n host=\"\u003cvar translate=\"no\"\u003e/tmp\u003c/var\u003e\",\n port=\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ePORT\u003c/span\u003e\u003c/var\u003e)\n\n cursor = connection.cursor()\n cursor.execute('select \\'Hello World\\'')\n for row in cursor:\n print(row)\n\n cursor.close()\n connection.close()\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003e/tmp\u003c/var\u003e: the default domain socket directory for PGAdapter. This can be changed using the `-dir` command line argument.\n- \u003cvar translate=\"no\"\u003ePORT\u003c/var\u003e: the port number where PGAdapter is running. Change this in the connection string if PGAdapter is running on a custom port. Otherwise, use the default port, `5432`.\n\nWhat's next\n-----------\n\n- Learn more about [PGAdapter](/spanner/docs/pgadapter).\n- For more information about PostgreSQL psycopg2 driver connection options, see [psycopg2 Connection Options](https://github.com/GoogleCloudPlatform/pgadapter/blob/postgresql-dialect/docs/psycopg2.md) in the PGAdapter GitHub repository."]]