Conectar o psycopg2 a um banco de dados do dialeto PostgreSQL
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, explicamos como conectar o driver psycopg2 do PostgreSQL a um banco de dados com dialeto PostgreSQL no Spanner. psycopg2 é um driver Python para PostgreSQL.
Verifique se o PGAdapter está em execução na mesma máquina que o
aplicativo que está se conectando usando o driver psycopg2 do PostgreSQL.
APPLICATION_HOST: o nome do host ou endereço IP da máquina em que o PGAdapter está sendo executado. Se você estiver executando localmente, use localhost.
PORT: o número da porta em que o PGAdapter está
em execução. Mude isso na string de conexão se o PGAdapter estiver
sendo executado em uma porta personalizada. Caso contrário, use a porta padrão, 5432.
Soquetes de domínio Unix
Nesta seção, explicamos como usar soquetes de domínio Unix para se conectar a um banco de dados PostgreSQL. Use conexões de soquete de domínio Unix quando precisar da menor latência possível.
Para usar soquetes de domínio Unix, o PGAdapter precisa estar em execução no mesmo host que o aplicativo cliente.
/tmp: o diretório de soquete de domínio padrão para
PGAdapter. Isso pode ser mudado usando o argumento de linha de comando -dir.
PORT: o número da porta em que o PGAdapter está
em execução. Mude isso na string de conexão se o PGAdapter estiver
sendo executado em uma porta personalizada. Caso contrário, use a porta padrão, 5432.
Para mais informações sobre as opções de conexão do driver psycopg2 do PostgreSQL, consulte
Opções de conexão do psycopg2
no repositório do PGAdapter no GitHub.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]