Cómo conectar psycopg2 a una base de datos de dialecto de PostgreSQL
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se explica cómo conectar el controlador psycopg2 de PostgreSQL a una base de datos con dialecto de PostgreSQL en Spanner. psycopg2 es un controlador de Python para PostgreSQL.
Verifica que PGAdapter se ejecute en la misma máquina que la aplicación que se conecta con el controlador psycopg2 de PostgreSQL.
APPLICATION_HOST: Es el nombre de host o la dirección IP de la máquina en la que se ejecuta PGAdapter. Si ejecutas el código de forma local, puedes usar localhost.
PORT: Es el número de puerto en el que se ejecuta PGAdapter. Cambia esto en la cadena de conexión si PGAdapter se ejecuta en un puerto personalizado. De lo contrario, usa el puerto predeterminado, 5432.
Sockets de dominio Unix
En esta sección, se explica cómo usar sockets de dominio de Unix para conectarse a una base de datos con dialecto de PostgreSQL. Usa conexiones de socket de dominio Unix cuando necesites la latencia más baja posible.
Para usar sockets de dominio Unix, PGAdapter debe ejecutarse en el mismo host que la aplicación cliente.
/tmp: Es el directorio de sockets de dominio predeterminado para PGAdapter. Esto se puede cambiar con el argumento de línea de comandos -dir.
PORT: Es el número de puerto en el que se ejecuta PGAdapter. Cambia esto en la cadena de conexión si PGAdapter se ejecuta en un puerto personalizado. De lo contrario, usa el puerto predeterminado, 5432.
Para obtener más información sobre las opciones de conexión del controlador psycopg2 de PostgreSQL, consulta Opciones de conexión de psycopg2 en el repositorio de GitHub de PGAdapter.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-10 (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."]]