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

APPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

La tâche DDL d'exécution de Analysis ServicesAnalysis 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.The Analysis ServicesAnalysis Services Execute DDL task runs data definition language (DDL) statements that can create, drop, or alter mining models and multidimensional objects such as cubes and 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 2012Adventure Works DW Multidimensional 2012, l’exemple de base de données Analysis ServicesAnalysis Services inclus dans SQL ServerSQL Server.For example, a DDL statement can create a partition in the Adventure Works cube, or delete a dimension in Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012, the sample Analysis ServicesAnalysis Services database included in SQL ServerSQL Server.

La tâche DDL d'exécution de Analysis ServicesAnalysis Services utilise un gestionnaire de connexions Analysis ServicesAnalysis Services pour se connecter à une instance de Analysis ServicesAnalysis Services ou à un projet Analysis ServicesAnalysis Services .The Analysis ServicesAnalysis Services Execute DDL task uses an Analysis ServicesAnalysis Services connection manager to connect to an instance of Analysis ServicesAnalysis Services or an Analysis ServicesAnalysis Services project. Pour plus d'informations, consultez Analysis Services Connection Manager.For more information, see Analysis Services Connection Manager.

Integration ServicesIntegration 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.includes a number of tasks that perform business intelligence operations, such as processing analytic objects and running data mining prediction queries.

Pour plus d'informations sur les tâches Business Intelligence associées, cliquez sur l'une des rubriques suivantes :For more information about related business intelligence tasks, click one of the following topics:

Instructions DDLDDL Statements

Les instructions DDL sont représentées en tant qu'instructions en langage ASSL ( Analysis ServicesAnalysis Services Scripting Language) et insérées dans une commande XMLA (XML for Analysis).The DDL statements are represented as statements in Analysis ServicesAnalysis Services Scripting Language (ASSL), and framed in an XML for Analysis (XMLA) command.

  • Le langage ASSL permet de définir et de décrire une instance de Analysis ServicesAnalysis Services, ainsi que les bases de données et les objets de base de données qu’elle contient.ASSL is used to define and describe an instance of Analysis ServicesAnalysis Services and the databases and database objects it contains. Pour plus d’informations, consultez Référence Analysis Services Scripting Language (ASSL).For more information, see 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 ServicesAnalysis Services.XMLA is a command language that is used to send action commands, such as Create, Alter, or Process, to an instance of Analysis ServicesAnalysis Services. Pour plus d’informations, consultez Référence XML for Analysis (XMLA).For more information, see XML for Analysis (XMLA) Reference.

Si le code DDL est stocké dans un fichier distinct, la tâche DDL d’exécution de Analysis ServicesAnalysis Services utilise un gestionnaire de connexions de fichiers pour spécifier le chemin du fichier.If the DDL code is stored in a separate file, the Analysis ServicesAnalysis Services Execute DDL task uses a File connection manager to specify the path of the file. Pour plus d’informations, consultez File Connection Manager.For more information, see 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 ServicesAnalysis Services doit utiliser le niveau de protection de package EncryptAllWithUserKey ou EncryptAllWithPassword.Because DDL statements can contain passwords and other sensitive information, a package that contains one or more Analysis ServicesAnalysis Services Execute DDL tasks should use the package protection level EncryptAllWithUserKey or EncryptAllWithPassword. Pour plus d’informations, consultez Integration Services (SSIS), packages.For more information, see Integration Services (SSIS) Packages.

Exemples d'instructions DDLDDL Examples

Les trois instructions DDL suivantes ont été générées en créant des scripts d’objets dans Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012, la base de données Analysis ServicesAnalysis Services incluse dans SQL ServerSQL Server.The following three DDL statements were generated by scripting objects in the Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012, the Analysis ServicesAnalysis Services database included in SQL ServerSQL Server.

L’instruction DDL suivante supprime la dimension Promotion .The following DDL statement deletes the Promotion dimension.

<Delete xmlns="https://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 2012Adventure Works DW Multidimensional 2012 .The following DDL statement processes the Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012 cube.

<Batch xmlns="https://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 .The following DDL statement creates the Forecasting mining model.

<Create xmlns="https://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 2012Adventure Works DW Multidimensional 2012, la base de données Analysis ServicesAnalysis Services incluse dans SQL ServerSQL Server.The following three DDL statements were generated by scripting objects in the Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012, the Analysis ServicesAnalysis Services database included in SQL ServerSQL Server.

L’instruction DDL suivante supprime la dimension Promotion .The following DDL statement deletes the Promotion dimension.

<Delete xmlns="https://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 2012Adventure Works DW Multidimensional 2012 .The following DDL statement processes the Adventure Works DW Multidimensional 2012Adventure Works DW Multidimensional 2012 cube.

<Batch xmlns="https://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 .The following DDL statement creates the Forecasting mining model.

<Create xmlns="https://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 ServicesConfiguration of the Analysis Services Execute DDL Task

Vous pouvez définir les propriétés par le biais du concepteur SSISSSIS ou par programmation.You can set properties through SSISSSIS Designer or programmatically.

Pour plus d'informations sur les propriétés définissables dans le concepteur SSISSSIS , cliquez sur la rubrique suivante :For more information about the properties that you can set in SSISSSIS Designer, click the following topic:

Pour plus d'informations sur la définition de ces propriétés dans le concepteur SSISSSIS , cliquez sur la rubrique suivante :For more information about setting these properties in SSISSSIS Designer, click the following topic:

Configuration par programmation de la tâche DDL d'exécution d'Analysis ServicesProgrammatic Configuration of the Analysis Services Execute DDL Task

Pour plus d'informations sur la définition par programme de ces propriétés, cliquez sur la rubrique suivante :For more information about programmatically setting these properties, click the following topic:

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

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 ServicesAnalysis Services .Use the General pageof the Analysis Services Execute DDL Task Editor dialog box to name and describe the Analysis ServicesAnalysis Services Execute DDL task.

OptionsOptions

NameName
Fournit un nom unique pour la tâche DDL d’exécution Analysis ServicesAnalysis Services .Provide a unique name for the Analysis ServicesAnalysis Services Execute DDL task. Ce nom sert d'étiquette à l'icône de la tâche.This name is used as the label in the task icon.

Notes

Les noms de tâche doivent être uniques dans un package.Task names must be unique within a package.

DescriptionDescription
Tapez une description de la tâche DDL d'exécution Analysis ServicesAnalysis Services .Type a description of the Analysis ServicesAnalysis Services Execute DDL task.

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

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 ServicesAnalysis Services ou à une base de données Analysis ServicesAnalysis Services et fournir des informations sur la source des instructions de langage de définition de données (DDL).Use the DDL page of the Analysis Services Execute DDL Task Editor dialog box to specify a connection to an Analysis ServicesAnalysis Services project or an Analysis ServicesAnalysis Services database and to provide information about the source of data definition language (DDL) statements.

Options statiquesStatic Options

ConnexionConnection
Sélectionnez un projet Analysis ServicesAnalysis Services ou un gestionnaire de connexions Analysis ServicesAnalysis 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.Select an Analysis ServicesAnalysis Services project or an Analysis ServicesAnalysis Services connection manager in the list, or click <New connection...> and use the Add Analysis Services Connection Manager dialog box to create a new connection.

Rubriques connexes : Informations de référence sur l’interface utilisateur de la boîte de dialogue Ajout d’un gestionnaire de connexions Analysis Services, Gestionnaire de connexions Analysis ServicesRelated Topics: Add Analysis Services Connection Manager Dialog Box UI Reference, Analysis Services Connection Manager

SourceTypeSourceType
Spécifiez le type de source des instructions DDL.Specify the source type of the DDL statements. Cette propriété dispose des options répertoriées dans le tableau suivant :This property has the options listed in the following table:

ValeurValue DescriptionDescription
Entrée directeDirect Input Définissez la source de l'instruction DDL enregistrée dans la zone de texte SourceDirect .Set the source to the DDL statement stored in the SourceDirect text box. Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.Selecting this value displays the dynamic options in the following section.
Connexion de fichiersFile Connection Définissez la source par un fichier qui contient l'instruction DDL.Set the source to a file that contains the DDL statement. Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.Selecting this value displays the dynamic options in the following section.
VariableVariable Définissez la source par une variable.Set the source to a variable. Sélectionnez cette valeur pour afficher l'option dynamique de la section suivante.Selecting this value displays the dynamic options in the following section.

Options dynamiquesDynamic Options

SourceType = Entrée directeSourceType = Direct Input

SourceSource
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.Type the DDL statements or click the ellipsis (...) and then type the statements in the DDL Statements dialog box.

SourceType = Connexion de fichiersSourceType = File Connection

SourceSource
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.Select a File connection in the list, or click <New connection...> and use the File Connection Manager dialog box to create a new connection.

Rubriques connexes : Gestionnaire de connexions de fichiersRelated Topics: File Connection Manager

SourceType = VariableSourceType = Variable

SourceSource
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.Select a variable in the list, or click <New variable...> and use the Add Variable dialog box to create a new variable.

Rubriques connexes : Variables Integration Services (SSIS)Related Topics: Integration Services (SSIS) Variables