Artículo
03/30/2012

sp_column_privileges (Transact-SQL)

Devuelve información acerca de los privilegios de columna de una tabla del entorno actual.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_column_privileges [ @table_name = ] 'table_name' 
     [ , [ @table_owner = ] 'table_owner' ] 
     [ , [ @table_qualifier = ] 'table_qualifier' ] 
     [ , [ @column_name = ] 'column' ]

Argumentos

[ @table_name = ] 'table_name'
Es la tabla que se usa para devolver información de catálogo. table_name es de tipo sysname y no tiene ningún valor predeterminado. No se admite la coincidencia de patrón de caracteres comodín.
[ @table_owner = ] 'table_owner'
Es el propietario de la tabla que se usa para devolver información de catálogo. table_owner es de tipo sysname y su valor predeterminado es NULL. No se admite la coincidencia de patrón de caracteres comodín. Si no se especifica el parámetro table_owner, se aplican las reglas predeterminadas de visibilidad de tabla del sistema de administración de bases de datos (DBMS) subyacente.

Si el usuario actual es propietario de una tabla con el nombre especificado, se devuelven las columnas de esa tabla. Si no se especifica table_owner y el usuario actual no es el propietario de una tabla con el valor de table_name especificado, los sp_columnprivileges buscan una tabla con el parámetro table_name especificado que pertenezca al propietario de la base de datos. Si hay una, se devuelven las columnas de esa tabla.
[ @table_qualifier = ] 'table_qualifier'
Es el nombre del calificador de la tabla. table_qualifier es de tipo sysname y su valor predeterminado es NULL. Varios productos DBMS admiten nombres de tres partes para las tablas (qualifier**.owner.**name). En SQL Server, esta columna representa el nombre de la base de datos. En algunos productos, representa el nombre del servidor del entorno de base de datos de la tabla.
[ @column_name = ] 'column'
Es una sola columna que se usa cuando sólo se obtiene una columna de información del catálogo. column es de tipo nvarchar(384) y su valor predeterminado es NULL. Si no se especifica el parámetro column, se devolverán todas las columnas. En SQL Server, column representa el nombre de la columna tal y como aparece en la tabla sys.columns. column puede incluir caracteres comodín mediante patrones de coincidencia de caracteres comodín del DBMS subyacente. Para obtener una interoperabilidad máxima, el cliente de puerta de enlace solo debe dar por supuesta la coincidencia de patrón estándar de ISO (caracteres comodín % y _).

Conjuntos de resultados

sp_column_privileges es equivalente a SQLColumnPrivileges en ODBC. Los resultados devueltos se ordenan por TABLE_QUALIFIER, TABLE_OWNER, TABLE_NAME, COLUMN_NAME y PRIVILEGE.

Nombre de columna	Tipo de datos	Descripción
TABLE_QUALIFIER	sysname	Nombre del calificador de la tabla. Este campo puede ser NULL.
TABLE_OWNER	sysname	Nombre del propietario de la tabla. Este campo siempre devuelve un valor.
TABLE_NAME	sysname	Nombre de la tabla. Este campo siempre devuelve un valor.
COLUMN_NAME	sysname	Nombre de columna por cada columna devuelta de TABLE_NAME. Este campo siempre devuelve un valor.
GRANTOR	sysname	Nombre del usuario de la base de datos que ha concedido permisos para COLUMN_NAME al GRANTEE presentado. En SQL Server, esta columna es siempre la misma que en TABLE_OWNER. Este campo siempre devuelve un valor. La columna GRANTOR puede ser el propietario de la base de datos (TABLE_OWNER) o un usuario al que el propietario de la base de datos le haya concedido permisos mediante la cláusula WITH GRANT OPTION en la instrucción GRANT.
GRANTEE	sysname	Nombre del usuario de la base de datos al que el GRANTOR presentado le ha concedido permisos para COLUMN_NAME. En SQL Server, esta columna incluye siempre un usuario de la base de datos de la tabla sysusers. Este campo siempre devuelve un valor.
PRIVILEGE	varchar(32)	Uno de los permisos de columna disponibles. Los permisos de columna pueden ser uno de los valores siguientes (u otros valores compatibles con el origen de datos cuando se define la implementación): SELECT = GRANTEE puede recuperar datos de las columnas. INSERT = GRANTEE puede proporcionar datos para esta columna cuando se inserten nuevas filas (por parte de GRANTEE) en la tabla. UPDATE = GRANTEE puede modificar datos existentes en la columna. REFERENCES = GRANTEE puede hacer referencia a una columna de una tabla externa en una relación entre clave principal y clave externa. Las relaciones entre clave principal y clave externa se definen mediante restricciones de tabla.
IS_GRANTABLE	varchar(3)	Indica si se permite que GRANTEE conceda permisos a otros usuarios (a menudo se hace referencia a esta operación como permiso “conceder por concesión”). Puede ser YES, NO o NULL. Un valor desconocido, o NULL, hace referencia a un origen de datos para el que “conceder por concesión” no se aplica.

Comentarios

Con SQL Server, los permisos se conceden mediante la instrucción GRANT y se retiran mediante la instrucción REVOKE.

Permisos

Requiere el permiso SELECT en el esquema.

Ejemplos

En el siguiente ejemplo se devuelve información acerca de privilegios de columna de una tabla específica.

USE AdventureWorks2008R2;
GO
EXEC sp_column_privileges @table_name = 'Employee' 
    ,@table_owner = 'HumanResources'
    ,@table_qualifier = 'AdventureWorks2008R2'
    ,@column_name = 'SalariedFlag';