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

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 Analysis Services Scripting Language (ASSL) référence.For more information, see Analysis Services Scripting Language (ASSL) Reference.

  • 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 l'une des rubriques suivantes :For more information about the properties that you can set in SSISSSIS Designer, click one of the following topics:

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: