Tarea Ejecutar DDL de Analysis Services

La tarea Ejecutar DDL de Analysis Services ejecuta instrucciones del lenguaje de definición de datos (DDL) que pueden crear, quitar o modificar modelos de minería de datos y objetos multidimensionales, como cubos y dimensiones. Por ejemplo, una instrucción DDL puede crear una partición en el cubo de Adventure Works o eliminar una dimensión de Adventure Works DW Multidimensional 2012, la base de datos de ejemplo de Analysis Services incluida en SQL Server.

La tarea Ejecutar DDL de Analysis Services utiliza un administrador de conexiones de Analysis Services para conectar con una instancia de Analysis Services o un proyecto de Analysis Services . Para más información, consulte Analysis Services Connection Manager.

Integration Services incluye diversas tareas que realizan operaciones de Business Intelligence, como procesamiento de objetos de análisis y la ejecución de consultas de predicción de minería de datos.

Para obtener más información sobre tareas de Business Intelligence relacionadas, haga clic en uno de los temas siguientes:

• Tarea de procesamiento de Analysis Services

• Tarea Consulta de minería de datos

Instrucciones DDL

Las instrucciones de DDL se representan como instrucciones del Lenguaje de scripting de Analysis Services (ASSL) y se generan como comandos de XML for Analysis (XMLA).

• ASSL se usa para definir y describir una instancia de Analysis Services , así como las bases de datos y los objetos de base de datos que contiene. Para obtener más información, vea Referencia del lenguaje de scripting de Analysis Services (ASSL).

• XMLA es un lenguaje de comandos que se usa para enviar comandos de acción, como Create, Alter o Process, a una instancia de Analysis Services. Para más información, vea Referencia XML for Analysis (XMLA).

Si se almacena el código de DDL en un archivo independiente, la tarea Ejecutar DDL de Analysis Services utiliza un administrador de conexiones de archivos para especificar la ruta del archivo. Para obtener más información, consulte File Connection Manager.

Dado que las instrucciones DDL pueden contener contraseñas y otra información confidencial, un paquete que contenga una o varias tareas ejecutar DDL de Analysis Services debe usar el nivel EncryptAllWithUserKey de protección de paquetes o EncryptAllWithPassword. Para más información, consulte Paquetes de Integration Services (SSIS) Packages.

Ejemplos de DDL

Las tres instrucciones DDL siguientes se generaron mediante objetos de scripting de Adventure Works DW Multidimensional 2012, la base de datos de Analysis Services incluida en SQL Server.

La siguiente instrucción DDL elimina la dimensión Promotion .

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

La siguiente instrucción DDL procesa el cubo de Adventure Works DW Multidimensional 2012 .

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

La siguiente instrucción DDL crea el modelo de minería Forecasting .

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

Las tres instrucciones DDL siguientes se generaron mediante objetos de scripting de Adventure Works DW Multidimensional 2012, la base de datos de Analysis Services incluida en SQL Server.

La siguiente instrucción DDL elimina la dimensión Promotion .

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

La siguiente instrucción DDL procesa el cubo de Adventure Works DW Multidimensional 2012 .

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

La siguiente instrucción DDL crea el modelo de minería Forecasting .

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

Configuración de la tarea Ejecutar DDL de Analysis Services

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSIS , haga clic en uno de los temas siguientes:

• Editor de la tarea Ejecutar DDL de Analysis Services (página General)

• Editor de la tarea Ejecutar DDL de Analysis Services (página DDL)

• Página Expresiones

Para obtener más información sobre cómo configurar estas propiedades en el Diseñador SSIS , haga clic en el siguiente tema:

• Establecer las propiedades de tareas o contenedores

Configuración mediante programación de la tarea Ejecutar DDL de Analysis Services

Para obtener más información sobre cómo establecer estas propiedades mediante programación, haga clic en el tema siguiente:

• ASExecuteDDLTask