Analysis Services kör DDL-uppgift

Artikel
01/02/2025

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

Analysis Services Utför DDL-uppgift kör DDL-instruktioner (datadefinitionsspråk) som kan skapa, ta bort eller ändra datautvinningsmodeller och flerdimensionella objekt som kuber och dimensioner. En DDL-instruktion kan till exempel skapa en partition i kuben Adventure Works eller ta bort en dimension i Adventure Works DW Multidimensional 2012, den Analysis Services-exempeldatabas som ingår i SQL Server.

Analysis Services Kör DDL-aktiviteten använder en Analysis Services-anslutningshanterare för att ansluta till en instans av Analysis Services eller ett Analysis Services-projekt. Mer information finns i Analysis Services Connection Manager.

Integration Services innehåller ett antal uppgifter som utför business intelligence-åtgärder, till exempel bearbetning av analysobjekt och körning av datautvinningsförutsägelsefrågor.

Om du vill ha mer information om relaterade business intelligence-uppgifter klickar du på något av följande avsnitt:

DDL-satser

DDL-uttrycken representeras som instruktioner i Analysis Services Scripting Language (ASSL) och inramade i ett XML for Analysis-kommando (XMLA).

ASSL används för att definiera och beskriva en instans av Analysis Services och de databaser och databasobjekt som den innehåller. Mer information finns i Analysis Services Scripting Language (ASSL för XMLA).
XMLA är ett kommandospråk som används för att skicka åtgärdskommandon, till exempel Skapa, Ändra eller Bearbeta, till en instans av Analysis Services. För mer information, se XML för analys (XMLA) referens.

Om DDL-koden lagras i en separat fil, använder Analysis Services Execute DDL-uppgiften en filanslutningshanterare för att ange sökvägen till filen. Mer information finns i Filanslutningshanteraren.

Eftersom DDL-instruktioner kan innehålla lösenord och annan känslig information bör ett paket som innehåller en eller flera Analysis Services exekvera DDL-uppgifter använda paketskyddsnivån EncryptAllWithUserKey eller EncryptAllWithPassword. Mer information finns i Integration Services (SSIS)-paket.

DDL-exempel

Följande tre DDL-instruktioner genererades av skriptobjekt i Adventure Works DW Multidimensional 2012, Analysis Services-databasen som ingår i SQL Server.

Följande DDL-instruktion tar bort dimensionen Promotion.

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

Följande DDL-instruktion bearbetar kuben Adventure Works DW Multidimensional 2012.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

Följande DDL-instruktion skapar Prognostisering gruvmodell.

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

Följande tre DDL-instruktioner genererades av skriptobjekt i Adventure Works DW Multidimensional 2012, Analysis Services-databasen som ingår i SQL Server.

Följande DDL-instruktion tar bort dimensionen Promotion.

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

Följande DDL-instruktion bearbetar kuben Adventure Works DW Multidimensional 2012.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

Följande DDL-instruktion skapar Prognostisering gruvmodell.

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

Konfiguration av Analysis Services kör DDL-uppgift

Du kan ange egenskaper via SSIS Designer eller programmatiskt.

Klicka på följande ämne om du vill ha mer information om de egenskaper som du kan ange i SSIS Designer:

Uttryckssida

Om du vill ha mer information om hur du ställer in dessa egenskaper i SSIS Designer klickar du på följande ämne:

Ange egenskaper för en aktivitet eller container

Programmatisk konfiguration av DDL-uppgift för Analysis Services-exekvering

Klicka på följande ämne om du vill ha mer information om hur du ställer in dessa egenskaper programmatiskt:

ASExecuteDDLTask

Analysis Services kör DDL-aktivitetsredigeraren (allmän sida)

Använd sidan Allmänt i dialogrutan Analysis Services Kör DDL-uppgiftsredigerare för att namnge och beskriva Analysis Services Kör DDL-uppgift.

Alternativ

namn
Ange ett unikt namn för Analysis Services Kör DDL-uppgift. Det här namnet används som etikett i aktivitetsikonen.

Notera

Uppgiftsnamn måste vara unika inom ett paket.

Beskrivning
Ange en beskrivning av uppgiften för att utföra DDL i Analysis Services.

Analysis Services kör DDL-aktivitetsredigeraren (DDL-sida)

Använd sidan DDL i dialogrutan Analysis Services Execute DDL Task Editor för att ange en anslutning till ett Analysis Services-projekt eller en Analysis Services-databas och för att ange information om källan för DDL-instruktioner (datadefinitionsspråk).

Statiska alternativ

Anslutning
Välj ett Analysis Services-projekt eller en Analysis Services-anslutningshanterare i listan eller klicka på <Ny anslutning...> och använd dialogrutan Lägg till Analysis Services Connection Manager för att skapa en ny anslutning.

Relaterade ämnen:Lägg till referens för användargränssnitt i dialogrutan för Analysis Services-anslutningshanteraren, Analysis Services-anslutningshanterare

Källtyp
Ange källtypen för DDL-uttrycken. Den här egenskapen innehåller alternativen i följande tabell:

Värde	Beskrivning
Direktinmatning	Ange källan till DDL-instruktionen som lagras i textrutan SourceDirect. Om du väljer det här värdet visas de dynamiska alternativen i följande avsnitt.
filanslutning	Ange källan till en fil som innehåller DDL-instruktionen. Om du väljer det här värdet visas de dynamiska alternativen i följande avsnitt.
variabel	Ange källan till en variabel. Om du väljer det här värdet visas de dynamiska alternativen i följande avsnitt.

Dynamiska alternativ

SourceType = Direkt inmatning

Källa
Skriv DDL-uttrycken eller klicka på ellipsen (...) och skriv sedan instruktionerna i dialogrutan DDL-instruktioner.

SourceType = Filanslutning

Källa
Välj en filanslutning i listan eller klicka på <Ny anslutning...> och använd dialogrutan Filanslutningshanteraren för att skapa en ny anslutning.

Relaterade ämnen:Filanslutningshanterare

SourceType = Variabel

Källa
Välj en variabel i listan eller klicka på <Ny variabel...> och använd dialogrutan Lägg till variabel för att skapa en ny variabel.

Relaterade ämnen:Integration Services-variabler (SSIS)

Dela via