SUSER_SID (Transact-SQL)
Retorna o SID (número de identificação de segurança) para o nome de logon especificado.
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
SUSER_SID ( [ 'login' ] [ , Param2 ] )
Argumentos
' login '
É o nome de logon do usuário. login é sysname. login, que é opcional, pode ser um logon do SQL Server ou um usuário ou grupo do Microsoft Windows. Se o login não for especificado, serão retornadas informações sobre o contexto de segurança atual. Se o parâmetro contiver a palavra NULL, retornará NULL.Param2
Especifica se o nome de logon é validado. Param2 é do tipo int e é opcional. Quando Param2 for 0, o nome de logon não será validado. Quando Param2 não estiver especificado como 0, será verificado se o nome de logon do Windows é exatamente igual ao nome de logon armazenado no SQL Server.
Tipos de retorno
varbinary(85)
Comentários
SUSER_SID pode ser usado como uma restrição DEFAULT em ALTER TABLE ou CREATE TABLE. SUSER_ID pode ser usado em uma lista de seleção, em uma cláusula WHERE ou em qualquer local em que uma expressão seja permitida. SUSER_SID deve sempre ser seguido de parênteses, mesmo que nenhum parâmetro seja especificado.
Quando chamado sem um argumento, SUSER_SID retorna o SID do contexto de segurança atual. Quando chamado sem um argumento em um lote que alternou o contexto usando EXECUTE AS, SUSER_SID retorna o SID do contexto representado. Quando chamado de um contexto representado, SUSER_SID(ORIGINAL_LOGIN()) retorna o SID contexto original.
No caso de o agrupamento do SQL Server e o agrupamento do Windows serem diferentes, SUSER_SID poderá falhar quando o SQL Server e o Windows armazenarem o logon em um formato diferente. Por exemplo, se o computador Windows TestComputer tiver o logon User e o SQL Server armazenar o logon como TESTCOMPUTER\User, a pesquisa do logon TestComputer\User talvez não seja capaz de resolver o nome de logon corretamente. Para ignorar essa validação do nome de logon, use Param2. A diferenciação de agrupamentos é geralmente provocada pelo erro 15401 do SQL Server:
Windows NT user or group '%s' not found. Check the name again.
Exemplos
A.Usando SUSER_SID
O exemplo a seguir retorna o número de identificação de segurança para o logon sa do SQL Server.
SELECT SUSER_SID('sa');
GO
B.Usando SUSER_SID com um nome de usuário do Windows
O exemplo a seguir retorna o número de identificação de segurança para o usuário do Windows London\Workstation1.
SELECT SUSER_SID('London\Workstation1');
GO
C.Usando SUSER_SID como uma restrição DEFAULT
O exemplo a seguir usa SUSER_SID como uma restrição DEFAULT em uma instrução CREATE TABLE.
USE AdventureWorks2012;
GO
CREATE TABLE sid_example
(
login_sid varbinary(85) DEFAULT SUSER_SID(),
login_name varchar(30) DEFAULT SYSTEM_USER,
login_dept varchar(10) DEFAULT 'SALES',
login_date datetime DEFAULT GETDATE()
);
GO
INSERT sid_example DEFAULT VALUES;
GO
D.Comparando o nome de logon do Windows ao nome de logon armazenado no SQL Server
O exemplo a seguir mostra como usar Param2 para obter o SID do Windows e usa esse SID como uma entrada para a função SUSER_SNAME. O exemplo fornece o logon no formato em que está armazenado no Windows (TestComputer\User) e o retorna no formato em que está armazenado no SQL Server (TESTCOMPUTER\User).
SELECT SUSER_SNAME(SUSER_SID('TestComputer\User', 0));