DDL ausführen (Analysis Services-Task)

Artikel
05/23/2023

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Der Analysis Services -Task DDL ausführen führt DLL-Anweisungen (Data Definition Language, Datendefinitionssprache) aus, mit denen Miningmodelle und mehrdimensionale Objekte, wie z. B. Cubes und Dimensionen, erstellt, gelöscht oder geändert werden können. Beispielsweise kann mit einer DDL-Anweisung eine Partition im Adventure Works -Cube erstellt oder eine Dimension in Adventure Works DW Multidimensional 2012, der im Lieferumfang von Analysis Services enthaltenen Beispieldatenbank von SQL Server, gelöscht werden.

Der Analysis Services -Task DDL ausführen stellt mithilfe eines Verbindungs-Managers von Analysis Services eine Verbindung mit einer Instanz von Analysis Services oder mit einem Projekt von Analysis Services her. Weitere Informationen finden Sie unter Analysis Services Connection Manager.

Integration Services schließt eine Reihe von Tasks ein, die Business Intelligence-Vorgänge ausführen, wie z. B. das Verarbeiten analytischer Objekte und das Ausführen von Data Mining-Vorhersageabfragen.

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu verwandten Business Intelligence-Tasks zu erhalten:

DDL-Anweisungen

Die DDL-Anweisungen werden als Analysis Services Scripting Language (ASSL) dargestellt und in einen XMLA-Befehl (XML for Analysis) eingebunden.

Mit ASSL werden eine Instanz von Analysis Services und die darin enthaltenen Datenbanken und Datenbankobjekte definiert und beschrieben. Weitere Informationen finden Sie unter Analysis Services Scripting Language (ASSL für XMLA).
Bei XMLA handelt es sich um eine Befehlssprache, mit der Aktionsbefehle, wie z. B. Create, Alter oder Process, an eine Instanz von Analysis Servicesgesendet werden. Weitere Informationen finden Sie in der XML for Analysis-Referenz (XMLA).

Wenn der DDL-Code in einer separaten Datei gespeichert ist, gibt der Analysis Services -Task DDL ausführen mithilfe eines Dateiverbindungs-Manager den Dateipfad an. Weitere Informationen finden Sie unter File Connection Manager.

DDL-Anweisungen können Kennwörter und sonstige vertrauliche Informationen enthalten. Deshalb sollte für ein Paket, das Analysis Services -Tasks „DDL ausführen“ enthält, die Paketschutzebene EncryptAllWithUserKey oder EncryptAllWithPasswordverwendet werden. Weitere Informationen finden Sie unter Integration Services-Pakete (SSIS).

DDL-Beispiele

Die folgenden drei DDL-Anweisungen wurden von Skripterstellungsobjekten in Adventure Works DW Multidimensional 2012, der im Lieferumfang von Analysis Services enthaltenen Beispieldatenbank von SQL Server, generiert.

Mit der folgenden DDL-Anweisung wird die Höherstufungs -Dimension gelöscht.

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

Mit der folgenden DDL-Anweisung wird der Adventure Works DW Multidimensional 2012 -Cube verarbeitet.

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

Mit der folgenden DDL-Anweisung wird das Forecasting -Miningmodell erstellt.

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

Mit der folgenden DDL-Anweisung wird die Höherstufungs -Dimension gelöscht.

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

Mit der folgenden DDL-Anweisung wird der Adventure Works DW Multidimensional 2012 -Cube verarbeitet.

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

Mit der folgenden DDL-Anweisung wird das Forecasting -Miningmodell erstellt.

<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 des Analysis Services-Tasks "DDL ausführen"

Sie können Eigenschaften mit dem SSIS -Designer oder programmgesteuert festlegen.

Klicken Sie auf das folgende Thema, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS -Designer festlegen können:

Seite Ausdrücke

Klicken Sie auf das folgende Thema, um weitere Informationen zum Festlegen dieser Eigenschaften im SSIS -Designer zu erhalten:

Festlegen der Eigenschaften eines Tasks oder Containers

Programmgesteuerte Konfiguration des Analysis Services-Tasks "DDL ausführen"

Klicken Sie auf das folgende Thema, um weitere Informationen zum programmgesteuerten Festlegen dieser Eigenschaften anzuzeigen:

ASExecuteDDLTask

Editor für den Analysis Services-Task 'DDL ausführen' (Seite Allgemein)

Auf der Seite Allgemein des Dialogfelds Editor für den Analysis Services-Task „DDL ausführen“ können Sie den Namen und eine Beschreibung des Analysis Services -Tasks „DDL ausführen“ angeben.

Tastatur

Name
Geben Sie einen eindeutigen Namen für den Analysis Services -Task „DDL ausführen“ an. Dieser Name wird im Tasksymbol als Bezeichnung verwendet.

Hinweis

Tasknamen müssen innerhalb eines Pakets eindeutig sein.

Beschreibung
Geben Sie eine Beschreibung des Analysis Services -Tasks 'DDL ausführen' ein.

Editor für den Analysis Services-Task 'DDL ausführen' (Seite DDL)

Auf der Seite DDL des Dialogfelds Editor für den Analysis Services-Task „DDL ausführen“ können Sie eine Verbindung mit einem Analysis Services -Projekt oder einer Analysis Services -Datenbank angeben sowie Informationen zur Quelle der DDL-Anweisungen (Data Definition Language) angeben.

Statische Optionen

Connection
Wählen Sie ein Analysis Services-Projekt oder einen Analysis Services-Verbindungs-Manager in der Liste aus, oder klicken Sie auf <Neue Verbindung...>, und erstellen Sie im Dialogfeld Analysis Services-Verbindungs-Manager hinzufügen eine neue Verbindung.

SourceType
Geben Sie den Quelltyp der DDL-Anweisung an. Für diese Eigenschaft sind die in der folgenden Tabelle aufgeführten Optionen verfügbar:

Wert	BESCHREIBUNG
Direct Input	Legen Sie die Quelle der im Textfeld SourceDirect gespeicherten DDL-Anweisung fest. Wenn Sie diesen Wert auswählen, werden im folgenden Abschnitt die dynamischen Optionen angezeigt.
File Connection	Legen Sie die Quelle für eine Datei fest, in der die DDL-Anweisung enthalten ist. Wenn Sie diesen Wert auswählen, werden im folgenden Abschnitt die dynamischen Optionen angezeigt.
Variable	Legen Sie die Quelle für eine Variable fest. Wenn Sie diesen Wert auswählen, werden im folgenden Abschnitt die dynamischen Optionen angezeigt.

Dynamische Optionen

SourceType = Direkteingabe

Quelle
Geben Sie die DDL-Anweisungen ein, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...) , und geben Sie dann die Anweisungen im Dialogfeld DDL-Anweisungen ein.

SourceType = File Connection

Quelle
Wählen Sie eine Dateiverbindung in der Liste aus, oder klicken Sie auf <Neue Verbindung...>, und erstellen Sie im Dialogfeld Dateiverbindungs-Manager eine neue Verbindung.

Verwandte Themen:Dateiverbindungs-Manager

SourceType = Variable

Quelle
Wählen Sie eine Variable in der Liste aus, oder klicken Sie auf <Neue Variable...>, und erstellen Sie im Dialogfeld Variable hinzufügen eine neue Variable.

Verwandte Themen:Integration Services-Variablen (SSIS)