sys.sp_rda_set_query_mode (Transact-SQL)

  • Articolo

Si applica a: SQL Server 2016 (13.x) e versioni successive

Specifica se le query sul database abilitato per Stretch corrente e le relative tabelle restituiscono dati locali e remoti (impostazione predefinita) o solo dati locali.

Importante

Stretch Database è deprecato in SQL Server 2022 (16.x) e database SQL di Azure. Questa funzionalità verrà rimossa in una versione futura del motore di database. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @mode = ] @mode

Uno dei valori seguenti:

  • DISABLED Tutte le query sulle tabelle abilitate per Stretch hanno esito negativo.

  • LOCAL_ONLY Le query sulle tabelle abilitate per Stretch restituiscono solo dati locali.

  • LOCAL_AND_REMOTE Le query sulle tabelle abilitate per Stretch restituiscono dati locali e remoti. Si tratta del comportamento predefinito.

[ @force = ] @force

Valore di bit facoltativo che è possibile impostare su 1 se si vuole modificare la modalità query senza convalida.

Valori del codice restituito

0 (esito positivo) o > 0 (errore).

Autorizzazioni

Richiede autorizzazioni db_owner .

Osservazioni:

Le stored procedure estese seguenti impostano anche la modalità di query per un database abilitato per Stretch.

  • sp_rda_deauthorize_db:

    Dopo l'esecuzione sp_rda_deauthorize_db di , tutte le query su database e tabelle abilitate per Stretch hanno esito negativo. Ovvero, la modalità query è impostata su DISABLED. Per uscire da questa modalità, eseguire una delle operazioni seguenti.

    • Eseguire sys.sp_rda_reauthorize_db (Transact-SQL) per riconnettersi al database di Azure remoto. Questa operazione reimposta automaticamente la modalità di query su LOCAL_AND_REMOTE, ovvero il comportamento predefinito per Stretch Database. Ovvero, le query restituiscono risultati sia dai dati locali che da quello remoto.

    • Eseguire sys.sp_rda_set_query_mode con l'argomento per consentire l'esecuzione LOCAL_ONLY delle query solo sui dati locali.

  • sp_rda_reauthorize_db:

    Quando si esegue sys.sp_rda_reauthorize_db (Transact-SQL) per riconnettersi al database di Azure remoto, questa operazione reimposta automaticamente la modalità di query su LOCAL_AND_REMOTE, ovvero il comportamento predefinito per Stretch Database. Ovvero, le query restituiscono risultati sia dai dati locali che da quello remoto.

Contenuto correlato