Delen via

DDL-taak in Analysis Services uitvoeren

  • Artikel

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

Met de taak "Analysis Services DDL-taak uitvoeren" worden DDL-instructies (data definitietaal) uitgevoerd waarmee mijnbouwmodellen en multidimensionale objecten, zoals kubussen en dimensies, kunnen worden gemaakt, verwijderd of gewijzigd. Een DDL-instructie kan bijvoorbeeld een partitie maken in de Adventure Works kubus, of een dimensie verwijderen in Adventure Works DW Multidimensional 2012, de voorbeeld-Analysis Services-database die is opgenomen in SQL Server.

De DDL-taak Analysis Services uitvoeren maakt gebruik van een Analysis Services-verbindingsbeheerder om verbinding te maken met een exemplaar van Analysis Services of een Analysis Services-project. Zie Analysis Services Connection Managervoor meer informatie.

Integration Services bevat een aantal taken die business intelligence-bewerkingen uitvoeren, zoals het verwerken van analytische objecten en het uitvoeren van voorspellingsquery's voor gegevensanalyse.

Klik op een van de volgende onderwerpen voor meer informatie over gerelateerde business intelligence-taken:

DDL-instructies

De DDL-verklaringen worden weergegeven als verklaringen in Analysis Services Scripting Language (ASSL) en ingekaderd in een XML for Analysis-commando (XMLA).

  • ASSL wordt gebruikt voor het definiëren en beschrijven van een exemplaar van Analysis Services en de databases en databaseobjecten die deze bevat. Zie Analysis Services Scripting Language (ASSL voor XMLA)voor meer informatie.

  • XMLA is een opdrachttaal die wordt gebruikt voor het verzenden van actieopdrachten, zoals Maken, Wijzigen of Verwerken, naar een exemplaar van Analysis Services. Zie XML for Analysis (XMLA) Referencevoor meer informatie.

Als de DDL-code is opgeslagen in een afzonderlijk bestand, gebruikt de Analysis Services-taak DDL uitvoeren een bestandsverbindingsbeheer om het pad van het bestand op te geven. Zie Bestandsverbindingsbeheervoor meer informatie.

Omdat DDL-instructies wachtwoorden en andere gevoelige informatie kunnen bevatten, moet een pakket met een of meer Analysis Services Execute DDL-taken het pakketbeveiligingsniveau EncryptAllWithUserKey of EncryptAllWithPasswordgebruiken. Zie SSIS-pakketten (Integration Services)voor meer informatie.

DDL-voorbeelden

De volgende drie DDL-instructies zijn gegenereerd door scriptingobjecten in de Adventure Works DW Multidimensionale 2012, de Analysis Services-database die is opgenomen in SQL Server.

Met de volgende DDL-instructie wordt de dimensie Promotie verwijderd.

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

De volgende DDL-verwerkingsopdracht verwerkt de kubus 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>

Met de volgende DDL-instructie wordt het Forecasting mining-model gemaakt.

<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>

De volgende drie DDL-instructies zijn gegenereerd door scripten in "Adventure Works DW Multidimensionale 2012", de Analysis Services-database die deel uitmaakt van SQL Server.

Met de volgende DDL-instructie wordt de dimensie Promotie verwijderd.

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

De volgende DDL-instructie verwerkt de kubus 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>

Met de volgende DDL-instructie wordt het Forecasting mining-model gemaakt.

<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>

Configuratie van de DDL-taak van Analysis Services uitvoeren

U kunt eigenschappen instellen via SSIS Designer of programmatisch.

Klik op het volgende onderwerp voor meer informatie over de eigenschappen die u in SSIS Designer kunt instellen:

Klik op het volgende onderwerp voor meer informatie over het instellen van deze eigenschappen in SSIS Designer:

Programmatische configuratie van de Execute DDL-taak van Analysis Services

Klik op het volgende onderwerp voor meer informatie over het programmatisch instellen van deze eigenschappen:

Editor voor het uitvoeren van DDL-taken in Analysis Services (algemene pagina)

Gebruik de Algemene pagina van het dialoogvenster Uitvoeren DDL-taakeditor voor Analysis Services om de Analysis Services DDL-taak een naam te geven en te beschrijven.

Opties

Naam
Geef een unieke naam op voor de taak "DDL uitvoeren" in Analysis Services. Deze naam wordt gebruikt als het label in het taakpictogram.

Notitie

Taaknamen moeten uniek zijn binnen een pakket.

Beschrijving
Typ een beschrijving van de Analysis Services DDL-uitvoertaak.

DDL-taakeditor (DDL-pagina) uitvoeren in Analysis Services

Gebruik de DDL- pagina van het dialoogvenster Analysis Services DDL-taakeditor uitvoeren dialoogvenster om een verbinding met een Analysis Services-project of een Analysis Services-database op te geven en informatie over de DDL-instructies (Data Definition Language) op te geven.

Statische opties

Verbinding
Selecteer een Analysis Services-project of analysis Services-verbindingsbeheer in de lijst of klik op <Nieuwe verbinding...> en gebruik het dialoogvenster Analysis Services Connection Manager toevoegen om een nieuwe verbinding te maken.

verwante onderwerpen:van de gebruikersinterface van Analysis Services-verbindingsbeheer toevoegen, Analysis Services Connection Manager-

Brontype
Geef het brontype van de DDL-instructies op. Deze eigenschap bevat de opties in de volgende tabel:

Waarde Beschrijving
Directe invoer Stel de bron in op de DDL-instructie die is opgeslagen in het tekstvak SourceDirect. Als u deze waarde selecteert, worden de dynamische opties in de volgende sectie weergegeven.
bestandsverbinding Stel de bron in op een bestand dat de DDL-instructie bevat. Als u deze waarde selecteert, worden de dynamische opties in de volgende sectie weergegeven.
variabele Stel de bron in op een variabele. Als u deze waarde selecteert, worden de dynamische opties in de volgende sectie weergegeven.

Dynamische opties

SourceType = Directe invoer

bron
Typ de DDL-instructies of klik op het beletselteken (...) en typ de instructies in het dialoogvenster DDL-instructies.

SourceType = Bestandsverbinding

bron
Selecteer een bestandsverbinding in de lijst of klik op <Nieuwe verbinding...> en gebruik het dialoogvenster Bestandsverbindingsbeheer om een nieuwe verbinding te maken.

verwante onderwerpen:Bestandsverbindingsbeheer

SourceType = Variabele

bron
Selecteer een variabele in de lijst of klik op <Nieuwe variabele...> en gebruik het dialoogvenster Variabele toevoegen om een nieuwe variabele te maken.

verwante onderwerpen:SSIS-variabelen (Integration Services)