REVOKE (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Quita un permiso concedido o denegado previamente.

Convenciones de sintaxis de Transact-SQL

Sintaxis

-- Syntax for SQL Server and Azure SQL Database  
  
-- Simplified syntax for REVOKE  
REVOKE [ GRANT OPTION FOR ]  
      {   
        [ ALL [ PRIVILEGES ] ]  
        |  
                permission [ ( column [ ,...n ] ) ] [ ,...n ]  
      }  
      [ ON [ class :: ] securable ]   
      { TO | FROM } principal [ ,...n ]   
      [ CASCADE] [ AS principal ]  
-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse and Microsoft Fabric
  
REVOKE   
    <permission> [ ,...n ]  
    [ ON [ <class_type> :: ] securable ]   
    [ FROM | TO ] principal [ ,...n ]  
    [ CASCADE ]  
[;]  
  
<permission> ::=  
{ see the tables below }  
  
<class_type> ::=  
{  
      LOGIN  
    | DATABASE  
    | OBJECT  
    | ROLE  
    | SCHEMA  
    | USER  
}  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

GRANT OPTION FOR
Indica que se revocará la capacidad de conceder el permiso especificado. Se requiere cuando se utiliza el argumento CASCADE.

Importante

Si la entidad de seguridad dispone del permiso especificado sin la opción GRANT, se revocará el permiso.

ALL
Se aplica a: SQL Server 2008 (10.0.x) y versiones posteriores

Esta opción no revoca todos los permisos posibles. Revocar ALL es equivalente a revocar los siguientes permisos.

  • Si el elemento protegible es una base de datos, ALL significa BACKUP DATABASE, BACKUP LOG, CREATE DATABASE, CREATE DEFAULT, CREATE FUNCTION, CREATE PROCEDURE, CREATE RULE, CREATE TABLE y CREATE VIEW.

  • Si el elemento protegible es una función escalar, ALL significa EXECUTE y REFERENCES.

  • Si el elemento protegible es una función con valores de tabla, ALL significa DELETE, INSERT, REFERENCES, SELECT y UPDATE.

  • Si el elemento protegible es un procedimiento almacenado, ALL significa EXECUTE.

  • Si el elemento protegible es una tabla, ALL significa DELETE, INSERT, REFERENCES, SELECT y UPDATE.

  • Si el elemento protegible es una vista, ALL significa DELETE, INSERT, REFERENCES, SELECT y UPDATE.

Nota:

La sintaxis de REVOKE ALL ha quedado desusada. Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, revoque permisos concretos.

PRIVILEGES
Incluido por compatibilidad con ISO. No cambia el comportamiento de ALL.

permission
Es el nombre de un permiso. Las asignaciones válidas de permisos a elementos protegibles se describen en los temas de la sección Sintaxis específica de los elementos protegibles, más adelante en este tema.

column
Especifica el nombre de una columna de una tabla en la que se van a revocar los permisos. Es obligatorio utilizar paréntesis.

class
Especifica la clase del elemento protegible para el que se va a revocar el permiso. El calificador de ámbito :: es obligatorio.

securable
Especifica el elemento protegible para el que se va a revocar el permiso.

TO | FROM principal
Es el nombre de una entidad de seguridad. Las entidades de seguridad de las que se pueden revocar permisos para un elemento protegible varían según el elemento. Para más información sobre las combinaciones válidas, vea los temas que se muestran en Sintaxis específica de los elementos protegibles más adelante en este tema.

CASCADE
Indica que el permiso que se va a revocar también se revocará de otras entidades de seguridad a las que se han concedido permisos por esta entidad de seguridad. Cuando se utiliza el argumento CASCADE, también se debe incluir el argumento GRANT OPTION FOR.

Precaución

Una revocación en cascada de un permiso concedido WITH GRANT OPTION revocará tanto GRANT como DENY de dicho permiso.

AS principal
Use la cláusula AS principal para indicar que se va a revocar un permiso que ha sido concedido por una entidad de seguridad distinta de usted. Por ejemplo, imagine que la usuaria María tiene el valor principal_id 12 y el usuario Raúl tiene el valor principal_id 15. Tanto María como Raúl conceden el mismo permiso a un usuario llamado Carlos. La tabla sys.database_permissions indicará los permisos dos veces, pero cada uno tendrá un valor de grantor_principal_id diferente. María podría revocar el permiso mediante la cláusula AS RAUL para quitar la concesión del permiso de Raúl.

El uso de AS en esta instrucción no implica la capacidad de suplantar a otro usuario.

Observaciones

La sintaxis completa de la instrucción REVOKE es compleja. El diagrama de sintaxis anterior se ha simplificado para concentrar la atención en su estructura. La sintaxis completa para revocar permisos en elementos protegibles específicos se describe en los temas que se muestran en Sintaxis específica de los elementos protegibles más adelante en este tema.

Se puede utilizar la instrucción REVOKE para retirar permisos concedidos y la instrucción DENY para evitar que una entidad de seguridad obtenga un permiso específico mediante una instrucción GRANT.

La concesión de un permiso quita DENY o REVOKE de ese permiso para el elemento protegible especificado. Si se deniega el mismo permiso en un ámbito superior que contiene el elemento protegible, DENY tiene prioridad. Pero tenga en cuenta que revocar el permiso concedido en un ámbito superior no tiene prioridad.

Precaución

Un permiso DENY de nivel de tabla no tiene prioridad sobre uno GRANT de nivel de columna. Se ha conservado esta incoherencia en la jerarquía de permisos para mantener la compatibilidad con versiones anteriores. Se eliminará en una próxima versión.

El procedimiento almacenado del sistema sp_helprotect informa de los permisos sobre un elemento protegible en el nivel de base de datos.

La instrucción REVOKE generará errores si no se especifica CASCADE al revocar un permiso de una entidad de seguridad que tenía concedido ese permiso con GRANT OPTION especificada.

Permisos

Las entidades de seguridad con el permiso CONTROL para un elemento protegible pueden revocar permisos para ese elemento. Los propietarios de objetos pueden revocar permisos en los objetos que poseen.

Los receptores del permiso CONTROL SERVER, como los miembros del rol fijo de servidor sysadmin, pueden revocar los permisos en cualquier elemento protegible en el servidor. Los receptores del permiso CONTROL en una base de datos, como los miembros del rol fijo de base de datos db_owner, pueden revocar los permisos en cualquier elemento protegible en la base de datos. Los receptores del permiso CONTROL en un esquema pueden revocar los permisos en cualquier objeto del esquema.

Sintaxis específica de los elementos protegibles

En esta tabla se enumeran los elementos protegibles y los temas donde se describe la sintaxis específica de los mismos.

Elemento protegible Tema
Rol de aplicación REVOKE (permisos de entidad de seguridad de base de datos de Transact-SQL)
Ensamblado REVOKE (permisos de ensamblado de Transact-SQL)
Clave asimétrica REVOKE (permisos de clave asimétrica de Transact-SQL)
Grupo de disponibilidad Disponibilidad de los permisos de grupo REVOKE (Transact-SQL)
Certificado REVOKE (permisos de certificado de Transact-SQL)
Contrato REVOKE (permisos de Service Broker de Transact-SQL)
Base de datos REVOKE (permisos de base de datos de Transact-SQL)
Punto de conexión REVOKE (permisos de extremo de Transact-SQL)
Credencial de ámbito de base de datos REVOKE (credencial de ámbito de base de datos de Transact-SQL)
Catálogo de texto completo REVOKE (permisos de texto completo de Transact-SQL)
Lista de palabras irrelevantes de texto completo REVOKE (permisos de texto completo de Transact-SQL)
Función REVOKE (permisos de objeto de Transact-SQL)
Inicio de sesión REVOKE (permisos de entidad de seguridad de servidor de Transact-SQL)
Tipo de mensaje REVOKE (permisos de Service Broker de Transact-SQL)
Object REVOKE (permisos de objeto de Transact-SQL)
Cola REVOKE (permisos de objeto de Transact-SQL)
Enlace de servicio remoto REVOKE (permisos de Service Broker de Transact-SQL)
Role REVOKE (permisos de entidad de seguridad de base de datos de Transact-SQL)
Enrutar REVOKE (permisos de Service Broker de Transact-SQL)
Esquema REVOKE (permisos de esquema de Transact-SQL)
Lista de propiedades de búsqueda REVOCAR permisos de la lista de propiedades de búsqueda (Transact-SQL)
Server REVOKE (permisos de servidor de Transact-SQL)
Servicio REVOKE (permisos de Service Broker de Transact-SQL)
Procedimiento almacenado REVOKE (permisos de objeto de Transact-SQL)
Clave simétrica REVOKE (permisos de clave simétrica de Transact-SQL)
Synonym (Sinónimo) REVOKE (permisos de objeto de Transact-SQL)
Objetos de sistema REVOKE (permisos de objeto de sistema de Transact-SQL)
Tabla REVOKE (permisos de objeto de Transact-SQL)
Tipo REVOKE (permisos de tipo de Transact-SQL)
Usuario REVOKE (permisos de entidad de seguridad de base de datos de Transact-SQL)
Ver REVOKE (permisos de objeto de Transact-SQL)
Colección de esquemas XML REVOKE (permisos de colección de esquemas XML de Transact-SQL)

Ejemplos

A. Concesión y revocación

Se aplica a: SQL Server, SQL Database

En el ejemplo siguiente se crea un esquema, un usuario de base de datos independiente y un nuevo rol en una base de datos de usuario. Agrega el usuario al rol, concede el permiso SELECT al rol en el esquema y quita (REVOKE) ese permiso al rol.

CREATE SCHEMA Sales;  
GO
CREATE USER Joe without login;
GO
CREATE ROLE Vendors;
GO
ALTER ROLE Vendors ADD MEMBER Joe; 
GO
GRANT SELECT ON SCHEMA :: Sales TO Vendors;
GO
REVOKE SELECT ON SCHEMA :: Sales TO Vendors;
GO
 

Consulte también

Jerarquía de permisos (motor de base de datos)
DENY (Transact-SQL)
GRANT (Transact-SQL)
sp_addlogin (Transact-SQL)
sp_adduser (Transact-SQL)
sp_changedbowner (Transact-SQL)
sp_dropuser (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helpuser (Transact-SQL)