El control de acceso detallado de Spanner combina los beneficios de Identity and Access Management (IAM) con el control de acceso basado en roles de SQL. Con el control de acceso detallado, defines roles de base de datos, otorgas privilegios a los roles y creas políticas de IAM para otorgar permisos sobre los roles de base de datos a las principales de IAM. En esta página, se describe cómo usar el control de acceso detallado con Spanner para bases de datos con dialecto de GoogleSQL y bases de datos con dialecto de PostgreSQL.
Como administrador, debes habilitar el control de acceso detallado para las principales de IAM individuales. Las principales para las que está habilitado el control de acceso detallado ("usuarios de control de acceso detallado") deben asumir un rol de base de datos para acceder a los recursos de Spanner.
El acceso a los recursos para los usuarios que no son usuarios de control de acceso detallado se rige por los roles de IAM a nivel de la base de datos. El control de acceso detallado es totalmente compatible y puede coexistir con el control de acceso a nivel de base de datos de IAM existente. Puedes usarla para acceder a objetos de base de datos individuales. Para controlar el acceso a toda la base de datos, usa roles de IAM.
Con el control de acceso detallado, puedes controlar el acceso a tablas, columnas, vistas y flujos de cambios.
Para administrar el control de acceso detallado, usa las siguientes declaraciones de DDL:
- Sentencias
CREATEyDROPpara crear y descartar roles de base de datos. Los roles de base de datos son colecciones de privilegios. Puedes crear hasta 100 roles para una base de datos. Sentencias
GRANTyREVOKEpara otorgar y revocar privilegios a los roles de la base de datos y desde ellos. Los privilegios incluyenSELECT,INSERT,UPDATE,DELETEyEXECUTE. Los nombres de los privilegios corresponden a las sentencias de SQL con nombres similares. Por ejemplo, un rol con el privilegioINSERTpuede ejecutar la instrucción de SQLINSERTen las tablas que se especifican en la sentenciaGRANT.Las siguientes declaraciones de DDL otorgan
SELECTen la tablaemployeesal rol de base de datoshr_rep.GoogleSQL
CREATE ROLE hr_rep; GRANT SELECT ON TABLE employees TO ROLE hr_rep;PostgreSQL
CREATE ROLE hr_rep; GRANT SELECT ON TABLE employees TO hr_rep;Para obtener más información sobre los privilegios, consulta Referencia de privilegios de control de acceso detallado.
Sentencias
GRANTpara otorgar roles a otros roles y crear jerarquías de roles, con herencia de privilegios.
Casos de uso
Los siguientes son casos de uso de ejemplo para el control de acceso detallado:
- Un sistema de información de RR.HH. que tiene roles para analista de compensación de ventas, administración de ventas y analista de RR.HH., cada uno con diferentes niveles de acceso a los datos. Por ejemplo, los analistas de compensación y la administración de ventas no deberían ver los números de seguridad social.
- Una aplicación de viajes compartidos con diferentes cuentas de servicio y privilegios para pasajeros y conductores.
- Un libro mayor que permite operaciones
SELECTyINSERT, pero no operacionesUPDATEyDELETE.
Recursos de Spanner y sus privilegios
A continuación, se incluye una lista de los recursos de Spanner y los privilegios de control de acceso detallado que puedes otorgarles.
- Esquemas
- Puedes otorgar el privilegio
USAGEen esquemas a roles de base de datos específicos. Para un esquema no predeterminado, los roles de la base de datos deben tener el privilegioUSAGEpara acceder a los objetos de la base de datos. La verificación de privilegios se ve de la siguiente manera:
¿Tienes USAGE en el esquema?
No: Rechaza el acceso.
Sí: ¿También tienes los derechos adecuados en la tabla?
No: Rechaza el acceso.
Sí: Puedes acceder a la tabla.
- Tablas
- Puedes otorgar los privilegios
SELECT,INSERT,UPDATEyDELETEen las tablas a los roles de la base de datos. En el caso de las tablas intercaladas, un privilegio otorgado en la tabla superior no se propaga a la tabla secundaria. - Columnas
- Puedes otorgar
SELECT,INSERTyUPDATEen un subconjunto de columnas de una tabla. Luego, el privilegio solo es válido para esas columnas. No se permiteDELETEa nivel de columna. - Vistas
- Puedes otorgar el privilegio
SELECTen una vista. Solo se admiteSELECTpara las vistas. Spanner admite vistas de privilegios del invocador y vistas de privilegios del definidor. Si creas una vista con derechos de invocador, para consultar la vista, el rol o el usuario de la base de datos necesita el privilegioSELECTen la vista y también el privilegioSELECTen los objetos subyacentes a los que se hace referencia en la vista. Si creas una vista con derechos de definidor, para consultar la vista, el rol o el usuario de la base de datos solo necesita el privilegioSELECTen la vista. Para obtener más información, consulta Descripción general de las vistas. - Flujos de cambios
- Puedes otorgar
SELECTen los flujos de cambios. También debes otorgarEXECUTEen la función de lectura asociada con un flujo de cambios. Para obtener más información, consulta Control de acceso detallado para los flujos de cambios. - Secuencias
- Puedes otorgar
SELECTyUPDATEen las secuencias. Para obtener información, consulta Control de acceso detallado para secuencias. - Modelos
- Puedes otorgar
EXECUTEen los modelos. Para obtener más información, consulta Control de acceso detallado para modelos.
Roles del sistema de control de acceso detallado
El control de acceso detallado tiene roles del sistema predefinidos para cada base de datos. Al igual que los roles de base de datos definidos por el usuario, los roles del sistema pueden controlar el acceso a los recursos de Spanner.
Por ejemplo, a un usuario con control de acceso detallado se le debe otorgar el rol del sistema spanner_sys_reader para acceder a Key Visualizer y necesita el rol del sistema spanner_info_reader para poder ver los resultados sin filtrar cuando consulta las tablas INFORMATION_SCHEMA.
Para obtener más información, consulta Roles del sistema de control de acceso detallado.
Jerarquías y herencia de roles de bases de datos
Puedes crear jerarquías de roles de base de datos, en las que los roles secundarios heredan los privilegios de los roles superiores. Los roles secundarios se conocen como miembros del rol superior.
Por ejemplo, considera las siguientes declaraciones GRANT:
GoogleSQL
GRANT SELECT ON TABLE employees TO ROLE pii_access;
GRANT ROLE pii_access TO ROLE hr_manager, hr_director;
PostgreSQL
GRANT SELECT ON TABLE employees TO pii_access;
GRANT pii_access TO hr_manager, hr_director;
hr_manager y hr_director son miembros del rol pii_access y heredan el privilegio SELECT en la tabla employees.

hr_manager y hr_director también pueden tener miembros, y esos miembros heredarían
el privilegio SELECT en employees.
No hay límites en la profundidad de las jerarquías de roles, pero el rendimiento de las consultas puede disminuir con estructuras de jerarquía de roles profundas y amplias.
Copia de seguridad y restablecimiento
Las copias de seguridad de Spanner incluyen definiciones de roles de base de datos. Cuando se restablece una base de datos a partir de una copia de seguridad, se vuelven a crear los roles de la base de datos con los privilegios otorgados. Sin embargo, las políticas de IAM no forman parte de las copias de seguridad de la base de datos, por lo que debes volver a otorgar acceso a los roles de la base de datos a las principales en la base de datos restablecida.
Descripción general de la configuración del control de acceso detallado
A continuación, se indican los pasos generales que debes seguir para comenzar a proteger los datos con el control de acceso detallado. Para obtener más detalles, consulta Configura el control de acceso detallado.
Debes tener los roles de IAM roles/spanner.admin o
roles/spanner.databaseAdmin para realizar estas tareas.
- Crear roles de base de datos y otorgarles privilegios
- Opcional: Crea jerarquías de roles con herencia otorgando roles a otros roles.
- Realiza estos pasos para cada principal que será un usuario de control de acceso detallado:
- Habilita el control de acceso detallado para la principal.
Luego, se le otorga automáticamente a la principal el rol de base de datos
public, que no tiene privilegios de forma predeterminada. Esta es una operación única para cada principal. - Otorga permisos de IAM en uno o más roles de base de datos a la principal.
- Después de que se otorguen todos los roles de base de datos requeridos a la principal, si esta tiene roles de IAM a nivel de la base de datos, considera revocar los roles a nivel de la base de datos para que el control de acceso de la principal se administre con un solo método.
- Habilita el control de acceso detallado para la principal.
Luego, se le otorga automáticamente a la principal el rol de base de datos
Limitaciones
- Las operaciones de exportación no exportan roles ni privilegios de la base de datos, y las operaciones de importación no pueden importarlos. Debes configurar manualmente los roles y privilegios después de que se complete la importación.
- La pestaña Datos de la página TABLA de la consola de Google Cloud no está disponible para los usuarios con control de acceso detallado.
¿Qué sigue?
- Accede a una base de datos con control de acceso detallado
- Control de acceso detallado para los flujos de cambios
- Configura el control de acceso detallado
- Referencia de privilegios de control de acceso detallado
- Roles del sistema de control de acceso detallado
- Declaraciones
GRANTyREVOKEde GoogleSQL - Sentencias
GRANTyREVOKEde PostgreSQL - Control de acceso detallado para secuencias
- Control de acceso detallado para modelos