EXECUTAR (Transact-SQL)

Artigo
12/21/2024

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)ponto de extremidade de análise SQL no Microsoft Fabric Warehouse no Microsoft Fabric banco de dados SQL no Microsoft Fabric

Executa uma cadeia de caracteres de comando ou cadeia de caracteres dentro de um lote de Transact-SQL ou um dos seguintes módulos: procedimento armazenado do sistema, procedimento armazenado definido pelo usuário, procedimento armazenado CLR, função definida pelo usuário com valor escalar ou procedimento armazenado estendido. A instrução EXEC ou EXECUTE pode ser usada para enviar comandos de passagem para servidores vinculados. Além disso, o contexto no qual uma cadeia de caracteres ou comando é executado pode ser definido explicitamente. Os metadados para o conjunto de resultados podem ser definidos usando as opções WITH RESULT SETS.

Importante

Antes de chamar EXECUTE com uma cadeia de caracteres, valide a cadeia de caracteres. Nunca execute um comando construído a partir da entrada do usuário que não tenha sido validado.

Transact-SQL convenções de sintaxe

Sintaxe

O bloco de código a seguir mostra a sintaxe no SQL Server 2019 (15.x) e versões posteriores. Como alternativa, consulte sintaxe no SQL Server 2017 e anteriores.

Sintaxe para SQL Server 2019 e versões posteriores.

-- Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    {
      [ @return_status = ]
      { module_name [ ;number ] | @module_name_var }
        [ [ @parameter = ] { value
                           | @variable [ OUTPUT ]
                           | [ DEFAULT ]
                           }
        ]
      [ ,...n ]
      [ WITH <execute_option> [ ,...n ] ]
    }
[ ; ]

-- Execute a character string
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS { LOGIN | USER } = ' name ' ]
[ ; ]

-- Execute a pass-through command against a linked server
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ] 'command_string [ ? ]' } [ + ...n ]
        [ { , { value | @variable [ OUTPUT ] } } [ ...n ] ]
    )
    [ AS { LOGIN | USER } = ' name ' ]
    [ AT linked_server_name ]
    [ AT DATA_SOURCE data_source_name ]
[ ; ]

<execute_option>::=
{
        RECOMPILE
    | { RESULT SETS UNDEFINED }
    | { RESULT SETS NONE }
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
}

<result_sets_definition> ::=
{
    (
         { column_name
           data_type
         [ COLLATE collation_name ]
         [ NULL | NOT NULL ] }
         [,...n ]
    )
    | AS OBJECT
        [ db_name . [ schema_name ] . | schema_name . ]
        {table_name | view_name | table_valued_function_name }
    | AS TYPE [ schema_name.]table_type_name
    | AS FOR XML
}

O bloco de código a seguir mostra a sintaxe no SQL Server 2017 (14.x) e versões anteriores. Como alternativa, consulte sintaxe no SQL Server 2019 em vez disso.

Sintaxe do SQL Server 2017 e versões anteriores.

-- Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    {
      [ @return_status = ]
      { module_name [ ;number ] | @module_name_var }
        [ [ @parameter = ] { value
                           | @variable [ OUTPUT ]
                           | [ DEFAULT ]
                           }
        ]
      [ ,...n ]
      [ WITH <execute_option> [ ,...n ] ]
    }
[ ; ]

-- Execute a character string
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS { LOGIN | USER } = ' name ' ]
[ ; ]

-- Execute a pass-through command against a linked server
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ] 'command_string [ ? ]' } [ + ...n ]
        [ { , { value | @variable [ OUTPUT ] } } [ ...n ] ]
    )
    [ AS { LOGIN | USER } = ' name ' ]
    [ AT linked_server_name ]
[ ; ]

<execute_option>::=
{
        RECOMPILE
    | { RESULT SETS UNDEFINED }
    | { RESULT SETS NONE }
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
}

<result_sets_definition> ::=
{
    (
         { column_name
           data_type
         [ COLLATE collation_name ]
         [ NULL | NOT NULL ] }
         [,...n ]
    )
    | AS OBJECT
        [ db_name . [ schema_name ] . | schema_name . ]
        {table_name | view_name | table_valued_function_name }
    | AS TYPE [ schema_name.]table_type_name
    | AS FOR XML
}

Sintaxe para In-Memory OLTP.

-- Execute a natively compiled, scalar user-defined function
[ { EXEC | EXECUTE } ]
    {
      [ @return_status = ]
      { module_name | @module_name_var }
        [ [ @parameter = ] { value
                           | @variable
                           | [ DEFAULT ]
                           }
        ]
      [ ,...n ]
      [ WITH <execute_option> [ ,...n ] ]
    }
<execute_option>::=
{
    | { RESULT SETS UNDEFINED }
    | { RESULT SETS NONE }
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
}

Sintaxe do Banco de Dados SQL do Azure.

-- Execute a stored procedure or function
[ { EXEC | EXECUTE } ]
    {
      [ @return_status = ]
      { module_name  | @module_name_var }
        [ [ @parameter = ] { value
                           | @variable [ OUTPUT ]
                           | [ DEFAULT ]
                           }
        ]
      [ ,...n ]
      [ WITH RECOMPILE ]
    }
[ ; ]

-- Execute a character string
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ]'tsql_string' } [ + ...n ] )
    [ AS {  USER } = ' name ' ]
[ ; ]

<execute_option>::=
{
        RECOMPILE
    | { RESULT SETS UNDEFINED }
    | { RESULT SETS NONE }
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
}

<result_sets_definition> ::=
{
    (
         { column_name
           data_type
         [ COLLATE collation_name ]
         [ NULL | NOT NULL ] }
         [,...n ]
    )
    | AS OBJECT
        [ db_name . [ schema_name ] . | schema_name . ]
        {table_name | view_name | table_valued_function_name }
    | AS TYPE [ schema_name.]table_type_name
    | AS FOR XML
}

Sintaxe para o Azure Synapse Analytics e o Parallel Data Warehouse.

-- Execute a stored procedure
[ { EXEC | EXECUTE } ]
    procedure_name
        [ { value | @variable [ OUT | OUTPUT ] } ] [ ,...n ]
[ ; ]

-- Execute a SQL string
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ] 'tsql_string' } [ +...n ] )
[ ; ]

Sintaxe do Microsoft Fabric.

-- Execute a stored procedure
[ { EXEC | EXECUTE } ]
    procedure_name
        [ { value | @variable [ OUT | OUTPUT ] } ] [ ,...n ]
        [ WITH <execute_option> [ ,...n ] ]  }
[ ; ]

-- Execute a SQL string
{ EXEC | EXECUTE }
    ( { @string_variable | [ N ] 'tsql_string' } [ +...n ] )
[ ; ]

<execute_option>::=
{
        RECOMPILE
    | { RESULT SETS UNDEFINED }
    | { RESULT SETS NONE }
    | { RESULT SETS ( <result_sets_definition> [,...n ] ) }
}

Argumentos

@return_status

Uma variável inteira opcional que armazena o status de retorno de um módulo. Essa variável deve ser declarada no lote, procedimento armazenado ou função antes de ser usada em uma instrução EXECUTE.

Quando usada para invocar uma função definida pelo usuário com valor escalar, a variável @return_status pode ser de qualquer tipo de dados escalar.

module_name

O nome totalmente qualificado ou não totalmente qualificado do procedimento armazenado ou da função definida pelo usuário com valor escalar a ser chamada. Os nomes dos módulos devem estar em conformidade com as regras para identificadores. Os nomes dos procedimentos armazenados estendidos sempre diferenciam maiúsculas de minúsculas, independentemente do agrupamento do servidor.

Um módulo que foi criado em outro banco de dados pode ser executado se o usuário que executa o módulo for proprietário do módulo ou tiver a permissão apropriada para executá-lo nesse banco de dados. Um módulo pode ser executado em outro servidor que executa o SQL Server se o usuário que executa o módulo tiver a permissão apropriada para usar esse servidor (acesso remoto) e executar o módulo nesse banco de dados. Se um nome de servidor for especificado, mas nenhum nome de banco de dados for especificado, o Mecanismo de Banco de Dados do SQL Server procurará o módulo no banco de dados padrão do usuário.

;número

Um inteiro opcional que é usado para agrupar procedimentos com o mesmo nome. Este parâmetro não é usado para procedimentos armazenados estendidos.

Observação

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso.

Para obter mais informações sobre grupos de procedimentos, consulte CREATE PROCEDURE.

@module_name_var

O nome de uma variável definida localmente que representa um nome de módulo.

Esta pode ser uma variável que contém o nome de uma função escalar definida pelo usuário nativamente compilada.

@parameter

O parâmetro para module_name, conforme definido no módulo. Os nomes dos parâmetros devem ser precedidos pelo sinal de arroba (@). Quando usado com o @parameter_name = valor formulário, os nomes de parâmetros e constantes não precisam ser fornecidos na ordem em que são definidos no módulo. No entanto, se o valor @parameter_name = formulário for usado para qualquer parâmetro, ele deve ser usado para todos os parâmetros subsequentes.

Por padrão, os parâmetros são anuláveis.

valor

O valor do parâmetro a ser passado para o módulo ou comando pass-through. Se os nomes dos parâmetros não forem especificados, os valores dos parâmetros deverão ser fornecidos na ordem definida no módulo.

Ao executar comandos de passagem em servidores vinculados, a ordem dos valores dos parâmetros depende do provedor OLE DB do servidor vinculado. A maioria dos provedores OLE DB vincula valores a parâmetros da esquerda para a direita.

Se o valor de um parâmetro for um nome de objeto, cadeia de caracteres ou qualificado por um nome de banco de dados ou nome de esquema, o nome inteiro deverá ser colocado entre aspas simples. Se o valor de um parâmetro for uma palavra-chave, a palavra-chave deve ser colocada entre aspas duplas.

Se você passar uma única palavra que não comece com @, que não esteja entre aspas (por exemplo, se você esquecer @ em um nome de parâmetro), a palavra será tratada como uma nvarchar string, apesar das aspas ausentes.

Se um padrão for definido no módulo, um usuário pode executar o módulo sem especificar um parâmetro.

O padrão também pode ser NULL. Geralmente, a definição de módulo especifica a ação que deve ser executada se um valor de parâmetro for NULL.

@variable

A variável que armazena um parâmetro ou um parâmetro de retorno.

REALIZAÇÃO

Especifica que o módulo ou a cadeia de caracteres de comando retorna um parâmetro. O parâmetro correspondente no módulo ou cadeia de caracteres de comando também deve ter sido criado usando a palavra-chave OUTPUT. Use essa palavra-chave quando usar variáveis de cursor como parâmetros.

Se valor for definido como OUTPUT de um módulo executado em um servidor vinculado, quaisquer alterações no @parameter correspondente executadas pelo provedor OLE DB serão copiadas de volta para a variável no final da execução do módulo.

Se OUTPUT parâmetros estiverem sendo usados e a intenção for usar os valores de retorno em outras instruções dentro do lote ou módulo de chamada, o valor do parâmetro deverá ser passado como uma variável, como @parameter = @variable. Não é possível executar um módulo especificando OUTPUT para um parâmetro que não está definido como um parâmetro OUTPUT no módulo. As constantes não podem ser passadas para o módulo usando OUTPUT; O parâmetro return requer um nome de variável. O tipo de dados da variável deve ser declarado e um valor atribuído antes de executar o procedimento.

Quando EXECUTE é usado em um procedimento armazenado remoto ou para executar um comando de passagem em um servidor vinculado, OUTPUT parâmetros não podem ser nenhum dos tipos de dados de objeto grande (LOB).

Os parâmetros de retorno podem ser de qualquer tipo de dados, exceto os tipos de dados LOB.

INADIMPLÊNCIA

Fornece o valor padrão do parâmetro, conforme definido no módulo. Quando o módulo espera um valor para um parâmetro que não tem um padrão definido e um parâmetro está faltando ou a palavra-chave DEFAULT é especificada, ocorre um erro.

@string_variable

O nome de uma variável local. @string_variable pode ser qualquer char, varchar, ncharou nvarchar tipo de dados. Estes incluem os (máx.) tipos de dados.

[N]»tsql_string'

Uma cadeia de caracteres constante. tsql_string pode ser qualquer nvarchar ou tipo de dados varchar. Se o N for incluído, a cadeia de caracteres será interpretada como tipo de dados nvarchar.

COMO context_specification

Especifica o contexto no qual a instrução é executada.

Especifica que o contexto a ser representado é um login. O escopo da representação é o servidor.

UTILIZADOR

Especifica o contexto a ser representado como um usuário no banco de dados atual. O escopo da representação é restrito ao banco de dados atual. Uma mudança de contexto para um usuário de banco de dados não herda as permissões de nível de servidor desse usuário.

Importante

Enquanto a mudança de contexto para o usuário do banco de dados estiver ativa, qualquer tentativa de acessar recursos fora do banco de dados fará com que a instrução falhe. Isso inclui instruções USE <database>, consultas distribuídas e consultas que fazem referência a outro banco de dados usando identificadores de três ou quatro partes.

'nome'

Um nome de utilizador ou início de sessão válido. O nome argumento deve ser um membro da função de servidor sysadmin fixa ou existir como uma entidade em sys.database_principals ou sys.server_principals, respectivamente.

Esse argumento não pode ser uma conta interna, como NT AUTHORITY\LocalService, NT AUTHORITY\NetworkServiceou NT AUTHORITY\LocalSystem.

Para obter mais informações, consulte Especificando um nome de usuário ou de login mais adiante neste artigo.

[N]»command_string'

Uma cadeia de caracteres constante que contém o comando a ser passado para o servidor vinculado. Se o N for incluído, a cadeia de caracteres será interpretada como tipo de dados nvarchar.

[?]

Indica parâmetros para os quais os valores são fornecidos na <arg-list> de comandos de passagem que são usados em uma instrução EXECUTE ('...', <arg-list>) AT <linkedsrv>.

EM linked_server_name

Especifica que command_string é executado em relação a linked_server_name e os resultados, se houver, são retornados ao cliente. linked_server_name deve se referir a uma definição de servidor vinculado existente no servidor local. Os servidores vinculados são definidos usando sp_addlinkedserver.

WITH <execute_option>

Possíveis opções de execução. As opções RESULT SETS não podem ser especificadas em uma instrução INSERT...EXECUTE.

EM DATA_SOURCE data_source_name

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.

Especifica que command_string é executado em relação a data_source_name e os resultados, se houver, são retornados ao cliente. data_source_name deve referir-se a uma definição de EXTERNAL DATA SOURCE existente na base de dados. Somente fontes de dados que apontam para o SQL Server são suportadas. Além disso, para fontes de dados do SQL Server Big Data Cluster que apontam para pool de computação, pool de dados ou pool de armazenamento são suportados. As fontes de dados são definidas usando CREATE EXTERNAL DATA SOURCE.

WITH <execute_option>

Possíveis opções de execução. As opções RESULT SETS não podem ser especificadas em uma instrução INSERT...EXECUTE.

Vigência	Definição
`RECOMPILE`	Força um novo plano a ser compilado, usado e descartado depois que o módulo é executado. Se houver um plano de consulta existente para o módulo, esse plano permanecerá no cache. Use esta opção se o parâmetro que você está fornecendo for atípico ou se os dados tiverem sido significativamente alterados. Essa opção não é usada para procedimentos armazenados estendidos. Recomendamos que você use essa opção com moderação porque é caro. Observação: Não é possível usar `WITH RECOMPILE` ao chamar um procedimento armazenado que usa `OPENDATASOURCE` sintaxe. A opção `WITH RECOMPILE` é ignorada quando um nome de objeto de quatro partes é especificado. Nota:`RECOMPILE` não é suportado com funções escalares definidas pelo utilizador compiladas nativamente. Se você precisar recompilar, use sp_recompile.
`RESULT SETS UNDEFINED`	Esta opção não fornece nenhuma garantia de quais resultados, se houver, são retornados, e nenhuma definição é fornecida. A instrução é executada sem erro se algum resultado for retornado ou nenhum resultado for retornado. `RESULT SETS UNDEFINED` é o comportamento padrão se um result_sets_option não for fornecido. Para funções escalares interpretadas definidas pelo usuário e funções escalares definidas pelo usuário compiladas nativamente, essa opção não está operacional porque as funções nunca retornam um conjunto de resultados. Aplica-se a: SQL Server 2012 (11.x) e versões posteriores e Banco de Dados SQL do Azure.
`RESULT SETS NONE`	Garante que a declaração `EXECUTE` não retorne nenhum resultado. Se algum resultado for retornado, o lote será abortado. Para funções escalares interpretadas definidas pelo usuário e funções escalares definidas pelo usuário compiladas nativamente, essa opção não está operacional porque as funções nunca retornam um conjunto de resultados. Aplica-se a: SQL Server 2012 (11.x) e versões posteriores e Banco de Dados SQL do Azure.
`<result_sets_definition>`	Fornece uma garantia de que o resultado volta conforme especificado no `result_sets_definition`. Para instruções que retornam vários conjuntos de resultados, forneça várias seções result_sets_definition. Coloque cada result_sets_definition entre parênteses, separados por vírgulas. Para obter mais informações, consulte `<result_sets_definition>` mais adiante neste artigo. Essa opção sempre resulta em um erro para funções escalares definidas pelo usuário compiladas nativamente porque as funções nunca retornam um conjunto de resultados. Aplica-se a: SQL Server 2012 (11.x) e versões posteriores e Banco de Dados SQL do Azure.

<result_sets_definition> descreve os conjuntos de resultados retornados pelas instruções executadas. As cláusulas do result_sets_definition têm o seguinte significado:

Vigência	Definição
{ column_name data_type [ COLIGIR collation_name ] [NULO \| NÃO NULA] }	Veja a tabela a seguir.
db_name	O nome do banco de dados que contém a tabela, a exibição ou a função com valor de tabela.
schema_name	O nome do esquema que possui a tabela, o modo de exibição ou a função com valor de tabela.
table_name \| view_name \| table_valued_function_name	Especifica que as colunas retornadas são aquelas especificadas na tabela, modo de exibição ou função com valor de tabela nomeada. Variáveis de tabela, tabelas temporárias e sinônimos não são suportados na sintaxe do objeto AS.
COMO TIPO [ schema_name. ]table_type_name	Especifica que as colunas retornadas são aquelas especificadas no tipo de tabela.
QUANTO AO XML	Especifica que os resultados XML da instrução ou procedimento armazenado chamado pela instrução `EXECUTE` são convertidos no formato como se fossem produzidos por uma instrução `SELECT ... FOR XML ...`. Toda a formatação das diretivas de tipo na instrução original é removida e os resultados retornados são como se nenhuma diretiva de tipo tivesse sido especificada. AS FOR XML não converte resultados tabulares não XML da instrução executada ou do procedimento armazenado em XML.

Vigência	Definição
column_name	Os nomes de cada coluna. Se o número de colunas for diferente do conjunto de resultados, ocorrerá um erro e o lote será anulado. Se o nome de uma coluna for diferente do conjunto de resultados, o nome da coluna retornado será definido como o nome definido.
data_type	Os tipos de dados de cada coluna. Se os tipos de dados forem diferentes, uma conversão implícita para o tipo de dados definido será executada. Se a conversão falhar, o lote será abortado
COLLATE collation_name	O agrupamento de cada coluna. Se houver uma incompatibilidade de agrupamento, um agrupamento implícito é tentado. Se isso falhar, o lote será abortado.
NULO \| NÃO NULO	A anulabilidade de cada coluna. Se a anulabilidade definida for `NOT NULL` e os dados retornados contiverem nulos, ocorrerá um erro e o lote será abortado. Se não for especificado, o valor padrão estará em conformidade com a configuração das opções `ANSI_NULL_DFLT_ON` e `ANSI_NULL_DFLT_OFF`.

O conjunto de resultados real que está sendo retornado durante a execução pode diferir do resultado definido usando a cláusula WITH RESULT SETS de uma das seguintes maneiras: número de conjuntos de resultados, número de colunas, nome da coluna, anulabilidade e tipo de dados. Se o número de conjuntos de resultados for diferente, ocorrerá um erro e o lote será anulado.

Comentários

Os parâmetros podem ser fornecidos usando valor ou usando @parameter_name = valor. Um parâmetro não faz parte de uma transação; portanto, se um parâmetro for alterado em uma transação que é revertida posteriormente, o valor do parâmetro não reverte para seu valor anterior. O valor retornado ao chamador é sempre o valor no momento em que o módulo retorna.

O aninhamento ocorre quando um módulo chama outro ou executa código gerenciado fazendo referência a um módulo CLR (Common Language Runtime), tipo definido pelo usuário ou agregado. O nível de aninhamento aumenta quando o módulo chamado ou a referência de código gerenciado inicia a execução e diminui quando o módulo chamado ou a referência de código gerenciado é concluído. Exceder o máximo de 32 níveis de aninhamento faz com que a cadeia de chamada completa falhe. O nível de aninhamento atual é armazenado na função @@NESTLEVEL sistema.

Como os procedimentos armazenados remotos e os procedimentos armazenados estendidos não estão dentro do escopo de uma transação (a menos que emitidos dentro de uma instrução BEGIN DISTRIBUTED TRANSACTION ou quando usados com várias opções de configuração), os comandos executados por meio de chamadas para eles não podem ser revertidos. Para obter mais informações, consulte Procedimentos armazenados do sistema e INICIAR TRANSAÇÕES DISTRIBUÍDAS.

Quando você usa variáveis de cursor, se você executar um procedimento que passa em uma variável de cursor com um cursor alocado a ela, ocorre um erro.

Não é necessário especificar a palavra-chave EXECUTE ao executar módulos se a instrução for a primeira de um lote.

Para obter mais informações específicas para procedimentos armazenados CLR, consulte Procedimentos armazenados CLR.

Usar EXECUTE com procedimentos armazenados

Não é necessário especificar a palavra-chave EXECUTE ao executar procedimentos armazenados quando a instrução for a primeira de um lote.

Os procedimentos armazenados do sistema SQL Server começam com os caracteres sp_. Eles são fisicamente armazenados no Resource Database, mas logicamente aparecem no esquema sys de cada sistema e banco de dados definido pelo usuário. Quando você executa um procedimento armazenado do sistema, em um lote ou dentro de um módulo, como um procedimento armazenado definido pelo usuário ou função, recomendamos que você qualifique o nome do procedimento armazenado com o nome do esquema sys.

Os procedimentos armazenados estendidos do sistema SQL Server começam com os caracteres xp_, e eles estão contidos no esquema dbo do banco de dados master. Quando você executa um procedimento armazenado estendido do sistema, em um lote ou dentro de um módulo, como um procedimento armazenado definido pelo usuário ou função, recomendamos que você qualifique o nome do procedimento armazenado com master.dbo.

Quando você executa um procedimento armazenado definido pelo usuário, em um lote ou dentro de um módulo, como um procedimento armazenado definido pelo usuário ou função, recomendamos que você qualifique o nome do procedimento armazenado com um nome de esquema. Não recomendamos que você nomeie um procedimento armazenado definido pelo usuário com o mesmo nome de um procedimento armazenado do sistema. Para obter mais informações sobre como executar procedimentos armazenados, consulte Executar um procedimento armazenado.

Usar EXECUTE com uma cadeia de caracteres

No SQL Server, os tipos de dados varchar(max) e nvarchar(max) podem ser especificados para permitir cadeias de caracteres de até 2 gigabytes de dados.

As alterações no contexto do banco de dados duram apenas até o final da instrução EXECUTE. Por exemplo, depois que o EXECUTE nesta instrução a seguir é executado, o contexto do banco de dados é master.

USE master;

EXECUTE ('USE AdventureWorks2022; SELECT BusinessEntityID, JobTitle FROM HumanResources.Employee;');

Mudança de contexto

Você pode usar a cláusula AS { LOGIN | USER } = '<name>' para alternar o contexto de execução de uma instrução dinâmica. Quando a opção de contexto é especificada como EXECUTE ('string') AS <context_specification>, a duração da opção de contexto é limitada ao escopo da consulta que está sendo executada.

O nome de usuário ou login especificado em AS { LOGIN | USER } = '<name>' deve existir como uma entidade de sys.database_principals ou sys.server_principals respectivamente, ou a instrução falhará. Além disso, IMPERSONATE permissões devem ser concedidas na entidade de segurança. A menos que o chamador seja o proprietário do banco de dados ou seja membro do sysadmin função de servidor fixa, a entidade de segurança deve existir mesmo quando o usuário estiver acessando o banco de dados ou instância do SQL Server por meio de uma associação de grupo do Windows. Por exemplo, suponha as seguintes condições:

CompanyDomain\SQLUsers grupo tem acesso ao banco de dados Sales.
CompanyDomain\SqlUser1 é membro do SQLUsers e, portanto, tem acesso implícito ao banco de dados Sales.

Embora CompanyDomain\SqlUser1 tenha acesso ao banco de dados por meio da associação ao grupo SQLUsers, a instrução EXECUTE @string_variable AS USER = 'CompanyDomain\SqlUser1' falha porque CompanyDomain\SqlUser1 não existe como entidade de segurança no banco de dados.

Melhores práticas

Especifique um login ou usuário que tenha os privilégios mínimos necessários para executar as operações definidas na instrução ou módulo. Por exemplo, não especifique um nome de login, que tenha permissões no nível do servidor, se apenas as permissões no nível do banco de dados forem necessárias. Ou não especifique uma conta de proprietário de banco de dados, a menos que essas permissões sejam necessárias.

Permissões

As permissões não são necessárias para executar a instrução EXECUTE. No entanto, as permissões são necessárias nos protegíveis que são referenciados dentro da cadeia de caracteres EXECUTE. Por exemplo, se a cadeia de caracteres contiver uma instrução INSERT, o chamador da instrução EXECUTE deverá ter INSERT permissão na tabela de destino. As permissões são verificadas no momento em que EXECUTE instrução é encontrada, mesmo que a instrução EXECUTE esteja incluída em um módulo.

EXECUTE permissões padrão para um módulo ao proprietário do módulo, que pode transferi-las para outros usuários. Quando um módulo é executado que executa uma cadeia de caracteres, as permissões são verificadas no contexto do usuário que executa o módulo, não no contexto do usuário que criou o módulo. No entanto, se o mesmo usuário possui o módulo de chamada e o módulo que está sendo chamado, EXECUTE verificação de permissão não é executada para o segundo módulo.

Se o módulo acessar outros objetos de banco de dados, a execução será bem-sucedida quando você tiver permissão EXECUTE no módulo e uma das seguintes condições for verdadeira:

O módulo é marcado como EXECUTE AS USER ou EXECUTE AS SELFe o proprietário do módulo tem as permissões correspondentes no objeto referenciado. Para obter mais informações sobre representação dentro de um módulo, consulte cláusula EXECUTE AS.
O módulo está marcado EXECUTE AS CALLERe você tem as permissões correspondentes no objeto.
O módulo é marcado EXECUTE AS <user_name>, e <user_name> tem as permissões correspondentes no objeto.

Permissões de comutação de contexto

Para especificar EXECUTE AS em um login, o chamador deve ter permissões de IMPERSONATE no nome de login especificado. Para especificar EXECUTE AS em um usuário de banco de dados, o chamador deve ter permissões de IMPERSONATE no nome de usuário especificado. Quando nenhum contexto de execução é especificado ou EXECUTE AS CALLER é especificado, IMPERSONATE permissões não são necessárias.

Exemplos: SQL Server

Os exemplos de código Transact-SQL neste artigo usam o banco de dados de exemplo ou , que você pode baixar da home page Microsoft SQL Server Samples and Community Projects.

Um. Use EXECUTE para passar um único parâmetro

O uspGetEmployeeManagers procedimento armazenado no banco de dados AdventureWorks2022 espera um parâmetro (@EmployeeID). Os exemplos a seguir executam o procedimento armazenado uspGetEmployeeManagers com Employee ID 6 como seu valor de parâmetro.

EXECUTE dbo.uspGetEmployeeManagers 6;
GO

A variável pode ser explicitamente nomeada na execução:

EXECUTE dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

Se a instrução a seguir for a primeira instrução em um lote ou um script de sqlcmd , não será necessário.

dbo.uspGetEmployeeManagers 6;
GO

--Or
dbo.uspGetEmployeeManagers @EmployeeID = 6;
GO

B. Usar vários parâmetros

O exemplo a seguir executa o procedimento armazenado spGetWhereUsedProductID no banco de dados AdventureWorks2022. Ele passa dois parâmetros: o primeiro parâmetro é um ID do produto () e o segundo parâmetro é um valor datetime .

DECLARE @CheckDate AS DATETIME;
SET @CheckDate = GETDATE();

EXECUTE dbo.uspGetWhereUsedProductID 819, @CheckDate;
GO

C. Use EXECUTE 'tsql_string' com uma variável

O exemplo a seguir mostra como EXECUTE manipula cadeias de caracteres criadas dinamicamente que contêm variáveis. Este exemplo cria o cursor tables_cursor para manter uma lista de todas as tabelas definidas pelo usuário no banco de dados AdventureWorks2022 e, em seguida, usa essa lista para reconstruir todos os índices nas tabelas.

DECLARE tables_cursor CURSOR
    FOR SELECT s.name, t.name FROM sys.objects AS t
    INNER JOIN sys.schemas AS s ON s.schema_id = t.schema_id
    WHERE t.type = 'U';

OPEN tables_cursor;

DECLARE @schemaname AS sysname;
DECLARE @tablename AS sysname;

FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;

WHILE (@@FETCH_STATUS <> -1)
    BEGIN
        EXECUTE ('ALTER INDEX ALL ON ' +
            @schemaname + '.' +
            @tablename + ' REBUILD;');
        FETCH NEXT FROM tables_cursor INTO @schemaname, @tablename;
    END

PRINT 'The indexes on all tables have been rebuilt.';

CLOSE tables_cursor;

DEALLOCATE tables_cursor;

D. Usar EXECUTE com um procedimento armazenado remoto

O exemplo a seguir executa o procedimento armazenado uspGetEmployeeManagers no servidor remoto SQLSERVER1 e armazena o status de retorno que indica sucesso ou falha no @retstat.

DECLARE @retstat AS INT;

EXECUTE
    @retstat = SQLSERVER1.AdventureWorks2022.dbo.uspGetEmployeeManagers
    @BusinessEntityID = 6;

E. Usar EXECUTE com uma variável de procedimento armazenado

O exemplo a seguir cria uma variável que representa um nome de procedimento armazenado.

DECLARE @proc_name AS VARCHAR (30);
SET @proc_name = 'sys.sp_who';

EXECUTE @proc_name;

F. Use EXECUTE com DEFAULT

O exemplo a seguir cria um procedimento armazenado com valores padrão para o primeiro e terceiro parâmetros. Quando o procedimento é executado, esses padrões são inseridos para o primeiro e terceiro parâmetros quando nenhum valor é passado na chamada ou quando o padrão é especificado. Observe as várias maneiras como a palavra-chave DEFAULT pode ser usada.

IF OBJECT_ID(N'dbo.ProcTestDefaults', N'P') IS NOT NULL
    DROP PROCEDURE dbo.ProcTestDefaults;
GO

-- Create the stored procedure.
CREATE PROCEDURE dbo.ProcTestDefaults (
    @p1 SMALLINT = 42,
    @p2 CHAR (1),
    @p3 VARCHAR (8) = 'CAR'
)
AS
SET NOCOUNT ON;
SELECT @p1, @p2, @p3;
GO

O Proc_Test_Defaults procedimento armazenado pode ser executado em muitas combinações.

-- Specifying a value only for one parameter (@p2).
EXECUTE dbo.ProcTestDefaults @p2 = 'A';

-- Specifying a value for the first two parameters.
EXECUTE dbo.ProcTestDefaults 68, 'B';

-- Specifying a value for all three parameters.
EXECUTE dbo.ProcTestDefaults 68, 'C', 'House';

-- Using the DEFAULT keyword for the first parameter.
EXECUTE dbo.ProcTestDefaults
    @p1 = DEFAULT,
    @p2 = 'D';

-- Specifying the parameters in an order different from the order defined in the procedure.
EXECUTE dbo.ProcTestDefaults DEFAULT,
    @p3 = 'Local',
    @p2 = 'E';

-- Using the DEFAULT keyword for the first and third parameters.
EXECUTE dbo.ProcTestDefaults DEFAULT, 'H', DEFAULT;
EXECUTE dbo.ProcTestDefaults DEFAULT, 'I', @p3 = DEFAULT;

G. Use EXECUTE com AT linked_server_name

O exemplo a seguir passa uma cadeia de caracteres de comando para um servidor remoto. Ele cria um servidor vinculado SeattleSales que aponta para outra instância do SQL Server e executa uma instrução DDL (CREATE TABLE) nesse servidor vinculado.

EXECUTE sp_addlinkedserver 'SeattleSales', 'SQL Server';
GO

EXECUTE ('CREATE TABLE AdventureWorks2022.dbo.SalesTbl
(SalesID INT, SalesName VARCHAR(10)); ') AT SeattleSales;
GO

H. Use EXECUTE WITH RECOMPILE

O exemplo a seguir executa o Proc_Test_Defaults procedimento armazenado e força um novo plano de consulta a ser compilado, usado e descartado depois que o módulo é executado.

EXECUTE dbo.Proc_Test_Defaults @p2 = 'A' WITH RECOMPILE;
GO

Eu. Use EXECUTE com uma função definida pelo usuário

O exemplo a seguir executa a função ufnGetSalesOrderStatusText escalar definida pelo usuário no banco de dados AdventureWorks2022. Ele usa a variável @returnstatus para armazenar o valor retornado pela função. A função espera um parâmetro de entrada, @Status. Isso é definido como um tipo de dados minúsculo.

DECLARE @returnstatus AS NVARCHAR (15);
SET @returnstatus = NULL;

EXECUTE
    @returnstatus = dbo.ufnGetSalesOrderStatusText
    @Status = 2;

PRINT @returnstatus;
GO

J. Usar EXECUTE para consultar um banco de dados Oracle em um servidor vinculado

O exemplo a seguir executa várias instruções SELECT no servidor Oracle remoto. O exemplo começa adicionando o servidor Oracle como um servidor vinculado e criando login de servidor vinculado.

-- Setup the linked server.
EXECUTE sp_addlinkedserver
    @server = 'ORACLE',
    @srvproduct = 'Oracle',
    @provider = 'OraOLEDB.Oracle',
    @datasrc = 'ORACLE10';

EXECUTE sp_addlinkedsrvlogin
    @rmtsrvname = 'ORACLE',
    @useself = 'false',
    @locallogin = NULL,
    @rmtuser = 'scott',
    @rmtpassword = 'tiger';

EXECUTE sp_serveroption 'ORACLE', 'rpc out', true;
GO

-- Execute several statements on the linked Oracle server.
EXECUTE ('SELECT * FROM scott.emp') AT ORACLE;
GO

EXECUTE ('SELECT * FROM scott.emp WHERE MGR = ?', 7902) AT ORACLE;
GO

DECLARE @v AS INT;
SET @v = 7902;

EXECUTE ('SELECT * FROM scott.emp WHERE MGR = ?', @v) AT ORACLE;
GO

K. Use EXECUTE AS USER para alternar o contexto para outro usuário

O exemplo a seguir executa uma cadeia de caracteres Transact-SQL que cria uma tabela e especifica a cláusula AS USER para alternar o contexto de execução da instrução do chamador para User1. O Mecanismo de Banco de Dados verifica as permissões de User1 quando a instrução é executada. User1 deve existir como um usuário no banco de dados e deve ter permissão para criar tabelas no esquema Sales, ou a instrução falhará.

EXECUTE ('CREATE TABLE Sales.SalesTable (SalesID INT, SalesName VARCHAR(10));')
AS USER = 'User1';
GO

L. Use um parâmetro com EXECUTE e AT linked_server_name

O exemplo a seguir passa uma cadeia de caracteres de comando para um servidor remoto usando um espaço reservado de ponto de interrogação (?) para um parâmetro. O exemplo cria uma SeattleSales de servidor vinculado que aponta para outra instância do SQL Server e executa uma instrução SELECT nesse servidor vinculado. A instrução SELECT usa o ponto de interrogação como um espaço reservado para o parâmetro ProductID (952), que é fornecido após a instrução.

-- Setup the linked server.
EXECUTE sp_addlinkedserver 'SeattleSales', 'SQL Server';
GO

-- Execute the SELECT statement.
EXECUTE ('SELECT ProductID, Name
    FROM AdventureWorks2022.Production.Product
    WHERE ProductID = ? ', 952) AT SeattleSales;
GO

M. Use EXECUTE para redefinir um único conjunto de resultados

Aplica-se a: SQL Server 2012 (11.x) e versões posteriores e Banco de Dados SQL do Azure.

Alguns dos exemplos anteriores executados EXECUTE dbo.uspGetEmployeeManagers 6; que retornaram sete colunas. O exemplo a seguir demonstra o uso da sintaxe WITH RESULT SET para alterar os nomes e tipos de dados do conjunto de resultados que retorna.

EXECUTE uspGetEmployeeManagers 16 WITH RESULT SETS
((
    [Reporting Level] INT NOT NULL,
    [ID of Employee] INT NOT NULL,
    [Employee First Name] NVARCHAR (50) NOT NULL,
    [Employee Last Name] NVARCHAR (50) NOT NULL,
    [Employee ID of Manager] NVARCHAR (MAX) NOT NULL,
    [Manager First Name] NVARCHAR (50) NOT NULL,
    [Manager Last Name] NVARCHAR (50) NOT NULL
));

N. Use EXECUTE para redefinir dois conjuntos de resultados

Aplica-se a: SQL Server 2012 (11.x) e versões posteriores e Banco de Dados SQL do Azure.

Ao executar uma instrução que retorna mais de um conjunto de resultados, defina cada conjunto de resultados esperado. O exemplo a seguir no AdventureWorks2022 cria um procedimento que retorna dois conjuntos de resultados. Em seguida, o procedimento é executado usando a cláusula WITH RESULT SETS e especificando duas definições de conjunto de resultados.

--Create the procedure
CREATE PROCEDURE Production.ProductList
@ProdName NVARCHAR (50)
AS
-- First result set
SELECT
    ProductID,
    Name,
    ListPrice
FROM Production.Product
WHERE Name LIKE @ProdName;
-- Second result set
SELECT Name,
    COUNT(S.ProductID) AS NumberOfOrders
FROM Production.Product AS P
    INNER JOIN Sales.SalesOrderDetail AS S
        ON P.ProductID = S.ProductID
WHERE Name LIKE @ProdName
GROUP BY Name;
GO

-- Execute the procedure
EXECUTE Production.ProductList '%tire%' WITH RESULT SETS
(
    -- first result set definition starts here
    (ProductID INT,
    [Name] NAME,
    ListPrice MONEY)
    -- comma separates result set definitions
    ,
    -- second result set definition starts here
    ([Name] NAME,
    NumberOfOrders INT)
);

O. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar um SQL Server remoto

Aplica-se a: SQL Server 2019 (15.x) e versões posteriores.

O exemplo a seguir passa uma cadeia de caracteres de comando para uma fonte de dados externa apontando para uma instância do SQL Server.

EXECUTE ( 'SELECT @@SERVERNAME' ) AT DATA_SOURCE my_sql_server;
GO

P. Use EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de computação no SQL Server Big Data Cluster

Aplica-se ao: SQL Server 2019 (15.x).

O exemplo a seguir passa uma cadeia de caracteres de comando para uma fonte de dados externa apontando para um pool de computação no SQL Server Big Data Cluster. O exemplo cria uma fonte de dados SqlComputePool em relação a um pool de computação no SQL Server Big Data Cluster e executa uma instrução SELECT na fonte de dados.

CREATE EXTERNAL DATA SOURCE SqlComputePool
WITH (LOCATION = 'sqlcomputepool://controller-svc/default');

EXECUTE ('SELECT @@SERVERNAME') AT DATA_SOURCE SqlComputePool;
GO

Q. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de dados no SQL Server Big Data Cluster

Aplica-se ao: SQL Server 2019 (15.x).

O exemplo a seguir passa uma cadeia de caracteres de comando para uma fonte de dados externa apontando para o pool de computação no SQL Server Big Data Cluster (BDC). O exemplo cria uma fonte de dados SqlDataPool em relação a um pool de dados no BDC e executa uma instrução SELECT em relação à fonte de dados.

CREATE EXTERNAL DATA SOURCE SqlDataPool
WITH (LOCATION = 'sqldatapool://controller-svc/default');

EXECUTE ('SELECT @@SERVERNAME') AT DATA_SOURCE SqlDataPool;
GO

R. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de armazenamento no SQL Server Big Data Cluster

Aplica-se ao: SQL Server 2019 (15.x).

O exemplo a seguir passa uma cadeia de caracteres de comando para uma fonte de dados externa apontando para o pool de computação no SQL Server Big Data Cluster. O exemplo cria uma fonte de dados SqlStoragePool em relação a um pool de dados no Cluster de Big Data do SQL Server e executa uma instrução SELECT em relação à fonte de dados.

CREATE EXTERNAL DATA SOURCE SqlStoragePool
WITH (LOCATION = 'sqlhdfs://controller-svc/default');

EXECUTE ('SELECT @@SERVERNAME') AT DATA_SOURCE SqlStoragePool;
GO

Exemplos: Azure Synapse Analytics

Os exemplos de código Transact-SQL neste artigo usam o banco de dados de exemplo ou , que você pode baixar da home page Microsoft SQL Server Samples and Community Projects.

R: Execução do procedimento básico

Execute um procedimento armazenado:

EXECUTE proc1;

Chame um procedimento armazenado com nome determinado em tempo de execução:

EXECUTE ('EXECUTE ' + @var);

Chame um procedimento armazenado de dentro de um procedimento armazenado:

CREATE sp_first AS EXECUTE sp_second; EXECUTE sp_third;

B: Executar strings

Execute uma cadeia de caracteres SQL:

EXECUTE ('SELECT * FROM sys.types');

Execute uma cadeia de caracteres aninhada:

EXECUTE ('EXECUTE (''SELECT * FROM sys.types'')');

Execute uma variável de cadeia de caracteres:

DECLARE @stringVar AS NVARCHAR (100);
SET @stringVar = N'SELECT name FROM' + ' sys.sql_logins';

EXECUTE (@stringVar);

C: Procedimentos com parâmetros

O exemplo a seguir cria um procedimento com parâmetros e demonstra três maneiras de executar o procedimento:

CREATE PROCEDURE ProcWithParameters (
    @name NVARCHAR (50),
    @color NVARCHAR (15)
)
AS
SELECT ProductKey,
       EnglishProductName,
       Color
FROM [dbo].[DimProduct]
WHERE EnglishProductName LIKE @namef
      AND Color = @color;
GO

Execute usando parâmetros posicionais:

EXECUTE ProcWithParameters N'%arm%', N'Black';

Execute usando parâmetros nomeados na ordem:

EXECUTE ProcWithParameters
    @name = N'%arm%',
    @color = N'Black';

Execute usando parâmetros nomeados fora de ordem:

EXECUTE ProcWithParameters
    @color = N'Black',
    @name = N'%arm%';
GO

@@NESTLEVEL (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
Cláusula EXECUTE AS (Transact-SQL)
utilitário osql
Entidades de (Mecanismo de Banco de Dados)
REVERTER (Transact-SQL)
sp_addlinkedserver (Transact-SQL)
utilitário sqlcmd
SUSER_NAME (Transact-SQL)
sys.database_principals (Transact-SQL)
sys.server_principals (Transact-SQL)
USER_NAME (Transact-SQL)
OPENDATASOURCE (Transact-SQL)
funções de User-Defined escalar para In-Memory OLTP

Partilhar via

EXECUTAR (Transact-SQL)

Sintaxe

Argumentos

@return_status

module_name

;número

@module_name_var

@parameter

valor

@variable

REALIZAÇÃO

INADIMPLÊNCIA

@string_variable

[N]»tsql_string'

COMO context_specification

INICIAR SESSÃO

UTILIZADOR

'nome'

[N]»command_string'

[?]

EM linked_server_name

EM DATA_SOURCE data_source_name

Comentários

Usar EXECUTE com procedimentos armazenados

Usar EXECUTE com uma cadeia de caracteres

Mudança de contexto

Especificar um nome de utilizador ou início de sessão

Melhores práticas

Permissões

Permissões de comutação de contexto

Exemplos: SQL Server

Um. Use EXECUTE para passar um único parâmetro

B. Usar vários parâmetros

C. Use EXECUTE 'tsql_string' com uma variável

D. Usar EXECUTE com um procedimento armazenado remoto

E. Usar EXECUTE com uma variável de procedimento armazenado

F. Use EXECUTE com DEFAULT

G. Use EXECUTE com AT linked_server_name

H. Use EXECUTE WITH RECOMPILE

Eu. Use EXECUTE com uma função definida pelo usuário

J. Usar EXECUTE para consultar um banco de dados Oracle em um servidor vinculado

K. Use EXECUTE AS USER para alternar o contexto para outro usuário

L. Use um parâmetro com EXECUTE e AT linked_server_name

M. Use EXECUTE para redefinir um único conjunto de resultados

N. Use EXECUTE para redefinir dois conjuntos de resultados

O. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar um SQL Server remoto

P. Use EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de computação no SQL Server Big Data Cluster

Q. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de dados no SQL Server Big Data Cluster

R. Usar EXECUTE com AT DATA_SOURCE data_source_name para consultar o pool de armazenamento no SQL Server Big Data Cluster

Exemplos: Azure Synapse Analytics

R: Execução do procedimento básico

B: Executar strings

C: Procedimentos com parâmetros

Conteúdo relacionado

Comentários

Recursos adicionais