Condividi tramite

.execute database script comando

Cambiare i servizi usando l'elenco a discesa Version .Switch services using the Version drop-down list. Altre informazioni sulla navigazione.
Si applica a: ✅ Esplora dati di Azure in Microsoft Fabric ✅

Esegue un batch di comandi di gestione nell'ambito di un singolo database.

Annotazioni

Selezionare il testo completo del comando prima di eseguirlo. In caso contrario, si arresta alla prima riga vuota nello script.

Suggerimento

Per impostazione predefinita, il .execute database script comando ha sempre esito positivo. Se si vuole che il comando non riesca quando uno dei comandi nello script ha esito negativo, eseguire il comando con la ThrowOnErrors proprietà impostata su True

.execute database script with (ThrowOnErrors=true).

Permissions

Per eseguire questo comando, è necessario disporre almeno autorizzazioni di amministratore del database.

Sintassi

.execute database script
[with(PropertyName=PropertyValue [, ...])] <|ControlCommandsScript

Altre informazioni sulle convenzioni di sintassi.

https://microsoft-ce-csi.acrolinx.cloud/htmldata/en/rules/6fba4c0492df38150ba70881e2fae9640d6466a0.html

Parametri

Nome TIPO Obbligatorio Description
ControlCommandsScript string ✔️ Testo con uno o più comandi di gestione.
PropertyName, PropertyValue string Proprietà facoltative. Vedere Proprietà supportate.

Proprietà supportate

PropertyName TIPO Description
ContinueOnErrors bool Se impostato su false : lo script si arresta al primo errore. Se impostato su true : l'esecuzione dello script continua. Impostazione predefinita: false.
ThrowOnErrors bool Se impostato su true : lo script genera un errore (esito negativo) nel primo errore. Non funziona insieme a ContinueOnErrors, è consentito solo uno. Impostazione predefinita: false.

Restituzioni

Ogni comando visualizzato nello script viene segnalato come record separato nella tabella di output. Ogni record ha i campi seguenti:

Parametro di output TIPO Description
OperationId guid Identificatore del comando.
CommandType string Tipo del comando.
CommandText string Testo del comando specifico.
Result string Risultato dell'esecuzione specifica del comando.
Motivo string Informazioni dettagliate sul risultato dell'esecuzione dei comandi.

Annotazioni

  • Il testo dello script può includere righe vuote e commenti tra i comandi.
  • I comandi vengono eseguiti in sequenza, nell'ordine in cui vengono visualizzati nello script di input.
  • L'esecuzione dello script è sequenziale, ma non transazionale e non viene eseguito alcun rollback in caso di errore. È consigliabile usare il formato idempotente dei comandi quando si usa .execute database script.
  • L'esecuzione del comando richiede autorizzazioni di amministratore del database, oltre alle autorizzazioni richieste da ogni comando specifico.
  • Comportamento predefinito del comando: non riesce nel primo errore, può essere modificato usando l'argomento della proprietà.
  • I comandi di gestione di sola lettura (.show comandi) non vengono eseguiti e vengono segnalati con stato Skipped.

Suggerimento

  • Questo comando è utile se si vuole "clonare"/"duplicare" un database esistente. È possibile usare nel .show database schema command database esistente (il database di origine) e usarne l'output come script Control-commands-script di ".execute database".
  • Se si vuole "clonare"/"duplicare" il cluster, è possibile usare il modello di Resource Manager e ricreare la risorsa.

Suggerimento

  • Questo comando è utile se si vuole "clonare"/"duplicare" un database esistente. È possibile usare nel .show database schema command database esistente (il database di origine) e usarne l'output come script Control-commands-script di ".execute database".

Example

Nell'esempio seguente viene eseguito uno script con più operazioni, continuando a essere eseguito anche se un comando non riesce. Lo script crea o unisce una tabella T con colonne a e b di tipo string. Imposta quindi un criterio di conservazione sulla tabella T per eliminare i dati in modo leggero dopo 10 giorni. Infine, crea o modifica la SampleT1 funzione , che accetta un parametro myLimit di tipo long e restituisce le prime myLimit righe della tabella T1. La funzione viene creata senza convalidarla durante la creazione.

.execute database script with (ContinueOnErrors=true)
<|
//
// Create tables
.create-merge table T(a:string, b:string)
//
// Apply policies
.alter-merge table T policy retention softdelete = 10d 
//
// Create functions
.create-or-alter function
  with (skipvalidation = "true") 
  SampleT1(myLimit: long) { 
    T1 | take myLimit
}
OperationId CommandType CommandText Result Motivo
1d28531b-58c8-4023-a5d3-16fa73c06cfa TabellaCrea .create-merge table T(a:string, b:string) Finito
67d0ea69-baa4-419a-93d3-234c03834360 RetentionPolicyAlter .alter-merge table T policy retention softdelete = 10d Finito
0b0e8769-d4e8-4ff9-adae-071e52a650c7 FunctionCreateOrAlter .create-or-alter function with (skipvalidation = "true")SampleT1(myLimit: long) {T1 \| take myLimit} Finito
  • Last updated on