sp_serveroption (Transact-SQL)

Aplica-se a:yes SQL Server (todas as versões com suporte)

Define opções de servidor para servidores remotos e servidores vinculados.

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

sp_serveroption [@server = ] 'server'   
      ,[@optname = ] 'option_name'       
      ,[@optvalue = ] 'option_value' ;  

Argumentos

[ @server = ] 'server' É o nome do servidor para o qual definir a opção. server é sysname, sem padrão.

[ @optname = ] 'option_name' É a opção a ser definida para o servidor especificado. option_name é varchar(35), sem padrão. option_name pode ser qualquer um dos valores a seguir.

Valor Descrição
compatível com ordenação Afeta a execução da Consulta Distribuída nos servidores vinculados. Se essa opção for definida como true, o SQL Server pressupõe que todos os caracteres no servidor vinculado sejam compatíveis com o servidor local, em relação ao conjunto de caracteres e à sequência de ordenação (ou à ordem de classificação). Isso permite que o SQL Server envie comparações sobre colunas de caracteres ao provedor. Se essa opção não estiver definida, o SQL Server sempre avaliará comparações sobre colunas de caracteres localmente.

Essa opção deve ser definida somente se você tiver certeza de que a fonte de dados correspondente ao servidor vinculado tem o mesmo conjunto de caracteres e ordem de classificação do servidor local.
nome da ordenação Especifica o nome da ordenação usada pela fonte de dados remota se o uso de ordenação remota for verdadeiro e a fonte de dados não for uma fonte de dados do SQL Server. O nome deve ser uma das ordenações que têm suporte do SQL Server.

Use essa opção ao acessar uma origem de dados OLE DB diferente do SQL Server, mas cuja ordenação coincide com uma das ordenações do SQL Server.

O servidor vinculado deve fornecer suporte a uma única ordenação a ser usada para todas as colunas naquele servidor. Não defina essa opção se o servidor vinculado fornecer suporte a várias ordenações dentro de uma única fonte de dados ou se a ordenação do servidor vinculado não puder ser determinada para corresponder a uma das ordenações do SQL Server.
tempo limite de conexão Valor de tempo limite em segundos para se conectar a um servidor vinculado.

Se 0, use o padrão sp_configure .
acesso a dados Habilita e desabilita um servidor vinculado para o acesso às consultas distribuídas. Pode ser usado somente para entradas sys.server adicionadas por meio de sp_addlinkedserver.
dist Distribuidor.
validação de esquema lenta Determina se o esquema de tabelas remotas será verificado.

Se for verdadeiro, ignore a verificação de esquema de tabelas remotas no início da consulta.
Pub Editor.
tempo limite da consulta O valor do tempo limite para consultas em um servidor vinculado.

Se 0, use o padrão sp_configure .
Rpc Habilita RPC a partir do servidor fornecido.
rpc out Habilita RPC para o servidor fornecido.
sub Assinante.
sistema Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
usar ordenação remota Determina se a ordenação de uma coluna remota ou de um servidor local será usada.

Se for true, a ordenação de colunas remotas será usada para fontes de dados do SQL Server e a ordenação especificada no nome da ordenação será usada para fontes de dados não SQL Server. Esse é o padrão.

Se for false, as consultas distribuídas sempre usarão a ordenação padrão do servidor local, enquanto o nome da ordenação e a ordenação de colunas remotas serão ignorados.
promoção de transação de proc remoto Use esta opção para proteger as ações de um procedimento servidor a servidor por meio de uma transação do MS DTC (Coordenador de Transações Distribuídas da Microsoft ). Quando esta opção for TRUE (ou ON), a chamada de um procedimento armazenado remoto iniciará uma transação distribuída e inscreverá a transação no MS DTC. A instância do SQL Server que faz a chamada de procedimento armazenado remoto é o originador da transação e controla a conclusão da transação. Quando as instruções subsequentes COMMIT TRANSACTION ou ROLLBACK TRANSACTION são emitidas para a conexão, a instância controladora solicita que o MS DTC gerencie a conclusão da transação distribuída em todas os computadores envolvidos.

Depois que uma transação distribuída Transact-SQL for iniciada, chamadas de procedimento armazenado remoto podem ser feitas para outras instâncias do SQL Server que foram definidas como servidores vinculados. Os servidores vinculados são todos inscritos na transação distribuída Transact-SQL e o MS DTC garante que a transação seja concluída em cada servidor vinculado.

Se essa opção estiver definida como FALSE (ou OFF), uma transação local não será promovida a uma transação distribuída durante a chamada de um procedimento remoto em um servidor vinculado.

Se antes de fazer uma chamada de procedimento de servidor a servidor, a transação já for uma transação distribuída, essa opção não terá efeito. A chamada de procedimento em relação ao servidor vinculado executará sob a mesma transação distribuída.

Se antes de fazer uma chamada de procedimento armazenado de servidor a servidor não houver nenhuma transação ativa, essa opção não terá efeito. Em seguida, o procedimento executa em relação ao servidor vinculado sem transações ativas.

O valor padrão dessa opção é TRUE (ou ON).

[ @optvalue = ] 'option_value' Especifica se o option_name deve ou não ser habilitado (TRUE ou ativado) ou desabilitado (FALSE ou desativado). option_value é varchar(10), sem padrão.

option_value pode ser um inteiro nãonegativo para as opções de tempo limite de conexão e tempo limite de consulta . Para a opção de nome de ordenação , option_value pode ser um nome de ordenação ou NULL.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

Se a opção compatível com ordenação for definida como TRUE, o nome da ordenação será definido automaticamente como NULL. Se o nome da ordenação for definido como um valor não nulo, a ordenação compatível automaticamente será definida como FALSE.

Permissões

Requer permissão ALTER ANY LINKED SERVER no servidor.

Exemplos

O exemplo a seguir configura um servidor vinculado correspondente a outra instância do SQL Server, SEATTLE3para ser compatível com a ordenação com a instância local do SQL Server.

USE master;  
EXEC sp_serveroption 'SEATTLE3', 'collation compatible', 'true';  

Consulte Também

Procedimentos armazenados de consultas distribuídas (Transact-SQL)
sp_adddistpublisher (Transact-SQL)
sp_addlinkedserver (Transact-SQL)
sp_dropdistpublisher (Transact-SQL)
sp_helpserver (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)