Compartilhar via


sys.sp_rda_set_query_mode (Transact-SQL)

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

Especifica se as consultas no banco de dados habilitado para Stretch atual e suas tabelas retornam dados locais e remotos (o padrão) ou apenas dados locais.

Importante

O banco de dados de ampliação foi preterido no SQL Server 2022 (16.x) e no Banco de Dados SQL do Azure. Esse recurso será removido em uma versão futura do mecanismo de banco de dados. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_rda_set_query_mode
    [ @mode = ] @mode
    [ , [ @force = ] @force ]
[ ; ]

Argumentos

@mode [ = ] @mode

Um dos seguintes valores:

  • DISABLED Todas as consultas em tabelas habilitadas para Stretch falham.

  • LOCAL_ONLY As consultas em tabelas habilitadas para Stretch retornam apenas dados locais.

  • LOCAL_AND_REMOTE As consultas em tabelas habilitadas para Stretch retornam dados locais e remotos. Esse é o comportamento padrão.

@force [ = ] @force

Um valor de bit opcional que você pode definir como 1 se quiser alterar o modo de consulta sem validação.

Valores do código de retorno

0 (sucesso) ou > 0 (falha).

Permissões

Requer permissões de db_owner.

Comentários

Os procedimentos armazenados estendidos a seguir também definem o modo de consulta para um banco de dados habilitado para Stretch.

  • sp_rda_deauthorize_db:

    Depois de executar sp_rda_deauthorize_db o , todas as consultas em bancos de dados e tabelas habilitados para Stretch falham. Ou seja, o modo de consulta é definido como DISABLED. Para sair desse modo, siga um destes procedimentos.

    • Execute sys.sp_rda_reauthorize_db (Transact-SQL) para se reconectar ao banco de dados remoto do Azure. Essa operação redefine automaticamente o modo de consulta para LOCAL_AND_REMOTE, que é o comportamento padrão do Stretch Database. Ou seja, as consultas retornam resultados de dados locais e remotos.

    • Execute sys.sp_rda_set_query_mode com o argumento para permitir que as LOCAL_ONLY consultas continuem a ser executadas somente em dados locais.

  • sp_rda_reauthorize_db:

    Quando você executa sys.sp_rda_reauthorize_db (Transact-SQL) para se reconectar ao banco de dados remoto do Azure, essa operação redefine automaticamente o modo de consulta para LOCAL_AND_REMOTE, que é o comportamento padrão do Stretch Database. Ou seja, as consultas retornam resultados de dados locais e remotos.