sp_column_privileges (Transact-SQL)

Artikel
05/23/2023

Gilt für:SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Gibt Informationen zu Spaltenprivilegien für eine einzelne Tabelle in der aktuellen Umgebung zurück.

Syntax

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

Argumente

[ @table_name= ] 'table_name'
Die Tabelle zum Zurückgeben von Kataloginformationen. table_name ist sysname, ohne Standardwert. Mustervergleiche mit Platzhalterzeichen werden nicht unterstützt.

[ @table_owner= ] 'table_owner'
Der Besitzer der Tabelle, die zum Zurückgeben von Kataloginformationen verwendet wird. table_owner ist sysname mit dem Standardwert NULL. Mustervergleiche mit Platzhalterzeichen werden nicht unterstützt. Wenn table_owner nicht angegeben wird, gelten die Standardregeln für die Tabellensichtbarkeit des zugrunde liegenden Datenbankverwaltungssystems (DBMS).

Wenn der aktuelle Benutzer eine Tabelle mit dem angegebenen Namen besitzt, werden die Spalten dieser Tabelle zurückgegeben. Wenn table_owner nicht angegeben ist und der aktuelle Benutzer keine Tabelle mit dem angegebenen table_name besitzt, sucht sp_column Berechtigungen nach einer Tabelle mit dem angegebenen table_name im Besitz des Datenbankbesitzers. Sofern eine solche Tabelle vorhanden ist, werden die Spalten dieser Tabelle zurückgegeben.

[ @table_qualifier= ] 'table_qualifier'
Der Name des Tabellenqualifizierers. table_qualifier ist sysname mit dem Standardwert NULL. Verschiedene DBMS-Produkte unterstützen dreiteilige Benennungen für Tabellen (Qualifizierer.besitzer.Name). In SQL Server stellt diese Spalte den Datenbanknamen dar. Bei anderen Produkten stellt sie den Servernamen der Datenbankumgebung für die Tabelle dar.

[ @column_name=] Spalte
Eine einzelne Spalte, die verwendet wird, wenn nur eine Spalte mit Kataloginformationen empfangen wird. column ist nvarchar(384) mit dem Standardwert NULL. Wenn keine Spalte angegeben wird, werden alle Spalten zurückgegeben. In SQL Server stellt die Spalte den Spaltennamen dar, der in der Tabelle sys.columns aufgeführt ist. Die Spalte kann MitPlatzhalterzeichen enthalten, die die Zuordnungsmuster des zugrunde liegenden DBMS verwenden. Für eine optimale Interoperabilität sollte der Gatewayclient nur einen ISO-Standardmustervergleich voraussetzen (die Platzhalterzeichen % und _).

Resultsets

sp_column_privileges entspricht SQLColumnPrivileges in ODBC. Die zurückgegebenen Ergebnisse sind nach den Spalten TABLE_QUALIFIER, TABLE_OWNER, TABLE_NAME, COLUMN_NAME und PRIVILEGE sortiert.

Spaltenname	Datentyp	BESCHREIBUNG
TABLE_QUALIFIER	sysname	Tabellenqualifizierername. Dieses Feld kann den Wert NULL annehmen.
TABLE_OWNER	sysname	Name des Tabellenbesitzers. Dieses Feld gibt immer einen Wert zurück.
table_name	sysname	Tabellenname. Dieses Feld gibt immer einen Wert zurück.
COLUMN_NAME	sysname	Der Name der Spalte für jede Spalte des zurückgegebenen TABLE_NAME. Dieses Feld gibt immer einen Wert zurück.
GRANTOR	sysname	Der Datenbank-Benutzername, der dem als GRANTEE aufgeführten Prinzipal Berechtigungen für die mit COLUMN_NAME angegebene Spalte erteilt hat. In SQL Server ist diese Spalte immer mit der TABLE_OWNER identisch. Dieses Feld gibt immer einen Wert zurück. Die GRANTOR-Spalte kann entweder der Datenbankbesitzer (TABLE_OWNER) oder ein anderer Benutzer sein, dem die Berechtigungen vom Datenbankbesitzer mithilfe der WITH GRANT OPTION-Klausel in der GRANT-Anweisung erteilt wurden.
GRANTEE	sysname	Der Datenbank-Benutzername, dem der als GRANTOR aufgeführte Prinzipal Berechtigungen für die mit COLUMN_NAME angegebene Spalte erteilt hat. In SQL Server enthält diese Spalte immer einen Datenbankbenutzer aus der Sysusers-Tabelle. Dieses Feld gibt immer einen Wert zurück.
PRIVILEGE	varchar(32)	Eine der verfügbaren Spaltenberechtigungen. Spaltenberechtigungen können folgende Werte annehmen (oder auch andere Werte, die von der Datenquelle bei der Definition der Implementierung unterstützt werden): SELECT = der Berechtigte (GRANTEE) kann Daten für die Spalten abrufen. INSERT = der Berechtigte (GRANTEE) kann Daten für diese Spalten bereitstellen, wenn neue Zeilen (von diesem GRANTEE) in die Tabelle eingefügt werden. UPDATE = der Berechtigte (GRANTEE) kann vorhandene Daten in der Spalte ändern. REFERENCES = der Berechtigte (GRANTEE) kann bei einer Primär-/Fremdschlüssel-Beziehung auf eine Spalte in einer Fremdschlüsseltabelle verweisen. Primär-/Fremdschlüssel-Beziehungen werden mithilfe von Tabelleneinschränkungen definiert.
IS_GRANTABLE	varchar(3)	Zeigt an, ob der Berechtigte (GRANTEE) anderen Benutzern Berechtigungen erteilen darf (bekannt als "Berechtigung mit Recht zum Erteilen"). Dieses Feld kann die Werte YES, NO oder NULL annehmen. Ein unbekannter Wert (oder NULL-Wert) verweist auf eine Datenquelle, für die die "Berechtigung mit Recht zum Erteilen" nicht zutreffend ist.

Bemerkungen

Bei SQL Server werden Berechtigungen mit der GRANT-Anweisung erteilt und von der REVOKE-Anweisung entfernt.

Berechtigungen

Erfordert SELECT-Berechtigung für das Schema.

Beispiele

Im folgenden Beispiel werden Informationen zum Spaltenprivileg für eine bestimmte Spalte zurückgegeben.

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

Weitere Informationen

GRANT (Transact-SQL)
REVOKE (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)