Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der PostgreSQL-Oberfläche für Spanner können Sie die vollständig verwaltete, skalierbare und hochverfügbare Spanner-Infrastruktur mit vertrauten PostgreSQL-Tools und ‑Syntax nutzen. Auf dieser Seite erfahren Sie mehr über die Funktionen und Einschränkungen der PostgreSQL-Oberfläche.
Vorteile der PostgreSQL-Oberfläche
Portabilität: Die PostgreSQL-Oberfläche bietet Zugriff auf die umfassenden Spanner-Funktionen. Dabei werden Schemas, Abfragen und Clients verwendet, die mit Open Source PostgreSQL kompatibel sind. Das vereinfacht die Migration einer in Spanner erstellten Anwendung in eine andere PostgreSQL-Umgebung. Diese Mobilität bietet Flexibilität bei der Bereitstellung und unterstützt Notfallwiederherstellungsszenarien, z. B. einen Notfallausstieg.
Vertrautheit: Wenn Sie bereits PostgreSQL verwenden, können Sie mit Spanner schnell loslegen, da viele PostgreSQL-Anweisungen und -Tools verwendet werden. Wenn Sie PostgreSQL in Ihrem gesamten Datenbankportfolio verwenden, gibt es weniger Unterschiede zwischen bestimmten Produkten und eine gemeinsame Reihe von Best Practices.
Unbegrenzte Spanner-Funktionen: Da die PostgreSQL-Oberfläche auf der bestehenden Spanner-Plattform basiert, bietet sie alle Verfügbarkeits-, Konsistenz- und Preis-Leistungs-Vorteile von Spanner, ohne dass Sie Kompromisse bei den Funktionen eingehen müssen, die in der ergänzenden GoogleSQL-Umgebung verfügbar sind.
Nicht unterstützte PostgreSQL-Features in Spanner
Die PostgreSQL-Oberfläche bietet die Funktionen von Spanner über Schemas, Typen, Abfragen und Clients, die mit PostgreSQL kompatibel sind. Es werden nicht alle Funktionen von PostgreSQL unterstützt. Die Migration einer vorhandenen PostgreSQL-Anwendung zu Spanner, auch mit der PostgreSQL-Oberfläche für Spanner, erfordert wahrscheinlich einige Überarbeitungen, um nicht unterstützte PostgreSQL-Funktionen oder Verhaltensunterschiede wie Abfrageoptimierung oder Primärschlüsseldesign zu berücksichtigen. Nach der Migration können Ihre Arbeitslasten jedoch von der Zuverlässigkeit und den einzigartigen Multi-Modell-Funktionen von Spanner profitieren.
In der folgenden Liste finden Sie weitere Informationen zu unterstützten und nicht unterstützten PostgreSQL-Funktionen:
Unterstützte PostgreSQL-Funktionen: Die PostgreSQL-Schnittstelle unterstützt viele der am häufigsten verwendeten PostgreSQL-Funktionen. Dazu gehören die Kernteile des Schema- und Typsystems, viele gängige Abfrageformen, eine Vielzahl von Funktionen und Operatoren sowie die wichtigsten Aspekte des PostgreSQL-Systemkatalogs. Anwendungen können viele PostgreSQL-Clients verwenden, indem sie über die Spanner-Implementierung des PostgreSQL-Netzwerkprotokolls eine Verbindung herstellen.
Einige PostgreSQL-Sprachfunktionen werden nicht unterstützt: Erweiterungen, benutzerdefinierte Datentypen, benutzerdefinierte gespeicherte Prozeduren und andere Funktionen. Eine vollständige Liste finden Sie unter PostgreSQL-Sprache in Spanner.
Außerdem gibt es einige Funktionen in PostgreSQL, die sich von der Open-Source-Version unterscheiden. Weitere Informationen finden Sie unter Bekannte Probleme in der PostgreSQL-Oberfläche für Spanner.
Spanner und Spanner-Kontrollebene: Bei Datenbanken mit PostgreSQL-Schnittstellen werden Spanner und Google Cloud-Tools verwendet, um Instanzen bereitzustellen, zu sichern, zu überwachen und zu optimieren.
Spanner unterstützt keine Tools wie pgAdmin für administrative Aktivitäten.
Unterstützung von Client- und Netzwerkprotokollen: Spanner unterstützt die wichtigsten Abfragefunktionen des PostgreSQL-Netzwerkprotokolls mit PGAdapter, einem schlanken Proxy, der parallel zu Ihrer Anwendung ausgeführt wird. So können viele Spanner-Clients ohne Änderungen mit einer Spanner-PostgreSQL-Oberflächendatenbank arbeiten und gleichzeitig die globale Endpunkt- und Verbindungsverwaltung sowie die IAM-Authentifizierung von Spanner nutzen. Die internen Benchmarks von Google zeigen, dass PGAdapter im Vergleich zu einer direkten Verbindung zu den integrierten Endpunkten von Spanner keine merkliche zusätzliche Latenz verursacht.
Verwaltung und Management
Die PostgreSQL-Oberfläche unterstützt die Verwaltung Ihrer Spanner-Datenbanken mit den folgenden Funktionen:
Einheitliche Oberfläche: Sie können Datenbanken mit aktivierter PostgreSQL-Oberfläche mithilfe der vorhandenen Konsolen, APIs und Tools von Spanner wie der Google Cloud CLI bereitstellen, verwalten und überwachen.
Flexible Konfiguration: Die PostgreSQL-Oberfläche wird bei der Erstellung pro Datenbank konfiguriert. Eine einzelne Spanner-Instanz kann sowohl GoogleSQL- als auch PostgreSQL-Oberflächendatenbanken aufnehmen.
Gemeinsame Vorteile: Beide Datenbankdialekte nutzen dieselbe zugrunde liegende verteilte Datenbank-Engine, was für eine gleichbleibende Skalierbarkeit, Konsistenz, Leistung und Sicherheit sorgt.
Features
Die PostgreSQL-Oberfläche von Spanner bietet zwei Hauptfunktionen, die die Einbindung in das PostgreSQL-System ermöglichen:
Unterstützung für PostgreSQL-Dialekte
Spanner bietet eine Teilmenge des PostgreSQL-SQL-Dialekts, einschließlich DQL (Data Query Language), DML (Data Manipulation Language) und DDL (Data Definition Language). Außerdem enthält es Erweiterungen zur Unterstützung von Spanner-spezifischen Funktionen wie verschachtelte Tabellen, Gültigkeitsdauer (Time to Live, TTL) und Abfragehinweise.
Ausführliche Informationen zu den unterstützten PostgreSQL-Sprachelementen finden Sie unter PostgreSQL-Sprache in Spanner. Informationen zur Verwendung von Spanner-Funktionen mit dem PostgreSQL-Dialekt finden Sie in der Dokumentation der jeweiligen Funktion.
PostgreSQL-Clientunterstützung
Mit Spanner können Sie von einer Vielzahl von Clients aus eine Verbindung zu Datenbanken herstellen:
PostgreSQL-Tools:Sie können bekannte Tools wie den PostgreSQL JDBC-Treiber und den PostgreSQL pgx-Treiber verwenden, um Ihre Anwendungen mit einer PostgreSQL-Schnittstellendatenbank zu verbinden. Eine Liste der unterstützten Treiber, ORMs und Tools finden Sie unter PostgreSQL-Treiber und ORMs.
psql-Befehlszeilentool: Die beliebte interaktive Umgebung psql wird unterstützt. Damit können Sie Abfragen ausführen, Metadaten untersuchen und Daten direkt über Ihr Terminal laden.
PGAdapter:Dieser schlanke Proxy vereinfacht die Verbindungsverwaltung und Authentifizierung. Weitere Informationen finden Sie in der
PGAdapter-Übersicht.
Spanner-Clients: Spanner bietet Open-Source-Spanner-Clients für verschiedene Programmiersprachen (Java, Go, Python, Node.js, Ruby, PHP, C#, C++) sowie einen Spanner-JDBC-Treiber und einen Treiber für das SQL-Paket von Go.
Spanner-Clients stellen ohne Proxy eine direkte Verbindung zum globalen Spanner-Endpunkt her. Spanner-Clients sind jedoch nicht mit vorhandenen PostgreSQL-Clients, ORMs oder Tools kompatibel.
Best Practices für die Verwendung der PostgreSQL-Oberfläche
Beachten Sie bei der Verwendung der PostgreSQL-Oberfläche die folgenden Best Practices:
[[["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-09-05 (UTC)."],[],[],null,["# PostgreSQL interface\n\nThe PostgreSQL interface for Spanner lets you take advantage of\nSpanner's fully managed, scalable, and highly available\ninfrastructure using familiar PostgreSQL tools and syntax. This page\nhelps you understand the capabilities and limitations of the PostgreSQL\ninterface.\n\nBenefits of the PostgreSQL interface\n------------------------------------\n\n- **Portability**: the PostgreSQL interface provides access to the breadth of Spanner features, using schemas, queries, and clients that are compatible with open source PostgreSQL. This simplifies moving an application built on Spanner to another PostgreSQL environment. This portability provides deployment flexibility and supports disaster recovery scenarios, such as a stressed exit.\n- **Familiarity**: if you already use PostgreSQL, you can quickly get started with Spanner using many of the same PostgreSQL statements and tools. Using PostgreSQL across your database portfolio means fewer variations between specific products and a common set of best practices.\n- **Uncompromisingly Spanner**: because it's built on Spanner's existing foundation, the PostgreSQL interface provides all of Spanner's existing availability, consistency, and price-performance benefits without having to compromise on any of the capabilities available in the complementary GoogleSQL ecosystem.\n\nUnsupported PostgreSQL features on Spanner\n------------------------------------------\n\nIt's important to understand that the PostgreSQL interface\nprovides the capabilities of Spanner through schemas, types,\nqueries, and clients that are compatible with PostgreSQL. It doesn't\nsupport all of the features of PostgreSQL. Migrating an existing\nPostgreSQL application to Spanner, even using\nthe PostgreSQL interface for Spanner, likely requires some rework to accommodate\nunsupported PostgreSQL capabilities or differences in behavior, like\nquery optimization or primary key design. However, once it's migrated, your\nworkloads can take advantage of Spanner's reliability and unique\nmulti-model capabilities.\n\nThe following list provides more information on supported and unsupported\nPostgreSQL features:\n\n- **Supported PostgreSQL functionality**: the PostgreSQL interface supports many of the most commonly used features of PostgreSQL. This includes core parts of the schema and type system, many common query shapes, a variety of functions and operators, and the key aspects of PostgreSQL's system catalog. Applications can use many PostgreSQL clients by connecting over Spanner's implementation of the PostgreSQL wire protocol.\n- **Some PostgreSQL language features aren't supported** : extensions, user-defined data types, user-defined stored procedures, and other features aren't supported. For a complete list, see [The PostgreSQL language in Spanner](/spanner/docs/reference/postgresql/overview). There are also some features in PostgreSQL that behave differently from open source PostgreSQL. For more information, see [Known issues in the PostgreSQL interface for Spanner](/spanner/docs/reference/postgresql/known-issues-postgresql-interface).\n- **Spanner and Spanner control plane**: databases with PostgreSQL interfaces use Spanner and Google Cloud tools to provision, secure, monitor, and optimize instances. Spanner doesn't support tools, such as pgAdmin for administrative activities.\n- **Client and wire protocol support**: Spanner supports the core query capabilities of the PostgreSQL wire protocol using PGAdapter, a lightweight proxy that runs alongside your application. This lets many Spanner clients work as-is with a Spanner PostgreSQL interface database, while leveraging Spanner's global endpoint and connection management and IAM authentication. Google's internal benchmarking shows that PGAdapter doesn't add any noticeable additional latency compared to direct connection to Spanner's built-in endpoints.\n\nAdministration and Management\n-----------------------------\n\nThe PostgreSQL interface supports the administration and\nmanagement of your Spanner databases with the following features:\n\n- **Unified experience**: provision, manage, and monitor PostgreSQL interface-enabled databases using Spanner's existing console, APIs, and tools like Google Cloud CLI.\n- **Flexible configuration**: configure the PostgreSQL interface per database at creation time. A single Spanner instance can accommodate both GoogleSQL and PostgreSQL interface databases.\n- **Shared benefits**: both database dialects share the same underlying distributed database engine, ensuring consistent scalability, consistency, performance, and security.\n\nFeatures\n--------\n\nSpanner's PostgreSQL interface offers two primary\nfeatures that enable integration with the PostgreSQL ecosystem:\n\n- **PostgreSQL dialect support**\n\n Spanner provides a subset of the PostgreSQL SQL\n dialect, including Data Query Language (DQL), Data Manipulation Language\n (DML), and Data Definition Language (DDL). Additionally, it includes\n extensions to support Spanner-specific features like\n [interleaved tables](/spanner/docs/schema-and-data-model#parent-child),\n [time to live (TTL)](/spanner/docs/ttl), and [query hints](/spanner/docs/reference/postgresql/query-syntax#pg_extensions).\n\n For detailed information on the supported PostgreSQL language\n elements, see [The PostgreSQL language in\n Spanner](/spanner/docs/reference/postgresql/overview). To\n understand how to use Spanner features with the\n PostgreSQL dialect, consult the documentation for the specific\n feature.\n- **PostgreSQL client support**\n\n Spanner lets you connect to databases from a variety of\n clients:\n - **PostgreSQL ecosystem tools:** you can use familiar\n tools like the [PostgreSQL JDBC driver](/spanner/docs/pg-jdbc-connect)\n and [PostgreSQL pgx driver](https://github.com/jackc/pgx) to connect\n your applications to a PostgreSQL interface database. For\n a list of supported drivers, ORMs, and tools see\n [PostgreSQL drivers and ORMs](/spanner/docs/drivers-overview#postgresql-drivers-and-orms).\n\n - **psql command-line tool** : the popular\n [`psql` interactive environment](/spanner/docs/psql-commands)\n is supported, letting you run queries, explore metadata, and load data\n directly from your terminal.\n\n - **PGAdapter:** this lightweight proxy simplifies connection\n management and authentication. For more details, refer to the [PGAdapter overview](/spanner/docs/pgadapter).\n\n - **Spanner clients:** Spanner provides\n open source Spanner clients for various programming\n languages (Java, Go, Python, Node.js, Ruby, PHP, C#, C++), along with a\n [Spanner JDBC driver](https://github.com/googleapis/java-spanner-jdbc)\n and a [driver for Go's SQL package](https://github.com/googleapis/go-sql-spanner).\n Spanner clients connect directly to\n Spanner's global endpoint without a proxy. However,\n Spanner clients don't offer compatibility with existing\n PostgreSQL clients, ORMs, or tools.\n\nBest practices for using the PostgreSQL interface\n-------------------------------------------------\n\nUse the following best practices when using the PostgreSQL interface:\n\n1. **Connect your applications** : use the [set of supported PostgreSQL\n tools](#connect-pg) for efficient connectivity.\n2. **Interact with your database**: for interactive work, choose\n between the following:\n\n - The familiar [psql command-line tool](/spanner/docs/psql-connect) (using the [PGAdapter proxy](/spanner/docs/pgadapter-get))\n - The intuitive [Spanner Studio](/spanner/docs/manage-data-using-console) page within the Google Cloud console\n - IDEs, such [DBeaver](https://cloud.google.com/blog/topics/developers-practitioners/exploring-cloud-spanner-data-dbeaver/) and [Visual Studio Code](https://cloud.google.com/blog/topics/developers-practitioners/browse-and-query-cloud-spanner-databases-visual-studio-code), [JetBrains](https://cloud.google.com/blog/topics/developers-practitioners/cloud-spanner-connectivity-using-jetbrains-ides), and [IntelliJ](/spanner/docs/use-intellij)\n - The Spanner emulator which lets you emulate Spanner on your local machine. This is useful during the development and test process.\n\n### What's next\n\n- Learn how to [choose between PostgreSQL and\n GoogleSQL](/spanner/docs/choose-googlesql-or-postgres).\n- Follow the [quickstart](/spanner/docs/create-query-database-console) to create and interact with a PostgreSQL database.\n- Learn more about [Spanner's PostgreSQL language\n support](/spanner/docs/reference/postgresql/overview).\n- Learn about [PGAdapter](/spanner/docs/pgadapter).\n- Learn about the [PGAdapter GitHub\n repository](https://github.com/GoogleCloudPlatform/pgadapter).\n- Review [known issues](/spanner/docs/known-issues-postgresql-interface) in the PostgreSQL interface."]]
