Tâche DDL d'exécution de SQL Server Analysis Services

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

La tâche DDL d'exécution de Analysis Services exécute des instructions DDL (Data Definition Language) qui peuvent créer, supprimer ou modifier des modèles d'exploration de données et des objets multidimensionnels tels que des cubes et des dimensions. Par exemple, une instruction DDL peut créer une partition dans le cube Adventure Works ou supprimer une dimension dans Adventure Works DW Multidimensional 2012, l’exemple de base de données Analysis Services inclus dans SQL Server.

La tâche DDL d'exécution de Analysis Services utilise un gestionnaire de connexions Analysis Services pour se connecter à une instance de Analysis Services ou à un projet Analysis Services . Pour plus d'informations, consultez Analysis Services Connection Manager.

Integration Services comprend une série de tâches qui effectuent des opérations de Business Intelligence, telles que le traitement des objets analytiques et l’exécution des requêtes de prédiction d’exploration de données.

Pour plus d'informations sur les tâches Business Intelligence associées, cliquez sur l'une des rubriques suivantes :

Instructions DDL

Les instructions DDL sont représentées en tant qu'instructions en langage ASSL ( Analysis Services Scripting Language) et insérées dans une commande XMLA (XML for Analysis).

  • Le langage ASSL permet de définir et de décrire une instance de Analysis Services , ainsi que les bases de données et les objets de base de données qu’elle contient. Pour plus d’informations, consultez Référence Analysis Services Scripting Language (ASSL for XMLA).

  • XMLA est un langage de commande qui permet d'envoyer des commandes d'action, telles que Create, Alter ou Process, à une instance de Analysis Services. Pour plus d’informations, consultez Référence XML for Analysis (XMLA).

Si le code DDL est stocké dans un fichier distinct, la tâche DDL d’exécution de Analysis Services utilise un gestionnaire de connexions de fichiers pour spécifier le chemin du fichier. Pour plus d’informations, consultez File Connection Manager.

Étant donné que les instructions DDL peuvent contenir des mots de passe et d’autres informations sensibles, un package qui comporte une ou plusieurs tâches DDL d’exécution Analysis Services doit utiliser le niveau de protection de package EncryptAllWithUserKey ou EncryptAllWithPassword. Pour plus d’informations, consultez Packages Integration Services (SSIS).

Exemples d'instructions DDL

Les trois instructions DDL suivantes ont été générées en créant des scripts d’objets dans Adventure Works DW Multidimensional 2012, la base de données Analysis Services incluse dans SQL Server.

L’instruction DDL suivante supprime la dimension Promotion .

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

L'instruction DDL suivante traite le cube 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>  
  

L’instruction DDL suivante crée le modèle d’exploration de données Forecasting .

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

Les trois instructions DDL suivantes ont été générées en créant des scripts d’objets dans Adventure Works DW Multidimensional 2012, la base de données Analysis Services incluse dans SQL Server.

L’instruction DDL suivante supprime la dimension Promotion .

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

L'instruction DDL suivante traite le cube 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>  
  

L’instruction DDL suivante crée le modèle d’exploration de données Forecasting .

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

Configuration de la tâche DDL d'exécution d'Analysis Services

Vous pouvez définir les propriétés par le biais du concepteur SSIS ou par programmation.

Pour plus d'informations sur les propriétés définissables dans le concepteur SSIS , cliquez sur la rubrique suivante :

Pour plus d'informations sur la définition de ces propriétés dans le concepteur SSIS , cliquez sur la rubrique suivante :

Configuration par programmation de la tâche DDL d'exécution d'Analysis Services

Pour plus d'informations sur la définition par programme de ces propriétés, cliquez sur la rubrique suivante :

Éditeur de tâche DDL d'exécution Analysis Services (page Général)

La page Général de la boîte de dialogue Éditeur de tâche DDL d’exécution Analysis Services permet de nommer et de décrire la tâche DDL d’exécution Analysis Services .

Options

Nom
Fournit un nom unique pour la tâche DDL d’exécution Analysis Services . Ce nom sert d'étiquette à l'icône de la tâche.

Notes

Les noms de tâche doivent être uniques dans un package.

Description
Tapez une description de la tâche DDL d'exécution Analysis Services .

Éditeur de tâche DDL d'exécution d'Analysis Services (page DDL)

Utilisez la page DDL de la boîte de dialogue Éditeur de tâche DDL d’exécution d’Analysis Services pour spécifier une connexion à un projet Analysis Services ou à une base de données Analysis Services et fournir des informations sur la source des instructions de langage de définition de données (DDL).

Options statiques

Connection
Sélectionnez un projet Analysis Services ou un gestionnaire de connexions Analysis Services dans la liste, ou cliquez sur <Nouvelle connexion...> et utilisez la boîte de dialogue Ajout d’un gestionnaire de connexions Analysis Services pour créer une connexion.

Rubriques connexes :Référence de l'interface utilisateur de la boîte de dialogue Ajout d’un gestionnaire de connexions Analysis Services, Gestionnaire de connexions Analysis Services

SourceType
Spécifiez le type de source des instructions DDL. Cette propriété dispose des options répertoriées dans le tableau suivant :

Valeur Description
Entrée directe Définissez la source de l'instruction DDL enregistrée dans la zone de texte SourceDirect . Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.
Connexion de fichiers Définissez la source par un fichier qui contient l'instruction DDL. Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.
Variable Définissez la source par une variable. Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.

Options dynamiques

SourceType = Entrée directe

Source
Tapez les instructions DDL ou cliquez sur le bouton représentant des points de suspension (...) , puis tapez les instructions dans la boîte de dialogue Instructions DDL.

SourceType = Connexion de fichiers

Source
Sélectionnez une connexion de fichiers dans la liste ou cliquez sur <Nouvelle connexion...> et utilisez la boîte de dialogue Gestionnaire de connexions de fichiers pour créer une connexion.

Rubriques connexes :Gestionnaire de connexions de fichiers

SourceType = Variable

Source
Sélectionnez une variable dans la liste ou cliquez sur <Nouvelle variable> et utilisez la boîte de dialogue Ajouter une variable pour créer une variable.

Rubriques connexes :Variables Integration Services (SSIS)