Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Antarmuka PostgreSQL untuk Spanner memungkinkan Anda memanfaatkan infrastruktur Spanner yang terkelola sepenuhnya, skalabel, dan sangat tersedia menggunakan alat dan sintaksis PostgreSQL yang sudah dikenal. Halaman ini
membantu Anda memahami kemampuan dan batasan antarmuka PostgreSQL.
Manfaat antarmuka PostgreSQL
Portabilitas: antarmuka PostgreSQL memberikan akses ke
berbagai fitur Spanner, menggunakan skema, kueri, dan
klien yang kompatibel dengan PostgreSQL open source. Hal ini
menyederhanakan pemindahan aplikasi yang di-build di Spanner ke lingkungan PostgreSQL
lain. Portabilitas ini memberikan fleksibilitas deployment dan mendukung skenario pemulihan dari bencana, seperti keluar dari stres.
Keakraban: jika sudah menggunakan PostgreSQL, Anda dapat memulai
Spanner dengan cepat menggunakan banyak pernyataan dan alat PostgreSQL
yang sama. Menggunakan PostgreSQL di seluruh portofolio database Anda berarti lebih sedikit variasi antara produk tertentu dan kumpulan praktik terbaik yang umum.
Spanner yang tidak berkompromi: karena dibuat berdasarkan
fondasi Spanner yang ada, antarmuka PostgreSQL menyediakan semua
manfaat ketersediaan, konsistensi, dan rasio harga-performa
Spanner yang ada tanpa harus mengorbankan kemampuan apa pun yang tersedia
di ekosistem GoogleSQL pelengkap.
Fitur PostgreSQL yang tidak didukung di Spanner
Penting untuk memahami bahwa antarmuka PostgreSQL menyediakan kemampuan Spanner melalui skema, jenis, kueri, dan klien yang kompatibel dengan PostgreSQL. Cloud SQL untuk PostgreSQL tidak
mendukung semua fitur PostgreSQL. Memigrasikan aplikasi PostgreSQL yang ada ke Spanner, bahkan menggunakan antarmuka PostgreSQL untuk Spanner, mungkin memerlukan beberapa pengerjaan ulang untuk mengakomodasi kemampuan PostgreSQL yang tidak didukung atau perbedaan perilaku, seperti pengoptimalan kueri atau desain kunci utama. Namun, setelah dimigrasikan, beban kerja Anda dapat memanfaatkan keandalan Spanner dan kemampuan multi-model unik.
Daftar berikut memberikan informasi selengkapnya tentang fitur PostgreSQL yang didukung dan tidak didukung:
Fungsi PostgreSQL yang didukung: antarmuka PostgreSQL mendukung banyak fitur PostgreSQL yang paling sering digunakan. Hal ini mencakup bagian inti dari skema dan sistem jenis, banyak bentuk kueri umum, berbagai fungsi dan operator, serta aspek utama katalog sistem PostgreSQL. Aplikasi
dapat menggunakan banyak klien PostgreSQL dengan terhubung melalui
penerapan protokol wire PostgreSQL Spanner.
Beberapa fitur bahasa PostgreSQL tidak didukung: ekstensi, jenis data yang ditentukan pengguna, prosedur tersimpan yang ditentukan pengguna, dan fitur lainnya tidak didukung. Untuk mengetahui daftar lengkap, lihat
Bahasa PostgreSQL di Spanner.
Ada juga beberapa fitur di PostgreSQL yang berperilaku berbeda
dari PostgreSQL open source. Untuk informasi selengkapnya, lihat
Masalah umum di antarmuka PostgreSQL untuk Spanner.
Spanner dan bidang kontrol Spanner: database dengan
antarmuka PostgreSQL menggunakan alat Spanner dan Google Cloud
untuk menyediakan, mengamankan, memantau, dan mengoptimalkan instance.
Spanner tidak mendukung alat, seperti pgAdmin untuk aktivitas
administratif.
Dukungan klien dan protokol kabel: Spanner mendukung kemampuan
kueri inti dari protokol kabel PostgreSQL menggunakan
PGAdapter, proxy ringan yang berjalan bersama
aplikasi Anda. Hal ini memungkinkan banyak klien Spanner berfungsi sebagaimana mestinya dengan database antarmuka PostgreSQL Spanner, sekaligus memanfaatkan endpoint global dan pengelolaan koneksi Spanner serta autentikasi IAM. Benchmarking internal Google menunjukkan bahwa
PGAdapter tidak menambahkan latensi tambahan yang signifikan dibandingkan dengan
koneksi langsung ke endpoint bawaan Spanner.
Administrasi dan Pengelolaan
Antarmuka PostgreSQL mendukung administrasi dan
pengelolaan database Spanner Anda dengan fitur berikut:
Pengalaman terpadu: sediakan, kelola, dan pantau database yang mendukung antarmuka PostgreSQL menggunakan konsol, API, dan alat Spanner yang ada seperti Google Cloud CLI.
Konfigurasi fleksibel: konfigurasikan
antarmuka PostgreSQL per database pada waktu pembuatan. Satu
instance Spanner dapat mengakomodasi database antarmuka
GoogleSQL dan PostgreSQL.
Manfaat bersama: kedua dialek database memiliki mesin database terdistribusi yang mendasarinya, yang memastikan skalabilitas, konsistensi, performa, dan keamanan yang konsisten.
Fitur
Antarmuka PostgreSQL Spanner menawarkan dua fitur utama
yang memungkinkan integrasi dengan ekosistem PostgreSQL:
Dukungan dialek PostgreSQL
Spanner menyediakan subkumpulan dialek SQL PostgreSQL, termasuk Data Query Language (DQL), Data Manipulation Language (DML), dan Data Definition Language (DDL). Selain itu, library ini mencakup ekstensi untuk mendukung fitur khusus Spanner seperti tabel interleaved, time to live (TTL), dan petunjuk kueri.
Untuk informasi mendetail tentang elemen bahasa PostgreSQL
yang didukung, lihat Bahasa PostgreSQL di
Spanner. Untuk memahami cara menggunakan fitur Spanner dengan dialek PostgreSQL, lihat dokumentasi untuk fitur tertentu.
Dukungan klien PostgreSQL
Spanner memungkinkan Anda terhubung ke database dari berbagai
klien:
Alat ekosistem PostgreSQL: Anda dapat menggunakan alat
yang sudah dikenal seperti driver JDBC PostgreSQL
dan driver pgx PostgreSQL untuk menghubungkan
aplikasi ke database antarmuka PostgreSQL. Untuk
daftar driver, ORM, dan alat yang didukung, lihat
Driver dan ORM PostgreSQL.
Alat command line psql: Lingkungan interaktif psql yang populer didukung, sehingga Anda dapat menjalankan kueri, menjelajahi metadata, dan memuat data langsung dari terminal.
PGAdapter: proxy ringan ini menyederhanakan pengelolaan
dan autentikasi koneksi. Untuk detail selengkapnya, lihat
ringkasan PGAdapter.
Klien Spanner: Spanner menyediakan
klien Spanner open source untuk berbagai bahasa
pemrograman (Java, Go, Python, Node.js, Ruby, PHP, C#, C++), beserta
driver JDBC Spanner
dan driver untuk paket SQL Go.
Klien Spanner terhubung langsung ke
endpoint global Spanner tanpa proxy. Namun,
klien Spanner tidak menawarkan kompatibilitas dengan klien, ORM, atau alat PostgreSQL
yang ada.
Praktik terbaik untuk menggunakan antarmuka PostgreSQL
Gunakan praktik terbaik berikut saat menggunakan antarmuka PostgreSQL:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]
