En esta página, se proporciona una descripción general de PGAdapter. Para obtener información sobre cómo iniciar PGAdapter, consulta Cómo iniciar PGAdapter.
PGAdapter es un proxy de sidecar que admite la
Interfaz de PostgreSQL para Spanner. Se ejecuta en la misma
como la aplicación y expone un extremo en localhost que admite
el protocolo de cable de PostgreSQL. Traduce el protocolo de red de PostgreSQL al protocolo de red de Spanner, gRPC. Con este proxy que se ejecuta de forma local, un cliente de PostgreSQL, como psql, puede conectarse a una base de datos de Spanner con dialecto PostgreSQL.
En el siguiente diagrama, se muestra cómo psql se conecta a Spanner a través de PGAdapter.
PGAdapter admite modos de consulta simples y extendidos. admite cualquier tipo de datos que admita la interfaz de PostgreSQL para Spanner.
Entornos de ejecución de PGAdapter
Puedes ejecutar PGAdapter con uno de los siguientes métodos:
- Independiente. PGAdapter se proporciona como un archivo JAR y se ejecuta de forma independiente en la JVM.
- Docker PGAdapter también se empaqueta como una imagen de Docker.
- Cloud Run. PGAdapter se puede implementar como un proxy de sidecar en Cloud Run.
- Proxy de sidecar. Un uso típico como proxy de sidecar es en un clúster de Kubernetes.
- En proceso. El código de la aplicación de Java puede usar el archivo JAR proporcionado para crear y, luego, iniciar una instancia de PGAdapter.
Para obtener detalles sobre estos métodos, consulta Cómo iniciar PGAdapter.
Autorización con PGAdapter
PGAdapter determina la cuenta de servicio o cualquier otro elemento principal de Identity and Access Management (IAM) que se usará para la conexión mediante el examen de las credenciales que especificas cuando la inicias. Los permisos de IAM otorgados a ese principal determinan los permisos que tiene la aplicación que se conecta en la base de datos.
Cuando usas un control de acceso detallado, puedes especificar
el rol de base de datos cuando inicias PGAdapter. Si especificas un rol de base de datos,
PGAdapter usa el control de acceso detallado cuando envía solicitudes de consultas
y sentencias DML. Esto requiere el permiso de IAM
spanner.databases.useRoleBasedAccess y, para roles de base de datos que no sean
public es el permiso spanner.databaseRoles.use. Los privilegios otorgados al rol de la base de datos determinan las operaciones que puede realizar la aplicación que se conecta. Si no especificas un rol de la base de datos, se usarán los permisos a nivel de la base de datos que se otorgan a la principal de IAM. Para realizar sentencias DDL, el principal debe tener el permiso spanner.databases.updateDdl.
Para obtener más información, consulta Información sobre el control de acceso detallado y Control de acceso con IAM.
¿Qué sigue?
- Cómo iniciar PGAdapter
- Obtén más información sobre el repositorio de GitHub de PGAdapter.
- Obtén más información sobre los controladores y ORM de PostgreSQL. para una tabla de controladores de PostgreSQL y ORM que usa PGAdapter admite.