.execute database script kommando`

Växla tjänster med listrutan Version . Läs mer om navigering.
Gäller för: ✅ Microsoft Fabric ✅ Azure Data Explorer

Kör en batch med hanteringskommandon i omfånget för en enskild databas.

Anmärkning

Välj den fullständiga kommandotexten innan du kör den. Annars stoppas den vid den första tomma raden i skriptet.

Tips/Råd

Som standard .execute database script lyckas kommandot alltid. Om du vill att kommandot ska misslyckas när ett av kommandona i skriptet misslyckas kör du kommandot med ThrowOnErrors egenskapen inställd på True

.execute database script with (ThrowOnErrors=true).

Permissions

Du måste ha minst databasadministratör behörighet att köra det här kommandot.

Syntax

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

Läs mer om syntaxkonventioner.

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

Parameterar

Namn Typ Krävs Description
ControlCommandsScript string ✔️ Text med ett eller flera hanteringskommandon.
PropertyName, PropertyValue string Valfria egenskaper. Se Egenskaper som stöds.

Stödda egenskaper

Egenskapsnamn Typ Description
ContinueOnErrors bool Om värdet är inställt false på stoppas skriptet vid det första felet. Om värdet är inställt true på fortsätter skriptkörningen. Förvald: false.
ThrowOnErrors bool Om det är inställt true på – genererar skriptet ett fel (misslyckas) vid det första felet. Fungerar inte tillsammans med ContinueOnErrors, endast en tillåts. Förvald: false.

Retur

Varje kommando som visas i skriptet rapporteras som en separat post i utdatatabellen. Varje post har följande fält:

Utdataparameter Typ Description
OperationId guid Identifierare för kommandot.
CommandType string Typ av kommando.
CommandText string Text för det specifika kommandot.
Result string Resultatet av den specifika kommandokörningen.
Reason string Detaljerad information om kommandokörningsresultat.

Anmärkning

  • Skripttexten kan innehålla tomma rader och kommentarer mellan kommandona.
  • Kommandon körs sekventiellt i den ordning de visas i indataskriptet.
  • Skriptkörningen är sekventiell, men icke-transaktionell och ingen återställning utförs vid fel. Vi rekommenderar att du använder idempotent-formen av kommandon när du använder .execute database script.
  • Körningen av kommandot kräver behörigheter för databasadministratör utöver de behörigheter som krävs för varje specifikt kommando.
  • Standardbeteende för kommandot – misslyckas vid det första felet kan det ändras med egenskapsargument.
  • Skrivskyddade hanteringskommandon (.show kommandon) körs inte och rapporteras med status Skipped.

Tips/Råd

  • Det här kommandot är användbart om du vill "klona"/"duplicera" en befintlig databas. Du kan använda .show database schema command på den befintliga databasen (källdatabasen) och använda dess utdata som Control-commands-script för ".execute database script".
  • Om du vill "klona"/"duplicera" klustret kan du använda dess ARM-mall och återskapa resursen.

Tips/Råd

  • Det här kommandot är användbart om du vill "klona"/"duplicera" en befintlig databas. Du kan använda .show database schema command på den befintliga databasen (källdatabasen) och använda dess utdata som Control-commands-script för ".execute database script".

Example

I följande exempel körs ett skript med flera åtgärder och fortsätter att köras även om ett kommando misslyckas. Skriptet skapar eller sammanfogar tabellen T med kolumner a och b av typen sträng. Den anger sedan en kvarhållningsprincip i tabellen T för mjuk borttagning av data efter 10 dagar. Slutligen skapar eller ändrar den SampleT1 funktionen, vilket tar en parameter myLimit av typen lång och returnerar de första myLimit raderna från tabellen T1. Funktionen skapas utan att verifiera den när den skapas.

.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 Reason
1d28531b-58c8-4023-a5d3-16fa73c06cfa TabellSkapa .create-merge table T(a:string, b:string) Slutfört
67d0ea69-baa4-419a-93d3-234c03834360 RetentionPolicyAlter .alter-merge table T policy retention softdelete = 10d Slutfört
0b0e8769-d4e8-4ff9-adae-071e52a650c7 FunctionCreateOrAlter .create-or-alter function with (skipvalidation = "true")SampleT1(myLimit: long) {T1 \| take myLimit} Slutfört
  • Last updated on