sys.sp_rda_set_query_mode (Transact-SQL)

  • Artículo

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores

Especifica si las consultas en la base de datos habilitada para Stretch actual y sus tablas devuelven datos locales y remotos (el valor predeterminado) o solo datos locales.

Importante

Stretch Database está en desuso en SQL Server 2022 (16.x) y Azure SQL Database. Esta característica se quitará en una versión futura del motor de base de datos. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @mode = ] @mode

Uno de los siguientes valores:

  • DISABLED Se produce un error en todas las consultas en tablas habilitadas para Stretch.

  • LOCAL_ONLY Las consultas en tablas habilitadas para Stretch solo devuelven datos locales.

  • LOCAL_AND_REMOTE Las consultas en tablas habilitadas para Stretch devuelven datos locales y remotos. Este es el comportamiento predeterminado.

[ @force = ] @force

Valor de bit opcional que puede establecer en 1 si desea cambiar el modo de consulta sin validación.

Valores de código de retorno

0 (correcto) o > 0 (erróneo).

Permisos

Requiere permisos de db_owner.

Comentarios

Los siguientes procedimientos almacenados extendidos también establecen el modo de consulta para una base de datos habilitada para Stretch.

  • sp_rda_deauthorize_db:

    Después de ejecutar sp_rda_deauthorize_db , se producirá un error en todas las consultas en las tablas y las bases de datos habilitadas para Stretch. Es decir, el modo de consulta se establece en DISABLED. Para salir de este modo, realice una de las siguientes acciones.

    • Ejecute sys.sp_rda_reauthorize_db (Transact-SQL) para volver a conectarse a la base de datos remota de Azure. Esta operación restablece automáticamente el modo de consulta a LOCAL_AND_REMOTE, que es el comportamiento predeterminado de Stretch Database. Es decir, las consultas devuelven resultados de datos locales y remotos.

    • Ejecute sys.sp_rda_set_query_mode con el LOCAL_ONLY argumento para permitir que las consultas continúen ejecutándose solo con datos locales.

  • sp_rda_reauthorize_db:

    Al ejecutar sys.sp_rda_reauthorize_db (Transact-SQL) para volver a conectarse a la base de datos remota de Azure, esta operación restablece automáticamente el modo de consulta a LOCAL_AND_REMOTE, que es el comportamiento predeterminado de Stretch Database. Es decir, las consultas devuelven resultados de datos locales y remotos.

Contenido relacionado