dmset - Impostazione parametro di sistema CDC Replication

Utilizzare questo comando per visualizzare o modificare i parametri di sistema di Replica CDC .

È anche possibile modificare i parametri di sistema in Console di gestione.

È possibile impostare i valori dei parametri per sottoscrizione, per tabella o per istanza. Seguire queste linee guida:

  • Se si specifica = ma nessun valore, il valore della proprietà viene cancellato.
  • Se non si specifica =, vengono restituiti i valori del parametro.
  • Specificando -s si rende il valore specifico per l'abbonamento specificato.
  • Specificando -t si rende il valore specifico per la tabella specificata.
  • Specificando -s e -t si rende il valore specifico per l'abbonamento e il nome della tabella specificati.

La gerarchia di precedenza è per - sottoscrizione - per - tabella, per - sottoscrizione, per - tabella e per - istanza.

Il comando dmset visualizza i seguenti valori:

param:sub:table=value // subscription and table -specific
param:sub=value // subscription specific
param::table=value // table specific
param=value // instance specific

Quando si richiede di visualizzare un valore per un parametro particolare:

  • Se vengono specificati un nome sottoscrizione e un nome tabella, mostrare il valore per la proprietà specificata e la sottoscrizione specificata e la tabella specificata.
  • Se viene specificato un nome sottoscrizione ma non un nome tabella, mostrare tutti i valori per la proprietà specificata e la sottoscrizione specificata.
  • Se viene specificato un nome tabella ma non un nome sottoscrizione, visualizzare tutti i valori per la proprietà e la tabella specificate.
  • Se non viene specificato alcun nome di sottoscrizione e di tabella, mostrare tutti i valori per la proprietà specificata.

Non tutti i parametri di sistema supportano le proprietà a livello di sottoscrizione o a livello di tabella.

Se si tenta di impostare, eliminare o visualizzare una proprietà del livello di sottoscrizione per una proprietà che non la supporta, verrà visualizzato il seguente messaggio di errore:

Subscription name is not applicable for property property-name

Se si tenta di impostare, eliminare o visualizzare una proprietà a livello di tabella per una proprietà che non la supporta, verrà visualizzato il seguente messaggio di errore:

Table name is not applicable for property property-name
Nota: è possibile impostare qualsiasi parametro di sistema utilizzando questo comando. Tuttavia, visualizzerà solo i parametri di sistema impostati su valori non predefiniti.

Sintassi

dmset [-I instance_name] [parameter[=[value]]] [-s subscription_name] [-t schema_name.table_name]

Parametri

[-I nome_istanza]
Specifica il nome dell'istanza CDC Replication . In alternativa, è possibile specificare la variabile di ambiente TSINSTANCE invece di questo valore.
[parametro]
Specifica il nome del parametro di sistema Replica CDC .
[valore]
Specifica il valore che si desidera assegnare al parametro di sistema.
[nome_sottoscrizione]
Specifica la sottoscrizione a cui si applica il valore del parametro.
nome_schema]
Specifica lo schema della tabella a cui si applica il valore del parametro.
nome_tabella]
Specifica il nome della tabella a cui si applica il valore del parametro.

Risultato

Questo comando restituisce un valore 0 se il comando ha avuto esito positivo e un valore diverso da zero se il comando ha esito negativo.

Esempi

dmset -I MYINSTANCE

Visualizza tutti i parametri di sistema impostati su valori non predefiniti.

dmset -I MYINSTANCE events_max_retain=20000

Imposta il parametro di sistema events_max_retain su 20000.

dmset -I MYINSTANCE events_max_retain

Visualizza il valore corrente del parametro specificato.

dmset -I MYINSTANCE stop_replication=

Elimina il parametro di sistema stop_replication .

dmset -I MYINSTANCE on_utility_action=REFRESH -s MYSUB -t MYTABLE

Imposta il parametro di sistema on_utilty_action su REFRESH per la sottoscrizione e la tabella specificate.